Web app

.github/workflows/run-tests.yml

@@ -20,7 +20,7 @@ jobs:
     - name: Compile Java code and tests
       run: |
         mkdir -p bin
-        find src -name "*.java" > sources.txt
-        javac -cp "lib/*" -d bin @sources.txt
+        find java-backend/src -name "*.java" > sources.txt
+        javac -cp "java-backend/lib/*" -d bin @sources.txt
     - name: Run JUnit tests
-      run: java -cp "bin:lib/*" org.junit.platform.console.ConsoleLauncher --scan-class-path
+      run: java -cp "bin:java-backend/lib/*" org.junit.platform.console.ConsoleLauncher --scan-class-path

.vscode/settings.json

@@ -0,0 +1,8 @@
+{
+  "java.project.sourcePaths": [
+    "java-backend/src"
+  ],
+  "java.project.referencedLibraries": [
+    "java-backend/lib/**/*.jar",
+  ]
+}

.gitignore → java-backend/.gitignore

@@ -4,4 +4,5 @@ we-get-these-100s.iml
 latex/main.aux
 latex/main.log
 .DS_Store
-main.out
+main.out
+.env

java-backend/Dockerfile

@@ -0,0 +1,53 @@
+# Use Eclipse Temurin as the builder (more secure and maintained)
+FROM eclipse-temurin:21-jdk-alpine AS builder
+WORKDIR /app
+
+# Create lib directory first to avoid errors if it doesn't exist
+RUN mkdir -p lib
+
+# Copy project source and dependencies
+COPY src/ ./src/
+COPY lib/*.jar ./lib/
+COPY src/simulation_data.json ./simulation_data.json
+
+# Compile the Java sources. 
+# Adjust the classpath, output directory, and source files as needed.
+RUN mkdir out && javac -d out -cp "./lib/*" $(find src -name "*.java")
+
+# Final stage: use a minimal JRE image for runtime
+FROM eclipse-temurin:21-jre-alpine
+WORKDIR /app
+
+# Create a non-root user for security
+RUN addgroup -g 1001 -S appgroup && \
+    adduser -S appuser -u 1001 -G appgroup
+
+# Copy compiled classes and the lib folder from builder stage
+COPY --from=builder /app/out/ ./out/
+COPY --from=builder /app/lib/ ./lib/
+COPY --from=builder /app/simulation_data.json ./simulation_data.json
+
+# Change ownership to the non-root user
+RUN chown -R appuser:appgroup /app
+
+# Switch to non-root user
+USER appuser
+
+# Expose the WebSocket port
+EXPOSE 8080
+
+# Add a simple healthcheck
+HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
+  CMD exit 0
+
+# Run in headless mode with server optimizations
+CMD ["java", \
+  "-Djava.awt.headless=true", \
+  "-server", \
+  "-XX:+UseContainerSupport", \
+  "-XX:MinRAMPercentage=50", \
+  "-XX:MaxRAMPercentage=80", \
+  "-Dfile.encoding=UTF-8", \
+  "-Duser.timezone=UTC", \
+  "-cp", "./out:./lib/*", \
+  "Main"]

java-backend/src/Main.java

@@ -0,0 +1,22 @@
+import api.Connector;
+import simulation.simulationData.Data;
+import util.Parser;
+import view.Engine;
+
+/**
+ * Main class to start the simulation through the Engine class.
+ * 
+ * @author Mehmet Kutay Bozkurt and Anas Ahmed
+ * @version 1.0
+ */
+public class Main {
+  private static final String PATH = System.getProperty("user.dir"); // The main directory of the project.
+
+  public static void main(String[] args) {
+    Connector.getInstance().start(); // For use with the web API.
+
+    // If you want to run the simulation without the web API, uncomment the following lines:
+    // Data.setSimulationData(Parser.parseSimulationData(Parser.getContentsOfFile(PATH + "/java-backend/src/simulation_data.json")));
+    // new Engine(800, 600, 60).start();
+  }
+}

java-backend/src/api/Connector.java

@@ -0,0 +1,71 @@
+package api;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+/**
+ * A class to manage WebSocket connections and handle simulation control.
+ * 
+ * @author Mehmet Kutay Bozkurt
+ * @version 1.0
+ */
+public class Connector {
+  // The port for the WebSocket server
+  public static final int WEBSOCKET_PORT = 8080;
+
+  // The logger to log messages.
+  private static Logger logger = LoggerFactory.getLogger(Connector.class);
+
+  private static Connector instance; // Singleton instance
+  private final WebSocketHandler webSocketServer; // The unified WebSocket server.
+
+  /**
+   * Private constructor for singleton pattern.
+   */
+  private Connector() {
+    webSocketServer = new WebSocketHandler(WEBSOCKET_PORT);
+  }
+
+  /**
+   * Get the singleton instance.
+   */
+  public static synchronized Connector getInstance() {
+    if (instance == null) {
+      instance = new Connector();
+    }
+    return instance;
+  }
+
+  /**
+   * Start listening for WebSocket connections and messages.
+   */
+  public void listen() {
+    try {
+      webSocketServer.start();
+    } catch (Exception e) {
+      logger.error("WebSocket server failed.", e);
+    }
+  }
+
+  /**
+   * Start the listener in a new thread.
+   */
+  public void start() {
+    Thread t = new Thread(this::listen);
+    t.start();
+  }
+
+  /**
+   * Close the WebSocket server.
+   */
+  public void close() {
+    webSocketServer.stop();
+  }
+
+  /**
+   * Get the WebSocket server instance.
+   */
+  public WebSocketServer getWebSocketServer() {
+    return webSocketServer;
+  }
+}