README.md

jLHS

jLHS(jLHS Light HTTP Server) is a fast and tiny HTTP server written in Java without any external dependencies.

Features

• HTTP 1.1
• Supports SSL(https)
• support for GET and POST requests. Others like PUT, DELETE, etc have limited support.
• Can send gzip compressed responses

Example

// create a server on the port 8080
Server server = new Server(8080);

// add a route to the server
server.on(Method.GET, // method
        "/hello", // url
        (request, response) -> { // request handler
            try {
                response.print("Hello, World!"); // sends "Hello, World!"
                response.end(); // this ends the response and closes related streams
            } catch (Exception e) {
                e.printStackTrace();
            }
        });
        
// test the following with ` curl --form "x=ignored_message" --form "a=test_message" localhost:8080/`
server.on(Method.POST,
        "/",
        (request, response) -> {
            try {
                // get the form data with name "a"
                var data = request.getRequestReader().getFormData("a").orElseThrow();
                data.getFormData().transferTo(System.out); // write to stdout
                response.print("OK"); // send a response
                response.end();
            } catch (Exception e) {
                e.printStackTrace();
            }
        });

server.on(Method.GET,
        "/params",
        (request, response) -> {
        try {
            response.writeHeader("content-type", "text/html");
            for (Map.Entry<String, String> entry : request.getParams().entrySet()) {
                response.print(entry.getKey() + ":" + entry.getValue() + "<br>");
            }
            response.end();
        } catch (Exception e) {
            e.printStackTrace();
        }
    });

server.on(Method.GET,
        Route.DEFAULT,
        ((request, response) -> {
            try {
                response.setCode(404, "Not Found");
                response.writeHeader("content-type", "text/html");
                response.print("The requested URL was not found on this server.");
                response.end();
            } catch (Exception e) {
                e.printStackTrace();
            }
        }));
server.start();

Documentation & Tests

TODO tbh

Contributing

All contributions and suggestions are welcome, just remember to follow the code style. And be polite.