11.使用feign实现声明式的调用
使用RestTemplate+ribbon已经可以完成对服务端负载均衡的调用,为什么还要使用feign?
@RequestMapping("/hi")
public String hi(String name) {
String restTemplateForObject = restTemplate.getForObject("http://HI-SERVICE/test/test?name=" + name, String.class);
return restTemplateForObject;
}
上述代码采用url拼接参数的形式发送请求,如果要发送多个请求参数那么代码就会变得很低效并且难以维护。例如
http://localhost:8762/hi/hi?name=dd&password=123456&age=18
如果使用字符串拼接的方式,那么代码可以编排为:
@RequestMapping("/hi")
public String hi(String name, String password, Integer age) {
Map<Object, Object> map = new HashMap<>();
map.put("name", name);
map.put("password", password);
map.put("age", age);
String restTemplateForObject = restTemplate.getForObject("http://HI-SERVICE/test/test?name={name}&password={password}&age={age}", String.class, map);
return restTemplateForObject;
}
在这里url仅仅包含三个参数,如果url为10个参数那么代码会变的更加难以维护。
1.feign简介
Feign是一个声明式的伪Http客户端,它使得写Http客户端变得更简单。使用Feign,只需要创建一个接口并注入。它具有可插拔的注解特性(可以使用springmvc的注解),可使用Feign 注解和JAX-RS注解。Feign支持可插拔的编码器和解码器。Feign默认集成了Ribbon,并和Eureka结合,默认实现了负载均衡的效果并且springcloud为feign添加了springmvc注解的支持。
2.为消费者整合feign
1.引入feign的相关依赖
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-feign</artifactId>
</dependency>
2.入口类开启feign支持
@EnableDiscoveryClient
@SpringBootApplication
@EnableFeignClients
public class HiApplication {
public static void main(String[] args) {
SpringApplication.run(HiApplication.class, args);
}
}
3.创建feign接口
@FeignClient(serviceId = "EUREKA-PROVIDER")
public interface feignTest {
@RequestMapping("/test/test1")
public String sayHi(String name);
}
注:feign会对serviceId与RequestMapping提供的地址进行拼接,远程调用方法。
建议:feign接口与服务者被调用的方法名最好保持一致,调用清晰明了。
4.控制器
@RequestMapping("/hi")
public String hi(String name) {
final String s = feignTest.sayHi(name);
System.out.println(s);
return s;
}
5.服务者控制器
@RestController
@RequestMapping("/test")
public class TestController {
@RequestMapping("/test1")
public String sayHi(String name){
return "xixixi 8763 :"+name;
}
}
测试结果:
单参数调用是没有任何问题的。在这里,你可以开启服务者集群,测试是否实现了负载均衡。经过我的测试时可以的,可以在client的配置文件中修改ribbon的实现类修改负载均衡为其他策略。
3.feign日志
很多的场景下,需要了解feign处理请求的具体细节,如何满足这种需求呢?
feign对日志的处理非常灵活可为每个feign客户端指定日志记录策略,每个客户端都会创建一个logger默认情况下logger的名称是feign的全限定名需要注意的是,feign日志的打印只会DEBUG级别做出响应。
我们可以为feign客户端配置各自的logger.lever对象,告诉feign记录那些日志logger.lever有以下的几种值
- NONE 不记录任何日志
- BASIC 仅仅记录请求方法,url,响应状态代码及执行时间
- HEAdERS 记录Basic级别的基础上,记录请求和响应的header
- FULL 记录请求和响应的header,body和元数据
1.java配置核心日志类
@Configuration
public class FeignLogConf {
@Bean
public Logger.Level feignConfiguration() {
return Logger.Level.FULL;
}
}
2.配置feign客户端的日志级别
logging.level.com.nyist.feign.FeignLogConf=debug
4.feign构造多参数请求
多参数情况下的feign调用会直接报错,比如两个String参数feign是无法识别的,必须要参数绑定,我想这就是可插拔注解:RequestParam是springmvc的。
1.错误方式
feign的注意事项
1.多参数传输的时候 必须要在feign接口上进行参数的绑定
public String testFeign(@RequestParam("name") String name, @RequestParam("password") String password, @RequestParam("age") Integer age);
2.以对象格式为参数进行数据传输时 必须设置feign的请求形式为post
3.在服务方接收对象参数时需在形参上加入@RequestBody的注解
public interface feignPost {
@RequestMapping(value = "/test/test1", method = RequestMethod.GET)
public User sayHi(User user);
}
错误日志信息
feign.FeignException: status 405 reading feignPost#sayHi(User); content:
{"timestamp":1546852876890,"status":405,"error":"Method Not Allowed","exception":"org.springframework.web.HttpRequestMethodNotSupportedException","message":"Request method 'POST' not supported","path":"/test/test1"}
由异常信息可知,尽管指定了get的方法,feign依然会使用post发送请求(对象传输时)。正确的方式如下:
2.get
@RequestMapping("/test/test",method = RequestMethod.GET)
public String sayHi(@RequestParam("name") String name,@RequestParam("password")String password);
3.post
feign配置
@FeignClient(serviceId = "HI-SERVICE")
public interface feignPost {
@RequestMapping(value = "/test/test1", method = RequestMethod.POST)
public User sayHi(User user);
}
但换个电脑测试时,GET请求是正常的。。。。
服务者
@RequestMapping("/test1")
public User test1(@RequestBody User user) {
return user;
}
2019-08-07补充内容: