与NoSQL技术的合作

Spring Data 还提供额外的项目，帮助您访问多种 NoSQL 技术，包括：spring-doc.cadn.net.cn

其中，Spring Boot 为 Cassandra、Couchbase、Elasticsearch、LDAP、MongoDB、Neo4J 和 Redis 提供自动配置。此外，Spring Boot for Apache Geode 也提供 Apache Geode 的自动配置。你可以使用其他项目，但必须自行配置。请参阅相关参考文档 spring.io/projects/spring-data。spring-doc.cadn.net.cn

Spring Boot 也为 InfluxDB 客户端提供自动配置，但已被弃用，取而代之的是提供自身 Spring Boot 集成的新 InfluxDB Java 客户端。spring-doc.cadn.net.cn

Redis

Redis 是一个缓存、消息代理和功能丰富的键值存储。 Spring Boot 为 Lettuce 和 Jedis 客户端库及其上层的 Spring Data Redis 提供的抽象库提供了基本的自动配置。spring-doc.cadn.net.cn

有一个Spring-boot-starter-data-redis方便地收集依赖。 默认情况下，它使用生菜。 该Starters既能处理传统应用，也能处理响应式应用。spring-doc.cadn.net.cn

我们还提供Spring-boot-starter-data-redis-reactive起始者是为与其他有响应式支持的商店保持一致。

连接Redis

你可以注入一个自动配置RedisConnection工厂,StringRedisTemplate或者说是原版Redis模板就像对待其他春豆一样。 以下列表展示了此类豆子的一个例子：spring-doc.cadn.net.cn

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")
	}

}

默认情况下，实例尝试连接到 Redis服务器本地主持：6379. 你可以用以下方式来指定自定义连接细节spring.data.redis.*性质，如下例所示：spring-doc.cadn.net.cn

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"

你也可以直接指定 Redis 服务器的网址。 设置URL时，主机、端口、用户名和密码属性会被忽略。 以下示例展示了这一点：spring-doc.cadn.net.cn

spring.data.redis.url=redis://user:secret@localhost:6379
spring.data.redis.database=0
spring:
  data:
    redis:
      url: "redis://user:secret@localhost:6379"
      database: 0
你也可以注册任意数量的豆子，实现它们LettuceClientConfigurationBuilderCustomizer为了更高级的自定义。客户端资源也可以通过以下方式进行定制ClientResourcesBuilderCustomizer. 如果你用绝地武士，JedisClientConfigurationBuilderCustomizer也可获得。

或者，你也可以注册一个类型的豆子RedisStandaloneConfiguration,RedisSentinelConfiguration,RedisClusterConfiguration或RedisStaticMasterReplicaConfiguration完全掌控配置。spring-doc.cadn.net.cn

绝地武士不支持主控/复制模式。

如果你自己加一个@Bean在任何自动配置类型中，它取代默认值（除非Redis模板，当排除基于豆名时，redis模板，不是它的类型）。spring-doc.cadn.net.cn

默认情况下，池化连接工厂是自动配置的Commons-pool2在阶级路径上。spring-doc.cadn.net.cn

自动配置RedisConnection工厂可以通过设置属性配置，如本示例所示，配置为使用 SSL 与服务器通信：spring-doc.cadn.net.cn

spring.data.redis.ssl.enabled=true
spring:
  data:
    redis:
      ssl:
        enabled: true

自定义的SSL信任材料可以在SSL捆绑中配置并应用于RedisConnection工厂如本例所示：spring-doc.cadn.net.cn

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首先。spring-doc.cadn.net.cn

连接到MongoDB数据库

要访问MongoDB数据库，可以注入一个自动配置的Mongo数据库工厂. 默认情况下，实例尝试连接到 的 MongoDB 服务器mongodb://localhost/test. 以下示例展示了如何连接MongoDB数据库：spring-doc.cadn.net.cn

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")
	}

}

如果你已经定义了自己的Mongo客户端它将用于自动配置合适的Mongo数据库工厂.spring-doc.cadn.net.cn

自动配置Mongo客户端是通过MongoClientSettings豆。 如果你已经定义了自己的MongoClientSettings，将不作修改地使用，且spring.data.mongodb属性将被忽略。 否则MongoClientSettings将自动配置，并且具有spring.data.mongodb属性被应用到它上。 无论哪种情况，你都可以申报一个或多个MongoClientSettingsBuilderCustomizer用来微调MongoClientSettings配置。 每个人将按顺序被叫到，MongoClientSettings.Builder用于构建MongoClientSettings.spring-doc.cadn.net.cn

