springcloud教程 -- 2.feign的使用實踐，如何優雅的發送請求

一，概念

強烈推薦各位閱讀官網，官網介紹寫的非常好！！！

Feign官網：https://cloud.spring.io/spring-cloud-static/spring-cloud-openfeign/2.2.2.RELEASE/reference/html/

總結：

Feign是一個聲明性web服務客戶端。它使編寫web服務客戶機更容易。使用Feign創建一個接口並註釋它。它具有可插入的註釋支持，包括Feign註釋和JAX-RS註釋。Feign也支持可插拔編碼器和解碼器。Spring Cloud增加了對Spring MVC註釋的支持，並支持使用Spring Web中默認使用的HttpMessageConverters。Spring Cloud集成了Ribbon和Eureka，以及Spring Cloud LoadBalancer，在使用Feign時提供一個負載均衡的http客戶端。

二，Feign的實際使用

接着第二章節, 本章節介紹如何使用Feign

沒看過上文的，請先查看相關文章：

springcloud教程 -- 1.快速搭建入門級demo,看這一篇就夠了

 

前文中我們創建了一個普通的消費者端：j-cloud-consumer

在這個工程中，我們使用RestTemplate來發送請求，代碼看起來較爲凌亂

接下來進入feign實踐：

1.基於上一章節，在j-cloud下新建一個moudle，使用feign的消費者工程：j-cloud-consumer-feign

創建過程參考上一章節

項目結構如下：

2.pom.xml文件內容如下：

<?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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>cn.jorian.framework</groupId>
    <artifactId>j-cloud-consumer-feign</artifactId>
    <version>1.0.0</version>
    <name>j-cloud-consumer-feign</name>
    <description>Demo project for Spring Boot</description>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>1.5.4.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>
        <cloud.version>Dalston.SR1</cloud.version>
    </properties>
    <dependencies>
        <!-- hystrix斷路器 -->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-hystrix</artifactId>
        </dependency>
        <!--LOMBOK-->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.16.20</version>
            <scope>provided</scope>
        </dependency>
        <!-- eureka 配置中心 -->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-eureka</artifactId>
        </dependency>
        <!-- fegin -->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-feign</artifactId>
        </dependency>
        <!-- boot-web -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>


    </dependencies>

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

</project>

3.控制器HelloController，代碼如下：

注意，此調用服務的方式已經改爲使用feign，而非RestTemplate

package cn.jorian.framework.controller;

import cn.jorian.framework.service.UserClient;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class Hellocontroller {
	@Autowired
	private UserClient feignClient;
	/**
	 * 此處的mapping是一級controller，調用方法裏邊綁定了二級的conroller，相當於用http完成一次轉發
	 * @return
	 */
	@GetMapping("/hello")
	public String hello(){
		return feignClient.sayHello();
	}

	@GetMapping("/hi")
	public String hi(){
		return feignClient.sayHi();
	}

	@GetMapping("/haha")
	public String haha(){
		return feignClient.sayHaha();
	}


}

4.啓動器JCloudConsumerFeignApplication，代碼如下：

此處注意，增加了feign客戶端的配置，需要配置feign的代碼基礎包路徑

package cn.jorian.framework;

import org.springframework.boot.SpringApplication;
import org.springframework.cloud.client.SpringCloudApplication;
import org.springframework.cloud.netflix.eureka.EnableEurekaClient;
import org.springframework.cloud.netflix.feign.EnableFeignClients;


/**
 * @author jorian
 */
@SpringCloudApplication
@EnableEurekaClient //表明這是一個eureka客戶端
@EnableFeignClients(basePackages = "cn.jorian.*") //開啓feign
public class JCloudConsumerFeignApplication {

	public static void main(String[] args) {
		// TODO Auto-generated method stub
		SpringApplication.run(JCloudConsumerFeignApplication.class, args);
	}

}

5.Feign客戶端UserClient,代碼如下：

仔細觀察代碼，使用了@FeignClient來表明是哪個應用

package cn.jorian.framework.service;


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

/**
 * 這個接口相當於把原來的服務提供者項目當成一個Service類
 * @author jorian
 *
 */
@FeignClient("PROVIDER-USER")
public interface UserClient {

		/**
		 * Feign中沒有原生的@GetMapping/@PostMapping/@DeleteMapping/@PutMapping，要指定需要用method進行
		 *
		 *
		 * 接口上方用requestmapping指定是服務提供者的哪個controller提供服務
		 */
		@RequestMapping(value="/user/sayHello",method=RequestMethod.GET)
		public String sayHello();

		@RequestMapping(value="/user/sayHi",method=RequestMethod.GET)
		public String sayHi();

		@RequestMapping(value="/user/sayHaha",method=RequestMethod.GET)
		public String sayHaha();


}

6.依次啓動j-cloud-server,j-cloud-provider1,j-cloud-provider2,j-cloud-consumer-feign

7.在註冊中心查看各個服務是否上線

8.訪問使用了feign的消費者服務接口：

多次訪問，可以看到返回結果已經實現了負載均衡

 

至此，feign的學習已經完成，

您可以繼續查看下一章：springcloud教程 -- 3.微服務熔斷機制，斷路器hystrix的使用詳解

或者下載github完整demo：若對您有用，請star，謝謝