springcloud-Feign基礎使用

聲明式REST客戶端：Feign

Feign是一個聲明式的Web服務客戶端。它使得Web服務客戶端的寫入更加方便。具有可插拔注解支持，包括Feign注解和JAX-RS注解。

Spring Cloud增加了對Spring MVC注釋的支持，並且使用了在Spring Web中默認使用的相同的HttpMessageConverter。Spring Cloud集成

了Ribbon和Eureka，在使用Feign時提供了負載均衡的http客戶端。

 

服務提供方就是個簡單的EurekaClient+web應用(spring.application.name : service-provider)。控制層如下：

@RestController
public class IndexController {

    @Autowired
    private IUserService userService;

    @GetMapping("/find/{id}")
    public User findById(@PathVariable Long id) {
        return userService.findById(id);
    }

    @PostMapping("/findUser")
    public User findOne(@RequestBody User user) {
        return user;
    }

}

 

服務調用方項目

pom依賴：

    　　<dependency>
            <!-- eureka客戶端 -->
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-eureka</artifactId>
        </dependency>
        <dependency>
            <!-- feign -->
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-feign</artifactId>
        </dependency>        

這里只依賴了Feign，沒有依賴Hystrix和Ribbon

application.yml文件配置：

server:
  port: 18082
    
spring:
  application:
    name: service-consumer #應用程序名稱
      
eureka:
  client:
    serviceUrl:
      defaultZone: http://admin:admin@localhost:8761/eureka
  instance:
    prefer-ip-address: true #當猜測主機名時，服務器的IP地址應該在操作系統報告的主機名中使用
    instance-id: ${spring.application.name}:${spring.application.instance_id:${server.port}}} #更改Eureka實例ID

入口啟動程序，加上@EnableFeignClients注解開啟Feign：

@SpringBootApplication
@EnableDiscoveryClient
@EnableFeignClients // 開啟feign
public class ConsumerApplication {

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

}

核心客戶端代碼：

/**
 * 使用feign
 */
@FeignClient(name = "service-provider", fallback = UserFallback.class)
public interface UserFeignClient {

    /**
     * get請求
     */
    @GetMapping("/find/{id}")
    UserEntity findById(@PathVariable("id") Long id); // PathVariable注解必須得設置value

    /**
     * post請求
     */
    @PostMapping("/findUser")
    UserEntity findUser(@RequestBody UserEntity user);

}

@FeignClient注解定義了該接口的一個Feign客戶端，name指定了注冊到Eureka的服務名，fallback是服務降級后的接口實現類(可參考springcloud-feign的hystrix支持)

@GetMapping指定了請求的相對url和http請求方式，與服務端一一對應。請求參數和返回類型也得和服務端對應

遇到的坑：   1、使用@PathVariable時，一定得設置value(這點和spring MVC不一樣，算是springcloud的一個坑)

　　　 　　  2、有些SpringCloud版本，這里只支持@RequestMapping，不支持GetMapping和PostMapping

 

控制層代碼：

@RestController
public class FeignController {

    @Autowired
    private UserFeignClient feignClient;

    @GetMapping("/find/{id}")
    public UserEntity getOne(@PathVariable Long id) {
        UserEntity user = feignClient.findById(id);
        return user;
    }
    
    @GetMapping("/getUser")
    public UserEntity findUser() {
        UserEntity user = new UserEntity();
        user.setId("100");
        user.setAge(10);
        user.setLastName("xuwenjin");
        return feignClient.findUser(user);
    }

}