基本介绍
- Spring集成Nacos之前需要下载Nacos并启动Nacos server
- 通过Nacos server和Nacos Spring配置管理模块,实现配置的动态变更
- 通过Nacos server和Nacos Spring服务发现模块,实现服务的注册与发现
配置管理
- 启动Nacos server后,为Spring应用启动Nacos配置管理服务
- 添加nacos-spring-context依赖:
<dependency>
<groupId>com.alibaba.nacos</groupId>
<artifactId>nacos-spring-context</artifactId>
<version>0.3.6</version>
</dependency>
- 启用Nacos Spring的配置管理服务:
- 添加 @EnableNacosConfig注解
- 使用 @NacosPropertySource加载dataId为nacosConfigs的配置源,并开启自动更新
@Configuration
@EnableNacosConfig(globalProperties = @NacosProperties(serverAddr = "127.0.0.1:8848"))
@NacosPropertySource(dataId = "nacosConfigs", autoRefreshed = true)
public class NacosConfiguration {
}
- 设置Nacos属性值: 通过Nacos的 @NacosValue注解设置属性值
@Controller
@RequestMapping("config")
public class ConfigController {
@NacosValue(value = "${useLocalCache:false}", autoRefreshed = true)
private boolean useLocalCache;
@RequestMapping(value = "/get", method = GET)
@ResponseBody
public boolean get() {
return useLocalCache;
}
}
- 获取配置信息:
- 启动Tomcat, 调用curl http://localhost:8080/config/get尝试获取配置信息
- 由于此时还未发布过配置,所以返回内容是false
- 发布配置信息:
- 通过调用Nacos Open API向Nacos Server发布配置
- dataId为nacosConfigs
- 内容为useLocalCache=true
curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacosConfigs&group=DEFAULT_GROUP&content=useLocalCache=true"
- 获取动态变更的配置信息:
- 再次调用curl http://localhost:8080/config/get获取配置信息
- 此时返回内容为true, 说明程序中的useLocalCache值已经被动态更新
服务发现与注册
- 添加nacos-spring-context依赖:
<dependency>
<groupId>com.alibaba.nacos</groupId>
<artifactId>nacos-spring-context</artifactId>
<version>0.3.6</version>
</dependency>
- 通过添加 @EnableNacosDiscovery注解开启Nacos Spring的服务发现功能
@Configuration
@EnableNacosDiscovery(globalProperties = @NacosProperties(serverAddr = "127.0.0.1:8848"))
public class NacosConfiguration {
}
- 使用 @NacosInjected注入Nacos的Service实例NamingService:
@Controller
@RequestMapping("discovery")
public class DiscoveryController {
@NacosInjected
private NamingService namingService;
@RequestMapping(value = "/get", method = GET)
@ResponseBody
public List<Instance> get(@RequestParam String serviceName) throws NacosException {
return namingService.getAllInstances(serviceName);
}
}
- 获取服务实例,发现服务:
- 启动Tomcat, 调用curl http://localhost:8080/discovery/get?serviceName=namingService. 此时返回空JSON数组
- 注册服务:
- 通过Nacos Open API向Nacos server注册一个名为namingService服务
curl -X PUT 'http://127.0.0.1:8848/nacos/v1/ns/instance?serviceName=example&ip=127.0.0.1&port=8080'
- 发现动态注册的服务实例:
- 再次访问curl http://localhost:8080/discovery/get?serviceName=namingService, 返回服务实例内容:
[
{
"instanceId": "127.0.0.1#8080#DEFAULT#example",
"ip": "127.0.0.1",
"port": 8080,
"weight": 1.0,
"healthy": true,
"cluster": {
"serviceName": null,
"name": "",
"healthChecker": {
"type": "TCP"
},
"defaultPort": 80,
"defaultCheckPort": 80,
"useIPPort4Check": true,
"metadata": {}
},
"service": null,
"metadata": {}
}
]