AI 助理
备案控制台登录注册
开发者社区 微服务 文章 正文

【Nacos系列第一篇】-Nacos之Spring Discovery 以及Config

2019-03-01 6045
版权
举报
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介： 作者：毕来生 【Nacos系列第一篇】-Nacos之Spring Discovery 以及Config
作者：毕来生

前言

​ 个人比较看好Spring Cloud Alibaba家族。此系列以Nacos为主题，从Spring、Spring boot、Spring Cloud多个方面逐步进行演示，源码解读。目前来看官方文档还有待完善。网络上除了官网外缺少Nacos系列文章。都是零零散散的知识点。如此系列文章哪里写的有不周全，错误之处。欢迎大家指正。谢谢。

​ 因公众号排版问题，可能会有代码显示不完整，请使用电脑版微信内置浏览器/复制链接到浏览器中。

1、Nacos是什么？

来自官网提供Nacos说明

服务（Service）是 Nacos 世界的一等公民。Nacos 支持几乎所有主流类型的“服务”的发现、配置和管理：

Kubernetes Service

gRPC & Dubbo RPC Service

Spring Cloud RESTful Service

Nacos 的关键特性包括一下等等:

  • 服务发现和服务健康监测
  • 动态配置服务
  • 动态 DNS 服务
  • 服务及其元数据管理

Nacos架构图

在这里插入图片描述

2、准备工作

工具：IDEA2018.3 、JDK： 1.8、Maven:3.5（通用配置。后续不在提及此部分。均已此版本演示）

Nacos：0.7.0(写此文章时最新版本，如后续更新。以最新版本给大家演示)

环境：Windows（演示用，后续更新完成后会有一章在linux下演示。有坑，但原理一样。不多赘述。）

Nacos稳定版本：https://github.com/alibaba/nacos/releases

Linux下请下载tar后解压。Windows下请下载zip。

  unzip nacos-server-$version.zip 或者 tar -xvf nacos-server-$version.tar.gz

        

          
        

        
        

          

          AI 代码解读

下载后启动Nacos。Nacos默认启动端口为8848，意为珠穆朗玛峰高度。如启动有端口冲突，请自行调整端口。

3、工程结构

上面说了那么多，现在先整理来看一下我们的工程结构
在这里插入图片描述

附上关键部分代码。

NacosConfiguration

package org.nacos.spring;

import com.alibaba.nacos.api.annotation.NacosProperties;
import com.alibaba.nacos.spring.context.annotation.config.NacosPropertySource;
import com.alibaba.nacos.spring.context.annotation.discovery.EnableNacosDiscovery;
import org.springframework.beans.factory.annotation.Configurable;

/**
 * @Author: bilaisheng
 * @Wechat: 878799579
 * @Date: 2019/1/13 19:28
 * @Todo: NacosConfiguration,用以注册以及测试Service Name ： nacos-spring
 * @Version : JDK1.8 , IDEA2018
 */
