本节就常见的微服务的消费者进行介绍。在JAVA领域比较常用的消费者框架主要有HttpClient、Ribbon、Feign 等。
Apache HttpClient是Apache Jakarta Common下的子项目,用来提供高效的、最新的、功能丰富的支持HTTP的客户端编程工具包,并且它支持HTTP最新的版本和建议。虽然在JDK的java.net包中已经提供了访问HTTP的基本功能,但是对于大部分应用程序来说,JDK 库本身提供的功能还不够丰富和灵活。HttpClient 相比传统JDK自带的URLConnection,增加了易用性和灵活性,它不仅使客户端发送Http请求变得容易,而且也方便了开发人员测试基于HTTP的接口,既提高了开发的效率,也方便提高代码的健壮性。
在之前章节的示例中,我们也大规模采用了HttpClient来作为REST客户端。
在程序中,我们经常使用RestTemplate实例来访问REST服务。RestTemplate 是Spring的核心类,用于同步客户端的HTTP访问。它简化了与HTTP服务器的通信,并强制执行RESTful原则。
默认情况下,RestTemplate 依赖于标准的JDK功能来建立HTTP连接,当然,我们也可以通过setRequestFactory属性来切换到使用不同的HTTP库,例如,上面我们所介绍的Apache HttpCli-ent, 以及其他的,如Netty、OkHtp等。
要使用Apache HttpClient,最方便的方式莫过于再添加Apache HttpClient依赖。
//依赖关系
dependencies {//添加Apache HttpClient依赖compile ('org . apache . httpcomponents :httpclient:4.5.3')
}
其次,通过RestTemplateBuilder来创建RestTemplate实例。
import org. spr ingframework .beans. factory .annotation . Autowired;
import org. spr ingframework. boot . web. client. RestTemplateBuilder;
import org. spr ingf r amework. context. annotation. Bean;
import org. springframework . context . annotation . Configuration;
import org. springfr amework . web. client.RestTemplate;
@Configuration
public class RestConfiguration {
@Autowi red
private RestTemplateBuilder builder;@Bean
public RestTemplate restTemplate() {
return builder .build() ;
}}
最后,就能通过RestTemplate实例来访问RESTfulAPI服务了。
@Service
public class WeatherDataServiceImpl implements WeatherDataService {
CAutowiredprivate RestTemplate restTemplate;private WeatherResponse doGetWeatherData (String uri) {
ResponseEntity<String> response = restTemplate . getForEntity (uri, String.class) ;
//。。
}
// .。}
Spring Cloud Ribbon是基于Netlix Ribbon实现的一套客户端负载均衡的工具。它是一一个基于HTTP和TCP的客户端负载均衡器。
Ribbon的一一个中心概念就是命名客户端。每个负载平衡器都是组合整个服务组件的一部分,它们一起协作,并可以根据需要与远程服务器进行交互,获取包含命名客户端名称的集合。SpringCloud根据需要,使用RibbonClientConfiguration为每个命名客户端创建一个新的集合作为Applica-tionContext。这其中包括- - 个ILoadBalancer、一个RestClient和一个ServerListFilter。
Ribbon经常与Eureka结合使用。在典型的分布式部署中,Eureka 为所有微服务实例提供服务注册,而Ribbon则提供服务消费的客户端。Ribbon 客户端组件提供一- 系列完善的配置选项,如连接超时、重试、重试算法等。Ribbon内置可插拔、可定制的负载均衡组件。下 面是用到的一一些负载均衡策略:
●简单轮询负载均衡;
●加权响应时间负 载均衡;
●区域感知轮询负载均衡;
●随机负载均衡。
其中,区域感知负载均衡器是Ribbon 一个久经考验的功能,该负载均衡器会采取如下步骤。
●负载均衡器会检查、计算所有可用区域的状态。如果某个区域中平均每个服务器的活跃请求已经达到配置的阈值,该区域将从活跃服务器列表中排除。如果多于-一个区域已经到达阈值,平均每服务器拥有最多活跃请求的区域将被排除。
●最差的区域被排除后,从剩下的区域中,将按照服务器实例数的概率抽样法选择一 个区域。
●在选定区域中,将会根据给定负载均衡策略规则返回一个服务器。
在micro-weather-eureka-client应用基础上,我们稍作修改,使其成为一个新的应用mi-cro-weather-eureka-client-ribbon,作为本章节的示例。
1.所需环境
为了演示本例子,需要采用如下开发环境。
JDK 8。
Gradle 4.0。
● redis 3.2.100。
● Spring Boot 2.0.0.M3。
●Spring Cloud Starter Netlix Eureka Client Finchley.M2。
●Spring Cloud Starter Netilix Ribbon。
2.项目配置
要使用Ribbon,最简单的方式莫过于添加Ribbon依赖。
//依赖关系
dependencies {//添加Spring Cloud Starter Netflix Ribbon依赖compile (' org. spr ingframework. cloud: spring-cloud-starter-netflix-rib-
bon')
}
3.启用Ribbon
Spring Cloud提供了声明式@RibbonClient注解来使用Ribbon。
package com. waylau. spring. cloud. weather . config;
import org. springframework.beans. factory . annotation. Autowired;
import org. spr ingf r amework. boot. web. cl ient. RestTemplateBuilder;
import org. springfr amework. cloud.client. loadbalancer .LoadBalanced;
import org.spr ingframework .cloud. netflix. ribbon. RibbonCl ient;
import org. spr ingfr amework. context. annotation. Bean;
import org. springfr amework.context. annotation. Configuration;
import org. springframework. web. client. RestTemplate;
t REST配置类.* @since 1.0.0 2017年11月03日
k Cauthor <a href="https: / /waylau. com">Way Lau</a>
@Configuration
@RibbonClient (name = "ribbon-client", configuration = RibbonConfiguration.
class)
public class RestConfiguration {
@Autowi red
private RestTemplateBuilder builder;@Bean
@LoadBalanced
public RestTemplate restTemplate () {
return builder .build() ;
}}
其中RibbonConfiguration是Ribbon自定义的配置类,定义如下。
/ **
*/package com. waylau. spring.cloud . weather . config;
import org. spr ingframework.cloud.netflix. ribbon. ZonePreferenceServerList
Filter;import org. springfr amework. context. annotation. Bean;
import org. springframework. context. annotation. Configuration;
import com. netflix. loadbalancer. IPing;
import com. netflix. loadbalancer . PingUrl;
/**
城市配置.
* @since 1.0.0 2017年11月3日
@author <a href="https://waylau. com">Way Lau</a>
@Configuration
public class RibbonConfiguration {
@Bean
public ZonePreferenceServerListFilter serverListFilter() {
ZonePreferenceServerListFilter filter = new ZonePreferenceServer-
ListFilter ()
filter .setZone ("myZone") ;
return filter;
@Bean
public IPing ribbonPing() {
return new PingUrl () ;
}
}
这样,我们就能通过应用名称msa-weather-city -eureka来访问微服务了,并且还实现了服务的负载均衡。
4.使用Ribbon
编写CityController,用于使用Ribbon配置的RestTemplate。
import org. springframework. beans. factory . annotation. Autowired;
import org . springf ramework. web. bind. annotation. GetMapping;
import org.spr ingframework . web. bind. annotation. RestController;
import org. springf ramework. web. cl ient . RestTemplate;
/**
City Controller .
* @since 1.0.0 2017年11月03日
@author <a href="https:/ /waylau. com">Way Lau</a>
@RestController
public class CityController
@Autowired
private RestTemplate res tTemplate;
@GetMapping ("/cities")
public String listCity() {
//通过应用名称来查找
String body = restTemplate . getForEntity ("http:/ /msa-weather-
city-eureka/cities", String.class) .getBody() ;
return body;
}
}
5.应用配置
该应用同时也是一个 Eureka Client。修改application.properties,将其修改为如下配置。
spring. application. name: micro-weather -eureka-client-ribbon eureka. client. serviceUrl .defaultZone: http://localhost:8761/eureka/
Feign是一- 个声明式的Web服务客户端,这使Web服务客户端的写人更加方便。它具有可插拔注解支持,包括Feign注解和JAX-RS注解。Feign 还支持可插拔编码器和解码器。Spring Cloud增加了对Spring MVC注解的支持,并且使用了在Spring Web中默认使用的相同的HttpMessageCon-verter。 在使用Feign时,Spring Cloud集成了Ribbon 和Eureka 来提供负载平衡的HTTP客户端。
在micro-weather-eureka-client应用基础上,我们稍作修改,使其成为一个新的应用mi-cro-weather- eureka-client-feign,作为本节的示例。
1.所需环境
为了演示本例子,需要采用如下开发环境。
●Gradle 4.0。
●Redis 3.2.100。
●Spring Boot 2.0.0.M3。
●Spring Cloud Starter Netflix Eureka Client Finchley.M2。
●Spring Cloud Starter OpenFeign Finchley.M2。
2.项目配置
为了使用Feign,增加如下配置。
dependencies {
//添加Spring Cloud Starter OpenFeign依赖
compile('org. spr ingframework. cloud:spring-cloud-starter-openfeign')
}
3.启用Feign
要启用Feign,最简单的方式就是在应用的根目录的Application 类上添加org.springframework.cloud.netlix. feign.EnableFeignClients注解。
import org.springframework .boot. SpringApplication;
import org. springfr amework . boot. autoconfigure . SpringBootApplication;
import org. springframework. cloud. client . discovery . EnableDi scoveryClient;
import org.springframework. cloud. netflix. feign. EnableFeignClients;
/**
★主应用程序.
★asince 1.0.0 2017年11月04日
* Cauthor <a href="https:/ /waylau. com">Way Lau</a>
*/
@SpringBootApplication
@EnableDiscoveryCl ient
@EnableFeignClients
public class Appl ication {
public static void main(String[] args) {
SpringApplication. run (Application.class, args) ;
}}
4.使用Feign
要使用Feign,首先是编写Feign请求接口。
package com. waylau. spring.cloud. weather .service;
import org. spr ingf ramework. cloud . netflix. feign. FeignClient;
import org. springfr amework. web . bind. annotation . GetMapping;
★访问城市信息的客户端.* Gsince 1.0.0 2017年11月4日
* @author <a href="https:/ /waylau. com">Way Lau</a>
*/@FeignClient ("msa-weather-city-eureka")
public interface CityClient {
@GetMapping("/cities")
String listCity() ;}}
其中,@FeignClient指定了要访问的服务的名称msa- weather-city-eureka。
在声明了CityClient 接口之后,我们就能在控制器CityController中使用该接口的实现。
import org. springframework .beans. factory .annotation. Autowired;
import org. springframework. web .bind. annotation. GetMapping;
import org. springf r amework. web.bind. annotation. RestController;
import com. waylau. spring. cloud . weather . service. CityClient;
/★** City Controller.★@since 1.0.0 2017年11月04日
* @author <a href="https:/ /waylau. com">Way Lau</a>
@RestController
public class CityController {
@Autowired
private CityClient cityClient;
@GetMapping("/cities")
public String listCity() {
/通过Feign客户端来查找String body = cityClient. listCity() ;return body;
}}
CityContoller 控制器专门用于请求获取城市信息的响应。这里,我们直接注入CityClient 接口即可,Feign框架会为我们提供具体的实现。
最后,修改application.properties。将其修改为如下配置。
spr ing . application. name: micro-weather -eureka-client-feign
eureka. client. serviceUrl. defaultZone: http:/ /localhost: 8761/eureka/
feign.cl ient. config. feignName . connectTimeout: 5000
feign. cl ient. config. feignName . readTimeout: 5000
其中:
● feign.client.config.feignName.connectTimeout为连接超时时间;
feign.client.conig. feignName.readTimeout为读数据的超时时间。
本节示例所涉及的源码,见micro-weather-eureka-server、micro-weather-eureka-client 和msa-weather-city-eureka,以及micro-weather-eureka-client-ribbon和micro-weather- eureka-client-feign。