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
@EnableDiscoveryClient
public 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: 8680

spring:
thymeleaf:
mode: HTML5
encoding: utf-8
content-type: text/html
cache: false
application:
name: pf-web

eureka:
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

pack
9a9e
age 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.*;

@Controller
public 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，所获取的结果完全一致。