compliance/ppt.md

BaseAPITestCase 核心方法能力一览

1. 生命周期钩子方法（可重写）

方法名	能力描述
__init__	初始化测试用例，加载接口 schema、参数、上下文等
generate_path_params	生成/修改路径参数（如 /user/{id} 中的 id），支持动态构造
generate_query_params	生成/修改 query 参数，支持边界值、缺失、类型异常等场景
generate_headers	生成/修改请求头，支持鉴权、格式异常等测试
generate_request_body	生成/修改请求体，支持字段缺失、类型不符等复杂场景
modify_request_url	动态修改请求 URL，适用于特殊路径拼接等需求
validate_request_url	请求发送前校验 URL 合规性
validate_request_headers	请求发送前校验头部数据
validate_request_body	请求发送前校验请求体
validate_response	响应校验，断言状态码、响应体、业务逻辑等
check_performance	性能校验，检查响应耗时等

2. 辅助工具方法（极大简化用例开发）

方法名	能力描述
_get_resolved_request_body_schema	获取并解析当前接口的请求体 schema，自动处理 $ref
_find_removable_field_path	查找可被移除的必填字段路径，便于生成“缺失字段”场景
_remove_value_at_path	按路径从数据中移除指定字段，支持嵌套结构
_find_simple_type_field_in_schema	查找 schema 中第一个简单类型字段，便于类型异常测试
_find_first_simple_type_parameter	查找第一个简单类型的参数（如 query/header），便于参数异常测试
_find_required_parameter_name	查找第一个必填参数名
expect_error_response	标准化校验错误响应（状态码、错误码等），减少样板代码
validate_data_against_schema	用 schema 校验任意数据结构，便于响应体合规性断言
passed / failed	快速生成验证结果对象，便于断言输出

3. 日志与上下文

方法名/属性	能力描述
self.logger	统一日志输出，便于调试与结果追踪
self.endpoint_spec	当前接口的详细规范，已处理 $ref
self.global_api_spec	全局 API 规范，便于跨接口引用

---

说明：

• 生命周期钩子方法由框架自动调用，用户可按需重写，实现灵活的请求构造与验证。
• 辅助工具方法极大简化了 schema 处理、字段查找、数据操作等底层细节，让用例开发者专注于业务逻辑。
• 通过这些方法，测试用例可轻松实现“字段缺失、类型异常、参数边界、响应断言、性能校验”等多种自动化测试能力。