使用 NoSQL 技术

Spring Data 提供了额外的项目，帮助你访问各种 NoSQL 技术，包括

在这些技术中，Spring Boot 为 Cassandra、Couchbase、Elasticsearch、LDAP、MongoDB、Neo4J 和 Redis 提供了自动配置。此外，适用于 Apache Geode 的 Spring Boot 为 Apache Geode 提供了自动配置。你可以使用其他项目，但必须自己配置它们。请参阅 spring.io/projects/spring-data 上的相应参考文档。

Spring Boot 还为 InfluxDB 客户端提供了自动配置，但它已被弃用，转而支持新的 InfluxDB Java 客户端，该客户端提供了自己的 Spring Boot 集成。

Redis

Redis 是一款缓存、消息代理和功能丰富的键值存储。Spring Boot 为 Lettuce 和 Jedis 客户端库以及 Spring Data Redis 提供的基于这些库的抽象提供了基本的自动配置。

有一个 spring-boot-starter-data-redis “Starter” 可以方便地收集依赖项。默认情况下，它使用 Lettuce。该 starter 同时处理传统应用程序和响应式应用程序。

我们还提供了一个 spring-boot-starter-data-redis-reactive “Starter”，以与支持响应式操作的其他存储保持一致。

连接到 Redis

您可以注入自动配置的 RedisConnectionFactory、StringRedisTemplate 或普通的 RedisTemplate 实例，就像注入任何其他 Spring Bean 一样。以下清单显示了此类 bean 的示例

Java
Kotlin

import org.springframework.data.redis.core.StringRedisTemplate;
import org.springframework.stereotype.Component;

@Component
public class MyBean {

	private final StringRedisTemplate template;

	public MyBean(StringRedisTemplate template) {
		this.template = template;
	}

	// ...

	public Boolean someMethod() {
		return this.template.hasKey("spring");
	}

}

import org.springframework.data.redis.core.StringRedisTemplate
import org.springframework.stereotype.Component

@Component
class MyBean(private val template: StringRedisTemplate) {

	// ...

	fun someMethod(): Boolean {
		return template.hasKey("spring")
	}

}

默认情况下，该实例尝试连接到 localhost:6379 上的 Redis 服务器。您可以使用 spring.data.redis.* 属性指定自定义连接详细信息，如下例所示

属性
YAML

spring.data.redis.host=localhost
spring.data.redis.port=6379
spring.data.redis.database=0
spring.data.redis.username=user
spring.data.redis.password=secret

spring:
  data:
    redis:
      host: "localhost"
      port: 6379
      database: 0
      username: "user"
      password: "secret"

您还可以注册任意数量实现 LettuceClientConfigurationBuilderCustomizer 的 bean，以进行更高级的自定义。还可以使用 ClientResourcesBuilderCustomizer 自定义 ClientResources。如果您使用 Jedis，还可以使用 JedisClientConfigurationBuilderCustomizer。或者，您可以注册类型为 RedisStandaloneConfiguration、RedisSentinelConfiguration 或 RedisClusterConfiguration 的 bean，以完全控制配置。

如果您添加了自己的任何自动配置类型的 @Bean，它将替换默认值（除了 RedisTemplate 的情况，此时排除基于 bean 名称 redisTemplate，而不是其类型）。

默认情况下，如果类路径中存在 commons-pool2，则会自动配置一个池化连接工厂。

可以将自动配置的 RedisConnectionFactory 配置为使用 SSL 与服务器通信，方法是设置属性，如下例所示

属性
YAML

spring.data.redis.ssl.enabled=true

spring:
  data:
    redis:
      ssl:
        enabled: true

可以在 SSL 捆绑包中配置自定义 SSL 信任材料，并将其应用于 RedisConnectionFactory，如下例所示

属性
YAML

spring.data.redis.ssl.bundle=example

spring:
  data:
    redis:
      ssl:
        bundle: "example"

MongoDB

MongoDB 是一款开源 NoSQL 文档数据库，它使用类似于 JSON 的模式，而不是传统的基于表的关联数据。Spring Boot 提供了多种便利功能，用于处理 MongoDB，包括 spring-boot-starter-data-mongodb 和 spring-boot-starter-data-mongodb-reactive “启动器”。

连接到 MongoDB 数据库

要访问 MongoDB 数据库，您可以注入自动配置的 org.springframework.data.mongodb.MongoDatabaseFactory。默认情况下，该实例尝试连接到 mongodb://127.0.0.1/test 中的 MongoDB 服务器。以下示例演示如何连接到 MongoDB 数据库

Java
Kotlin

import com.mongodb.client.MongoCollection;
import com.mongodb.client.MongoDatabase;
import org.bson.Document;

