SpringCloud【Greenwich版本】第二章服务消费者和提供者(Feign)

序言

上一章节我们已经学习了最基本的Eureka服务的创建与发现，本章主要想和大家分享下SpringCloud基于Feign来做服务的消费和提供者，希望达到的效果是类似dubbo一样有服务的提供方和消费方。

Feign简介

Feign是一个声明式的伪Http客户端，它使得写Http客户端变得更简单。使用Feign，只需要创建一个接口并注解。它具有可插拔的注解特性，可使用Feign 注解和JAX-RS注解。Feign支持可插拔的编码器和解码器。Feign默认集成了Ribbon，并和Eureka结合，默认实现了负载均衡的效果。

准备工作

继续用上一节的工程，启动eureka-server，端口为8761。

创建统一接口调用jar包

为了实现Feign的服务消费者和提供者，就需要有统一接口池来给提供者来实现和消费者来调用，所以我们这边就需要创建这个统一接口池项目，我们这边把其工程名命名为spring-cloud-spi(如果有必要也可根据需要命名为其他的)，jar包名称为dataspi.jar。

创建项目

打开IntelliJ，新建项目工程，选择Spring Assistant(若碰到没有Spring Assistant需要在IntelliJ的插件库中查询并安装即可)

创建工程

下一步点击Clound Routing -> 选择 Feign,然后点击完成

选择Feign工程

SpringCloudSpiApplication.java 中加入Feign的注解

@SpringBootApplication
@EnableFeignClients
public class SpringCloudSpiApplication {

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

}

创建用户模型(User)

public class User implements Serializable {
    private Long id;
    private String name;
    // 男 女
    private String gender;

    public Long getId() {
        return id;
    }

    public void setId(Long id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

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

    public String getGender() {
        return gender;
    }

    public void setGender(String gender) {
        this.gender = gender;
    }
}

再创建根据ID查找用户信息的接口

@FeignClient("data-user-provider")
public interface UserProvider {
    @GetMapping("user/{id}")
    User userInfo(@PathVariable(value = "id", required = true) Long id);
}

到此最简单的根据ID查找用户信息的接口已经定义好了，我们可以将此项目打包到本地maven库，也可以到远端镜像源。（jar包已经在章节根目录下，可以自行加入到工程用本地访问的方式加载）。

【打包注意】在我们打包过程中，maven plugin 一定要加入exec这个配置属性，不然远端访问的话会访问不到

<plugins>
    <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
        <configuration>
            <classifier>exec</classifier>
        </configuration>
    </plugin>
</plugins>

创建服务提供者

创建feign-provider服务提供者项目工程

创建方式与创建统一接口jar包方式一样，创建完后，在pom.xml加入eureka server和dataspi的依赖

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
</dependency>
<dependency>
    <groupId>sam.trial</groupId>
    <artifactId>dataspi</artifactId>
    <version>0.0.1-SNAPSHOT</version>
</dependency>

FeignProviderApplication.java 文件中添加Feign client注解

@SpringBootApplication
@EnableFeignClients
@EnableEurekaClient
@EnableDiscoveryClient
public class FeignProviderApplication {

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

}

实现接口数据

@RestController
public class UserControllerImpl implements UserProvider {
    @Override
    public User userInfo(Long id) {
        User user = new User();
        user.setId(id);
        user.setName("feign provider 1");
        user.setGender("male");
        return user;
    }
}

创建提供者服务配置

在application.properties里面配置注册服务、端口和服务名称

eureka.client.serviceUrl.defaultZone=http://localhost:8761/eureka/
server.port=8801
spring.application.name=data-user-provider

创建服务消费者

创建feign-consumer服务消费者工程

创建方式与创建服务提供者方式一样。（请详见创建服务提供者模块，不再赘述）

FeignConsumerApplication.java文件中添加注解

在FeignConsumerApplication.java添加Feign client注解，并加载UserProvider接口文件

@SpringBootApplication
@EnableFeignClients(basePackageClasses = {UserProvider.class})
@EnableEurekaClient
public class FeignConsumerApplication {

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

}

创建消费者访问接口

@RestController
@RequestMapping("consumer")
public class HelloController {
    @Autowired
    private UserProvider userProvider;

    @GetMapping("hello/{id}")
    public String helloUser(@PathVariable(value = "id", required = true) Long id) {
        User u = userProvider.userInfo(id);
        return "hello " + u.getName();
    }
}

创建消费服务配置