SpringCloud零基础上手（四）——服务发现以及Feign（声明式RESTful服务调用）

接着上篇的内容，我们再创建一个项目充当服务消费者，命名为pf-font，如果pf-login视为后端，那么pf-font 就是前端，达到前后端分离的目的。

一、pf-front目录结构

pf-front同样是一个多模块项目，尽管它目前只有一个模块——pf-web，方便后面扩展其他模块。

二、结构组成

1、pf-font的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 http://maven.apache.org/xsd/maven-4.0.0.xsd">    <modelVersion>4.0.0</modelVersion>    <groupId>cn.pw</groupId>    <artifactId>pf-front</artifactId>    <version>1.0-SNAPSHOT</version>    <packaging>pom</packaging>    <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.SR4</spring-cloud.version>        <fastjson-version>1.2.15</fastjson-version>    </properties>    <parent>        <groupId>org.springframework.boot</groupId>        <artifactId>spring-boot-starter-parent</artifactId>        <version>1.5.8.RELEASE</version>        <relativePath/> <!-- lookup parent from repository -->    </parent>    <dependencies>        <dependency>            <groupId>org.springframework.boot</groupId>            <artifactId>spring-boot-starter-web</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>        </dependency>        <dependency>            <groupId>org.springframework.cloud</groupId>            <artifactId>spring-cloud-starter-feign</artifactId>        </dependency>        <dependency>            <groupId>com.alibaba</groupId>            <artifactId>fastjson</artifactId>            <version>${fastjson-version}</version>        </dependency>        <dependency>            <groupId>org.springframework.boot</groupId>            <artifactId>spring-boot-starter-thymeleaf</artifactId>        </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>    <modules>        <module>pf-web</module>    </modules></project>

2、pf-web的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 http://maven.apache.org/xsd/maven-4.0.0.xsd">    <modelVersion>4.0.0</modelVersion>    <parent>        <groupId>cn.pw</groupId>        <artifactId>pf-front</artifactId>        <version>1.0-SNAPSHOT</version>    </parent>    <artifactId>pf-web</artifactId>    <build>        <plugins>            <plugin>                <groupId>org.springframework.boot</groupId>                <artifactId>spring-boot-maven-plugin</artifactId>            </plugin>        </plugins>    </build></project>  

三、pf-web

1、启动类

package cn.pw.platform.web;import org.springframework.boot.SpringApplication;import org.springframework.boot.autoconfigure.SpringBootApplication;import org.springframework.cloud.client.discovery.EnableDiscoveryClient;import org.springframework.cloud.netflix.feign.EnableFeignClients;@SpringBootApplication@EnableFeignClients@EnableDiscoveryClientpublic class WebApplication {    public static void main(String[] args) {        SpringApplication.run(WebApplication.class, args);    }}

这里我使用@EnableDiscoveryClient而没有使用@EnableEurekaClient，因为后者只能为Eureka作用，而前者则依赖于classpath中的实现，也就是说@EnableDiscoveryClient有多种实现，如eureka, consul, zookeeper，我们需要在application.yml中指定具体的实现。

@EnableFeignClients开启了对Feign的支持 。

当我们在classpath中配置了eureka，@EnableDiscoveryClient和@EnableEurekaClient作用是一样的。

2、配置文件application.yml

server:  port: 8680spring:  thymeleaf:    mode: HTML5    encoding: utf-8    content-type: text/html    cache: false  application:    name: pf-webeureka:  client:    service-url:      default-zone: http://127.0.0.1:8761/eureka/    instance:      instance-id: ${spring.cloud.client.ipAddress}:{server.port}      prefer-ip-address: true

这个配置不难看懂，Eureka的配置项中，我们将pf-web自身也注册到了注册中心。
现在启动Eureka Server 和 pf-web ，我们在注册中心的页面可以得到验证 。

四、使用Feign 调用 pf-login 的接口

1、在pf-web中定义Feign的调用接口

package cn.pw.platform.web.feign;import cn.pw.platform.web.vo.UserVo;import org.springframework.cloud.netflix.feign.FeignClient;import org.springframework.web.bind.annotation.GetMapping;import org.springframework.web.bind.annotation.PathVariable;import org.springframework.web.bind.annotation.PostMapping;import org.springframework.web.bind.annotation.RequestBody;@FeignClient(name="pf-login-server")public interface LoginClient {    @GetMapping("/selectUserByName/{userName}")    UserVo selectUserByName(@PathVariable("userName") String userName);    @PostMapping("/user/add")    UserVo addUser(@RequestBody UserVo userVo);}

@FeignClient(name="pf-login-server")指明了要调用的服务名，接口中定义的方法要符合被调服务的接口要求。

2、写一个测试类Controller

package cn.pw.platform.web.controller;import cn.pw.platform.web.feign.LoginClient;import org.springframework.beans.factory.annotation.Autowired;import org.springframework.stereotype.Controller;import org.springframework.validation.BindingResult;import org.springframework.web.bind.annotation.*;@Controllerpublic class LoginController {    @Autowired    private LoginClient loginClient;    @GetMapping("/searchByName/{name}")    @ResponseBody    public UserVo searchByName(@PathVariable("name") String name){        return loginClient.selectUserByName(name);    }}

3、补充 一个参数映射类UserVo用于封装从服务端请求来的参数。

public class UserVo {    private Long id;    private String name;    private String nickName;    private String password;    private Integer age;    private Integer sex;    //...省略getter setter方法}

4、测试

逐个启动所需项目，Eureka Server、pf-login、pf-web。

使用postman ，请求 http://localhost:8680/searchByName/libin

结果：

{
“id”: 10,
“name”: “libin”,
“nickName”: null,
“password”: “123456”,
“age”: 18,
“sex”: null
}

和上一篇我们直接调用server，所获取的结果完全一致。