import org.springframework.data.mongodb.MongoDatabaseFactory;
import org.springframework.stereotype.Component;

@Component
public class MyBean {

	private final MongoDatabaseFactory mongo;

	public MyBean(MongoDatabaseFactory mongo) {
		this.mongo = mongo;
	}

	// ...

	public MongoCollection<Document> someMethod() {
		MongoDatabase db = this.mongo.getMongoDatabase();
		return db.getCollection("users");
	}

}

import com.mongodb.client.MongoCollection
import org.bson.Document
import org.springframework.data.mongodb.MongoDatabaseFactory
import org.springframework.stereotype.Component

@Component
class MyBean(private val mongo: MongoDatabaseFactory) {

	// ...

	fun someMethod(): MongoCollection<Document> {
		val db = mongo.mongoDatabase
		return db.getCollection("users")
	}

}

如果您定义了自己的 MongoClient，它将用于自动配置合适的 MongoDatabaseFactory。

自动配置的 MongoClient 是使用 MongoClientSettings bean 创建的。如果您定义了自己的 MongoClientSettings，它将被使用，且不进行修改，并且 spring.data.mongodb 属性将被忽略。否则，将自动配置 MongoClientSettings，并将 spring.data.mongodb 属性应用于它。在任何情况下，您都可以声明一个或多个 MongoClientSettingsBuilderCustomizer bean 来微调 MongoClientSettings 配置。每个 bean 都将按顺序使用 MongoClientSettings.Builder 调用，该 MongoClientSettings.Builder 用于构建 MongoClientSettings。

您可以设置 spring.data.mongodb.uri 属性来更改 URL 并配置其他设置，例如副本集，如下例所示

属性
YAML

spring.data.mongodb.uri=mongodb://user:[email protected]:27017,mongoserver2.example.com:23456/test

spring:
  data:
    mongodb:
      uri: "mongodb://user:[email protected]:27017,mongoserver2.example.com:23456/test"

或者，您可以使用离散属性指定连接详细信息。例如，您可以在 application.properties 中声明以下设置

属性
YAML

spring.data.mongodb.host=mongoserver1.example.com
spring.data.mongodb.port=27017
spring.data.mongodb.additional-hosts[0]=mongoserver2.example.com:23456
spring.data.mongodb.database=test
spring.data.mongodb.username=user
spring.data.mongodb.password=secret

spring:
  data:
    mongodb:
      host: "mongoserver1.example.com"
      port: 27017
      additional-hosts:
      - "mongoserver2.example.com:23456"
      database: "test"
      username: "user"
      password: "secret"

可以将自动配置的 MongoClient 配置为使用 SSL 与服务器通信，方法是设置属性，如下例所示

属性
YAML

spring.data.mongodb.uri=mongodb://user:[email protected]:27017,mongoserver2.example.com:23456/test
spring.data.mongodb.ssl.enabled=true

spring:
  data:
    mongodb:
      uri: "mongodb://user:[email protected]:27017,mongoserver2.example.com:23456/test"
      ssl:
        enabled: true

可以在 SSL 捆绑包中配置自定义 SSL 信任材料，并将其应用于 MongoClient，如下例所示

属性
YAML

spring.data.mongodb.uri=mongodb://user:[email protected]:27017,mongoserver2.example.com:23456/test
spring.data.mongodb.ssl.bundle=example

spring:
  data:
    mongodb:
      uri: "mongodb://user:[email protected]:27017,mongoserver2.example.com:23456/test"
      ssl:
        bundle: "example"

如果未指定 spring.data.mongodb.port，则使用默认值 27017。您可以从前面显示的示例中删除此行。

您还可以使用 host:port 语法将端口指定为主机地址的一部分。如果您需要更改 additional-hosts 条目的端口，则应使用此格式。

如果您不使用 Spring Data MongoDB，则可以注入 MongoClient bean，而不是使用 MongoDatabaseFactory。如果您想完全控制建立 MongoDB 连接，您还可以声明您自己的 MongoDatabaseFactory 或 MongoClient bean。

如果您使用的是反应式驱动程序，则 SSL 需要 Netty。如果 Netty 可用且尚未自定义要使用的工厂，则自动配置将自动配置此工厂。

MongoTemplate

Spring Data MongoDB 提供了一个 MongoTemplate 类，其设计与 Spring 的 JdbcTemplate 非常相似。与 JdbcTemplate 一样，Spring Boot 会自动配置一个 bean，以便注入模板，如下所示

Java
Kotlin

import com.mongodb.client.MongoCollection;
import org.bson.Document;

import org.springframework.data.mongodb.core.MongoTemplate;
import org.springframework.stereotype.Component;

@Component
public class MyBean {

	private final MongoTemplate mongoTemplate;