你可以设置Spring.mongodb.uri属性用于更改URL，并配置其他设置，如副本集，如下例所示：spring-doc.cadn.net.cn

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

或者，你也可以用离散属性来指定连接细节。 例如，你可以在你的application.properties:spring-doc.cadn.net.cn

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

自动配置Mongo客户端可以通过设置属性配置，如本示例所示，配置为使用 SSL 与服务器通信：spring-doc.cadn.net.cn

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

自定义的SSL信任材料可以在SSL捆绑中配置并应用于Mongo客户端如本例所示：spring-doc.cadn.net.cn

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

如果spring.mongodb.port未指定，默认值为27017被使用。 你可以删除之前示例中的这行。spring-doc.cadn.net.cn

你也可以通过使用host：port语法。 如果你需要更改额外主持人进入。spring-doc.cadn.net.cn
如果你不使用 Spring Data MongoDB，可以注入一个Mongo客户端豆子代替使用Mongo数据库工厂. 如果你想完全控制建立 MongoDB 连接，也可以声明自己的连接Mongo数据库工厂或Mongo客户端豆。
如果你使用响应式驱动，Netty 是 SSL 的必需条件。如果 Netty 可用且工厂尚未自定义，自动配置会自动配置该工厂。

Mongo模板

Spring Data MongoDB 提供了Mongo模板该班级的设计与斯普林的课程非常相似Jdbc模板. 如同Jdbc模板Spring Boot 会自动配置一个豆子，让你注入模板，具体如下：spring-doc.cadn.net.cn

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")
	}

}

参见蒙古行动完整细节需参考API文档。spring-doc.cadn.net.cn

Spring Data MongoDB Repositories

Spring Data 支持对 MongoDB 的仓库支持。与之前讨论的 JPA 仓库一样，基本原则是查询是基于方法名称自动构建的。spring-doc.cadn.net.cn

事实上，Spring Data JPA 和 Spring Data MongoDB 共享相同的基础设施。你可以拿之前的 JPA 例子，假设城市现在是MongoDB的数据类，而非JPA@Entity，其工作原理相同，如下例所示：spring-doc.cadn.net.cn

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-doc.cadn.net.cn

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

Neo4j

Neo4j 是一个开源的 NoSQL 图数据库，采用丰富的数据模型，由一类关系连接的节点组成，比传统的关系数据库管理方法更适合连接的大数据。Spring Boot 为使用 Neo4j 提供了多项便利功能，包括Spring-boot-starter-data-neo4j起动机。spring-doc.cadn.net.cn

连接 Neo4j 数据库

要访问 Neo4j 服务器，可以注入自动配置Drivers. 默认情况下，实例尝试连接到 Neo4j 服务器本地主机：7687使用Bolt协议。以下示例展示了如何注射Neo4j。Drivers这不仅让你能访问其他功能，还包括会期:spring-doc.cadn.net.cn

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.Driver
import org.neo4j.driver.TransactionContext
import org.neo4j.driver.Values
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 和凭证：spring-doc.cadn.net.cn

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"

自动配置Drivers是通过org.neo4j.driver.Config$ConfigBuilder. 要微调配置，请声明一个或多个ConfigBuilderCustomizer豆。 每个人将按顺序被叫到，org.neo4j.driver.Config$ConfigBuilder用于构建Drivers.spring-doc.cadn.net.cn

Spring Data Neo4j Repositories

Spring Data 支持 Neo4j 的仓库。有关 Spring Data Neo4j 的完整细节，请参见参考文档。spring-doc.cadn.net.cn

Spring Data Neo4j 与 Spring Data JPA 共享公共基础设施，就像许多其他 Spring Data 模块一样。你可以拿之前的 JPA 例子来定义城市作为Spring Data Neo4j@Node而非JPA@Entity仓库抽象的原理相同，如下示例所示：spring-doc.cadn.net.cn

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?>?

}

这Spring-boot-starter-data-neo4jStarter 支持仓库支持以及事务管理。Spring Boot 支持经典和被动式 Neo4j 仓库，使用Neo4j模板或ReactiveNeo4j模板豆。 当 Project Reactor 在类路径上可用时，响应式样式也会被自动配置。spring-doc.cadn.net.cn

存储库和实体通过扫描被发现。 默认情况下，自动配置包会被扫描。 你可以通过以下方式自定义位置以查找仓库和实体@EnableNeo4jRepositories和@EntityScan分别。spring-doc.cadn.net.cn

在使用响应式样式的应用中，一个ReactiveTransactionManager不是自动配置的。要启用事务管理，必须在配置中定义以下 bean：spring-doc.cadn.net.cn

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 是一个开源的分布式 RESTful 搜索和分析引擎。Spring Boot 为 Elasticsearch 客户端提供了基础的自动配置功能。spring-doc.cadn.net.cn

