轉載自 Nacos Spring Cloud 快速開始

本文主要面向?Spring Cloud?的使用者，通過兩個示例來介紹如何使用 Nacos 來實現分布式環境下的配置管理和服務注冊發現。

關于 Nacos Spring Cloud 的詳細文檔請參看：Nacos Config?和?Nacos Discovery。

• 通過 Nacos Server 和 spring-cloud-starter-alibaba-nacos-config 實現配置的動態變更。
• 通過 Nacos Server 和 spring-cloud-starter-alibaba-nacos-discovery 實現服務的注冊與發現。

前提條件

您需要先下載 Nacos 并啟動 Nacos server。操作步驟參見?Nacos 快速入門

啟動配置管理

啟動了 Nacos server 后，您就可以參考以下示例代碼，為您的 Spring Cloud 應用啟動 Nacos 配置管理服務了。完整示例代碼請參考：nacos-spring-cloud-config-example

添加依賴：

<dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId><version>${latest.version}</version> </dependency>

注意：版本?2.1.x.RELEASE?對應的是 Spring Boot 2.1.x 版本。版本?2.0.x.RELEASE?對應的是 Spring Boot 2.0.x 版本，版本?1.5.x.RELEASE?對應的是 Spring Boot 1.5.x 版本。

更多版本對應關系參考：版本說明 Wiki

在?bootstrap.properties?中配置 Nacos server 的地址和應用名

spring.cloud.nacos.config.server-addr=127.0.0.1:8848spring.application.name=example

說明：之所以需要配置?spring.application.name?，是因為它是構成 Nacos 配置管理?dataId字段的一部分。

在 Nacos Spring Cloud 中，dataId?的完整格式如下：

${prefix}-${spring.profiles.active}.${file-extension}

• prefix?默認為?spring.application.name?的值，也可以通過配置項?spring.cloud.nacos.config.prefix來配置。
• spring.profiles.active?即為當前環境對應的 profile，詳情可以參考?Spring Boot文檔。?注意：當?spring.profiles.active?為空時，對應的連接符?-?也將不存在，dataId 的拼接格式變成?${prefix}.${file-extension}
• file-exetension?為配置內容的數據格式，可以通過配置項?spring.cloud.nacos.config.file-extension?來配置。目前只支持?properties?和?yaml?類型。

通過 Spring Cloud 原生注解?@RefreshScope?實現配置自動更新：

@RestController @RequestMapping("/config") @RefreshScope public class ConfigController {@Value("${useLocalCache:false}")private boolean useLocalCache;@RequestMapping("/get")public boolean get() {return useLocalCache;} }

首先通過調用?Nacos Open API?向 Nacos Server 發布配置：dataId 為example.properties，內容為useLocalCache=true

curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=example.properties&group=DEFAULT_GROUP&content=useLocalCache=true"

運行?NacosConfigApplication，調用?curl http://localhost:8080/config/get，返回內容是?true。

再次調用?Nacos Open API?向 Nacos server 發布配置：dataId 為example.properties，內容為useLocalCache=false

curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=example.properties&group=DEFAULT_GROUP&content=useLocalCache=false"

再次訪問?http://localhost:8080/config/get，此時返回內容為false，說明程序中的useLocalCache值已經被動態更新了。

啟動服務發現

本節通過實現一個簡單的?echo service?演示如何在您的 Spring Cloud 項目中啟用 Nacos 的服務發現功能，如下圖示:

完整示例代碼請參考：nacos-spring-cloud-discovery-example

添加依賴：

<dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId><version>${latest.version}</version> </dependency>

注意：版本?2.1.x.RELEASE?對應的是 Spring Boot 2.1.x 版本。版本?2.0.x.RELEASE?對應的是 Spring Boot 2.0.x 版本，版本?1.5.x.RELEASE?對應的是 Spring Boot 1.5.x 版本。

更多版本對應關系參考：版本說明 Wiki

配置服務提供者，從而服務提供者可以通過 Nacos 的服務注冊發現功能將其服務注冊到 Nacos server 上。

i. 在?application.properties?中配置 Nacos server 的地址：

server.port=8070 spring.application.name=service-providerspring.cloud.nacos.discovery.server-addr=127.0.0.1:8848

ii. 通過 Spring Cloud 原生注解?@EnableDiscoveryClient?開啟服務注冊發現功能：

@SpringBootApplication @EnableDiscoveryClient public class NacosProviderApplication {public static void main(String[] args) {SpringApplication.run(NacosProviderApplication.class, args);}@RestControllerclass EchoController {@RequestMapping(value = "/echo/{string}", method = RequestMethod.GET)public String echo(@PathVariable String string) {return "Hello Nacos Discovery " + string;}} }

配置服務消費者，從而服務消費者可以通過 Nacos 的服務注冊發現功能從 Nacos server 上獲取到它要調用的服務。

i. 在?application.properties?中配置 Nacos server 的地址：

server.port=8080 spring.application.name=service-consumerspring.cloud.nacos.discovery.server-addr=127.0.0.1:8848

ii. 通過 Spring Cloud 原生注解?@EnableDiscoveryClient?開啟服務注冊發現功能。給?RestTemplate?實例添加?@LoadBalanced?注解，開啟?@LoadBalanced?與?Ribbon?的集成：

@SpringBootApplication @EnableDiscoveryClient public class NacosConsumerApplication {@LoadBalanced@Beanpublic RestTemplate restTemplate() {return new RestTemplate();}public static void main(String[] args) {SpringApplication.run(NacosConsumerApplication.class, args);}@RestControllerpublic class TestController {private final RestTemplate restTemplate;@Autowiredpublic TestController(RestTemplate restTemplate) {this.restTemplate = restTemplate;}@RequestMapping(value = "/echo/{str}", method = RequestMethod.GET)public String echo(@PathVariable String str) {return restTemplate.getForObject("http://service-provider/echo/" + str, String.class);}} }

啟動?ProviderApplication?和?ConsumerApplication?，調用?http://localhost:8080/echo/2018，返回內容為?Hello Nacos Discovery 2018。

相關項目

• Nacos
• Nacos Spring
• Nacos Spring Boot
• Spring Cloud Alibaba

總結

以上是生活随笔為你收集整理的Nacos（七）之Spring Cloud集成的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。