【SpringBoot深入浅出系列】SpringBoot集成Nacos及Feign

---

前言

本文通过 SpringBoot 创建两个项目：shop_server、shop_client，并注册至nacos注册中心，通过Feign实现服务间调用。

一、Nacos 是什么？

Nacos 是阿里巴巴的开源项目，致力于帮助您发现、配置和管理微服务。Nacos 提供了一组简单易用的特性集，帮助您快速实现动态服务发现、服务配置、服务元数据及流量管理。
Nacos 帮助您更敏捷和容易地构建、交付和管理微服务平台。 Nacos 是构建以“服务”为中心的现代应用架构 (例如微服务范式、云原生范式) 的服务基础设施。
Nacos更详细的说明见：https://nacos.io/zh-cn/

二、Feign 是什么？

Feign 是一个声明式 Web 服务客户端。它使编写 Web 服务客户端变得更加容易。只需要创建一个接口并添加注解就可以进行微服务的调用。

三、集成步骤

1.安装启动 Nacos

详见：Nacos的安装使用

2.创建 SpringBoot 项目 shop_server

创建 SpringBoot 项目的方法见：使用Idea创建 SpringBoot 项目

（1）.添加依赖

pom.xml 文件中添加以下依赖：

<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-openfeign</artifactId>
    <version>2.1.3.RELEASE</version>
</dependency>
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>fastjson</artifactId>
    <version>1.2.69</version>
</dependency>
<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.18.22</version>
</dependency>

（2）.添加配置

application.yml 文件中添加以下配置：

server:
  port: 8080
spring:
  application:
    name: shop-server
  cloud:
    nacos:
      discovery:
        server-addr: 127.0.0.1:8848
      config:
        server-addr: 127.0.0.1:8848

（3）.启动类添加注解

项目启动类添加两个注解：@EnableDiscoveryClient（注册中心注册发现）、@EnableFeignClients（feign客户端调用）

@SpringBootApplication
@EnableDiscoveryClient
@EnableFeignClients
public class ShopServerApplication {

    public static void main(String[] args) {
        SpringApplication.run(ShopServerApplication.class, args);
    }

}

（4）.新建订单实体类

@Data
public class Order {
    private String orderId; // 订单 id

    private Long userId; // 用户 id

    private Date createDate; // 创建时间

    private Date updateDate; // 修改时间

    private String orderDetails; // 订单详情
}

（5）.新建订单服务接口类

package com.chaoyue.shop_server.service;

import com.alibaba.fastjson.JSONObject;

public interface OrderService {
    /** 获取订单信息
     *
     * @return
     */
    JSONObject getInfos();
}

（6）.新建订单服务实现类

package com.chaoyue.shop_server.impl;

import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONObject;
import com.chaoyue.shop_server.entity.Order;
import com.chaoyue.shop_server.service.OrderService;
import org.springframework.stereotype.Service;

import java.util.Date;

@Service
public class OrderSeviceImpl implements OrderService {

    /** 获取订单信息
     *
     * @return
     */
    @Override
    public JSONObject getInfos() {
        Order order = new Order();
        order.setOrderId("1");
        order.setUserId(1L);
        order.setCreateDate(new Date());
        order.setUpdateDate(new Date());
        order.setOrderDetails("订单详情");
        return JSONObject.parseObject(JSON.toJSONString(order));
    }
}

（7）.新建订单控制类

package com.chaoyue.shop_server.controller;

import com.alibaba.fastjson.JSONObject;
import com.chaoyue.shop_server.service.OrderService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/api/order")
public class OrderController {

    @Autowired
    private OrderService orderService;

    /** 获取订单信息
     *
     * @return
     */
    @RequestMapping("/getInfos")
    public JSONObject getInfos() {
        return orderService.getInfos();
    }
}

（8）.启动服务

启动服务，可在 Nacos 注册中心看到已注册的服务

3.创建 SpringBoot 项目 shop_client

创建 SpringBoot 项目的方法见：使用Idea创建 SpringBoot 项目

（1）.添加依赖

pom.xml 文件中添加以下依赖：

<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-openfeign</artifactId>
    <version>2.1.3.RELEASE</version>
</dependency>
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>fastjson</artifactId>
    <version>1.2.69</version>
</dependency>
<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.18.22</version>
</dependency>

（2）.添加配置

application.yml 文件中添加以下配置：

server:
  port: 8081
spring:
  application:
    name: shop-client
  cloud:
    nacos:
      discovery:
        server-addr: 127.0.0.1:8848
      config:
        server-addr: 127.0.0.1:8848

（3）.启动类添加注解

项目启动类添加两个注解：@EnableDiscoveryClient（注册中心注册发现）、@EnableFeignClients（feign客户端调用）

@SpringBootApplication
@EnableDiscoveryClient
@EnableFeignClients
public class ShopClientApplication {

    public static void main(String[] args) {
        SpringApplication.run(ShopClientApplication.class, args);
    }

}

（4）.新建Feign接口

新建 OrderFeignClient 接口方法类，用来调用 shop_server 中的接口

package com.chaoyue.shop_client.feignClient;

import com.alibaba.fastjson.JSONObject;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

@FeignClient(name = "shop-server")
public interface OrderFeignClient {

    /** 获取订单信息
     *
     * @return
     */
    @RequestMapping(value = "/api/order/getInfos", method = RequestMethod.GET)
    JSONObject getInfos();
}

（5）.新建订单控制类

package com.chaoyue.shop_client.controller;

import com.alibaba.fastjson.JSONObject;
import com.chaoyue.shop_client.feignClient.OrderFeignClient;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/api/order")
public class OrderController {

    @Autowired
    private OrderFeignClient orderFeignClient;

    @RequestMapping("/getInfos")
    public JSONObject getInfos() {
        return orderFeignClient.getInfos();
    }
}

（6）.启动服务

启动服务，可在 Nacos 注册中心看到已注册的服务

四、测试

浏览器输入链接：http://localhost:8081/api/order/getInfos
返回：{"orderDetails":"订单详情","updateDate":1644580394055,"orderId":"1","userId":1,"createDate":1644580394055}

---

总结

以上就是今天要讲的内容，如果大家要了解更多的相关内容，请关注本博客的后续博文。