Spring Boot 支持多个客户端：spring-doc.cadn.net.cn

春季靴提供了一个专门的起始角色，Spring-boot-Starter-data-elasticsearch.spring-doc.cadn.net.cn

使用 REST 客户端连接 Elasticsearch

Elasticsearch提供两个不同的REST客户端，你可以用来查询集群：低级客户端和Java API客户端。Java API客户端由co.elastic.clients：elasticsearch-java模块和低级客户端由co.elastic.clients：elasticsearch-rest5-client模块。 此外，Spring Boot 还支持来自org.springframework.data：spring-data-elasticsearch模块。 默认情况下，客户端会针对目标本地主持：9200. 你可以使用春季.elasticsearch。*进一步调整客户端配置方式，如下例所示：spring-doc.cadn.net.cn

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"

使用 Rest5Client 连接 Elasticsearch

如果你有co.elastic.clients：elasticsearch-rest5-client在类路径上，Spring Boot 会自动配置并注册Rest5客户端豆。 除了之前描述的性质外，还要对Rest5客户端你可以注册任意数量的豆子实现Rest5ClientBuilderCustomizer用于更高级的定制。要完全控制客户端配置，定义一个Rest5ClientBuilder豆。spring-doc.cadn.net.cn

此外，还有嗅探器可以自动配置，自动发现运行中的Elasticsearch集群中的节点，并将其设置为Rest5客户端豆。 你可以进一步调整嗅探器配置如下示例所示：spring-doc.cadn.net.cn

spring.elasticsearch.restclient.sniffer.enabled=true
spring.elasticsearch.restclient.sniffer.interval=10m
spring.elasticsearch.restclient.sniffer.delay-after-failure=30s
spring:
  elasticsearch:
    restclient:
      sniffer:
        enabled: true
        interval: "10m"
        delay-after-failure: "30s"

使用 ElasticsearchClient 连接 ElasticSearch

如果你使用了Spring靴Starters 弹性搜索或已添加co.elastic.clients：elasticsearch-java对于类路径，Spring Boot 会自动配置并注册Elasticsearch客户端豆。spring-doc.cadn.net.cn

这Elasticsearch客户端使用依赖于上述 的传输Rest5客户端. 因此，上述性质可用于配置Elasticsearch客户端. 此外，你可以定义一个Rest5ClientOptions（休息5客户选项）Bean可以进一步控制运输机的行为。spring-doc.cadn.net.cn

使用 ReactiveElasticsearchClient 连接 Elasticsearch

春季数据弹性搜索船ReactiveElasticsearchClient用于以响应式方式查询 Elasticsearch 实例。如果你的类路径上有 Spring Data Elasticsearch 和 Reactor，Spring Boot 会自动配置并注册ReactiveElasticsearchClient.spring-doc.cadn.net.cn

这ReactiveElasticsearchClient使用依赖于上述 的传输Rest5客户端. 因此，上述性质可用于配置ReactiveElasticsearchClient. 此外，你可以定义一个Rest5ClientOptions（休息5客户选项）Bean可以进一步控制运输机的行为。spring-doc.cadn.net.cn

通过使用 Spring 数据连接 Elasticsearch

要连接 Elasticsearch，一个Elasticsearch客户端豆必须被定义，由Spring Boot自动配置，或由应用程序手动提供（见前述部分）。有了该配置，一个弹性搜索模板可以像其他春豆一样注入，如下例所示：spring-doc.cadn.net.cn

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以及反应器，Spring Boot 也可以自动配置ReactiveElasticsearchClient以及一个ReactiveElasticsearch模板作为豆子。它们是其他REST客户端的响应式等价物。spring-doc.cadn.net.cn

Spring Data Elasticsearch 仓库

Spring Data 支持对 Elasticsearch 的仓库支持。与之前讨论的 JPA 仓库一样，基本原则是查询是基于方法名自动构建的。spring-doc.cadn.net.cn

事实上，Spring Data JPA 和 Spring Data Elasticsearch 共享相同的基础设施。你可以以之前的 JPA 例子为例，假设城市现在是一个弹性搜索@Document阶级而非JPA@Entity，原理相同。spring-doc.cadn.net.cn

通过扫描来发现仓库和文档。 默认情况下，自动配置包会被扫描。 你可以通过以下方式自定义查找仓库和文档的位置@EnableElasticsearchRepositories和@EntityScan分别。spring-doc.cadn.net.cn

有关 Spring Data Elasticsearch 的完整细节，请参见参考文档。

