最近刚好打算做一个springcloud系列的分享,趁此机会刚好梳理下springcloud常用组件的使用,今天先对feign做个简单介绍!

feign是一个声明式的Web服务客户端,它使得发送web请求变得很容易,而openFign是springcloud对feign的一个升级,可以支持springMvc的注解；

接下来描述下我是怎么使用openFeign发送web请求的，首先需要明确,使用openFeign是有一定的代码侵入的,不过侵入的是consumer的代码,通过在consumer中添加openFeign的注解来拼装请求并发送，一般有两种方式,一种是consumer端根据provider提供的接口文档编写调用用例.另一种是由Prodiver提供一个接口API的jar包供consumer调用；下面上我的测试步骤及代码,两种方式都有涉及；

consumer端

　首先在consumer中引入openFeigin以及HTTPClient的依赖：

　　　　　
org.springframework.cloud spring-cloud-starter-openfeign

    <!-- 引入open-feign的httpClien依赖 -->  
    <dependency>  
       <groupId>io.github.openfeign</groupId>  
       <artifactId>feign-httpclient</artifactId>  
    </dependency>  

　　　　
　　　　 　　　　com.darling.api 　　　　server-apis 　　　　0.0.1-SNAPSHOT 　　　　compile 　　　　

　　然后在consumer中封装一个service引入feign,来进行远程调用,关键代码如下：

package com.darling.eureka.consumer.service;

import com.darling.api.service.UserService;
import com.darling.eureka.consumer.model.User;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.*;

/**
* @description: 通过openFeign远程调用服务提供者
* @author: dll
* @date: Created in 2021/9/14 12:29
* @version: 1.0
* @modified By:
*/
@FeignClient(name = "EUREKA-PROVIDER")
public interface UserApiService extends UserService{

@GetMapping("/test/sayHi?name={name}")  
String sayHi(@PathVariable String name);

/\*\*  
 \* 测试 插入一条信息  
 \* @param user  
 \* @return  
 \*/  
@GetMapping("/test/insertInfo")  
String insertInfo(@RequestBody User user);

}

　　说明：

　　　　1、consumer中的启动类需要加上@EnableFeignClients注解,这里代码没有贴出

　　　　2、FeignClient注解有多种属性可选,如自定义配置信息的configuration、直接指定访问链接的url等，由于我这里只是一个测试的demo就直接用name来指定在eureka中注册的Prodiver的服务名称了；

　　　　3、代码中的GetMapping就是上面说的两种方式之一,consumer根据Prodiver提供的接口文档进行编码调用的；

　　　　4、代码中的UserService就是上面说的另一种方式,由服务提供者提供的一个接口依赖包,我这里包名叫server-apis，,这样consumer中就可以像调用本地方法一样调用远程服务提供的接口能力,下面贴上UserService的代码：

package com.darling.api.service;

import com.darling.api.model.UserInfo;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;

/**
* @description:
* @author: dll
* @date: Created in 2021/9/15 22:02
* @version:
* @modified By:
*/
@RequestMapping("/serverApis")
public interface UserService {

@GetMapping("/test")  
UserInfo test();

/\*\*  
 \* 获取用户信息  
 \* @return  用户姓名、年龄等信息  
 \*/  
@GetMapping("/getInfo")  
UserInfo getInfo();

}

　　　　需要注意的是,无论是通过Prodiver提供的依赖包还是直接编写调用代码,以上代码中所有的类似GetMapping、PostMapping的注解都是由Prodiver暴露出来的接口请求路径,由feign负责识别、拼装并发起远程请求的；

　　　　下面来看看consumer中的Controller的调用代码：

package com.darling.eureka.consumer.controller;

import com.darling.api.model.UserInfo;
import com.darling.eureka.consumer.model.User;
import com.darling.eureka.consumer.service.UserApiService;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import javax.annotation.Resource;

/**
* @description: 测试openFeign的远程调用
* @author: dll
* @date: Created in 2021/8/25 21:52
* @version: 1.0
* @modified By:
*/
@RestController
@RequestMapping("/consumer/test")
public class TestConsumerController {

@Resource  
private UserApiService userApiService;

/\*\*  
 \* 调用UserApiService中自己根据接口文档编写的调用代码  
 \* @return  
 \*/  
@RequestMapping("/sayHello")  
public String sayHello() {  
    String res = userApiService.sayHi("hahaha");  
    System.out.println("res = " + res);  
    return res;  
}

/\*\*  
 \* 调用UserApiService中自己根据接口文档编写的调用代码  
 \* @param user  
 \* @return  
 \*/  
@RequestMapping("/insert")  
public String insertInfo(User user) {  
    String res = userApiService.insertInfo(user);  
    System.out.println("res = " + res);  
    return res;  
}

/\*\*  
 \* 调用UserApiService中由Prodiver提供的server-apis依赖包中的UserService的接口  
 \* @return  
 \*/  
@RequestMapping("/getUserInfo")  
public UserInfo getUserInfo() {  
    UserInfo res = userApiService.getInfo();  
    System.out.println("res = " + res);  
    return res;  
}

}

　　provider端

如果没有采用由Prodiver提供接口依赖包的方式的话,使用openFeign对Prodiver端几乎无任何侵入,Prodiver只需写好自己可以提供的服务并提供一份接口文档即可；

　　下面主要聊聊如果通过提供接口依赖包的方式Prodiver应该做哪些调整以及其中可能遇到的坑

　　首先,需要定义一个专门用来提供接口能力的api服务(server-apis),就正常的web服务即可,代码可参见上面的UserService；然后由Prodiver引入这个服务；需要注意的是如果通过这种方式提供服务的话,Prodiver

需要以接口实现类的方式来提供具体服务的实现,不能在controller中定义接口的调用路径了，否则访问会直接404；

　　总结

　　通过以上的调用实例,我们可以得出结论,feign调用虽香但是对代码的确会有一定的侵入性,主要针对服务的调用者而言,而是通过依赖包调用还是由consumer自己编码调用,无非是愿意接受jar包耦合还是接口文档耦合了,

所以对于同一个团队开发的consumer和Prodiver来说,个人更倾向于通过定义统一的接口依赖包,双方严格按照依赖包进行开发,依赖包的变更大家都能实时感知并作出及时响应,调用起来也更方便；

而对于跨团队来开发consumer和Prodiver来说,个人认为通过接口文档会更合理,consumer相对来说能把命运掌握在自己手上,对接的时候只认接口文档,减少了对接口包的依赖