# Java实现的接口自动化框架

**Repository Path**: rebortgzmyinit/java_apitest

## Basic Information

- **Project Name**: Java实现的接口自动化框架
- **Description**: 基于JAVA+jsonpath+httpclient+allure实现的接口自动化框架
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-09-18
- **Last Updated**: 2026-02-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: JAVA数据驱动接口框架

## README

# Java API 测试项目

这是一个使用 TestNG 进行 API 测试的 Java 项目。项目包含了丰富的测试用例和测试功能，适合用于 Web 服务接口的自动化测试。

## 项目特点

- 使用 TestNG 框架进行测试
- 支持从 Excel 和 YAML 文件加载测试数据
- 提供强大的 HTTP 请求工具类
- 支持全局变量管理和 SQL 初始化
- 包含详细的测试报告 (Allure 报告)

## 主要功能

- 从 Excel 加载测试用例数据
- 发送各种类型的 HTTP 请求 (GET, POST, PUT, DELETE 等)
- 支持请求头、参数、JSON 体的灵活配置
- 支持全局变量替换和保存
- 支持 SQL 初始化操作
- 提供详细的日志记录和异常处理
- 支持测试分组、依赖测试、超时设置等 TestNG 功能

## 目录结构

- `src/main/java` - 核心代码
  - `com/hwapitest/demo` - 测试用例示例
  - `com/hwapitest/entity` - 数据实体类
  - `com/hwapitest/testcase` - 测试基类
  - `com/hwapitest/utils` - 工具类
- `src/main/resources` - 资源文件
  - `caseData` - 测试数据文件
  - `config.properties` - 配置文件
  - `jdbc.properties` - 数据库连接配置
  - `log4j.properties` - 日志配置
- `src/test/resources` - 测试资源
- `allure-report` - Allure 测试报告
- `allure-results` - Allure 测试结果

## 测试功能示例

### 测试注解使用

```java
public class TestAnnotation {
    @Test
    public void test() {
        // 测试逻辑
    }

    @BeforeMethod
    public void beforeMethodTest() {
        // 方法前操作
    }

    // 其他测试方法...
}
```

### 测试依赖

```java
public class TestDepend {
    @Test(dependsOnMethods = {"test2"})
    public void test() {
        // 依赖 test2 方法执行完成
    }

    @Test
    public void test2() {
        // 被依赖的测试方法
    }
}
```

### 测试分组

```java
public class TestGroups {
    @Test(groups = "login")
    public void testa() {
        // 登录测试
    }

    @Test(groups = "submitOrder")
    public void testb() {
        // 提交订单测试
    }

    @BeforeGroups("submitOrder")
    public void testBeforeGroups() {
        // 提交订单前的准备工作
    }
}
```

## 使用说明

1. 准备测试数据：将测试用例数据放入 Excel 文件中
2. 配置环境：修改 `config.properties` 和 `jdbc.properties` 文件中的配置
3. 编写测试用例：继承 `BaseCase` 类并实现测试逻辑
4. 执行测试：使用 TestNG 运行测试
5. 查看报告：在 `allure-report` 目录查看详细的测试报告

## 依赖库

- TestNG (测试框架)
- Apache POI (Excel 操作)
- JSONPath (JSON 解析)
- HttpClient (HTTP 请求)
- Log4j (日志记录)
- MySQL JDBC (数据库连接)

## 测试报告

项目生成 Allure 测试报告，可以查看详细的测试执行情况，包括：
- 测试执行统计
- 测试用例详情
- 测试步骤跟踪
- 失败原因分析
- 测试趋势统计

## 注意事项

1. 确保测试环境配置正确
2. 测试数据文件需要保持打开状态
3. 数据库操作需要确保 SQL 语句正确
4. 大量测试时注意设置合适的超时时间
5. 使用全局变量时注意变量命名避免冲突

该项目提供了一个完整的 API 测试解决方案，可根据具体需求扩展和修改。