	public MyBean(MongoTemplate mongoTemplate) {
		this.mongoTemplate = mongoTemplate;
	}

	// ...

	public MongoCollection<Document> someMethod() {
		return this.mongoTemplate.getCollection("users");
	}

}

import com.mongodb.client.MongoCollection
import org.bson.Document
import org.springframework.data.mongodb.core.MongoTemplate
import org.springframework.stereotype.Component

@Component
class MyBean(private val mongoTemplate: MongoTemplate) {

	// ...

	fun someMethod(): MongoCollection<Document> {
		return mongoTemplate.getCollection("users")
	}

}

有关完整详细信息，请参阅 MongoOperations Javadoc。

Spring Data MongoDB 存储库

Spring Data 包括对 MongoDB 的存储库支持。与前面讨论的 JPA 存储库一样，基本原则是根据方法名称自动构建查询。

事实上，Spring Data JPA 和 Spring Data MongoDB 共享相同的公共基础设施。您可以采用前面的 JPA 示例，假设 City 现在是 MongoDB 数据类，而不是 JPA @Entity，它以相同的方式工作，如下例所示

Java
Kotlin

import org.springframework.data.domain.Page;
import org.springframework.data.domain.Pageable;
import org.springframework.data.repository.Repository;

public interface CityRepository extends Repository<City, Long> {

	Page<City> findAll(Pageable pageable);

	City findByNameAndStateAllIgnoringCase(String name, String state);

}

import org.springframework.data.domain.Page
import org.springframework.data.domain.Pageable
import org.springframework.data.repository.Repository

interface CityRepository :
	Repository<City?, Long?> {
	fun findAll(pageable: Pageable?): Page<City?>?
	fun findByNameAndStateAllIgnoringCase(name: String?, state: String?): City?
}

通过扫描找到存储库和文档。默认情况下，会扫描自动配置包。您可以使用 @EnableMongoRepositories 和 @EntityScan 分别自定义查找存储库和文档的位置。

有关 Spring Data MongoDB 的完整详细信息，包括其丰富的对象映射技术，请参阅其参考文档。

Neo4j

Neo4j 是一款开源 NoSQL 图形数据库，它使用由一级关系连接的节点的丰富数据模型，比传统的 RDBMS 方法更适合连接大数据。Spring Boot 提供了多种便利功能，用于处理 Neo4j，包括 spring-boot-starter-data-neo4j “Starter”。

连接到 Neo4j 数据库

要访问 Neo4j 服务器，您可以注入一个自动配置的 org.neo4j.driver.Driver。默认情况下，该实例会尝试使用 Bolt 协议连接到 localhost:7687 上的 Neo4j 服务器。以下示例展示了如何注入一个 Neo4j Driver，它可以让您访问 Session 等内容

Java
Kotlin

import org.neo4j.driver.Driver;
import org.neo4j.driver.Session;
import org.neo4j.driver.Values;

import org.springframework.stereotype.Component;

@Component
public class MyBean {

	private final Driver driver;

	public MyBean(Driver driver) {
		this.driver = driver;
	}

	// ...

	public String someMethod(String message) {
		try (Session session = this.driver.session()) {
			return session.executeWrite(
					(transaction) -> transaction
						.run("CREATE (a:Greeting) SET a.message = $message RETURN a.message + ', from node ' + id(a)",
								Values.parameters("message", message))
						.single()
						.get(0)
						.asString());
		}
	}

}

import org.neo4j.driver.*
import org.springframework.stereotype.Component

@Component
class MyBean(private val driver: Driver) {
	// ...
	fun someMethod(message: String?): String {
		driver.session().use { session ->
			return@someMethod session.executeWrite { transaction: TransactionContext ->
				transaction
					.run(
						"CREATE (a:Greeting) SET a.message = \$message RETURN a.message + ', from node ' + id(a)",
						Values.parameters("message", message)
					)
					.single()[0].asString()
			}
		}
	}
}

您可以使用 spring.neo4j.* 属性配置驱动程序的各个方面。以下示例展示了如何配置要使用的 URI 和凭据

属性
YAML

spring.neo4j.uri=bolt://my-server:7687
spring.neo4j.authentication.username=neo4j
spring.neo4j.authentication.password=secret

spring:
  neo4j:
    uri: "bolt://my-server:7687"
    authentication:
      username: "neo4j"
      password: "secret"

自动配置的 Driver 是使用 ConfigBuilder 创建的。要微调其配置，请声明一个或多个 ConfigBuilderCustomizer bean。每个 bean 都将按顺序使用 ConfigBuilder 调用，该 ConfigBuilder 用于构建 Driver。

Spring Data Neo4j 存储库

Spring Data 包含 Neo4j 的存储库支持。有关 Spring Data Neo4j 的完整详细信息，请参阅参考文档。

