1. 快速入门
此快速入门将通过使用 Spring Cloud Zookeeper 进行服务发现和分布式配置来演示。
首先在你的机器上启动Zookeeper。然后你可以访问它并将其用作Spring Cloud Zookeeper的服务注册表和配置源。
1.1. 发现客户端使用
要在应用程序中使用这些功能，您可以将其构建为一个依赖于 spring-cloud-zookeeper-core 和 spring-cloud-zookeeper-discovery 的 Spring Boot 应用程序。添加依赖项最便捷的方式是使用 Spring Boot Starters：org.springframework.cloud:spring-cloud-starter-zookeeper-discovery。我们建议使用依赖管理以及 spring-boot-starter-parent。以下示例展示了一个典型的 Maven 配置：
<project>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>{spring-boot-version}</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
<dependencies>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-zookeeper-discovery</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-dependencies</artifactId>
<version>${spring-cloud.version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>以下示例显示了一个典型的 Gradle 配置：
plugins {
id 'org.springframework.boot' version ${spring-boot-version}
id 'io.spring.dependency-management' version ${spring-dependency-management-version}
id 'java'
}
repositories {
mavenCentral()
}
dependencies {
implementation 'org.springframework.cloud:spring-cloud-starter-zookeeper-discovery'
testImplementation 'org.springframework.boot:spring-boot-starter-test'
}
dependencyManagement {
imports {
mavenBom "org.springframework.cloud:spring-cloud-dependencies:${springCloudVersion}"
}
}| 根据您使用的版本，可能需要调整项目中使用的Apache Zookeeper版本。 您可以阅读更多相关内容，请参阅安装Zookeeper部分。 |
现在您可以创建一个标准的 Spring Boot 应用程序，例如以下 HTTP 服务器：
@SpringBootApplication
@RestController
public class Application {
@GetMapping("/")
public String home() {
return "Hello World!";
}
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
当这个HTTP服务器运行时，它会连接到运行在默认本地端口（2181）上的Zookeeper。
要修改启动行为，可以通过使用application.properties来更改Zookeeper的位置，如下例所示：
spring:
cloud:
zookeeper:
connect-string: localhost:2181
您现在可以使用 DiscoveryClient、@LoadBalanced RestTemplate 或 @LoadBalanced WebClient.Builder 来从 Zookeeper获取服务和实例数据，如下例所示：
@Autowired
private DiscoveryClient discoveryClient;
public String serviceUrl() {
List<ServiceInstance> list = discoveryClient.getInstances("STORES");
if (list != null && list.size() > 0 ) {
return list.get(0).getUri().toString();
}
return null;
}1.2. 分布式配置使用
要在应用程序中使用这些功能，您可以将其构建为一个依赖于 spring-cloud-zookeeper-core 和 spring-cloud-zookeeper-config 的 Spring Boot 应用程序。添加依赖项最便捷的方式是使用 Spring Boot Starters：org.springframework.cloud:spring-cloud-starter-zookeeper-config。我们建议使用依赖管理以及 spring-boot-starter-parent。以下示例展示了一个典型的 Maven 配置：
<project>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>{spring-boot-version}</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
<dependencies>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-zookeeper-config</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-dependencies</artifactId>
<version>${spring-cloud.version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>以下示例显示了一个典型的 Gradle 配置：
plugins {
id 'org.springframework.boot' version ${spring-boot-version}
id 'io.spring.dependency-management' version ${spring-dependency-management-version}
id 'java'
}
repositories {
mavenCentral()
}
dependencies {
implementation 'org.springframework.cloud:spring-cloud-starter-zookeeper-config'
testImplementation 'org.springframework.boot:spring-boot-starter-test'
}
dependencyManagement {
imports {
mavenBom "org.springframework.cloud:spring-cloud-dependencies:${springCloudVersion}"
}
}| 根据您使用的版本，可能需要调整项目中使用的Apache Zookeeper版本。 您可以阅读更多相关内容，请参阅安装Zookeeper部分。 |
现在您可以创建一个标准的 Spring Boot 应用程序，例如以下 HTTP 服务器：
@SpringBootApplication
@RestController
public class Application {
@GetMapping("/")
public String home() {
return "Hello World!";
}
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
该应用程序从Zookeeper检索配置数据。
如果使用 Spring Cloud Zookeeper Config，需要将 spring.config.import 属性设置为绑定到 Zookeeper。
你可以在 Spring Boot 配置数据导入部分 了解更多相关信息。 |