springboot整合Nacos组件环境搭建和入门案例详解(最新推荐)

 更新时间:2025年03月04日 09:57:50   作者:飞翔的佩奇  
本文介绍了Nacos的基础概念、关键特性、专业术语和生态圈,如何在Windows环境下搭建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、环境包下载

这里直接下载打包好的文件,也可以下载源码自己打包。

https://github.com/alibaba/nacos/releases

下载文件: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("${spring.application.name}")
    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 ;
    }
}

到此这篇关于springboot整合Nacos组件,环境搭建和入门案例详解的文章就介绍到这了,更多相关springboot Nacos组件内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 浅析Java基于Socket的文件传输案例

    浅析Java基于Socket的文件传输案例

    这篇文章主要针对Java基于Socket的文件传输案例进行详细解析,具有一定的参考价值,感兴趣的朋友可以参考一下
    2016-02-02
  • java swing实现的扫雷游戏及改进版完整示例

    java swing实现的扫雷游戏及改进版完整示例

    这篇文章主要介绍了java swing实现的扫雷游戏及改进版,结合完整实例形式对比分析了java使用swing框架实现扫雷游戏功能与相关操作技巧,需要的朋友可以参考下
    2017-12-12
  • Java 获取当前时间及实现时间倒计时功能【推荐】

    Java 获取当前时间及实现时间倒计时功能【推荐】

    这篇文章主要介绍了Java 获取当前时间及实现时间倒计时功能 ,本文通过实例代码给大家介绍的非常详细,具有一定的参考借鉴价值,需要的朋友可以参考下
    2019-05-05
  • Java常用工具类—集合排序

    Java常用工具类—集合排序

    这篇文章主要介绍了Java集合排序,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-03-03
  • java学生信息管理系统设计(2)

    java学生信息管理系统设计(2)

    这篇文章主要为大家详细介绍了java学生信息管理系统设计,学生信息添加进入数据库的事务,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2016-11-11
  • Idea如何集成Git&添加项目到git仓库

    Idea如何集成Git&添加项目到git仓库

    这篇文章主要介绍了Idea如何集成Git&添加项目到git仓库,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2023-12-12
  • 如何利用Spring的@Import扩展点与spring进行无缝整合

    如何利用Spring的@Import扩展点与spring进行无缝整合

    这篇文章主要介绍了如何利用Spring的@Import扩展点与spring进行无缝整合的实例代码,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-08-08
  • 详解Java POI excel自定义设置单元格格式

    详解Java POI excel自定义设置单元格格式

    这篇文章主要介绍了Java POI excel设置单元格格式,自定义设置,设置单元格格式:来源_formats,更多数据类型从formats里面发现,需要的朋友可以参考下
    2024-01-01
  • SpringBoot轻松实现ip解析(含源码)

    SpringBoot轻松实现ip解析(含源码)

    IP地址一般以数字形式表示,如192.168.0.1,IP解析是将这个数字IP转换为包含地区、城市、运营商等信息的字符串形式,如“广东省深圳市 电信”,这样更方便人理解和使用,本文给大家介绍了SpringBoot如何轻松实现ip解析,需要的朋友可以参考下
    2023-10-10
  • SpringBoot开启server:compression:enabled(Illegal character ((CTRL-CHAR, code 31)))的问题解决

    SpringBoot开启server:compression:enabled(Illegal characte

    本文主要介绍了SpringBoot开启server:compression:enabled(Illegal character ((CTRL-CHAR, code 31)))的的问题解决,具有一定的参考价值,感兴趣的可以了解一下
    2025-03-03

最新评论