Spring Data Neo4j 与 Spring Data JPA 共享通用基础设施，就像许多其他 Spring Data 模块一样。您可以采用前面的 JPA 示例，并将 `City` 定义为 Spring Data Neo4j `@Node` 而不是 JPA `@Entity`，并且存储库抽象以相同的方式工作，如下例所示

Java
Kotlin

import java.util.Optional;

import org.springframework.data.neo4j.repository.Neo4jRepository;

public interface CityRepository extends Neo4jRepository<City, Long> {

	Optional<City> findOneByNameAndState(String name, String state);

}

import org.springframework.data.neo4j.repository.Neo4jRepository
import java.util.Optional

interface CityRepository : Neo4jRepository<City?, Long?> {

	fun findOneByNameAndState(name: String?, state: String?): Optional<City?>?

}

“Starter” `spring-boot-starter-data-neo4j` 启用存储库支持以及事务管理。Spring Boot 支持经典和响应式 Neo4j 存储库，使用 `Neo4jTemplate` 或 `ReactiveNeo4jTemplate` bean。当类路径中存在 Project Reactor 时，还会自动配置响应式样式。

通过扫描查找存储库和实体。默认情况下，会扫描自动配置包。您可以使用 `@EnableNeo4jRepositories` 和 `@EntityScan` 分别自定义用于查找存储库和实体的位置。

在使用响应式样式的应用程序中，不会自动配置 `ReactiveTransactionManager`。要启用事务管理，必须在配置中定义以下 bean

Java
Kotlin

import org.neo4j.driver.Driver;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.neo4j.core.ReactiveDatabaseSelectionProvider;
import org.springframework.data.neo4j.core.transaction.ReactiveNeo4jTransactionManager;

@Configuration(proxyBeanMethods = false)
public class MyNeo4jConfiguration {

	@Bean
	public ReactiveNeo4jTransactionManager reactiveTransactionManager(Driver driver,
			ReactiveDatabaseSelectionProvider databaseNameProvider) {
		return new ReactiveNeo4jTransactionManager(driver, databaseNameProvider);
	}

}

import org.neo4j.driver.Driver
import org.springframework.context.annotation.Bean
import org.springframework.context.annotation.Configuration
import org.springframework.data.neo4j.core.ReactiveDatabaseSelectionProvider
import org.springframework.data.neo4j.core.transaction.ReactiveNeo4jTransactionManager

@Configuration(proxyBeanMethods = false)
class MyNeo4jConfiguration {

	@Bean
	fun reactiveTransactionManager(driver: Driver,
			databaseNameProvider: ReactiveDatabaseSelectionProvider): ReactiveNeo4jTransactionManager {
		return ReactiveNeo4jTransactionManager(driver, databaseNameProvider)
	}
}

Elasticsearch

Elasticsearch 是一个开源、分布式、RESTful 搜索和分析引擎。Spring Boot 为 Elasticsearch 客户端提供基本的自动配置。

Spring Boot 支持多个客户端

官方低级 REST 客户端
官方 Java API 客户端
Spring Data Elasticsearch 提供的 `ReactiveElasticsearchClient`

Spring Boot 提供了一个专门的“Starter”，即 `spring-boot-starter-data-elasticsearch`。

使用 REST 客户端连接到 Elasticsearch

Elasticsearch 提供了两个不同的 REST 客户端，您可以使用它们来查询集群：`org.elasticsearch.client:elasticsearch-rest-client` 模块中的低级客户端和 `co.elastic.clients:elasticsearch-java` 模块中的 Java API 客户端。此外，Spring Boot 还为 `org.springframework.data:spring-data-elasticsearch` 模块中的响应式客户端提供支持。默认情况下，客户端将以 `localhost:9200` 为目标。您可以使用 `spring.elasticsearch.*` 属性进一步调整客户端的配置方式，如下例所示

属性
YAML

spring.elasticsearch.uris=https://search.example.com:9200
spring.elasticsearch.socket-timeout=10s
spring.elasticsearch.username=user
spring.elasticsearch.password=secret

spring:
  elasticsearch:
    uris: "https://search.example.com:9200"
    socket-timeout: "10s"
    username: "user"
    password: "secret"

使用 RestClient 连接到 Elasticsearch

如果您在类路径中具有 `elasticsearch-rest-client`，Spring Boot 将自动配置并注册一个 `RestClient` bean。除了前面描述的属性之外，为了微调 `RestClient`，您可以注册任意数量实现 `RestClientBuilderCustomizer` 的 bean，以进行更高级的自定义。要完全控制客户端的配置，请定义一个 `RestClientBuilder` bean。

