Nacos系列---【SpringCloudAlibaba集成Nacos最佳实践】

1.引入maven坐标

父pom.xml

<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>

  <parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.6.13</version>
  </parent>

  <groupId>com.demo</groupId>
  <artifactId>fast-cloud</artifactId>
  <version>1.0-SNAPSHOT</version>
  <packaging>pom</packaging>

  <name>fast-cloud-2021.x-2.6.13</name>
  <url>脚手架模板项目</url>

  <modules>
    <module>fast-service</module>
    <module>fast-gateway</module>
    <module>fast-service-api</module>
    <module>fast-common</module>
  </modules>

  <properties>
    <spring-cloud-alibaba.version>2021.0.5.0</spring-cloud-alibaba.version>
    <spring-cloud.version>2021.0.5</spring-cloud.version>
  </properties>
  <dependencies>
    <dependency>
      <groupId>org.projectlombok</groupId>
      <artifactId>lombok</artifactId>
    </dependency>
  </dependencies>

  <dependencyManagement>
    <dependencies>
      <!--gateway是由springcloud开发的，所以要引入springcloud依赖-->
      <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-dependencies</artifactId>
        <version>${spring-cloud.version}</version>
        <type>pom</type>
        <scope>import</scope>
      </dependency>
      <dependency>
        <groupId>com.alibaba.cloud</groupId>
        <artifactId>spring-cloud-alibaba-dependencies</artifactId>
        <version>${spring-cloud-alibaba.version}</version>
        <type>pom</type>
        <scope>import</scope>
      </dependency>
    </dependencies>
  </dependencyManagement>
</project>

fast-gateway的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>
    <parent>
        <groupId>com.demo</groupId>
        <artifactId>fast-cloud-2021.x-2.6.13</artifactId>
        <version>1.0-SNAPSHOT</version>
    </parent>

    <artifactId>fast-gateway</artifactId>

    <properties>
        <maven.compiler.source>8</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>
    <dependencies>
        <!--gateway是由springcloud开发的，所以要引入springcloud依赖；网关是由webflux+netty+reactor开发的，所以不需要tomcat，不需要starter-web-->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-gateway</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-loadbalancer</artifactId>
        </dependency>
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
        </dependency>
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
        </dependency>
    </dependencies>

</project>

2.引入通用配置文件(基本不用改)

除了nacos信息和root.name需要修改,其他的都不用改，项目想启动什么环境，修改active就行。后续可以把active从pom中取，就更优雅了，留给你自己完成吧。如果父子项目只有两级，root.name也可以从pom中取。

#注意：server.port如果在nacos的配置文件中设置了，则以nacos中的配置为准,就算在这里设置了，也没有用
#全工程通用配置：这个值定义nacos中的命名空间ID,不能有小数点和其他符号，只要对接nacos，root.name这个变量必须有
root:
  name: fast-cloud-2021-x-2-6-13
spring:
  profiles:
    active: dev
  application:
    name: @project.artifactId@
  cloud:
    nacos:
      server-addr: 120.0.0.1:8848
      discovery:
        username: nacos
        password: nacos
        #这个值对应的是命名空间ID，而不是命名空间名称
        namespace: ${root.name}
        group: ${spring.profiles.active}
      config:
        namespace: ${spring.cloud.nacos.discovery.namespace}
        username: ${spring.cloud.nacos.discovery.username}
        password: ${spring.cloud.nacos.discovery.password}
        #group区分大小写：dev和DEV代表不一样的组
        group: ${spring.profiles.active}
  config:
    import:
      - nacos:${spring.application.name}.yml?refreshEnabled=true

3.在nacos上配置命名空间和配置文件

这里我为了nacos能多项目共用，把namespace对应成项目唯一标识，把group对应成环境，dataId对应成服务对应的application.yml配置文件。

注册中心和配置中心一样的道理，就不截图了。

4.自动刷新变量

import org.springframework.beans.factory.annotation.Value;
import org.springframework.cloud.context.config.annotation.RefreshScope;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RefreshScope
@RestController
public class TestController {

    @Value("${server.port}")
    private String port;

    @GetMapping("port")
    public String test(){
        return "发布端口为:"+port;
    }
}