# ISLoadStorm

**Repository Path**: fengjf/isload-storm

## Basic Information

- **Project Name**: ISLoadStorm
- **Description**: LoadStorm 是一个基于 Spring Boot 的负载测试管理平台，整合了 JMeter 的功能，支持基于 JMX 文件和动态 API 参数的负载测试。项目实现了分层架构，具有清晰的代码结构，易于扩展和维护。
- **Primary Language**: Java
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-09-12
- **Last Updated**: 2025-09-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ISLoadStorm

## 简介
ISLoadStorm 是一个基于 Spring Boot 的负载测试管理平台，通过整合 Apache JMeter 的核心功能，提供了一个现代化的性能测试解决方案。平台支持基于 JMX 文件的传统测试方式和基于动态 API 参数的灵活测试方式，满足不同场景的性能测试需求。

## 主要特性
- 双模式测试支持
  - JMX 文件模式：支持上传和运行标准 JMeter 测试脚本
  - API 模式：支持动态配置 HTTP 接口测试参数
- 实时监控
  - 测试进度实时展示
  - 样本数据统计
  - 错误率监控
- 灵活的测试控制
  - 支持测试的启动、停止和状态查询
  - 可配置的并发用户数和爬升时间
- 数据管理
  - 测试历史记录保存
  - 结果数据导出功能

## 技术栈
- 后端：Spring Boot
- 压测引擎：Apache JMeter
- 数据库：MySQL + MyBatis-Plus
- 并发控制：ThreadPoolTaskExecutor

## 环境要求
- JDK 1.8+
- Maven 3.6+
- Apache JMeter 5.4+
- MySQL 5.7+

## 快速开始

### 1. 环境配置
```bash
# 克隆项目
git clone [项目地址]

# 配置 JMeter 环境变量
export JMETER_HOME=/path/to/apache-jmeter
```

### 2. 数据库配置
```sql
# 创建数据库
CREATE DATABASE loadstorm;

# 导入初始化脚本
source schema.sql
```

### 3. 修改配置文件
```yaml
# application.yml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/loadstorm
    username: your_username
    password: your_password

jmeter:
  home: /path/to/apache-jmeter
```

### 4. 启动应用
```bash
mvn spring-boot:run
```

## API 文档

### 测试管理
```
POST /api/load/run/{loadId}  # 启动测试
GET /api/load/status/{testId}  # 查询测试状态
POST /api/load/stop/{testId}  # 停止测试
```

## 项目结构
```
src/main/java/com/iscs/loadstorm
├── config/         # 配置类
├── controller/     # 接口控制层
├── entity/         # 实体类
├── mapper/         # MyBatis接口
├── service/        # 业务逻辑层
├── runner/         # 测试执行器
└── util/           # 工具类
```

## 贡献指南
1. Fork 本仓库
2. 创建您的特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交您的更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 打开一个 Pull Request

## 版本历史
- v1.0.0 (2024-12-24)
    - 初始版本发布
    - 支持 JMX 文件和 API 模式的负载测试
    - 实现基本的测试管理功能

## 许可证
[MIT License](LICENSE)

## 联系方式
- 项目维护者：[M J]
- 邮箱：[3056847915@qq.com]

## 致谢
- Apache JMeter
- Spring Boot
```

这个修改后的 README：
1. 添加了详细的功能特性说明
2. 包含了完整的环境配置和启动说明
3. 提供了清晰的 API 文档
4. 添加了项目结构说明
5. 包含了版本历史和许可证信息
6. 保留了贡献指南但做了更清晰的说明

你可以根据实际情况调整其中的具体内容，比如联系方式、版本号等。