JpaUserStore
@Transactional public class JpaUserStore implements UserStoreio/agentscope/builder/web/persistence/jpa/JpaUserStore.java:43–186JPA 用户存储，负责持久化与读取数据。位于 io.agentscope.builder.web.persistence.jpa 包，实现 UserStore。核心成员包括 passwordEncoder、findById、findByUsername、listAll、createUser、verifyPassword。
JPA-backed UserStore. This is the only UserStore implementation shipped with
the builder; it is always wired in by JpaPersistenceConfig.
On first start, if the builder_user table is empty, a default admin/admin
user is seeded so an operator can sign in immediately after pointing the builder at a fresh
database. The seeded password is logged with a "change immediately" warning, matching the
file-mode behavior.
Wired through io.agentscope.builder.web.persistence.jpa.JpaPersistenceConfig;
declared as a plain @Service-flavored Spring bean (annotated via the configuration
class rather than @Component so the JPA backend stays inert when the configuration
does not load).
构造器摘要Constructor Summary
| 构造器Constructor | 说明Description |
|---|---|
public JpaUserStore(UserEntityRepository repository) | 初始化 `JpaUserStore` 实例。 Creates a new instance. |
public JpaUserStore(UserEntityRepository repository, boolean seedUsers) | 初始化 `JpaUserStore` 实例。 Creates a new instance. |
方法摘要Method Summary
| 方法Method | 说明Description |
|---|---|
public PasswordEncoder passwordEncoder() | 返回 `passwordEncoder` 结果。 Returns the password encoder. |
public Optional<UserRecord> findById(String userId) | 查找通过标识。 Finds the by id. |
public Optional<UserRecord> findByUsername(String username) | 查找 `findByUsername`。 Finds the by username. |
public List<UserRecord> listAll() | 列出所有。 Lists the all. |
public UserRecord createUser(String userId, String username, String password, List<String> roles) | 创建用户。 Creates the user. |
public boolean verifyPassword(UserRecord user, String rawPassword) | 执行 `verifyPassword` 方法。 Performs the verify password operation. |
public Optional<UserRecord> updatePassword(String userId, String newPassword) | 更新密码。 Updates the password. |
public Optional<UserRecord> updateRoles(String userId, List<String> newRoles) | 更新 `updateRoles`。 Updates the roles. |
public boolean deleteUser(String userId) | 删除用户。 Deletes the user. |
构造器详情Constructor Detail
JpaUserStore
public JpaUserStore(UserEntityRepository repository)初始化 JpaUserStore 实例。
Creates a new instance.
| 名称Name | 类型Type | 说明Description |
|---|---|---|
repository | UserEntityRepository | 仓库（类型 `UserEntityRepository`）。The repository. |
io/agentscope/builder/web/persistence/jpa/JpaUserStore.java:52–54JpaUserStore
public JpaUserStore(UserEntityRepository repository, boolean seedUsers)初始化 JpaUserStore 实例。
Creates a new instance.
| 名称Name | 类型Type | 说明Description |
|---|---|---|
repository | UserEntityRepository | 仓库（类型 `UserEntityRepository`）。The repository. |
seedUsers | boolean | 预置用户（类型 `boolean`）。The seed users. |
io/agentscope/builder/web/persistence/jpa/JpaUserStore.java:56–59方法详情Method Detail
passwordEncoder
public PasswordEncoder passwordEncoder()返回 passwordEncoder 结果。
Returns the password encoder.
PasswordEncoderio/agentscope/builder/web/persistence/jpa/JpaUserStore.java:79–82findById
public Optional<UserRecord> findById(String userId)查找通过标识。
Finds the by id.
| 名称Name | 类型Type | 说明Description |
|---|---|---|
userId | String | 用户标识（类型 `String`）。The user id. |
Optional<UserRecord>io/agentscope/builder/web/persistence/jpa/JpaUserStore.java:84–88findByUsername
public Optional<UserRecord> findByUsername(String username)查找 findByUsername。
Finds the by username.
| 名称Name | 类型Type | 说明Description |
|---|---|---|
username | String | username（类型 `String`）。The username. |
Optional<UserRecord>io/agentscope/builder/web/persistence/jpa/JpaUserStore.java:90–95listAll
public List<UserRecord> listAll()列出所有。
Lists the all.
List<UserRecord>io/agentscope/builder/web/persistence/jpa/JpaUserStore.java:97–101createUser
public UserRecord createUser(String userId, String username, String password, List<String> roles)创建用户。
Creates the user.
| 名称Name | 类型Type | 说明Description |
|---|---|---|
userId | String | 用户标识（类型 `String`）。The user id. |
username | String | username（类型 `String`）。The username. |
password | String | 密码（类型 `String`）。The password. |
roles | List<String> | roles（类型 `List`）。The roles. |
UserRecordio/agentscope/builder/web/persistence/jpa/JpaUserStore.java:103–118verifyPassword
public boolean verifyPassword(UserRecord user, String rawPassword)执行 verifyPassword 方法。
Performs the verify password operation.
| 名称Name | 类型Type | 说明Description |
|---|---|---|
user | UserRecord | 用户（类型 `UserRecord`）。The user. |
rawPassword | String | 原始密码（类型 `String`）。The raw password. |
booleanio/agentscope/builder/web/persistence/jpa/JpaUserStore.java:120–123updatePassword
public Optional<UserRecord> updatePassword(String userId, String newPassword)更新密码。
Updates the password.
| 名称Name | 类型Type | 说明Description |
|---|---|---|
userId | String | 用户标识（类型 `String`）。The user id. |
newPassword | String | 新建密码（类型 `String`）。The new password. |
Optional<UserRecord>io/agentscope/builder/web/persistence/jpa/JpaUserStore.java:125–136updateRoles
public Optional<UserRecord> updateRoles(String userId, List<String> newRoles)更新 updateRoles。
Updates the roles.
| 名称Name | 类型Type | 说明Description |
|---|---|---|
userId | String | 用户标识（类型 `String`）。The user id. |
newRoles | List<String> | 新建 Roles（类型 `List`）。The new roles. |
Optional<UserRecord>io/agentscope/builder/web/persistence/jpa/JpaUserStore.java:138–147deleteUser
public boolean deleteUser(String userId)删除用户。
Deletes the user.
| 名称Name | 类型Type | 说明Description |
|---|---|---|
userId | String | 用户标识（类型 `String`）。The user id. |
booleanio/agentscope/builder/web/persistence/jpa/JpaUserStore.java:149–162