SpringBoot2整合Nacos组件，环境搭建和入门案例详解

SpringBoot2整合Nacos组件，环境搭建和⼊门案例详解
本⽂源码： ||
⼀、Nacos基础简介
1、概念简介
Nacos 是构建以“服务”为中⼼的现代应⽤架构，如微服务范式、云原⽣范式等服务基础设施。

聚焦于发现、配置和管理微服务。

Nacos提供⼀组简单易⽤的特性集，帮助开发者快速实现动态服务发现、服务配置、服务元数据及流量管理。

敏捷构建、交付和管理微服务平台。

2、关键特性
动态配置服务
服务发现和服务健康监测
动态 DNS 服务
服务及其元数据管理
3、专业术语解释
命名空间
⽤于进⾏租户粒度的配置隔离。

不同的命名空间下，可以存在相同的 Group 或 Data ID 的配置。

配置集
⼀组相关或者不相关的配置项的集合称为配置集。

在系统中，⼀个配置⽂件通常就是⼀个配置集，包含了系统各个⽅⾯的配置。

配置集 ID
Nacos 中的某个配置集的ID。

配置集ID是组织划分配置的维度之⼀。

DataID通常⽤于组织划分系统的配置集。

配置分组
Nacos 中的⼀组配置集，是组织配置的维度之⼀。

通过⼀个有意义的字符串对配置集进⾏（Group）分组，从⽽区分 Data ID 相同的配置集。

配置快照
Nacos 的客户端 SDK 会在本地⽣成配置的快照。

当客户端⽆法连接到 Nacos Server 时，可以使⽤配置快照显⽰系统的整体容灾能⼒。

服务注册
存储服务实例和服务负载均衡策略的数据库。

服务发现
使⽤服务名对服务下的实例的地址和元数据进⾏探测，并以预先定义的接⼝提供给客户端进⾏查询。

元数据
Nacos数据（如配置和服务）描述信息，如服务版本、权重、容灾策略、负载均衡策略等。

4、Nacos⽣态圈
Nacos ⽆缝⽀持⼀些主流的开源框架⽣态：
Spring Cloud 微服务框架 ;
Dubbo RPC框架 ;
Kubernetes 容器应⽤ ;
⼆、Nacos环境搭建
1、环境版本
这⾥在Windos环境下搭建Nacos单个服务。

Nacos版本：官⽅推荐的稳定版本为1.1.4。

基础环境：JDK 1.8+；Maven 3.2.x
2、环境包下载
这⾥直接下载打包好的⽂件，也可以下载源码⾃⼰打包。

下载⽂件：nacos-server-1.1.4.zip
3、启动环境
启动⽂件地址：nacos\bin
启动⽂件：startup.cmd
关闭⽂件：shutdown.cmd
启动后登陆，账户密码默认：nacos/nacos ;⾸页效果如下：
三、整合SpringBoot2
注意：版本 0.2.x.RELEASE 对应的是 Spring Boot 2.x 版本，版本 0.1.x.RELEASE 对应的是 Spring Boot 1.x 版本。

1、新建配置
2、核⼼依赖
<!-- Nacos 组件依赖 -->
<dependency>
<groupId>com.alibaba.boot</groupId>
<artifactId>nacos-discovery-spring-boot-starter</artifactId>
<version>0.2.3</version>
</dependency>
<dependency>
<groupId>com.alibaba.boot</groupId>
<artifactId>nacos-config-spring-boot-starter</artifactId>
<version>0.2.3</version>
</dependency>
3、Yml配置⽂件
这⾥把项⽬作为服务注册到Nacos中。

nacos:
config:
server-addr: 127.0.0.1:8848
discovery:
server-addr: 127.0.0.1:8848
4、启动类配置
启动类关联配置中⼼的dataId标识。

@EnableSwagger2
@SpringBootApplication
@NacosPropertySource(dataId = "WARE_ID", autoRefreshed = true)
public class Application7017 {
public static void main(String[] args) {
SpringApplication.run(Application7017.class,args) ;
}
}
5、核⼼配置类
import com.alibaba.nacos.api.annotation.NacosInjected;
import com.alibaba.nacos.api.exception.NacosException;
import com.alibaba.nacos.api.naming.NamingService;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Configuration;
import javax.annotation.PostConstruct;
@Configuration
public class NacosConfig {
@Value("${server.port}")
private int serverPort;
@Value("${}")
private String applicationName;
@NacosInjected
private NamingService namingService;
@PostConstruct
public void registerInstance() throws NacosException {
namingService.registerInstance(applicationName, "127.0.0.1", serverPort);
}
}
启动成功后查询服务列表：
6、基础API⽤例
这⾥演⽰两个基础⽤法：上述步骤1的配置内容读取，步骤4的服务列表读取。

基于swagger2管理测试接⼝。

@Api("Nacos接⼝管理")
@RestController
@RequestMapping("/nacos")
public class NacosController {
@NacosValue(value = "${MyName:null}", autoRefreshed = true)
private String myName;
@NacosValue(value = "${project:null}", autoRefreshed = true)
private String project;
@ApiOperation(value="查询配置信息")
@GetMapping(value = "/info")
public String info () {
return myName+":"+project;
}
@NacosInjected
private NamingService namingService;
@ApiOperation(value="查询服务列表")
@GetMapping(value = "/getServerList")
public List<Instance> getServerList (@RequestParam String serviceName) {
try {
return namingService.getAllInstances(serviceName) ;
} catch (Exception e){
e.printStackTrace();
}
return null ;
}
}
四、源代码地址
GitHub·地址
https:///cicadasmile/middle-ware-parent
GitEE·地址
https:///cicadasmile/middle-ware-parent。