Kris
2e6f087732
- 完成REQ-010-17（性能优化和限流处理）的所有6个阶段 - 创建ADR文档：0026-performance-optimization.md - 创建Prompt文档：027-performance-optimization.md - 创建会话记录：20260119-performance-optimization.md - 创建变更记录：20260119-performance-optimization.md - 创建复盘报告：20260119-performance-optimization-retro.md - 更新index.md和CHANGELOG.md - 完成REQ-010-2（基础实体类和Mapper创建）的前3个阶段 - 更新ADR文档：0011-entity-mapper-create.md - 创建Prompt文档：002-entity-mapper-create.md - 更新index.md 所有文档均按照SSOT方法论创建，包括需求定义、架构决策、提示词资产化、执行会话、变更记录和闭环复盘。
4.1 KiB
4.1 KiB
com.sforce.soap.apex 模块说明
概述
com.sforce.soap.apex 模块是 Salesforce Apex SOAP API 的 Java 客户端实现，提供了与 Salesforce Apex 相关功能的 SOAP 接口交互能力。
主要功能
1. Apex 代码编译和执行
- CompileClasses: 编译 Apex 类
- CompileTriggers: 编译 Apex 触发器
- CompileAndTest: 编译并运行测试
- ExecuteAnonymous: 执行匿名 Apex 代码
2. 测试执行
- RunTests: 运行 Apex 测试
- RunTestsRequest: 测试请求参数
- RunTestsResult: 测试执行结果
- RunTestSuccess: 测试成功结果
- RunTestFailure: 测试失败结果
3. 代码覆盖率
- CodeCoverageResult: 代码覆盖率结果
- CodeCoverageWarning: 代码覆盖率警告
- CodeLocation: 代码位置信息
4. Flow 覆盖率
- FlowCoverageResult: Flow 覆盖率结果
- FlowCoverageWarning: Flow 覆盖率警告
5. 日志记录
- LogInfo: 日志信息
- LogType: 日志类型
- LogCategory: 日志分类
- LogCategoryLevel: 日志级别
6. WSDL 转换
- WsdlToApexInfo: WSDL 到 Apex 转换信息
- WsdlToApexResult: WSDL 转换结果
核心类
SoapConnection
作用: Apex SOAP API 的连接类，负责建立和管理与 Salesforce 的 SOAP 连接。
主要功能:
- 管理连接配置
- 处理 SOAP 头信息
- 执行 API 调用
使用示例:
SoapConnection connection = new SoapConnection();
connection.setSessionHeader(sessionId);
connection.setCallOptions("MyClient");
RunTestsRequest
作用: 定义运行 Apex 测试的请求参数。
主要属性:
allTests: 是否运行所有测试runTests: 指定要运行的测试类
使用示例:
RunTestsRequest request = new RunTestsRequest();
request.setAllTests(true);
RunTestsResult result = connection.runTests(request);
ExecuteAnonymousResult
作用: 执行匿名 Apex 代码的结果。
主要属性:
success: 是否执行成功compileProblem: 编译问题exceptionMessage: 异常消息exceptionStackTrace: 异常堆栈
使用示例:
ExecuteAnonymousResult result = connection.executeAnonymous(
"System.debug('Hello World');"
);
使用场景
1. CI/CD 集成
在持续集成/持续部署流程中：
- 编译 Apex 代码
- 运行单元测试
- 检查代码覆盖率
- 验证测试结果
2. 代码质量检查
- 检查代码覆盖率是否达到要求
- 识别未测试的代码路径
- 生成测试报告
3. 动态代码执行
- 执行匿名 Apex 代码进行调试
- 运行临时脚本
- 执行管理任务
4. Flow 测试
- 测试 Flow 的执行
- 检查 Flow 覆盖率
- 验证 Flow 逻辑
注意事项
- 权限要求: 需要适当的 API 权限才能使用这些功能
- 限制: 有 API 调用次数和执行时间限制
- 错误处理: 需要正确处理编译错误和运行时错误
- 异步操作: 某些操作是异步的，需要检查结果状态
- 版本兼容性: 不同版本的 Salesforce 可能有不同的 API 行为
相关文档
文件列表
- SoapConnection.java - SOAP 连接类
- RunTestsRequest.java - 测试请求类
- RunTestsResult.java - 测试结果类
- ExecuteAnonymousResult.java - 匿名执行结果类
- CodeCoverageResult.java - 代码覆盖率结果类
- FlowCoverageResult.java - Flow 覆盖率结果类
- LogInfo.java - 日志信息类
- CompileClassResult.java - 类编译结果类
- CompileTriggerResult.java - 触发器编译结果类
- DeleteApexResult.java - Apex 删除结果类