Spring Data for Apache Cassandra 3.0 在从早期版本升级时引入了一组重大更改。Spring中文文档

查看依赖项

升级到 Spring Data Cassandra 需要升级到 DataStax 驱动程序版本 4。升级到新驱动程序会带来传递依赖项更改，最值得注意的是，Google Guava 被驱动程序捆绑和着色。 有关驱动程序相关更改的详细信息，请查看 DataStax Java Driver for Apache Cassandra 4 升级指南。Spring中文文档

调整配置

DataStax Java Driver 4 将对象合并为一个对象，因此删除了所有与 API 相关的 API。 通过删除大多数移动到的配置项（主要是基于文件的配置项），对配置进行了大量修改。 这意味着 ，现在通过其他方式配置了更多选项。ClusterSessionCqlSessionClusterDriverConfigLoaderSocketOptionsAddressTranslatorSpring中文文档

如果使用的是基于 XML 的配置，请确保将所有配置文件从命名空间 （） 迁移到命名空间 （）。cqlwww.springframework.org/schema/cql www.springframework.org/schema/cql/spring-cql.xsdcassandrawww.springframework.org/schema/data/cassandra www.springframework.org/schema/data/cassandra/spring-cassandra.xsdSpring中文文档

为了反映配置构建器中的更改，已重命名为 accept now，而不是 . 请确保在配置中提供本地数据中心，因为这是正确配置负载平衡所必需的。ClusterBuilderConfigurerSessionBuilderConfigurerCqlSessionBuilderCluster.BuilderSpring中文文档

连接

（） 和 （） 的配置元素合并为一个 （） 元素，用于配置键空间和端点。Clustercassandra:clusterSessioncassandra:sessionCqlSessioncassandra:sessionSpring中文文档

升级后，模式支持已移至新的命名空间元素：该元素提供 Bean。cassandra:session-factorySessionFactorySpring中文文档

例 1.版本 2 中的集群、会话和架构配置：
<cassandra:cluster contact-points="localhost" port="9042">
  <cassandra:keyspace action="CREATE_DROP" name="mykeyspace" />
</cassandra:cluster>

<cassandra:session keyspace-name="mykeyspace" schema-action="CREATE">
  <cassandra:startup-cql>CREATE TABLE …</cassandra:startup-cql>
</cassandra:session>
例 2.版本 3 中的会话和架构配置：
<cassandra:session contact-points="localhost" port="9042" keyspace="mykeyspace" local-datacenter="datacenter1">
  <cassandra:keyspace action="CREATE_DROP" name="mykeyspace" />
</cassandra:session>

<cassandra:session-factory schema-action="CREATE">
  <cassandra:script location="classpath:/schema.cql"/>
</cassandra:session-factory>
Spring Data Cassandra 3.0 在使用 XML 命名空间配置时不再注册默认的 Mapping Context、Context 和 Template API bean。 默认值应应用于应用程序或 Spring Boot 级别。
Spring Data Cassandra 3.0 在使用 XML 命名空间配置时不再注册默认的 Mapping Context、Context 和 Template API bean。 默认值应应用于应用程序或 Spring Boot 级别。

模板 API

Spring Data for Apache Cassandra 封装了驱动程序升级带来的大多数更改，如果您的应用程序主要与映射实体或原始 Java 类型交互，则提供模板 API 和存储库支持。Spring中文文档

我们通常建议使用创建对象，因为出厂用法允许同步创建架构，并在使用多个数据库时引入一定程度的灵活性。CqlTemplateCassandraTemplateSessionFactorySpring中文文档

例 3.版本 2 中的模板 API 配置：
<cql:template session-ref="…" />

<cassandra:template session-ref="…" cassandra-converter-ref="…"/>
例 4.版本 3 中的模板 API 配置：
<cassandra:session-factory />

<cassandra:cql-template session-factory-ref="…" />

<cassandra:template session-factory-ref="…" cassandra-converter-ref="…"/>

您必须在直接使用 DataStax 驱动程序 API 的所有地方调整您的代码。 典型案例包括：Spring中文文档

变化AsyncCqlTemplate

DataStax 驱动程序 4 更改了异步运行的查询的结果类型。 为了反映这些更改，您需要调整提供以下功能的代码：Spring中文文档

结果集提取需要 DataStax 的新接口。 现在在以前使用的地方使用。 请注意，它返回一个而不是标量对象，因此代码的迁移可以在提取器中使用完全非阻塞的代码。AsyncResultSetAsyncCqlTemplateAsyncResultSetExtractorResultSetExtractorAsyncResultSetExtractor.extractData(…)FutureSpring中文文档

数据模型迁移

如果使用以下功能，则数据模型可能需要更新：Spring中文文档

@CassandraType

DataStax 驱动程序 4 不再附带用于描述 Cassandra 类型的枚举。 我们决定使用 重新引入枚举。 请务必更新您的导入以使用新引入的替换类型。NameCassandraType.NameSpring中文文档

