Home Grown Router type server. Lets you map routes into HttpHandlers.
Configuration of thread pool.
Leverages Mongo running in a docker as the storage.
All server params are configurable via javawebserver.properties described bellow.
This project requires Maven, Java 17, and Docker for MongoDB. Follow the steps below to set up your environment and get the project running.
- Docker and Docker Compose
- Java 17
- Maven
-
Maven Setup:
getsetupmaven.shgrabs the latest version of Maven and puts it into~/maven. It also sets up the environment.
-
Java Setup:
getjava.shgrabs version 17 of Java and installs it to~/java.setupjava.shsets up the environment to run Java from the above directory.
-
Run Maven:
setupmaven.shsets up the environment to run Maven from the above directories.
-
MongoDB Setup:
- Ensure Docker and Docker Compose are set up and working on your system (Get Started with Docker).
- Configure
docker-compose.yamlcorrectly for your system. - Run
./runmongodocker.shto start MongoDB using Docker Compose. - On the first run of
docker-compose up, themongodb/mongo-init/init-mongo.jsscript will prepopulate your database. Note: You must delete the database to run this script again.
-
Build and Run the Server:
- First, start MongoDB with
docker-compose up. - Then, you are free to run Maven commands:
mvn clean packagemvn clean compile jar:jar
- To run the server:
./runserver.sh- or
mvn -pl javawebserver exec:java -Dexec.mainClass=com.shyhumangames.app.App
- First, start MongoDB with
The server supports the following endpoints:
/players/${id}Example:http://0.0.0.0:8080/players/2/phones/${id}Example:http://0.0.0.0:8080/phones/4/tickets/${id}Example:http://0.0.0.0:8080/tickets/4
- The main server class is
com.shyhumangames.app.App. - Server settings are controlled by
./javawebserver/resources/javawebserver.properties.
Guidelines for how to contribute to the project.
note the example of logging middleware I made in this example in com.shyhumangames.app.App