put

put#

YR.put()#

Warning

调用本章节的接口会触发数据系统客户端初始化，runtime 进程将会额外占用 50MB 内存，在 K8S 上部署时有潜在 OOM 风险。 因此，当使用本章节的接口时，请为使用接口的函数声明一个更大的内存资源规格。

接口说明#

public static <T> ObjectRef put(T obj) throws YRException#

将数据对象存储在数据系统。

ObjectRef<Integer> ref = YR.put(1);

  • 参数：

    • <T> - 入参类型。

    • obj (Object) – 所需要存储的数据对象（不能为未经 List 容器储存的 objectRef）。

  • 返回：

    ObjectRef。该数据在数据系统中的唯一标识 “ id ”，详见 ObjectRef 介绍。

  • 抛出：

    • YRException - 传入 objectRef 需由 List 容器储存，否则抛出该异常。

    • IOException - 储存失败，可能由数据系统断连等引起。

public static <T> ObjectRef put(T obj, CreateParam createParam) throws YRException#

将数据对象存储在数据系统。

CreateParam createParam = new CreateParam();
createParam.setWriteMode(WriteMode.NONE_L2_CACHE);
createParam.setConsistencyType(ConsistencyType.PRAM);
createParam.setCacheType(CacheType.MEMORY);
ObjectRef<Integer> ref = YR.put(1, createParam);

  • 参数：

    • <T> - 入参类型。

    • obj (Object) – 所需要存储的数据对象（不能为未经 List 容器储存的 objectRef）。

    • createParam (CreateParam) - 可选。为对象配置是否需要可靠性等属性。

  • 返回：

    ObjectRef。该数据在数据系统中的唯一标识 “ id ”，详见 ObjectRef 介绍。

  • 抛出：

    • YRException - 传入 objectRef 需由 List 容器储存，否则抛出该异常。

    • IOException - 储存失败，可能由数据系统断连等引起。

CreateParam 类介绍

字段

类型

说明

writeMode

WriteMode

设置数据的可靠性。当服务端配置支持二级缓存时用于保证可靠性时，比如 redis 服务，那么通过这个配置可以保证数据可靠性。默认值为 WriteMode.NONE_L2_CACHE。

consistencyType

ConsistencyType

数据一致性配置。分布式场景可以配置不同级别的一致性语义。可选参数为 YR::ConsistencyType::PRAM（异步）和 YR::ConsistencyType::PRAM（因果一致性）。默认值为 YR::ConsistencyType::PRAM。

cacheType

CacheType

用于标识分配的是内存介质还是磁盘介质。可选参数为 YR::CacheType::Memory（内存介质） 和 YR::CacheType::Disk（磁盘介质）。默认值为 YR::CacheType::Memory。
Contents