springcloud学习笔记三：利用Feign编写客户消费端

Feign

在上一篇笔记中，我们在消费者端使用restemplate的方式远程消费服务，这样写虽然可以，但是却与我们其它的代码有点格格不入，那么通过feign，一个http客户端库，可以做到使用HTTP请求远程服务时能与调用本地方法一样的编码体验，与我们的客户端代码看起来融为一体。

使用：

首先在消费者端（我们这里用学习笔记二中创建的消费者端http://blog.csdn.net/u011890101/article/details/77206665）先加入feign的相关依赖包，完整pom：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
	<modelVersion>4.0.0</modelVersion>

	<groupId>com.point</groupId>
	<artifactId>point-consumer</artifactId>
	<version>0.0.1-SNAPSHOT</version>
	<packaging>jar</packaging>

	<name>point-consumer</name>
	<description>test consumer</description>

	<parent>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-parent</artifactId>
		<version>1.5.6.RELEASE</version>
		<relativePath/> <!-- lookup parent from repository -->
	</parent>

	<properties>
		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
		<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
		<java.version>1.8</java.version>
		<spring-cloud.version>Dalston.SR2</spring-cloud.version>
	</properties>

	<dependencies>
		<dependency>
			<groupId>org.springframework.cloud</groupId>
			<artifactId>spring-cloud-starter-eureka</artifactId>
		</dependency>
		<dependency>
			<groupId>org.springframework.cloud</groupId>
			<artifactId>spring-cloud-starter-ribbon</artifactId>
		</dependency>
		<dependency>
			<groupId>org.springframework.cloud</groupId>
			<artifactId>spring-cloud-starter-feign</artifactId>
		</dependency>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-test</artifactId>
			<scope>test</scope>
		</dependency>
	</dependencies>

	<dependencyManagement>
		<dependencies>
			<dependency>
				<groupId>org.springframework.cloud</groupId>
				<artifactId>spring-cloud-dependencies</artifactId>
				<version>${spring-cloud.version}</version>
				<type>pom</type>
				<scope>import</scope>
			</dependency>
		</dependencies>
	</dependencyManagement>

	<build>
		<plugins>
			<plugin>
				<groupId>org.springframework.boot</groupId>
				<artifactId>spring-boot-maven-plugin</artifactId>
			</plugin>
		</plugins>
	</build>


</project>

在入口类加入@EnableFeignClients，表示启用feign。

@EnableDiscoveryClient
@EnableFeignClients
@SpringBootApplication
public class PointConsumerApplication {

	public static void main(String[] args) {
		SpringApplication.run(PointConsumerApplication.class, args);
	}
	
	@Bean
	@LoadBalanced
	public RestTemplate restTemplate(){
		return new RestTemplate();
	}
}

编写feign客户端，新建一个接口类

@FeignClient("point-provider")
@RequestMapping("provider")
public interface ConsumerService {
	
	@GetMapping("getName")
	public String getName();
}

其中@FeignClient所对应的即是服务的名称，我们这里填写的还是之前我们所创建的名为point-provider的服务。

映射地址以及方法即对应服务所提供的rest方法，用springmvc提供的注解编写，这样我们一个feign客户端类就编写完毕，可以在controller层进行注入调用。

@RestController
@RequestMapping("consumer")
public class ConsumerController {

	@Autowired
	private RestTemplate restTemplate;
	@Resource
	private ConsumerService consumerService;
	
	
	@GetMapping("getName")
	public String getName(){
		return restTemplate.getForObject("http://point-provider/provider/getName", String.class);
	}
	
	@GetMapping("getNameByFeign")
	public String getNameByFeign(){
		return consumerService.getName();
	}
}

访问http://localhost:3000/consumer/getNameByFeign，

调用成功。

feign是基于ribbon实现的，所以它自带了客户端负载均衡功能，有兴趣的话，可以按照学习笔记二中的方式，开启同一个服务的两个实例进行测试。