README.md

Java Server

Requirements

• Java 1.8
• Maven 3.5.0

Run com.github.kyleannen.javaserver.Server

• Clone repository.
• Compile the project.

mvn package

• Run the server, optionally specifying the port and root directory to serve.

java -jar target/java-server-0.5.5.jar -p 3030 -d /Root/directory/to/serve

Run tests

mvn clean test

Adding routes

To add route, a method can be added in the ConfigRoutes class.

If the server is to be used as a dependency, the following pattern can be used to add routes, disable dynamic directory and file serving, and to run a custom configuration of the server.

import com.github.kyleannen.javaserver

public class CustomServer {
    public void run() {
        Router router = new Router();
        //optionally disable dynamic routing of directory structures
        router.disableDirectoryRouting();
        //optionally disable dynamic routing of files (file serving)
        router.disableFileRouting();
        //add individual routes
        router.addRoute("GET", "/custom/route", customController);
        //create a string array of the command line flags to pass to the server
        String[] args = new String[]{"-p", "3000"}
        Server server = ConfigureServer().configure(args, router);
        server.start();
    }
}