Pages (referred to as a context) can be added using the createContext method on a SimpleHttpServer. This method accepts a string, where the page will be located at; and a handler, which handles the request.

SimpleHttpServer server = SimpleHttpServer.create(8080);

// this would be accessible at
// localhost:8080/some/web/page
server.createContext("/some/web/page");

// this would be accessible at
// localhost:8080/some/other/web/page
server.createContext(
    "/some/other/web/page",
    new HttpHandler(){

        @Override
        public void handle(HttpExchange httpExchange){
            // ...
        }

    }
);

Contexts in a server are case sensitive and will use the most specific context available.

Example: If a user goes to /this/web/page and there are only handlers for /this and /this/web, then the handler for /this/web would be used because its the most specific context that exists on the server.

This consequently means that any handler added to the root / context would handle any requests that don’t have a handler, since it’s the most specific one available.

To resolve this issue the libary provides a root handler.