AS AgentScopeAPI 手册 / API Reference

InMemoryStore

public class InMemoryStore implements BaseStore
源码Source io/agentscope/harness/agent/filesystem/remote/store/InMemoryStore.java:34–121

In 记忆存储,负责持久化与读取数据。位于 io.agentscope.harness.agent.filesystem.remote.store 包,实现 BaseStore。核心成员包括 get、put、putIfVersion、search、delete、size。

Thread-safe in-memory implementation of BaseStore.

Items are stored in a ConcurrentHashMap keyed by the concatenation of namespace components and the item key, separated by '\0'.

Every successful #put and #putIfVersion increments the item's StoreItem#version() counter, enabling optimistic concurrency control.

方法摘要Method Summary

方法Method说明Description
public StoreItem get(List<String> namespace, String key)
按条件读取数据。
Performs the get operation.
public void put(List<String> namespace, String key, Map<String, Object> value)
执行 `put` 方法。
Performs the put operation.
public boolean putIfVersion(List<String> namespace, String key, Map<String, Object> value, long expectedVersion)
执行 `putIfVersion` 方法。
Atomic compare-and-swap: updates the item only when the stored version equals `expectedVersion`.
public List<StoreItem> search(List<String> namespace, int limit, int offset)
执行搜索相关操作。
Performs the search operation.
public void delete(List<String> namespace, String key)
删除数据。
Performs the delete operation.
public int size()
返回大小。
Returns the number of items currently stored.
public void clear()
清空或重置内部状态。
Removes all items from the store.

方法详情Method Detail

get

public StoreItem get(List<String> namespace, String key)

按条件读取数据。

Performs the get operation.

参数Parameters
名称Name类型Type说明Description
namespaceList<String>命名空间(类型 `List`)。The namespace.
keyString键(类型 `String`)。The key.
返回Returns StoreItem
返回StoreItem。Returns store item.
源码Source io/agentscope/harness/agent/filesystem/remote/store/InMemoryStore.java:38–41

put

public void put(List<String> namespace, String key, Map<String, Object> value)

执行 put 方法。

Performs the put operation.

参数Parameters
名称Name类型Type说明Description
namespaceList<String>命名空间(类型 `List`)。The namespace.
keyString键(类型 `String`)。The key.
valueMap<String, Object>值(类型 `Map`)。The value.
源码Source io/agentscope/harness/agent/filesystem/remote/store/InMemoryStore.java:43–52

putIfVersion

public boolean putIfVersion(List<String> namespace, String key, Map<String, Object> value, long expectedVersion)

执行 putIfVersion 方法。

Atomic compare-and-swap: updates the item only when the stored version equals expectedVersion.

参数Parameters
名称Name类型Type说明Description
namespaceList<String>命名空间(类型 `List`)。The namespace.
keyString键(类型 `String`)。The key.
valueMap<String, Object>值(类型 `Map`)。The value.
expectedVersionlongexpected 版本(类型 `long`)。The expected version.
返回Returns boolean
返回布尔值,表示判断结果。`true` if the item was written, `false` if the version did not match
源码Source io/agentscope/harness/agent/filesystem/remote/store/InMemoryStore.java:61–77

delete

public void delete(List<String> namespace, String key)

删除数据。

Performs the delete operation.

参数Parameters
名称Name类型Type说明Description
namespaceList<String>命名空间(类型 `List`)。The namespace.
keyString键(类型 `String`)。The key.
源码Source io/agentscope/harness/agent/filesystem/remote/store/InMemoryStore.java:95–98

size

public int size()

返回大小。

Returns the number of items currently stored.

返回Returns int
返回数值结果。Returns a numeric result.
源码Source io/agentscope/harness/agent/filesystem/remote/store/InMemoryStore.java:101–103

clear

public void clear()

清空或重置内部状态。

Removes all items from the store.

源码Source io/agentscope/harness/agent/filesystem/remote/store/InMemoryStore.java:106–108
基于官方固定版本源码静态生成Generated from pinned official sources · Python 2.0.11 · Java 2.0.4
签名与文档为静态抽取;如有疑问请以源码为准。Signatures and docs are extracted statically; verify against the source when in doubt.