强制报价

此标志现已弃用，建议不要再使用它。 Spring Data for Apache Cassandra 在内部使用驱动程序，确保在需要的地方引用。CqlIdentifierSpring中文文档

物业类型

DataStax 驱动程序 4 不再使用 . 请升级您的数据模型以使用 . 还请将原始 UDT 和元组类型分别迁移到新的驱动程序类型。java.lang.Datejava.time.LocalDateTimeUdtValueTupleValueSpring中文文档

其他更改

  • 驱动程序的常量类已被删除，并重新引入为 。 已适应.ConsistencyLevelDefaultConsistencyLevel@ConsistencyDefaultConsistencyLevelSpring中文文档

  • RetryPolicyon 和 types 被删除，没有替换。QueryOptions…CqlTemplateSpring中文文档

  • 驱动程序类型已删除。 分页状态现在使用 .PagingStateByteBufferSpring中文文档

  • SimpleUserTypeResolver接受而不是 .CqlSessionClusterSpring中文文档

  • SimpleTupleTypeFactory已迁移到 . 不再需要 / 上下文。enumSimpleTupleTypeFactory.INSTANCEClusterCqlSessionSpring中文文档

  • 引入功能构建语句，因为 QueryBuilder API 使用不可变语句类型。StatementBuilderSpring中文文档

  • SessionBean 重命名为 to，Bean 重命名为 to 。sessioncassandraSessionSessionFactorysessionFactorycassandraSessionFactorySpring中文文档

  • ReactiveSessionBean 重命名为 to，Bean 重命名为 to 。reactiveSessionreactiveCassandraSessionReactiveSessionFactoryreactiveSessionFactoryreactiveCassandraSessionFactorySpring中文文档

  • ReactiveSessionFactory.getSession()现在返回一个 . 以前它只返回 .Mono<ReactiveSession>ReactiveSessionSpring中文文档

  • 数据类型解析已移入，因此所有与 / 相关的方法都已移入（受影响的方法为 、 、 和 ）。ColumnTypeResolverDataTypeCassandraPersistentEntityCassandraPersistentPropertyColumnTypeResolverMappingContext.getDataType(…)CassandraPersistentProperty.getDataType()CassandraPersistentEntity.getUserType()CassandraPersistentEntity.getTupleType()Spring中文文档

  • 架构创建已从 移动到 （受影响的方法为 、 和 ）。MappingContextSchemaFactoryCassandraMappingContext.getCreateTableSpecificationFor(…)CassandraMappingContext.getCreateIndexSpecificationsFor(…)CassandraMappingContext.getCreateUserTypeSpecificationFor(…)Spring中文文档

弃用

  • CassandraCqlSessionFactoryBean，请改用。CqlSessionFactoryBeanSpring中文文档

  • KeyspaceIdentifier和 ，请改用。CqlIdentifiercom.datastax.oss.driver.api.core.CqlIdentifierSpring中文文档

  • CassandraSessionFactoryBean，请改用。CqlSessionFactoryBeanSpring中文文档

  • AbstractCqlTemplateConfiguration，请改用。AbstractSessionConfigurationSpring中文文档

  • AbstractSessionConfiguration.getClusterName()，请改用。AbstractSessionConfiguration.getSessionName()Spring中文文档

  • CodecRegistryTupleTypeFactory，请改用。SimpleTupleTypeFactorySpring中文文档

  • Spring Data的，请改用驱动程序。CqlIdentifierCqlIdentifierSpring中文文档

  • forceQuote不再需要引用的属性。 正确转义保留关键字并注意区分大小写。CqlIdentifierSpring中文文档

  • fetchSizeon 和 types 已弃用，请改用QueryOptions…CqlTemplatepageSizeSpring中文文档

  • CassandraMappingContext.setUserTypeResolver(…)、 和 ： 在 上配置这些属性。CassandraMappingContext.setCodecRegistry(…)CassandraMappingContext.setCustomConversions(…)CassandraConverterSpring中文文档

  • TupleTypeFactory和 ： 不再使用，因为 Cassandra 驱动程序附带了工厂方法。CassandraMappingContext.setTupleTypeFactory(…)TupleTypeFactoryDataTypes.tupleOf(…)Spring中文文档

  • 不推荐通过 （） 创建架构。 通过 （） 创建密钥空间不受影响。CqlSessionFactoryBeancassandra:sessionCqlSessionFactoryBeancassandra:sessionSpring中文文档

清除

配置 API

公用事业

  • GuavaListenableFutureAdapterSpring中文文档

  • QueryOptions以及构造函数获取和参数。 将构建器与执行配置文件结合使用作为替换。WriteOptionsConsistencyLevelRetryPolicySpring中文文档

  • CassandraAccessor.setRetryPolicy(…)和方法。 使用执行配置文件作为替换。ReactiveCqlTemplate.setRetryPolicy(…)Spring中文文档

命名空间支持

增加

配置 API

命名空间支持