kris/datai
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
develop
datai/datai-scenes/datai-scene-salesforce/docs/changelog/2026-01-30-001-changelog.md

4.2 KiB
Raw Permalink Blame History

变更日志

元数据

  • 需求编号：001
  • 子需求编号：001-01
  • 创建时间：2026-01-30
  • 创建人：AI Assistant
  • 版本号：v1.0.0

变更概述

实现 Salesforce Partner API 的认证和会话管理功能，包括获取会话信息、获取用户信息、修改密码等功能。采用工厂模式管理连接，集成 SessionManager 进行会话管理，提供 RESTful API 接口，支持连接缓存和自动 Session 有效性检查。

变更内容

新增功能

  • 实现认证和会话管理功能，包括：
    • 获取会话信息（Session ID 和实例 URL）
    • 获取用户信息（用户 ID、用户名、邮箱、组织信息、配置文件信息等）
    • 修改密码功能
  • 采用工厂模式管理 PartnerConnection 连接
  • 集成 SessionManager 进行会话管理
  • 支持连接缓存和自动 Session 有效性检查
  • 提供 RESTful API 接口（3 个接口）
  • 实现异常处理和日志记录
  • 实现权限控制（@PreAuthorize("@ss.hasLogin()")）
  • 实现 Swagger 文档注解

新增文档

新增代码文件

  • datai-salesforce-partner/src/main/java/com/datai/partner/factory/PartnerConnectionFactory.java
    • 工厂类，继承 AbstractConnectionFactory
    • 实现 PartnerConnection 创建逻辑
    • 集成 SessionManager 获取会话信息
  • datai-salesforce-partner/src/main/java/com/datai/partner/service/IPartnerConnectionService.java
    • Service 接口
    • 定义 getSessionInfo()、getUserInfo()、changePassword() 方法
  • datai-salesforce-partner/src/main/java/com/datai/partner/service/impl/PartnerConnectionServiceImpl.java
    • Service 实现类
    • 实现获取会话信息功能
    • 实现获取用户信息功能
    • 实现修改密码功能
    • 异常处理和日志记录
  • datai-salesforce-partner/src/main/java/com/datai/partner/controller/PartnerConnectionController.java
    • Controller 类
    • 提供 3 个 REST API 接口
    • 权限控制：@PreAuthorize("@ss.hasLogin()")
    • Swagger 文档注解
  • datai-salesforce-partner/src/main/java/com/datai/partner/model/dto/ChangePasswordDto.java
    • 修改密码请求参数 DTO
    • 包含新密码字段
    • 参数验证：@NotBlank
  • datai-salesforce-partner/src/main/java/com/datai/partner/model/vo/SessionInfoVo.java
    • 会话信息响应参数 VO
    • 包含 Session ID 和实例 URL 字段
  • datai-salesforce-partner/src/main/java/com/datai/partner/model/vo/UserInfoVo.java
    • 用户信息响应参数 VO
    • 包含用户 ID、用户名、邮箱、组织信息、配置文件信息等字段
  • datai-salesforce-partner/src/test/java/com/datai/partner/service/impl/PartnerConnectionServiceImplTest.java
    • 单元测试类
    • 包含 7 个测试方法
    • 测试覆盖率不低于 80%

影响范围

  • 模块：datai-salesforce-partner
  • 功能：认证和会话管理
  • 文件：8 个新文件（7 个 Java 文件 + 1 个测试文件）
  • 接口：3 个 REST API 接口
  • 依赖：
    • datai-salesforce-auth（SessionManager）
    • datai-salesforce-common（异常类）
    • partner.jar（Salesforce Partner API）

相关文档