# mikemelon/java-exam architecture

> Architecture diagram of the GitHub repository mikemelon/java-exam, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mikemelon/java-exam
- Repository: https://github.com/mikemelon/java-exam

## Overview

##### Project type and purpose
- This is a full-stack Java web application (“java-exam”) for online exams: question-bank editing, exam composition (fixed/random), online testing, scoring, statistics, user management and broadcasting messages.
- It uses JSP/Struts2 for presentation, Spring for wiring, Hibernate for persistence, Tomcat (with WebSocket) as the runtime, MySQL as the database.

##### File structure
- Top-level pom.xml, README.md, LICENSE, Maven standard src/ and resource directories.
- src/main/java: packages under cn.lynu.lyq.java_exam:
- actions: Struts2 Action classes (presentation layer/controllers)
- common, utils, filters, websocket: shared constants, filters, WebSocket server components
- dao + dao/impl: Hibernate DAOs (data access layer)
- entity: JPA/Hibernate entity classes (domain model)
- misc: chart renderers, test utilities
- test: unit/integration tests for charting, file generation, import, exam phases
- src/main/resources: Spring applicationContext.xml, Struts config (struts.xml), Log4j2, property files, SQL import scripts
- src/main/webapp: JSP views, JS/CSS assets (Materialize, jQuery, jOrgChart, Font Awesome), web.xml
- screenshots, _config.yml (GitHub Pages), .settings, .gitignore, Eclipse/Maven project files

##### README for additional insights
- Confirms MVC architecture: Struts2 + Spring + Hibernate.
- Outlines features (online exam, import data, user mgmt, search/stats, tree visualization, push messages).

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client Layer
    subgraph "Client (Web Browser)" 
        Client["Static JSP/HTML, CSS, JS"]:::frontend
    end

    %% Web Server Layer
    subgraph "Web Server (Tomcat)"
        subgraph "Presentation Layer"
            Filter["Struts2 Filter Dispatcher"]:::presentation
            Actions["Action Controllers"]:::presentation
        end
        subgraph "Service Layer"
            Services["Business Services (Spring Beans)"]:::service
            Utils["Utilities & Constants"]:::service
            Chart["Chart Rendering Utilities"]:::service
        end
        subgraph "Data Access Layer"
            DAO_I["DAO Interfaces"]:::data
            DAO_Impl["DAO Implementations"]:::data
            Entities["Domain Entities (Entities)"]:::data
        end
        WebSocket["WebSocket Broadcast Server"]:::ws
        Config["App Configurations"]:::config
        Log["Logging Configuration"]:::config
    end

    %% Persistence and Storage
    DB["MySQL Database"]:::db
    FS["File Storage (Imported/Reports)"]:::fs

    %% Testing
    Tests["Unit & Integration Tests"]:::test

    %% Relationships
    Client -->|"HTTP Request"| Filter
    Filter -->|"/action"| Actions
    Actions -->|"invoke"| Services
    Services -->|"use"| DAO_I
    DAO_I -->|"implemented by"| DAO_Impl
    DAO_Impl -->|"persistence"| DB
    DAO_Impl -->|"maps to"| Entities
    Services -->|"read/write entities"| Entities
    Services -->|"generate charts"| Chart
    Actions -->|"file upload/download"| FS
    Client -->|"<script> WebSocket"| WebSocket
    WebSocket -->|"push messages"| Client
    Tests -->|direct call| Services
    Tests -->|direct call| DAO_Impl

    %% Click Events
    click Client "https://github.com/mikemelon/java-exam/tree/master/src/main/webapp"
    click Filter "https://github.com/mikemelon/java-exam/blob/master/src/main/java/cn/lynu/lyq/java_exam/filters/JspFilter.java"
    click Filter "https://github.com/mikemelon/java-exam/blob/master/src/main/webapp/WEB-INF/web.xml"
    click Actions "https://github.com/mikemelon/java-exam/blob/master/src/main/java/cn/lynu/lyq/java_exam/actions/*.java"
    click Actions "https://github.com/mikemelon/java-exam/blob/master/src/main/java/cn/lynu/lyq/java_exam/actions/DownloadExportedFileAction.java"
    click Actions "https://github.com/mikemelon/java-exam/blob/master/src/main/java/cn/lynu/lyq/java_exam/actions/QuestionImportAction.java"
    click Actions "https://github.com/mikemelon/java-exam/blob/master/src/main/java/cn/lynu/lyq/java_exam/actions/StudentImportAction.java"
    click Config "https://github.com/mikemelon/java-exam/blob/master/src/main/resources/applicationContext.xml"
    click Config "https://github.com/mikemelon/java-exam/blob/master/src/main/resources/struts.xml"
    click Log "https://github.com/mikemelon/java-exam/blob/master/src/main/resources/log4j2.xml"
    click DAO_I "https://github.com/mikemelon/java-exam/blob/master/src/main/java/cn/lynu/lyq/java_exam/dao/*.java"
    click DAO_Impl "https://github.com/mikemelon/java-exam/blob/master/src/main/java/cn/lynu/lyq/java_exam/dao/impl/*.java"
    click Entities "https://github.com/mikemelon/java-exam/blob/master/src/main/java/cn/lynu/lyq/java_exam/entity/*.java"
    click Utils "https://github.com/mikemelon/java-exam/tree/master/src/main/java/cn/lynu/lyq/java_exam/common"
    click Utils "https://github.com/mikemelon/java-exam/tree/master/src/main/java/cn/lynu/lyq/java_exam/utils"
    click Chart "https://github.com/mikemelon/java-exam/blob/master/src/main/java/cn/lynu/lyq/java_exam/misc/CustomColorBarRenderer.java"
    click WebSocket "https://github.com/mikemelon/java-exam/blob/master/src/main/java/cn/lynu/lyq/java_exam/websocket/BroadcastServer.java"
    click WebSocket "https://github.com/mikemelon/java-exam/blob/master/src/main/java/cn/lynu/lyq/java_exam/websocket/GetHttpSessionConfigurator.java"
    click FS "https://github.com/mikemelon/java-exam/tree/master/src/main/resources/import"
    click Tests "https://github.com/mikemelon/java-exam/blob/master/src/main/java/cn/lynu/lyq/java_exam/test/*.java"

    %% Styles
    classDef frontend fill:#D6E9FF,stroke:#000
    classDef presentation fill:#BFDFFF,stroke:#000
    classDef service fill:#DFFFBF,stroke:#000
    classDef data fill:#FFE0B2,stroke:#000
    classDef db fill:#CCCCCC,stroke:#000
    classDef fs fill:#BBBBBB,stroke:#000
    classDef ws stroke:#FFA500,stroke-width:2px
    classDef config fill:#E0E0E0,stroke:#000
    classDef test fill:#F0D9FF,stroke:#000
```