此外，如果 elasticsearch-rest-client-sniffer 在类路径中，则会自动配置一个 Sniffer 以从正在运行的 Elasticsearch 集群自动发现节点，并将它们设置在 RestClient bean 上。您可以进一步调整 Sniffer 的配置方式，如下例所示

属性
YAML

spring.elasticsearch.restclient.sniffer.interval=10m
spring.elasticsearch.restclient.sniffer.delay-after-failure=30s

spring:
  elasticsearch:
    restclient:
      sniffer:
        interval: "10m"
        delay-after-failure: "30s"

使用 ElasticsearchClient 连接到 Elasticsearch

如果您在类路径上有 co.elastic.clients:elasticsearch-java，Spring Boot 将自动配置并注册一个 ElasticsearchClient bean。

ElasticsearchClient 使用依赖于前面描述的 RestClient 的传输。因此，前面描述的属性可用于配置 ElasticsearchClient。此外，您可以定义一个 RestClientOptions bean 来进一步控制传输的行为。

使用 ReactiveElasticsearchClient 连接到 Elasticsearch

Spring Data Elasticsearch 提供 ReactiveElasticsearchClient，用于以响应式方式查询 Elasticsearch 实例。如果您在类路径上有 Spring Data Elasticsearch 和 Reactor，Spring Boot 将自动配置并注册一个 ReactiveElasticsearchClient。

ReactiveElasticsearchclient 使用依赖于前面描述的 RestClient 的传输。因此，前面描述的属性可用于配置 ReactiveElasticsearchClient。此外，您可以定义一个 RestClientOptions bean 来进一步控制传输的行为。

使用 Spring Data 连接到 Elasticsearch

要连接到 Elasticsearch，必须定义一个 ElasticsearchClient bean，由 Spring Boot 自动配置或由应用程序手动提供（请参阅前面的部分）。有了此配置，就可以像注入任何其他 Spring bean 一样注入 ElasticsearchTemplate，如下例所示

Java
Kotlin

import org.springframework.data.elasticsearch.client.elc.ElasticsearchTemplate;
import org.springframework.stereotype.Component;

@Component
public class MyBean {

	private final ElasticsearchTemplate template;

	public MyBean(ElasticsearchTemplate template) {
		this.template = template;
	}

	// ...

	public boolean someMethod(String id) {
		return this.template.exists(id, User.class);
	}

}

import org.springframework.stereotype.Component

@Component
class MyBean(private val template: org.springframework.data.elasticsearch.client.elc.ElasticsearchTemplate ) {

	// ...

	fun someMethod(id: String): Boolean {
		return template.exists(id, User::class.java)
	}

}

在存在 spring-data-elasticsearch 和 Reactor 的情况下，Spring Boot 还可以自动配置一个 ReactiveElasticsearchClient 和一个 ReactiveElasticsearchTemplate 作为 bean。它们是其他 REST 客户端的响应式等效项。

Spring Data Elasticsearch 存储库

Spring Data 包含对 Elasticsearch 的存储库支持。与前面讨论的 JPA 存储库一样，基本原则是基于方法名称自动为您构建查询。

事实上，Spring Data JPA 和 Spring Data Elasticsearch 共享相同的通用基础设施。你可以采用前面提到的 JPA 示例，假设 City 现在是 Elasticsearch @Document 类，而不是 JPA @Entity，它以相同的方式工作。

通过扫描找到存储库和文档。默认情况下，会扫描自动配置包。你可以分别使用 @EnableElasticsearchRepositories 和 @EntityScan 自定义查找存储库和文档的位置。

有关 Spring Data Elasticsearch 的完整详细信息，请参阅参考文档。

Spring Boot 支持经典和响应式 Elasticsearch 存储库，使用 ElasticsearchRestTemplate 或 ReactiveElasticsearchTemplate bean。如果存在必需的依赖项，Spring Boot 很可能会自动配置这些 bean。

如果你希望使用自己的模板来支持 Elasticsearch 存储库，你可以添加自己的 ElasticsearchRestTemplate 或 ElasticsearchOperations @Bean，只要它被命名为 "elasticsearchTemplate"。对于 ReactiveElasticsearchTemplate 和 ReactiveElasticsearchOperations 也是如此，bean 名称是 "reactiveElasticsearchTemplate"。

你可以选择使用以下属性禁用存储库支持

属性
YAML

spring.data.elasticsearch.repositories.enabled=false

spring:
  data:
    elasticsearch:
      repositories:
        enabled: false

Cassandra

Cassandra是一个开源分布式数据库管理系统，旨在跨多个商品服务器处理大量数据。Spring Boot 为 Cassandra 提供自动配置，以及Spring Data Cassandra在其之上提供的抽象。有一个 spring-boot-starter-data-cassandra “Starter”用于以一种便捷的方式收集依赖项。

连接到 Cassandra