@Configurable
@EnableNacosConfig(globalProperties = @NacosProperties(serverAddr = "127.0.0.1:8848"))
@NacosPropertySource(dataId = "nacos-spring", autoRefreshed = true)
public class NacosConfiguration {
}

        

          
        

        
        

          

          AI 代码解读
  • @EnableNacosConfig 注解启用 Nacos Spring 的配置管理服务。
  • @NacosPropertySource 加载了 dataId 为 nacos-spring`的配置源，并开启自动更新。
  • 对 Nacos Spring 的用户来说，在自身应用中就只是设置 “autoRefreshed” 的一个布尔值。然后在需要修改配置的时候，调用 Nacos 修改配置的接口，或使用 Nacos 的控制台去修改，配置发生变更后， Nacos 就会把最新的配置推送到该应用的所有机器上。

NacosDiscoveryController

package org.nacos.spring.controller;

import com.alibaba.nacos.api.annotation.NacosInjected;
import com.alibaba.nacos.api.config.annotation.NacosValue;
import com.alibaba.nacos.api.exception.NacosException;
import com.alibaba.nacos.api.naming.NamingService;
import com.alibaba.nacos.api.naming.pojo.Instance;
import com.alibaba.nacos.spring.context.annotation.discovery.EnableNacosDiscovery;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.ResponseBody;

import java.util.Date;
import java.util.List;

import static org.springframework.web.bind.annotation.RequestMethod.GET;

/**
 * @Author: bilaisheng
 * @Wechat: 878799579
 * @Date: 2019/1/13 19:29
 * @Todo: NacosDisCoveryTest
 * @Version : JDK1.8 , IDEA2018
 */
@Controller
@RequestMapping("nacos")
public class NacosDiscoveryController {

    @NacosInjected
    private NamingService namingService;

    @NacosValue(value = "${useLocalCache:false}", autoRefreshed = true)
    private boolean useLocalCache;

    @RequestMapping("/{str}")
    public String helloNacos(@PathVariable String str){
        return new Date() + "Hello Nacos " + str;
    }

    @RequestMapping("/instance")
    @ResponseBody
    public List<Instance> getInstance(@PathVariable  String serviceName) throws NacosException {
        return namingService.getAllInstances(serviceName);
    }

    @RequestMapping(value = "/get", method = GET)
    @ResponseBody
    public boolean get() {
        return useLocalCache;
    }
}

        

          
        

        
        

          

          AI 代码解读

​ 此文件为普通Spring映射控制器，话说Nacos Spring还是小马哥@mercyblitz亲自操刀。大家可以不用怀疑质量啦。相信很多同学都快被小马哥逼的要劝退了。

​ 着重说明一下，这个也是Nacos中常用的方法之一。

    @RequestMapping("/instance")
    @ResponseBody
    public List<Instance> getInstance(@PathVariable  String serviceName) throws NacosException {
        return namingService.getAllInstances(serviceName);
    }

        

          
        

        
        

          

          AI 代码解读
获取全部实例 
List<Instance> getAllInstances(String serviceName) throws NacosException;

List<Instance> getAllInstances(String serviceName, List<String> clusters) throws NacosException;

        

          
        

        
        

          

          AI 代码解读

请求参数

名称 类型 描述
serviceName 字符串 服务名
clusters List 集群列表

返回参数

List 实例列表。

获取配置

描述

用于服务启动的时候从 Nacos 获取配置。

public String getConfig(String dataId, String group, long timeoutMs) throws NacosException

        

          
        

        
        

          

          AI 代码解读

请求参数

参数名 参数类型 描述
dataId string 配置 ID，采用类似 package.class（如com.taobao.tc.refund.log.level）的命名规则保证全局唯一性，class 部分建议是配置的业务含义。全部字符小写。只允许英文字符和 4 种特殊字符（"."、":"、"-"、"_"），不超过 256 字节。
group string 配置分组，建议填写产品名:模块名（Nacos:Test）保证唯一性，只允许英文字符和4种特殊字符（"."、":"、"-"、"_"），不超过128字节。
timeout long 读取配置超时时间，单位 ms，推荐值 3000。

返回值

参数类型 描述
string 配置值

请求示例

try {
    String serverAddr = "{serverAddr}";
    String dataId = "{dataId}";
    String group = "{group}";
    Properties properties = new Properties();
    properties.put("serverAddr", serverAddr);
    ConfigService configService = NacosFactory.createConfigService(properties);
    String content = configService.getConfig(dataId, group, 5000);
    System.out.println(content);
} catch (NacosException e) {
    // TODO Auto-generated catch block
    e.printStackTrace();
}

        

          
        

        
        

          

          AI 代码解读

​

​ 上述两个文件中关于Nacos使用，请参考官网NacosSDK。里面详细标注了每个方法以及对应参数以及测试案例。

父pom.xml

<?xml version="1.0" encoding="UTF-8"?>

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>org.bilaisheng.nacos</groupId>
  <artifactId>nacos-spring-examples</artifactId>
  <packaging>pom</packaging>
  <version>1.0-SNAPSHOT</version>
  <modules>
    <module>nacos-spring-discvoery</module>
  </modules>

  <name>nacos-spring-examples</name>

  <properties>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <spring.framework.version>5.1.3.RELEASE</spring.framework.version>
    <servlet-api.version>4.0.1</servlet-api.version>
    <nacos-spring-context.version>0.2.2-RC1</nacos-spring-context.version>
  </properties>

  <dependencyManagement>
    <dependencies>
      <!-- https://mvnrepository.com/artifact/javax.servlet/javax.servlet-api -->
      <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
        <version>${servlet-api.version}</version>
        <scope>provided</scope>
      </dependency>

      <!-- https://mvnrepository.com/artifact/org.springframework/spring-core -->
      <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-core</artifactId>
        <version>${spring.framework.version}</version>
      </dependency>

      <!-- https://mvnrepository.com/artifact/org.springframework/spring-context -->
      <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-context</artifactId>
        <version>${spring.framework.version}</version>
      </dependency>

      <!-- https://mvnrepository.com/artifact/org.springframework/spring-webmvc -->
      <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>${spring.framework.version}</version>
      </dependency>

      <!-- https://mvnrepository.com/artifact/com.alibaba.nacos/nacos-spring-context -->
      <dependency>
        <groupId>com.alibaba.nacos</groupId>
        <artifactId>nacos-spring-context</artifactId>
        <version>${nacos-spring-context.version}</version>
      </dependency>

    </dependencies>
  </dependencyManagement>
</project>


        

          
        

        
        

          

          AI 代码解读

本工程pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <artifactId>nacos-spring-examples</artifactId>
        <groupId>org.bilaisheng.nacos</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>nacos-spring-discvoery</artifactId>
    <dependencies>
        <!-- https://mvnrepository.com/artifact/javax.servlet/javax.servlet-api -->
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
        </dependency>

        <!-- https://mvnrepository.com/artifact/org.springframework/spring-webmvc -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
        </dependency>

        <!-- https://mvnrepository.com/artifact/com.alibaba.nacos/nacos-spring-context -->
        <dependency>
            <groupId>com.alibaba.nacos</groupId>
            <artifactId>nacos-spring-context</artifactId>
        </dependency>
    </dependencies>
</project>

        

          
        

        
        

          

          AI 代码解读

页面请求

页面请求同普通Spring相同，启动后根据http://ip:端口/controller/xxx。

喜欢就关注我吧

在这里插入图片描述

文章标签：
Java
Nacos
Spring
Apache
关键词：
Spring nacos
spring配置审计
Spring config
nacos配置审计
nacos spring
毕来生
+关注
172文章21问答
目录
打赏
0
0
0
1
934
分享
相关文章
蓝易云
|
2月前
|
Cloud Native Java Nacos
springcloud/springboot集成NACOS 做注册和配置中心以及nacos源码分析
通过本文，我们详细介绍了如何在 Spring Cloud 和 Spring Boot 中集成 Nacos 进行服务注册和配置管理，并对 Nacos 的源码进行了初步分析。Nacos 作为一个强大的服务注册和配置管理平台，为微服务架构提供
蓝易云
579 14
阿里云云原生
|
5月前
|
存储 人工智能 Java
Spring AI Alibaba 配置管理，用 Nacos 就够了
本文通过一些实操案例展示了 Spring AI Alibaba + Nacos 在解决 AI 应用中一系列复杂配置管理挑战的方案，从动态 Prompt 模板的灵活调整、模型参数的即时优化，到敏感信息的安全加密存储。Spring AI Alibaba 简化了对接阿里云通义大模型的流程，内置 Nacos 集成也为开发者提供了无缝衔接云端配置托管的捷径，整体上极大提升了 AI 应用开发的灵活性和响应速度。
阿里云云原生
880 81
蓝易云
|
3月前
|
监控 Java Nacos
使用Spring Boot集成Nacos
通过上述步骤，Spring Boot应用可以成功集成Nacos，利用Nacos的服务发现和配置管理功能来提升微服务架构的灵活性和可维护性。通过这种集成，开发者可以更高效地管理和部署微服务。
蓝易云
602 17
土木林森
|
8月前
|
Cloud Native Java Nacos
微服务时代的新宠儿！Spring Cloud Nacos实战指南，带你玩转服务发现与配置管理，拥抱云原生潮流！
【8月更文挑战第29天】Spring Cloud Nacos作为微服务架构中的新兴之星，凭借其轻量、高效的特点，迅速成为服务发现、配置管理和治理的首选方案。Nacos（命名和配置服务）由阿里巴巴开源，为云原生应用提供了动态服务发现及配置管理等功能，简化了服务间的调用与依赖管理。本文将指导你通过五个步骤在Spring Boot项目中集成Nacos，实现服务注册、发现及配置动态管理，从而轻松搭建出高效的微服务环境。
土木林森
412 0
土木林森
|
7月前
|
Java 开发工具 对象存储
简化配置管理：Spring Cloud Config与Netflix OSS中的动态配置解决方案
简化配置管理：Spring Cloud Config与Netflix OSS中的动态配置解决方案
土木林森
125 2
FeelTouchLabs
|
8月前
|
Cloud Native Java Nacos
Spring Cloud Config、Apollo、Nacos和Archaius对比
这篇文章对比了Spring Cloud Config、Apollo、Nacos和Archaius这四种配置中心的适应场景、优缺点。文中讨论了它们的功能特点，例如Spring Cloud Config的集中化配置管理和动态刷新能力，Apollo的实时配置推送和权限治理，Nacos的服务发现和管理功能，以及Archaius的动态配置更新能力。文章指出选择配置中心应根据项目需求和架构来决定，并提供了一个对比图来帮助读者更直观地理解这些工具的差异。
FeelTouchLabs
237 1
Spring Cloud Config、Apollo、Nacos和Archaius对比
william.zhang(张)
|
8月前
|
运维 Java Nacos
Spring Cloud应用框架：Nacos作为服务注册中心和配置中心
Spring Cloud应用框架：Nacos作为服务注册中心和配置中心
william.zhang(张)
178 1
土木林森
|
8月前
|
Dubbo Java Nacos
【实战攻略】破解Dubbo+Nacos+Spring Boot 3 Native打包后运行异常的终极秘籍——从零开始彻底攻克那些让你头疼不已的技术难题！
【8月更文挑战第15天】Nacos作为微服务注册与配置中心受到欢迎，但使用Dubbo+Nacos+Spring Boot 3进行GraalVM native打包后常遇运行异常。本文剖析此问题及其解决策略：确认GraalVM版本兼容性；配置反射列表以支持必要类和方法；采用静态代理替代动态代理；检查并调整配置文件；禁用不支持的功能；利用日志和GraalVM诊断工具定位问题；根据诊断结果调整GraalVM配置。通过系统排查方法，能有效解决此类问题，确保服务稳定运行。
土木林森
209 0
程序猿DD
|
Java Nacos Spring
Spring Cloud Alibaba基础教程：Nacos配置的加载规则详解
上一篇，我们学习了如何在Nacos中创建配置，以及如何使用Spring Cloud Alibaba的Nacos客户端模块来加载配置。在入门例子中，我们只配置了Nacos的地址信息，没有配置任何其他与配置加载相关的其他内容。
程序猿DD
3431 0
Quan_Chen
|
1月前
|
XML Java 数据库连接
微服务——SpringBoot使用归纳——Spring Boot集成MyBatis——基于 xml 的整合
本教程介绍了基于XML的MyBatis整合方式。首先在`application.yml`中配置XML路径，如`classpath:mapper/*.xml`，然后创建`UserMapper.xml`文件定义SQL映射，包括`resultMap`和查询语句。通过设置`namespace`关联Mapper接口，实现如`getUserByName`的方法。Controller层调用Service完成测试，访问`/getUserByName/{name}`即可返回用户信息。为简化Mapper扫描，推荐在Spring Boot启动类用`@MapperScan`注解指定包路径避免逐个添加`@Mapper`
Quan_Chen
65 0

热门文章

最新文章

  • 1
    RAG 调优指南：Spring AI Alibaba 模块化 RAG 原理与使用
    72
  • 2
    Java版Manus实现来了，Spring AI Alibaba发布开源OpenManus实现
    83
  • 3
    Java程序员在AI时代必会的技术：Spring AI
    52
  • 4
    使用Spring AI调用AI模型
    25
  • 5
    Spring AI与DeepSeek实战三：打造企业知识库
    39
  • 6
    Spring AI与DeepSeek实战四：系统API调用
    51
  • 7
    使用 Ollama 本地模型与 Spring AI Alibaba 的强强结合，打造下一代 RAG 应用
    15
  • 8
    Spring 和 Spring Boot 之间的比较
    26
  • 9
    智慧班牌源码，采用Java + Spring Boot后端框架，搭配Vue2前端技术，支持SaaS云部署
    25
  • 10
    深入理解 Spring Boot 中日期时间格式化：@DateTimeFormat 与 @JsonFormat 完整实践
    24
  • 1
    nacos配置管理拉取不到配置异常
    404
  • 2
    inishConnect(..) failed: Connection refused，服务本地正常服务器网关报400，nacos服务实例不能下线
    174
  • 3
    有了k8s还需要gateway网关，nacos配置中心吗
    487
  • 4
    Nacos客户端配置错误检查
    334
  • 5
    登录nacos客户端提示no message available
    386
  • 6
    黑马头条01，环境搭建，今日头条的介绍，今日头条的功能架构图，技术栈的说明，服务层，nacos（奶靠丝）安装，安装在Linux服务器上环境准备，
    217
  • 7
    Docker 部署 Nacos 集群
    390
  • 8
    Nacos 集群部署过程中,常见的问题
    163
  • 9
    Nacos 集群部署时性能优化配置
    330
  • 10
    Nacos 的配置过程
    123

    • 相关课程

    更多
  • 精通Spring Cloud Alibaba
  • 微服务框架 Spring Cloud 快速入门
  • 微服务实战-分布式配置中心 - Config
  • Java Web开发系列课程 - Spring框架入门
  • Spring Boot 2.5.x开发实战
  • Spring Cloud微服务架构设计与开发实战

    • 相关电子书

    更多
  • 云栖社区特邀专家徐雷Java Spring Boot开发实战系列课程（第20讲）：经典面试题与阿里等名企内部招聘求职面试技巧
  • 微服务架构模式与原理Spring Cloud开发实战
  • 阿里特邀专家徐雷Java Spring Boot开发实战系列课程（第18讲）：制作Java Docker镜像与推送到DockerHub和阿里云Docker仓库

    • 相关实验场景

    更多
  • Spring-cloud-bus-rocketmq入门与实践
  • Spring-cloud-stream-binder-rocketmq入门与实践
  • 从零搭建Spring Boot的Hello World
    • 下一篇
    oss创建bucket
    目录
    AI助理

    你好，我是AI助理

    可以解答问题、推荐解决方案等