Spring Boot 支持经典和响应式 Elasticsearch 仓库，使用弹性搜索模板或ReactiveElasticsearch模板豆。 很可能这些豆子是Spring Boot自动配置的，因为有所需的依赖关系。spring-doc.cadn.net.cn

如果你想用自己的模板来支持Elasticsearch仓库，可以添加自己的模板弹性搜索模板或弹性搜索作 @Bean，只要它被命名为“elasticsearch模板”. 同样的情况也适用于ReactiveElasticsearch模板和响应式弹性搜索作，豆子名称“reactiveElasticsearchTemplate”.spring-doc.cadn.net.cn

你可以选择用以下属性禁用仓库支持：spring-doc.cadn.net.cn

spring.data.elasticsearch.repositories.enabled=false
spring:
  data:
    elasticsearch:
      repositories:
        enabled: false

Cassandra

Cassandra 是一个开源的分布式数据库管理系统，旨在处理跨多个普通服务器的大量数据。Spring Boot 为 Cassandra 及其上层的抽象功能提供自动配置。有一个Spring-boot-starter-data-cassandra方便地收集依赖。spring-doc.cadn.net.cn

连接卡桑德拉

你可以注入一个自动配置Cql模板,卡桑德拉模板或者卡桑德拉CqlSession就像对待其他春豆一样。 这Spring。卡桑德拉。*属性可以用来定制连接。 通常，你会提供keyspace-name和接触点以及本地数据中心名称，如下示例所示：spring-doc.cadn.net.cn

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"

如果所有接触点的端口相同，你可以使用快捷方式只指定主机名，如下例所示：spring-doc.cadn.net.cn

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 与服务器通信：spring-doc.cadn.net.cn

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如本例所示：spring-doc.cadn.net.cn

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-doc.cadn.net.cn

Spring Boot 默认不会查找此类文件，但可以通过以下方式加载spring.cassandra.config. 如果一个性质同时存在于Spring。卡桑德拉。*配置文件中值为Spring。卡桑德拉。*优先。spring-doc.cadn.net.cn

对于更高级的驱动定制，你可以注册任意数量的豆子来实现DriverConfigLoaderBuilderCustomizer. 这CqlSession可以用 类型的 bean 进行自定义CqlSessionBuilderCustomizer.spring-doc.cadn.net.cn
如果你使用，CqlSessionBuilder创建多个CqlSession豆子们，记住构建器是可变的，所以每次游戏都要注入一个新的副本。

以下代码列表展示了如何注射卡桑德拉豆：spring-doc.cadn.net.cn

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)
	}

}

如果你自己加一个@Bean类型卡桑德拉模板，它取代了默认值。spring-doc.cadn.net.cn

Spring Data Cassandra 仓库

Spring Data 包含 Cassandra 的基本仓库支持。 目前，这比之前提到的JPA仓库和需求更为有限@Query注释查找方法。spring-doc.cadn.net.cn

存储库和实体通过扫描被发现。 默认情况下，自动配置包会被扫描。 你可以通过以下方式自定义位置以查找仓库和实体@EnableCassandraRepositories和@EntityScan分别。spring-doc.cadn.net.cn

有关Spring Data Cassandra的完整详情，请参见参考文档。

沙发底座

Couchbase 是一个开源、分布式、多模型的面向 NoSQL 文档数据库，专为交互式应用优化。 Spring Boot 提供 Couchbase 及其上层 Spring Data Couchbase 提供的抽象自动配置。 有Spring-boot-starter-data-couchbase和Spring-boot-starter-data-couchbase-reactive方便地收集依赖的起始工具。spring-doc.cadn.net.cn

连接 Couchbase

你可以买一个簇通过添加 Couchbase SDK 和一些配置。 这Spring.Couchbase。*属性可以用来定制连接。 通常，你需要提供连接字符串和认证凭证。基本的身份验证可以通过以下示例进行配置：spring-doc.cadn.net.cn

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"

客户端证书可以用来做身份验证，而不是用户名和密码。 包含客户端证书的 Java 密钥库的位置和密码可如示例所示配置：spring-doc.cadn.net.cn

spring.couchbase.connection-string=couchbase://192.168.1.123
spring.couchbase.env.ssl.enabled=true
spring.couchbase.authentication.jks.location=classpath:client.p12
spring.couchbase.authentication.jks.password=secret
spring:
  couchbase:
    connection-string: "couchbase://192.168.1.123"
    env:
      ssl:
        enabled: true
    authentication:
      jks:
        location: "classpath:client.p12"
        password: "secret"

PEM编码的证书和私钥可以如下例所示配置：spring-doc.cadn.net.cn