你可以注入自动配置的 CassandraTemplate 或 Cassandra CqlSession 实例，就像使用任何其他 Spring Bean 一样。spring.cassandra.* 属性可用于自定义连接。通常，你提供 keyspace-name 和 contact-points 以及本地数据中心名称，如下例所示

属性
YAML

spring.cassandra.keyspace-name=mykeyspace
spring.cassandra.contact-points=cassandrahost1:9042,cassandrahost2:9042
spring.cassandra.local-datacenter=datacenter1

spring:
  cassandra:
    keyspace-name: "mykeyspace"
    contact-points: "cassandrahost1:9042,cassandrahost2:9042"
    local-datacenter: "datacenter1"

如果所有联系点都使用相同的端口，则可以使用快捷方式，只指定主机名，如下例所示

属性
YAML

spring.cassandra.keyspace-name=mykeyspace
spring.cassandra.contact-points=cassandrahost1,cassandrahost2
spring.cassandra.local-datacenter=datacenter1

spring:
  cassandra:
    keyspace-name: "mykeyspace"
    contact-points: "cassandrahost1,cassandrahost2"
    local-datacenter: "datacenter1"

这两个示例是相同的，因为端口默认为 9042。如果您需要配置端口，请使用 spring.cassandra.port。

可以将自动配置的 CqlSession 配置为使用 SSL 与服务器进行通信，方法是设置属性，如下例所示

属性
YAML

spring.cassandra.keyspace-name=mykeyspace
spring.cassandra.contact-points=cassandrahost1,cassandrahost2
spring.cassandra.local-datacenter=datacenter1
spring.cassandra.ssl.enabled=true

spring:
  cassandra:
    keyspace-name: "mykeyspace"
    contact-points: "cassandrahost1,cassandrahost2"
    local-datacenter: "datacenter1"
    ssl:
      enabled: true

可以在 SSL 捆绑包中配置自定义 SSL 信任材料，并将其应用于 CqlSession，如下例所示

属性
YAML

spring.cassandra.keyspace-name=mykeyspace
spring.cassandra.contact-points=cassandrahost1,cassandrahost2
spring.cassandra.local-datacenter=datacenter1
spring.cassandra.ssl.bundle=example

spring:
  cassandra:
    keyspace-name: "mykeyspace"
    contact-points: "cassandrahost1,cassandrahost2"
    local-datacenter: "datacenter1"
    ssl:
      bundle: "example"

Cassandra 驱动程序有自己的配置基础设施，该基础设施在类路径的根目录加载 application.conf。

Spring Boot 默认不查找此类文件，但可以使用 spring.cassandra.config 加载此类文件。如果某个属性同时存在于 spring.cassandra.* 和配置文件中，则 spring.cassandra.* 中的值优先。

对于更高级的驱动程序自定义，您可以注册任意数量实现 DriverConfigLoaderBuilderCustomizer 的 Bean。可以使用类型为 CqlSessionBuilderCustomizer 的 Bean 自定义 CqlSession。

如果您使用 CqlSessionBuilder 创建多个 CqlSession Bean，请记住该构建器是可变的，因此请确保为每个会话注入一个新副本。

以下代码清单显示了如何注入 Cassandra Bean

Java
Kotlin

import org.springframework.data.cassandra.core.CassandraTemplate;
import org.springframework.stereotype.Component;

@Component
public class MyBean {

	private final CassandraTemplate template;

	public MyBean(CassandraTemplate template) {
		this.template = template;
	}

	// ...

	public long someMethod() {
		return this.template.count(User.class);
	}

}

import org.springframework.data.cassandra.core.CassandraTemplate
import org.springframework.stereotype.Component

@Component
class MyBean(private val template: CassandraTemplate) {

	// ...

	fun someMethod(): Long {
		return template.count(User::class.java)
	}

}

如果您添加自己的 CassandraTemplate 类型的 @Bean，它将替换默认值。

Spring Data Cassandra 存储库

Spring Data 包括对 Cassandra 的基本存储库支持。目前，这比前面讨论的 JPA 存储库的限制更大，并且需要使用 @Query 注释的查找器方法。

通过扫描找到存储库和实体。默认情况下，将扫描自动配置包。您可以使用 @EnableCassandraRepositories 和 @EntityScan 分别自定义查找存储库和实体的位置。

有关 Spring Data Cassandra 的完整详细信息，请参阅参考文档。

Couchbase

Couchbase 是一款开源、分布式、多模型 NoSQL 面向文档的数据库，针对交互式应用程序进行了优化。Spring Boot 提供了对 Couchbase 的自动配置，以及 Spring Data Couchbase 提供的基于 Couchbase 的抽象。有 spring-boot-starter-data-couchbase 和 spring-boot-starter-data-couchbase-reactive “启动器”，可以方便地收集依赖项。

