简单接入spring-cloud-feign

首先在pom里引入依赖：主要是eurkea和feign

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <version>2.1.1.RELEASE</version>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>

        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-eureka</artifactId>
            <version>1.3.4.RELEASE</version>
        </dependency>

        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-feign</artifactId>
            <version>1.4.6.RELEASE</version>
        </dependency>

    </dependencies>
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>Finchley.SR2</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

其次，在主类声明：@EnableFeignClients，@EnableDiscoveryClient

package com.sc.feignconsumer;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
import org.springframework.cloud.openfeign.EnableFeignClients;

@SpringBootApplication
@EnableFeignClients
@EnableDiscoveryClient
public class FeignConsumerApplication {

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

}

然后，定义一个服务：主要是声明@FeignClient，里面的hello-service不分大小写

package com.sc.feignconsumer.service;

import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.stereotype.Component;
import org.springframework.web.bind.annotation.RequestMapping;

@Component
@FeignClient("hello-service")
public interface HelloService {

    @RequestMapping("/hello")
    String hello();

}

接着，定义一个restful api：注入刚才提供的HelloService

package com.sc.feignconsumer.controller;

import com.sc.feignconsumer.service.HelloService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class FeignConsumerController {

    @Autowired
    private HelloService helloService;

    @GetMapping("/feign-consumer")
    public String helloConsumer(){
        return this.helloService.hello();
    }
}

运行测试：明显的，feign自动帮我们实现了RestTemplate以及ribbon！

观察Eureka面板：

 

基于以上结果，扩展至带RequestParam，RequestHeader，RequestBody的参数绑定：

首先定义实体User，注意其中的默认构造函数：

package com.sc.feignconsumer.entity;

public class User {

    private String name;
    private Integer age;

    // 要有默认构造函数，否则会报错 Cannot construct instance of `com.sc.feignconsumer.entity.User` (no Creators, like default construct, exist): cannot deserialize from Object value (no delegate- or property-based Creator)
    public User(){}

    public User( String name, Integer age) {
        this.name = name;
        this.age = age;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public Integer getAge() {
        return age;
    }

    public void setAge(Integer age) {
        this.age = age;
    }

    @Override
    public String toString() {
        return "User{" +
                "name='" + name + '\'' +
                ", age=" + age +
                '}';
    }
}

其次，声明服务接口：

package com.sc.feignconsumer.service;

import com.sc.feignconsumer.entity.User;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.stereotype.Component;
import org.springframework.web.bind.annotation.*;

@Component
@FeignClient("hello-service")
public interface HelloService {

    @RequestMapping("/hello")
    String hello();

    // 注意：以下三个方法，必须显示声明参数名称，否则Feign会抛出IIIegalStateException
    @GetMapping("/hello1")
    String hello(@RequestParam("name") String name);

    @GetMapping("/hello2")
    User hello(@RequestHeader("name") String name, @RequestHeader("age") Integer age);

    @PostMapping("/hello3")
    String hello(@RequestBody User user);

}

在控制器中调用如下：

    @GetMapping("/feign-consumer2")
    public String helloConsumer2() {
        StringBuilder sb = new StringBuilder();
        sb.append(this.helloService.hello("daluo")).append("\n");
        sb.append(this.helloService.hello("spring", 30)).append("\n");
        sb.append(this.helloService.hello(new User("feign", 20))).append("\n");
        return sb.toString();
    }

结果：