# javaee-lab4 **Repository Path**: LLD-319/javaee-lab4 ## Basic Information - **Project Name**: javaee-lab4 - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-12 - **Last Updated**: 2026-11-12 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # JavaEE 实验四:MySQL 与 MongoDB 日志读写性能测试 本项目实现两套接口一致、日志字段一致、分页规则一致的日志服务,用于对比 Spring Data JPA/MySQL 与 Spring Data MongoDB/MongoDB 的读写性能。 ## 仓库结构 1. `pom.xml`:Maven 父工程 2. `lab4-common`:两套应用共用的 DTO 3. `lab4-jpa-app`:Spring Data JPA + MySQL 实现 4. `lab4-mongo-app`:Spring Data MongoDB + MongoDB 实现 5. `mysql/01-schema.sql`:MySQL 初始化脚本 6. `mongo/01-init.js`:MongoDB 初始化和索引脚本 7. `jmeter/LogRead.jmx`:读取 JMX 8. `jmeter/LogWrite.jmx`:写入 JMX 9. `jmeter/run-test.sh`:JMeter 运行脚本 10. `README.md`:运行说明 11. `deploy/e-apps.env.example`:环境变量示例,只有占位密码 12. `tools/`:用于生成两边一致测试数据的脚本 13. `.gitignore`:排除构建产物和敏感文件 完整目录如下: ```text lab4-log-benchmark/ ├── pom.xml ├── README.md ├── .gitignore ├── lab4-common/ │ ├── pom.xml │ └── src/main/java/com/example/lab4/common/ ├── lab4-jpa-app/ │ ├── pom.xml │ ├── Dockerfile │ └── src/main/ ├── lab4-mongo-app/ │ ├── pom.xml │ ├── Dockerfile │ └── src/main/ ├── mysql/ │ └── 01-schema.sql ├── mongo/ │ └── 01-init.js ├── jmeter/ │ ├── LogRead.jmx │ ├── LogWrite.jmx │ ├── run-test.sh │ └── README.md ├── deploy/ │ └── e-apps.env.example ├── tools/ │ ├── generate_mysql_seed.py │ ├── seed_mongo.js │ └── README.md └── results/ └── README.md ``` ## 技术栈 ```text Java 21 Spring Boot 3.2.5 Maven 3.9+ Spring Data JPA Spring Data MongoDB MySQL 8.0 MongoDB 7.0 JMeter 5.6.3 Prometheus ``` ## 统一数据模型 | 字段 | MySQL | MongoDB | 说明 | |---|---|---|---| | `id` | `CHAR(26)` 主键 | `_id` 字符串 | 26 位 ULID | | `traceId` | `VARCHAR(64)` | 字符串 | 链路标识,可为空 | | `level` | `VARCHAR(10)` | 字符串 | TRACE、DEBUG、INFO、WARN、ERROR | | `source` | `VARCHAR(128)` | 字符串 | 服务或模块名 | | `message` | `VARCHAR(4096)` | 字符串 | 日志正文 | | `clientIp` | `VARCHAR(45)` | 字符串 | IPv4 或 IPv6 | | `createdAt` | `DATETIME(6)` | BSON Date | 统一使用 UTC | ## 统一 REST API 写入一条日志: ```http POST /api/logs Content-Type: application/json ``` ```json { "traceId": "trace-001", "level": "INFO", "source": "order-service", "message": "订单创建成功", "clientIp": "127.0.0.1" } ``` 按级别和时间范围分页查询: ```http GET /api/logs?level=INFO&from=2026-01-01T00:00:00Z&to=2026-01-02T00:00:00Z&page=0&size=20 ``` 分页规则: ```text level 为可选等值条件 from <= createdAt < to page 从 0 开始 size 默认 20,最大 100 排序为 createdAt DESC, id DESC 响应字段为 content、page、size、totalElements ``` 健康检查和 Prometheus 指标: ```text GET /actuator/health GET /actuator/prometheus ``` ## MySQL 初始化 先为 `mysql/01-schema.sql` 设置真实应用密码,再执行: ```bash mysql -uroot -p < mysql/01-schema.sql ``` 脚本会创建: ```text 数据库:lab4 用户:logapp 表:app_log 索引:idx_level_created、idx_created ``` ## MongoDB 初始化 MongoDB 管理员和应用用户需要单独创建。初始化索引: ```bash docker exec -i mongo-log mongosh \ -u mongoadmin -p --authenticationDatabase admin \ < mongo/01-init.js ``` MongoDB 连接串必须使用 `authSource=lab4`: ```text mongodb://logapp:MONGO_APP_PASSWORD@MONGO_HOST:27017/lab4?authSource=lab4&maxPoolSize=20 ``` ## 编译与打包 在安装了 JDK 21 和 Maven 3.9+ 的服务器上执行: ```bash mvn clean package -DskipTests ``` 构建应用镜像: ```bash docker build -t lab4-jpa:1.0 lab4-jpa-app docker build -t lab4-mongo:1.0 lab4-mongo-app ``` ## 环境变量 复制环境变量模板: ```bash cp deploy/e-apps.env.example /etc/lab4/e-apps.env chmod 600 /etc/lab4/e-apps.env ``` 根据实际环境修改: ```dotenv MYSQL_URL=jdbc:mysql://MYSQL_HOST:3306/lab4?useUnicode=true&characterEncoding=utf8&serverTimezone=UTC MYSQL_USER=logapp MYSQL_PASSWORD=YOUR_MYSQL_PASSWORD MONGO_URI=mongodb://logapp:YOUR_MONGO_PASSWORD@MONGO_HOST:27017/lab4?authSource=lab4&maxPoolSize=20 ``` `e-apps.env`、真实密码和其他密钥不得提交到 Git。 ## 运行应用 JPA/MySQL 版: ```bash docker run -d --name log-jpa-app \ --restart unless-stopped \ --cpus=1.5 --memory=900m \ -p 8080:8080 \ --env-file /etc/lab4/e-apps.env \ lab4-jpa:1.0 ``` MongoDB 版: ```bash docker run -d --name log-mongo-app \ --restart unless-stopped \ --cpus=1.5 --memory=900m \ -p 8081:8080 \ --env-file /etc/lab4/e-apps.env \ lab4-mongo:1.0 ``` 正式压测时,应用服务器上应只运行当前被测应用,避免两个 JVM 同时争抢资源。 ## 测试数据 生成 MySQL 固定种子数据: ```bash python3 tools/generate_mysql_seed.py 200000 > seed_mysql.sql ``` 导入同一份逻辑数据到 MongoDB: ```bash docker cp tools/seed_mongo.js mongo-log:/tmp/seed_mongo.js docker exec -i mongo-log mongosh \ -u mongoadmin -p --authenticationDatabase admin \ --file /tmp/seed_mongo.js ``` 两边基线均为 200,000 条记录,level 分布必须一致。 ## JMeter 测试 先赋予脚本执行权限: ```bash chmod +x jmeter/run-test.sh ``` 脚本参数格式: ```bash ./jmeter/run-test.sh <线程数> <运行编号> ``` 例如测试 Mongo 读取: ```bash DURATION=10 RAMP_UP=2 \ ./jmeter/run-test.sh read mongo 50 1 ``` 测试 JPA 写入: ```bash DURATION=10 RAMP_UP=2 \ ./jmeter/run-test.sh write jpa 100 1 ``` 结果保存在: ```text results/<模式>-<后端>-<线程数>-<运行编号>.jtl results/<模式>-<后端>-<线程数>-<运行编号>-html/index.html ```