第 5 章 将应用程序迁移到 Data Grid 8

默认情况下，Data Grid 8 使用 ProtoStream API 将所有数据作为协议缓冲区（一种语言中立且向后兼容的格式）。

protobuf 编码是一种模式定义格式，现在是许多应用程序的默认标准，与 JBoss Marshalling 相比，转码数据时具有更大的灵活性，这是 Data Grid 7 中的默认设置。

因为 ProtoStream marshaller 基于 Protobuf 格式，所以数据网格可以在不先转换为 Java 对象的情况下转换为其他编码。使用 JBoss Marshalling 时，需要在转换为任何其他格式前将键和值转换为 Java 对象。

作为迁移到 Data Grid 8 的一部分，您应该为您的 Java 类使用 ProtoStream marshalling。

在高级别中，要使用 ProtoStream marshaller，您可以使用 ProtoStream 处理器生成 SerializationContextInitializer 实现。首先，您可以在 Java 类中添加 @Proto 注解，然后使用 Data Grid 提供的 ProtoStream 处理器来生成包含以下内容的序列化上下文：

根据您使用的嵌入式还是远程缓存，Data Grid 可以自动注册 SerializationContextInitializer 实现。

嵌套 ProtoStream 注解

Data Grid 8.2 升级到 ProtoStream 4.4.0.Final，这在某些情况下需要迁移。

在以前的版本中，ProtoStream API 没有正确地嵌套消息类型，从而导致消息只生成顶层。

如果您在持久缓存存储中有 Protobuf 编码的条目，您应该修改 Java 类，以便 ProtoStream 注解位于顶级。这样可确保您的持久消息嵌套与 Java 类中的嵌套匹配，否则可能会出现数据不兼容的问题。

例如，如果您有嵌套的 Java 类，如下所示：

class OuterClass {
   class InnerClass {
       @ProtoField(1)
       int someMethod() {
       }
   }
}

您应该调整类，以便 InnerClass 不再是 OuterClass 的子级：

class InnerClass {
    @ProtoField(1)
    int someMethod() {
    }
}

Data Grid Server 的 Marshalling

您应该只对远程缓存使用 Protobuf 编码，并将 ProtoStream marshaller 用于任何自定义类型。

其他 marshaller 实现（如 JBoss marshalling）需要您使用与 Data Grid CLI、Data Grid Console 或 Ickle 查询不兼容的不同缓存编码。

缓存存储和 ProtoStream

在 Data Grid 7.x 中，您保留至缓存存储的数据与 Data Grid 8 中的 ProtoStream marshaller 不兼容。您必须使用 StoreMigrator 工具将数据从任何 Data Grid 7.x 缓存存储迁移到 Data Grid 8 缓存存储。

Data Grid 提供替代的 marshaller 实现，到 ProtoStream 有助于简化从旧版本进行迁移。在迁移到 ProtoStream marshalling 时，您应该只使用这些替代的 marshallers 作为中间解决方案。

deserialization Allow List

红帽承诺使用包含的语言，术语"white list"已更改为"允许列表"，用于配置 Java 类的序列化。

<cache-container>
   <serialization>
      <white-list>
         <class>org.infinispan.test.data.Person</class>
         <regex>org.infinispan.test.data.*</regex>
       </white-list>
   </serialization>
</cache-container>

<cache-container>
   <serialization>
      <allow-list>
         <class>org.infinispan.test.data.Person</class>
         <regex>org.infinispan.test.data.*</regex>
       </allow-list>
   </serialization>
</cache-container>

JBoss marshalling

在 Data Grid 7 中，JBoss Marshalling 是默认的 marshaller。在 Data Grid 8 中，ProtoStream marshalling 是默认值。

如果需要在迁移到 Data Grid 8 的过程中使用 JBoss Marshalling 作为临时解决方案，请执行以下操作：

您必须将 Hot Rod Java 客户端配置为使用 JBoss Marshalling，如下所示：