连接到 Couchbase

您可以通过添加 Couchbase SDK 和一些配置来获取 Cluster。spring.couchbase.* 属性可用于自定义连接。通常，您会提供连接字符串、用户名和密码，如下例所示

属性
YAML

spring.couchbase.connection-string=couchbase://192.168.1.123
spring.couchbase.username=user
spring.couchbase.password=secret

spring:
  couchbase:
    connection-string: "couchbase://192.168.1.123"
    username: "user"
    password: "secret"

还可以自定义一些 ClusterEnvironment 设置。例如，以下配置将超时时间更改为打开新的 Bucket，并启用对已配置的 SSL 捆绑包的 SSL 支持

属性
YAML

spring.couchbase.env.timeouts.connect=3s
spring.couchbase.env.ssl.bundle=example

spring:
  couchbase:
    env:
      timeouts:
        connect: "3s"
      ssl:
        bundle: "example"

有关更多详细信息，请查看 spring.couchbase.env.* 属性。要进行更多控制，可以使用一个或多个 ClusterEnvironmentBuilderCustomizer bean。

Spring Data Couchbase 存储库

Spring Data 包含对 Couchbase 的存储库支持。

通过扫描找到存储库和文档。默认情况下，会扫描自动配置包。您可以使用 @EnableCouchbaseRepositories 和 @EntityScan 分别自定义查找存储库和文档的位置。

有关 Spring Data Couchbase 的完整详细信息，请参阅参考文档。

您可以像使用任何其他 Spring Bean 一样注入自动配置的 CouchbaseTemplate 实例，前提是提供了 CouchbaseClientFactory bean。当 Cluster 可用（如上所述）并且指定了存储桶名称时，就会发生这种情况

属性
YAML

spring.data.couchbase.bucket-name=my-bucket

spring:
  data:
    couchbase:
      bucket-name: "my-bucket"

以下示例演示如何注入 CouchbaseTemplate bean

Java
Kotlin

import org.springframework.data.couchbase.core.CouchbaseTemplate;
import org.springframework.stereotype.Component;

@Component
public class MyBean {

	private final CouchbaseTemplate template;

	public MyBean(CouchbaseTemplate template) {
		this.template = template;
	}

	// ...

	public String someMethod() {
		return this.template.getBucketName();
	}

}

import org.springframework.data.couchbase.core.CouchbaseTemplate
import org.springframework.stereotype.Component

@Component
class MyBean(private val template: CouchbaseTemplate) {

	// ...

	fun someMethod(): String {
		return template.bucketName
	}

}

您可以在自己的配置中定义一些 bean，以覆盖自动配置提供的 bean

名为 couchbaseMappingContext 的 CouchbaseMappingContext @Bean。
名为 couchbaseCustomConversions 的 CustomConversions @Bean。
名为 couchbaseTemplate 的 CouchbaseTemplate @Bean。

为了避免在自己的配置中硬编码这些名称，您可以重复使用 Spring Data Couchbase 提供的 BeanNames。例如，您可以自定义要使用的转换器，如下所示

Java
Kotlin

import org.assertj.core.util.Arrays;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.couchbase.config.BeanNames;
import org.springframework.data.couchbase.core.convert.CouchbaseCustomConversions;

@Configuration(proxyBeanMethods = false)
public class MyCouchbaseConfiguration {

	@Bean(BeanNames.COUCHBASE_CUSTOM_CONVERSIONS)
	public CouchbaseCustomConversions myCustomConversions() {
		return new CouchbaseCustomConversions(Arrays.asList(new MyConverter()));
	}

}

import org.assertj.core.util.Arrays
import org.springframework.context.annotation.Bean
import org.springframework.context.annotation.Configuration
import org.springframework.data.couchbase.config.BeanNames
import org.springframework.data.couchbase.core.convert.CouchbaseCustomConversions

@Configuration(proxyBeanMethods = false)
class MyCouchbaseConfiguration {

	@Bean(BeanNames.COUCHBASE_CUSTOM_CONVERSIONS)
	fun myCustomConversions(): CouchbaseCustomConversions {
		return CouchbaseCustomConversions(Arrays.asList(MyConverter()))
	}

}

LDAP

LDAP（轻量级目录访问协议）是一种开放的、与供应商无关的行业标准应用程序协议，用于通过 IP 网络访问和维护分布式目录信息服务。Spring Boot 为任何兼容的 LDAP 服务器提供自动配置，并支持 UnboundID 中的嵌入式内存内 LDAP 服务器。

Spring Data LDAP 提供了 LDAP 抽象。有一个 spring-boot-starter-data-ldap “Starter”，用于以一种便捷的方式收集依赖项。

连接到 LDAP 服务器

