Kitteh, a lightweight pure java webserver

Kitteh is a very simple web server. It's not J2EE compilant, it's a standalone library that you can include in your existing project to implement a web user interface.

Features:

very small footprint
sessions
dispatching
parameters and headers parsing
serving static or dynamic content
HTML basic authentication
basic SSL support
Basic Websocket support
etc.

Available in MAVEN via JitPack.

How to use Kitteh

You create and run an instance of WebServer via the WebServerBuilder facility, passing a single DocumentProducer, which is a very simple interface where you define what your server will serve:

void produceDocument(Request request, Response response)

The following is the smallest Kitteh2 program. Other more complex examples are present in the "examples" package.

public static void main(String[] args) throws Exception
{
	String html = "<html><body><h1>Hello World!</h1></body></html>";
	WebServerBuilder
		.produce( (req, res) -> res.setContent(html) )
		.port(8080)
		.run()
		.waitTermination();
}

Many utility DocumentProducer are included here, to implement various things like HTML Authentication, serving files or dispatching, either via rules or with annotations:

public class AnnotatedProducer {

	@Get public void hello(Response response, @NamedArg("name") String name)
	{
		response.setContent("Greetings to: "+name);
	}
	
	@Get public String hello2(@NamedArg("name") String name)
	{
		return "More greetings to: "+name;
	}
	
	@Get public String sum(@NamedArg("a") Integer a, @NamedArg("b") Integer b)
	{
		return "Sum is: " + (a+b);
	}
	
	public static void main(String[] args) throws IOException
	{
		WebServerBuilder
			.produce(new AnnotationProducer(new AnnotatedProducer()))
			.port( 8080)
			.run()
			.waitTermination();
	}
}

Here's a dispatcher based on rules. You can map to either instances of other DocumentProducers or to class names, where regex pattern matching is available:

	Map<String, Object> rules = new HashMap<String, Object>();
	
	rules.put("", new Welcome());
	rules.put("another\\.html", "examples.pages.Informations");
	rules.put("slow\\.html", "examples.pages.Slow");
	rules.put("pages/(.*)", "examples.pages.dispatch.$1");
	rules.put("secret/(.*)",  new AuthenticationProducer(new Informations(), "myuser", "mypass", "Top Secret Area"));
	DocumentProducer f = new FileProducer("www");
	
	DocumentProducer d = new DispatcherProducer(rules, f);

DocumentProducers can be composed with the decorator pattern to add many functionalities, such as logging, concurrency, etc.

msx80/Kitteh

Kitteh, a lightweight pure java webserver

How to use Kitteh