接口interface io.agentscope.builder.web.persistence.jpa 2.x

CoordLeaseEntityRepository

public interface CoordLeaseEntityRepository extends JpaRepository<CoordLeaseEntity, Long>

源码Source io/agentscope/builder/web/persistence/jpa/CoordLeaseEntityRepository.java:27–59

定义 Coord Lease Entity 仓库契约的接口。位于 io.agentscope.builder.web.persistence.jpa 包，实现 JpaRepository<CoordLeaseEntity, Long>。核心成员包括 findByLeaseKindAndLeaseKey、findByKindAndKeyForUpdate、heartbeatIfOwned、findByLeaseKindAndExpiresAtLessThan、findByLeaseKindAndLeaseKeyStartingWithOrderByAcquiredAtAsc、deleteByKindKeyAndInstance。

An interface in io.agentscope.builder.web.persistence.jpa that defines the contract for components that persists and restores session and memory data across calls. Declared in io.agentscope.builder.web.persistence.jpa. Implements JpaRepository.

方法摘要Method Summary

方法Method	说明Description
`public Optional<CoordLeaseEntity> findByLeaseKindAndLeaseKey(String leaseKind, String leaseKey)`	查找 `findByLeaseKindAndLeaseKey`。 Finds the by lease kind and lease key.
`public Optional<CoordLeaseEntity> findByKindAndKeyForUpdate(String kind, String key)`	查找通过种类和键用于更新。 Finds the by kind and key for update.
`public int heartbeatIfOwned(String kind, String key, String instanceId, long expiresAt)`	执行 `heartbeatIfOwned` 方法。 Performs the heartbeat if owned operation.
`public List<CoordLeaseEntity> findByLeaseKindAndExpiresAtLessThan(String leaseKind, long expiresAt)`	查找 `findByLeaseKindAndExpiresAtLessThan`。 Finds the by lease kind and expires at less than.
`public List<CoordLeaseEntity> findByLeaseKindAndLeaseKeyStartingWithOrderByAcquiredAtAsc(String leaseKind, String leaseKeyPrefix)`	查找 `findByLeaseKindAndLeaseKeyStartingWithOrderByAcquiredAtAsc`。 Finds the by lease kind and lease key starting with order by acquired at asc.
`public int deleteByKindKeyAndInstance(String kind, String key, String instanceId)`	删除通过种类键和实例。 Deletes the by kind key and instance.

方法详情Method Detail

findByLeaseKindAndLeaseKey

public Optional<CoordLeaseEntity> findByLeaseKindAndLeaseKey(String leaseKind, String leaseKey)

查找 findByLeaseKindAndLeaseKey。

Finds the by lease kind and lease key.

参数Parameters

名称Name	类型Type	说明Description
`leaseKind`	String	lease 种类（类型 `String`）。The lease kind.
`leaseKey`	String	lease 键（类型 `String`）。The lease key.

返回Returns Optional<CoordLeaseEntity>

返回可选。Returns optional.

源码Source io/agentscope/builder/web/persistence/jpa/CoordLeaseEntityRepository.java:29

findByKindAndKeyForUpdate

public Optional<CoordLeaseEntity> findByKindAndKeyForUpdate(String kind, String key)

查找通过种类和键用于更新。

Finds the by kind and key for update.

参数Parameters

名称Name	类型Type	说明Description
`kind`	String	种类（类型 `String`）。The kind.
`key`	String	键（类型 `String`）。The key.

返回Returns Optional<CoordLeaseEntity>

返回可选。Returns optional.

源码Source io/agentscope/builder/web/persistence/jpa/CoordLeaseEntityRepository.java:31–34

heartbeatIfOwned

public int heartbeatIfOwned(String kind, String key, String instanceId, long expiresAt)

执行 heartbeatIfOwned 方法。

Performs the heartbeat if owned operation.

参数Parameters

名称Name	类型Type	说明Description
`kind`	String	种类（类型 `String`）。The kind.
`key`	String	键（类型 `String`）。The key.
`instanceId`	String	实例标识（类型 `String`）。The instance id.
`expiresAt`	long	过期 At（类型 `long`）。The expires at.

返回Returns int

返回数值结果。Returns a numeric result.

源码Source io/agentscope/builder/web/persistence/jpa/CoordLeaseEntityRepository.java:36–44

findByLeaseKindAndExpiresAtLessThan

public List<CoordLeaseEntity> findByLeaseKindAndExpiresAtLessThan(String leaseKind, long expiresAt)

查找 findByLeaseKindAndExpiresAtLessThan。

Finds the by lease kind and expires at less than.

参数Parameters

名称Name	类型Type	说明Description
`leaseKind`	String	lease 种类（类型 `String`）。The lease kind.
`expiresAt`	long	过期 At（类型 `long`）。The expires at.

返回Returns List<CoordLeaseEntity>

返回列出。Returns list.

源码Source io/agentscope/builder/web/persistence/jpa/CoordLeaseEntityRepository.java:46

findByLeaseKindAndLeaseKeyStartingWithOrderByAcquiredAtAsc

public List<CoordLeaseEntity> findByLeaseKindAndLeaseKeyStartingWithOrderByAcquiredAtAsc(String leaseKind, String leaseKeyPrefix)

查找 findByLeaseKindAndLeaseKeyStartingWithOrderByAcquiredAtAsc。

Finds the by lease kind and lease key starting with order by acquired at asc.

参数Parameters

名称Name	类型Type	说明Description
`leaseKind`	String	lease 种类（类型 `String`）。The lease kind.
`leaseKeyPrefix`	String	lease 键 Prefix（类型 `String`）。The lease key prefix.

返回Returns List<CoordLeaseEntity>

返回列出。Returns list.

源码Source io/agentscope/builder/web/persistence/jpa/CoordLeaseEntityRepository.java:48–49

deleteByKindKeyAndInstance

public int deleteByKindKeyAndInstance(String kind, String key, String instanceId)

删除通过种类键和实例。

Deletes the by kind key and instance.

参数Parameters

名称Name	类型Type	说明Description
`kind`	String	种类（类型 `String`）。The kind.
`key`	String	键（类型 `String`）。The key.
`instanceId`	String	实例标识（类型 `String`）。The instance id.

返回Returns int

返回数值结果。Returns a numeric result.

源码Source io/agentscope/builder/web/persistence/jpa/CoordLeaseEntityRepository.java:51–58