Server

Object Hierarchy:

Soup.Server Soup.Server Soup.Server GLib.Object GLib.Object GLib.Object->Soup.Server

Description:

[ CCode ( type_id = "soup_server_get_type ()" ) ]
public class Server : Object

Example: Simple server, sync:

public class NoodleSoupServer : Soup.Server {
	private int access_counter = 0;

	public NoodleSoupServer () {
		Object (port: 8088);
		assert (this != null);

		// Links:
		//   http://localhost:8088/about.html
		//   http://localhost:8088/index.html
		//   http://localhost:8088/
		this.add_handler ("/about.html", about_handler);
		this.add_handler ("/index.html", root_handler);
		this.add_handler ("/", root_handler);

		// Links:
		//   http://localhost:8088/*
		this.add_handler (null, default_handler);
	}

	private static void root_handler (Soup.Server server, Soup.Message msg, string path, GLib.HashTable? query, Soup.ClientContext client) {
		string html_head = "<head><title>Index</title></head>";
		string html_body = "<body><h1>Index:</h1></body>";
		msg.set_response ("text/html", Soup.MemoryUse.COPY, "<html>%s%s</html>".printf (html_head, html_body).data);
	}

	private static void about_handler (Soup.Server server, Soup.Message msg, string path, GLib.HashTable? query, Soup.ClientContext client) {
		string html_head = "<head><title>About</title></head>";
		string html_body = "<body><h1>About:</h1></body>";
		msg.set_response ("text/html", Soup.MemoryUse.COPY, "<html>%s%s</html>".printf (html_head, html_body).data);
	}

	private static void default_handler (Soup.Server server, Soup.Message msg, string path, GLib.HashTable? query, Soup.ClientContext client) {
		NoodleSoupServer self = server as NoodleSoupServer;
		assert (self != null);

		if (msg.uri.get_path () == "/foo.html") {
			// http://localhost:8088/foo.html
			string html_head = "<head><title>Default</title></head>";
			string html_body = "<body><h1>Default:</h1><p>%s</p><p>%u</p></body>".printf (msg.uri.to_string (false), ++self.access_counter);
			msg.set_response ("text/html", Soup.MemoryUse.COPY, "<html>%s%s</html>".printf (html_head, html_body).data);
		} else {
			// 404:
			msg.set_response ("text/html", Soup.MemoryUse.COPY, "<html><head><title>404</title></head><body><h1>404</h1></body></html>".data);
			msg.status_code = 404;
		}
	}

	public static int main (string[] args) {
		NoodleSoupServer server = new NoodleSoupServer ();
		server.run ();
		return 0;
	}
}

valac --pkg libsoup-2.4 simple-server-sync.vala

Example: Simple server, async:

public class NoodleSoupServer : Soup.Server {
	private int access_counter = 0;

	public NoodleSoupServer () {
		assert (this != null);

		// Links:
		//   http://localhost:8088/*
		this.add_handler (null, default_handler);
	}

	private static void default_handler (Soup.Server server, Soup.Message msg, string path, GLib.HashTable? query, Soup.ClientContext client) {
		unowned NoodleSoupServer self = server as NoodleSoupServer;

		uint id = self.access_counter++;
		print ("Default handler start (%u)\n", id);

		// Simulate asynchronous input / time consuming operations:
		// See GLib.IOSchedulerJob for time consuming operations
		Timeout.add_seconds (0, () => {
			string html_head = "<head><title>Index</title></head>";
			string html_body = "<body><h1>Index:</h1></body>";
			msg.set_response ("text/html", Soup.MemoryUse.COPY, "<html>%s%s</html>".printf (html_head, html_body).data);

			// Resumes HTTP I/O on msg:
			self.unpause_message (msg);
			print ("Default handler end (%u)\n", id);
			return false;
		}, Priority.DEFAULT);

		// Pauses HTTP I/O on msg:
		self.pause_message (msg);
	}

	public static int main (string[] args) {
		try {
			int port = 8088;

			MainLoop loop = new MainLoop ();

			NoodleSoupServer server = new NoodleSoupServer ();
			server.listen_all (port, 0);

			loop.run ();
		} catch (Error e) {
			print ("Error: %s\n", e.message);
		}
		return 0;
	}
}

valac --pkg libsoup-2.4 simple-server-async-new.vala


Namespace: Soup
Package: libsoup-2.4

Content:

Properties:

  • public Address @interface { owned get; construct; }
    The address of the network interface the server is listening on, if you are using the old Server API.
  • public MainContext async_context { get; owned construct; }
    The server's MainContext, if you are using the old API.
  • public string[] http_aliases { owned get; set; }
    A null-terminated array of URI schemes that should be considered to be aliases for "http".
  • public string[] https_aliases { owned get; set; }
    A comma-delimited list of URI schemes that should be considered to be aliases for "https".
  • public uint port { get; construct; }
    The port the server is listening on, if you are using the old Server API.
  • public bool raw_paths { get; construct; }
  • public string server_header { owned get; set construct; }
    If non-%NULL, the value to use for the "Server" header on Messages processed by this server.
  • public string ssl_cert_file { owned get; construct; }
    Path to a file containing a PEM-encoded certificate.
  • public string ssl_key_file { owned get; construct; }
    Path to a file containing a PEM-encoded private key.
  • public TlsCertificate tls_certificate { owned get; construct; }
    A TlsCertificate that has a private_key set.

Creation methods:

  • public Server (string optname1, ...)
    Creates a new Server.

Methods:

Signals:

Inherited Members:

All known members inherited from class GLib.Object