Spring Cloud学习系列第二章：使用Feign调用服务

一、Feign简介

  Feign是一个声明式的Web服务客户端。这使得Web服务客户端的写入更加方便 要使用Feign创建一个界面并对其进行注释。它具有可插入注释支持，包括Feign注释和JAX-RS注释。Feign还支持可插拔编码器和解码器。Spring
Cloud增加了对Spring MVC注释的支持，并使用Spring Web中默认使用的

HttpMessageConverters

。Spring Cloud集成Ribbon和Eureka以在使用Feign时提供负载均衡的http客户端。

  上面这段话是官方文档，说的有些啰嗦，简单来说，就是Feign帮我们准备了一套调用Spring Cloud注册服务中心里面的服务，不用再去使用Apache httpclient之类的http客户端工具了，还提供了很多功能，编解码、负载均衡等。

二、创建Feign项目

我们的目的是使用上一章发布的服务，而且是到Eureka Server中去访问服务，所以我们的Feign项目就是比Eureka
Server项目多一个Feign的依赖，内容如下。

<?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.nan</groupId>
<artifactId>feigndemo</artifactId>
<version>0.0.1-SNAPSHOT</version>
<packaging>jar</packaging>

<name>feigndemo</name>
<description>Demo project for Spring Boot</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-feign</artifactId>
</dependency>

<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-eureka</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>

  项目启动入口要激活Feign client，内容如下。

package com.nan.feigndemo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.eureka.EnableEurekaClient;
import org.springframework.cloud.netflix.feign.EnableFeignClients;

@SpringBootApplication
@EnableEurekaClient
@EnableFeignClients
public class FeigndemoApplication {

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

}

  接下来就要声明Feign客户端了，目的就是指向我们发布的服务，首先看内容。

package com.nan.feigndemo.client;

import org.springframework.cloud.netflix.feign.FeignClient;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;

@FeignClient("HelloService")
public interface HelloServiceClient {

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

}

  很明显，这是一个interface，是一个声明式使用方式。重要的注解，FeignClient，"HelloService"属性就是我们发布的服务的spring.application.name。下面的接口方法就和我们发布的Rest接口一致了，另外RequestMapping不要用在interface上，不然会被spring mvc容器扫描到。

  然后编写我们自己的项目业务，调用这个客户端，内容如下。

package com.nan.feigndemo.controller;

import com.nan.feigndemo.client.HelloServiceClient;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class FeignDemoController {

@Autowired
private HelloServiceClient helloServiceClient;

@RequestMapping("/feigndemo")
public String feignDemo(@RequestParam("name") String name) {
return helloServiceClient.hello(name);
}

}

  简单的controller，就不多废话了。重要的是下面的项目配置。

server:
port: 8080
spring:
application:
name: FeignDemo
eureka:
client:
serviceUrl:
defaultZone: http://node01:8081/eureka/,http://node02:8082/eureka/[/code]  server.port和application.name是我们项目自己的，eureka.client.serviceUrl就是我们的Eureka Server集群模式的地址，然后启动项目，记得Eureka server和HelloService也要启动。然后浏览器访问我们的feigndemo项目，浏览器输入http://localhost:8080/feigndemo?name=秦始皇，浏览器会出现 Hello
秦始皇, this client port is 9091，再刷新页面，会出现 Hello 秦始皇, this client port is 9092。OK，服务调用，负载均衡都已实现，真是太佩服他们了，一步一步简化我们的开发。

  以上就是笔者目前所学，还是很初级的内容，如果有什么错误和遗漏，还请见谅并指正，不胜感激。