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的注解

1
2
3
4
5
6
7
8
9
@SpringBootApplication
@EnableFeignClients
public class SpringCloudSpiApplication {

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

}

创建用户模型(User)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
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查找用户信息的接口

1
2
3
4
5
@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这个配置属性,不然远端访问的话会访问不到

1
2
3
4
5
6
7
8
9
<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的依赖

1
2
3
4
5
6
7
8
9
<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注解

1
2
3
4
5
6
7
8
9
10
11
@SpringBootApplication
@EnableFeignClients
@EnableEurekaClient
@EnableDiscoveryClient
public class FeignProviderApplication {

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

}

实现接口数据

1
2
3
4
5
6
7
8
9
10
11
@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里面配置注册服务、端口和服务名称

1
2
3
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接口文件

1
2
3
4
5
6
7
8
9
10
@SpringBootApplication
@EnableFeignClients(basePackageClasses = {UserProvider.class})
@EnableEurekaClient
public class FeignConsumerApplication {

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

}

创建消费者访问接口

1
2
3
4
5
6
7
8
9
10
11
12
@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();
}
}

创建消费服务配置

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

1
2
3
eureka.client.serviceUrl.defaultZone=http://localhost:8761/eureka/
server.port=8790
spring.application.name=feign-consumer

最终效果

eureka server preview

consumer perview

出现上图效果,恭喜你第二章已经搞定啦^_^

项目示例地址

https://github.com/lenvonsam/spring-cloud-training/tree/master/chapter-sec

0%