要连接到 LDAP 服务器，请确保声明对 spring-boot-starter-data-ldap “Starter”或 spring-ldap-core 的依赖项，然后在 application.properties 中声明服务器的 URL，如下例所示

属性
YAML

spring.ldap.urls=ldap://myserver:1235
spring.ldap.username=admin
spring.ldap.password=secret

spring:
  ldap:
    urls: "ldap://myserver:1235"
    username: "admin"
    password: "secret"

如果您需要自定义连接设置，可以使用 spring.ldap.base 和 spring.ldap.base-environment 属性。

根据这些设置自动配置一个 LdapContextSource。如果一个 DirContextAuthenticationStrategy bean 可用，它将与自动配置的 LdapContextSource 关联。如果你需要自定义它，例如使用一个 PooledContextSource，你仍然可以注入自动配置的 LdapContextSource。确保将你自定义的 ContextSource 标记为 @Primary，以便自动配置的 LdapTemplate 使用它。

Spring Data LDAP 存储库

Spring Data 包括对 LDAP 的存储库支持。

通过扫描找到存储库和文档。默认情况下，自动配置包被扫描。你可以使用 @EnableLdapRepositories 和 @EntityScan 分别自定义查找存储库和文档的位置。

Spring Data LDAP 的完整详细信息，请参阅参考文档。

你还可以注入一个自动配置的 LdapTemplate 实例，就像你对任何其他 Spring Bean 所做的那样，如下例所示

Java
Kotlin

import java.util.List;

import org.springframework.ldap.core.LdapTemplate;
import org.springframework.stereotype.Component;

@Component
public class MyBean {

	private final LdapTemplate template;

	public MyBean(LdapTemplate template) {
		this.template = template;
	}

	// ...

	public List<User> someMethod() {
		return this.template.findAll(User.class);
	}

}

import org.springframework.ldap.core.LdapTemplate
import org.springframework.stereotype.Component

@Component
class MyBean(private val template: LdapTemplate) {

	// ...

	fun someMethod(): List<User> {
		return template.findAll(User::class.java)
	}

}

嵌入式内存中 LDAP 服务器

出于测试目的，Spring Boot 支持从 UnboundID 自动配置一个内存中 LDAP 服务器。要配置服务器，添加一个对 com.unboundid:unboundid-ldapsdk 的依赖，并声明一个 spring.ldap.embedded.base-dn 属性，如下所示

属性
YAML

spring.ldap.embedded.base-dn=dc=spring,dc=io

spring:
  ldap:
    embedded:
      base-dn: "dc=spring,dc=io"

可以定义多个 base-dn 值，但是，由于识别名称通常包含逗号，因此必须使用正确的符号来定义它们。

在 yaml 文件中，你可以使用 yaml 列表符号。在属性文件中，你必须将索引包含在属性名称中

属性
YAML

spring.ldap.embedded.base-dn[0]=dc=spring,dc=io
spring.ldap.embedded.base-dn[1]=dc=vmware,dc=com

spring.ldap.embedded.base-dn:
- "dc=spring,dc=io"
- "dc=vmware,dc=com"

默认情况下，服务器在随机端口上启动并触发常规 LDAP 支持。无需指定 spring.ldap.urls 属性。

如果你的类路径上有一个 schema.ldif 文件，它将用于初始化服务器。如果你想从不同的资源加载初始化脚本，你还可以使用 spring.ldap.embedded.ldif 属性。

默认情况下，使用标准架构来验证 LDIF 文件。您可以通过设置 spring.ldap.embedded.validation.enabled 属性来完全关闭验证。如果您有自定义属性，可以使用 spring.ldap.embedded.validation.schema 来定义您的自定义属性类型或对象类。

InfluxDB

InfluxDB 的自动配置已弃用，计划在 Spring Boot 3.4 中删除，转而使用新的 InfluxDB Java 客户端，它提供了自己的 Spring Boot 集成。

InfluxDB 是一个开源时间序列数据库，针对快速、高可用性存储和检索时间序列数据进行了优化，这些数据涉及运营监控、应用程序指标、物联网传感器数据和实时分析等领域。

连接到 InfluxDB

Spring Boot 自动配置了一个 InfluxDB 实例，前提是 influxdb-java 客户端在类路径中，并且使用 spring.influx.url 设置了数据库的 URL。

如果连接到 InfluxDB 需要用户名和密码，您可以相应地设置 spring.influx.user 和 spring.influx.password 属性。

InfluxDB 依赖于 OkHttp。如果您需要调整 InfluxDB 在后台使用的 http 客户端，您可以注册一个 InfluxDbOkHttpClientBuilderProvider bean。

如果您需要对配置进行更多控制，请考虑注册一个 InfluxDbCustomizer bean。