spring.couchbase.connection-string=couchbase://192.168.1.123
spring.couchbase.env.ssl.enabled=true
spring.couchbase.authentication.pem.certificates=classpath:client.crt
spring.couchbase.authentication.pem.private-key=classpath:client.key
spring:
  couchbase:
    connection-string: "couchbase://192.168.1.123"
    env:
      ssl:
        enabled: true
    authentication:
      pem:
        certificates: "classpath:client.crt"
        private-key: "classpath:client.key"

也可以自定义一些集群环境设置。 例如，以下配置更改超时以打开新桶并通过引用配置好的SSL捆绑包，支持SSL：spring-doc.cadn.net.cn

spring.couchbase.env.timeouts.connect=3s
spring.couchbase.env.ssl.bundle=example
spring:
  couchbase:
    env:
      timeouts:
        connect: "3s"
      ssl:
        bundle: "example"
检查一下spring.couchbase.env.*更多细节请见“properties”。 想要获得更多控制权，一个或多个ClusterEnvironmentBuilderCustomizer豆子也可以使用。

Spring Data Couchbase Repositories

Spring Data 支持Couchbase的仓库。spring-doc.cadn.net.cn

通过扫描来发现仓库和文档。 默认情况下，自动配置包会被扫描。 你可以通过以下方式自定义查找仓库和文档的位置@EnableCouchbaseRepositories和@EntityScan分别。spring-doc.cadn.net.cn

有关 Spring Data Couchbase 的完整详情，请参见参考文档。spring-doc.cadn.net.cn

你可以注入一个自动配置沙发底座模板就像对待其他春豆一样，只要CouchbaseClientFactory豆子是有供应的。 当簇如上所述，已指定桶名称：spring-doc.cadn.net.cn

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

以下示例展示了如何注入沙发底座模板豆：spring-doc.cadn.net.cn

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
	}

}

你可以在自己的配置中定义几个豆子，以覆盖自动配置所提供的：spring-doc.cadn.net.cn

为了避免在自己的配置里硬编码这些名字，你可以重复使用。豆名由Spring Data Couchbase提供。 例如，你可以自定义转换器，具体如下：spring-doc.cadn.net.cn

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-doc.cadn.net.cn

LDAP 抽象由 Spring Data LDAP 提供。 有一个Spring-boot-starter-data-ldap方便地收集依赖。spring-doc.cadn.net.cn

连接到LDAP服务器

要连接到LDAP服务器，务必声明对Spring-boot-starter-data-ldap起始者或Spring-LDAP-核心然后在 application.properties 中声明服务器的 URL，如下示例所示：spring-doc.cadn.net.cn

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

如果你需要自定义连接设置，可以使用春.ldap.base和Spring.ldap.base-environment性能。spring-doc.cadn.net.cn

一LdapContextSource是根据这些设置自动配置的。 如果DirContext认证策略BEAN 可用，它关联到自动配置LdapContextSource. 如果你需要自定义，比如用PooledContextSource你仍然可以注入自动配置LdapContextSource. 一定要标记你的定制上下文来源如@Primary因此自动配置LdapTemplate用它。spring-doc.cadn.net.cn

Spring Data LDAP 仓库

Spring Data 支持对 LDAP 的存储库支持。spring-doc.cadn.net.cn

通过扫描来发现仓库和文档。 默认情况下，自动配置包会被扫描。 你可以通过以下方式自定义查找仓库和文档的位置@EnableLdapRepositories和@EntityScan分别。spring-doc.cadn.net.cn

有关Spring Data LDAP的完整细节，请参见参考文档。

你也可以注入自动配置LdapTemplate实例，就像你对待其他春豆一样，如下示例所示：spring-doc.cadn.net.cn

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并声明 aSpring.ldap.embedded.base-dn性质，具体如下：spring-doc.cadn.net.cn

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

可以定义多个基底 dn 值，但由于区分名称通常包含逗号，必须使用正确的符号来定义。spring-doc.cadn.net.cn

在 yaml 文件中，你可以使用 yaml 列表符号。在属性文件中，你必须将索引作为属性名称的一部分：spring-doc.cadn.net.cn

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财产。spring-doc.cadn.net.cn

如果存在schema.ldif你的类路径上的文件，它被用来初始化服务器。 如果你想从其他资源加载初始化脚本，也可以使用spring.ldap.embedded.ldif财产。spring-doc.cadn.net.cn

默认情况下，使用标准模式来验证LIF文件。 你可以通过设置spring.ldap.embedded.validation.enabled财产。 如果你有自定义属性，可以用spring.ldap.embedded.validation.schema用来定义你的自定义属性类型或对象类。spring-doc.cadn.net.cn