第 7 章 设置持久性存储

以声明性方式或以编程方式在链中添加缓存存储到 Data Grid 缓存。缓存读取操作会按照配置的顺序检查每个缓存存储，直到它们找到有效的非null 元素。写入操作会影响所有缓存存储，但您配置为只读的缓存存储除外。

<persistence passivation="false">
   <!-- note that class is missing and is induced by the fileStore element name -->
   <file-store
           shared="false" preload="true"
           fetch-state="true"
           read-only="false"
           purge="true"
           path="${java.io.tmpdir}">
      <write-behind modification-queue-size="123" />
   </file-store>
</persistence>

<local-cache name="myCustomStore">
   <persistence passivation="false">
      <store
         class="org.acme.CustomStore"
         fetch-state="false" preload="true" shared="false"
         purge="true" read-only="false" segmented="true">

         <write-behind modification-queue-size="123" />

         <property name="myProp">${system.property}</property>
      </store>
   </persistence>
</local-cache>

ConfigurationBuilder builder = new ConfigurationBuilder();
builder.persistence()
      .passivation(false)
      .addSingleFileStore()
         .preload(true)
         .shared(false)
         .fetchPersistentState(true)
         .ignoreModifications(false)
         .purgeOnStartup(true)
         .location(System.getProperty("java.io.tmpdir"))
         .async()
            .enabled(true)

Data Grid 使用全局文件系统位置将数据保存到持久性存储。

Data Grid 服务器使用 $RHDG_HOME/server/data 目录作为全局持久位置。

如果您使用 Data Grid 作为嵌入在自定义应用程序中的库，并且启用了 global-state，则全局持久位置默认为 user.dir 系统属性。此系统属性通常使用应用程序启动的目录。您应该将全局持久位置配置为使用合适的位置。

<cache-container default-cache="myCache">
   <global-state>
      <persistent-location path="example" relative-to="my.data"/>
   </global-state>
   ...
</cache-container>

new GlobalConfigurationBuilder().globalState().enable().persistentLocation("example", "my.data");

例如，您要配置全局持久位置，如下所示：

<global-state>
   <persistent-location path="/tmp/example" relative-to="my.data"/>
</global-state>

然后，配置使用名为 myDataStore 的单个文件缓存存储，如下所示：

<file-store path="myDataStore"/>

在这种情况下，配置会在 /tmp/example/myDataStore/myCache.dat中生成单一文件缓存存储

如果您试图设置位于全局持久位置外的绝对路径，并且启用了 global-state，Data Grid 会抛出以下异常：

ISPN000558: "The store location 'foo' is not a child of the global persistent location 'bar'"

传递配置 Data Grid，在从内存中驱除这些条目时写入条目以缓存存储。这样，传递可确保只维护一个条目的副本，可以是内存中或缓存存储中，这可以防止不必要的且可能昂贵的写入持久性存储。

当尝试访问传递的条目时，激活是从缓存存储中恢复内存的过程。因此，当启用 passivation 时，您必须配置实现 CacheWriter 和 CacheLoader 接口的缓存存储，以便可以从持久性存储写入和加载条目。

当 Data Grid 从缓存中驱除条目时，它会通知缓存监听程序被传递该条目，然后将条目存储在缓存存储中。当 Data Grid 获取被驱除条目的访问请求时，它会从缓存存储加载条目到内存中，然后通知缓存监听程序已激活该条目。

只有基于 JDBC 字符串的缓存存储支持事务操作。如果将缓存配置为事务性，您应该设置 transactional=true，以便使数据存储在持久性存储中与内存中的数据同步。

对于所有其他缓存存储，Data Grid 不对事务操作中的缓存加载程序进行编码。如果事务在在内存中修改数据时成功修改数据，但不会完全应用缓存存储中的数据更改，这可能会导致数据不一致。在这种情况下，手动恢复无法使用缓存存储。

缓存存储可以将数据组织到哪些键映射到的散列空间片段中。

分段存储提高了批量操作的读取性能；例如，流传输数据(Cache.size、Cache.entrySet.stream)、预加载缓存和执行状态传输操作。

但是，分段存储也可以丢失写操作的性能。此性能丢失适用于可以使用事务或写成存储进行批量写入操作。因此，您应该在启用分段存储前评估写操作的开销。如果写入操作的性能丢失了大量性能，则批量读取操作的性能可能无法接受。

在大多数情况下，基于文件系统的缓存存储适用于本地缓存存储，用于内存溢出的数据，因为它超过大小和/或时间限制。

直写是一个缓存写入模式，写入内存和写入缓存存储是同步的。当客户端应用程序更新缓存条目时，在大多数情况下，Data Grid 不会返回调用，直到它更新缓存存储为止。这个缓存写入模式会导致对缓存存储更新会在客户端线程的界限内进行。

Write-Through 模式的主要优点是，缓存和缓存存储同时更新，这样可确保缓存存储始终与缓存一致。

但是，Write-Through 模式可能会降低性能，因为需要访问和更新缓存存储会直接为缓存操作添加延迟。

Data Grid 默认为 Write-Through 模式，除非您在缓存存储上明确配置 Write-Behind 模式。

<persistence passivation="false">
   <file-store fetch-state="true"
               read-only="false"
               purge="false" path="${java.io.tmpdir}"/>
</persistence>

write-Behind 是一个缓存写入模式，其中写入内存是同步的，写入缓存存储是异步的。

当客户端发送写入请求时，Data Grid 会将这些操作添加到修改队列中。在数据网格加入队列时处理操作，以便调用线程不会被阻止，操作会立即完成。

如果修改队列中的写入操作数量超过队列的大小，则数据网格会将这些额外的操作添加到队列中。但是，这些操作不会完成，直到已在队列中的 Data Grid 进程操作为止。

例如，调用 Cache.putAsync 立即返回，如果修改队列未满，则 Stage 也会立即完成。如果修改队列已满，或者 Data Grid 当前正在处理批处理写操作，则 Cache.putAsync 会立即返回，并且 Stage 稍后完成。

write-Behind 模式提供与 Write-Through 模式相比的性能优势，因为缓存操作不需要等待更新底层缓存存储完成。但是，在处理修改队列前，缓存存储中的数据与缓存中的数据不一致。因此，Write-Behind 模式适合具有低延迟的缓存存储，如不共享和本地基于文件系统的缓存存储，其中写入缓存和写入缓存存储之间的时间尽可能小。

<persistence passivation="false">
   <file-store fetch-state="true"
               read-only="false"
               purge="false" path="${java.io.tmpdir}">
   <write-behind modification-queue-size="123"
                 fail-silently="true"/>
   </file-store>
</persistence>

前面的配置示例使用 fail-silently 参数来控制缓存存储不可用时或修改队列已满时发生的情况。