试水Spring Cloud Hystrix

Posted 2021-01-08 Interest-Driven Engineer, for

Spring Cloud Hystrix是一个容错库，它实现了断路器模式，使得当服务发生异常时，会自动切断连接，并将请求引导至预设的回调方法。

服务端

在Spring Tool Suite的文件菜单中，点击新建Spring Starter Project。建立一个普通的Restful风格的服务。

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@SpringBootApplication
public class SpringcloudHystrixServerApplication {

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

	@RequestMapping(value = "/message")
	public String getMessage() {
		return "Hello World!";
	}
}

application.properties文件中配置服务的端口，server.port=8200。

服务启动后，可以在浏览器查看相应接口。

客户端

再建立一个客户端应用程序，在创建时选择Hystrix，Hystrix Dashboard，Actuator和Web模块。

项目创建完成后，添加一个Service，其中包括调用服务端接口的方法及一个回调方法。注意这里@HystrixCommand的用法。

import java.net.URI;

import org.springframework.stereotype.Service;
import org.springframework.web.client.RestTemplate;

import com.netflix.hystrix.contrib.javanica.annotation.HystrixCommand;

@Service
public class MessageService {
	private final RestTemplate restTemplate;

	public MessageService(RestTemplate rest) {
		this.restTemplate = rest;
	}

	@HystrixCommand(fallbackMethod = "reliable")
	public String getMessage() {
		URI uri = URI.create("http://localhost:8200/message");

		return this.restTemplate.getForObject(uri, String.class);
	}

	public String reliable() {
		return "Woo, something wrong!";
	}
}

在客户端的入口方法加上@EnableCircuitBreaker标记，并把它的端口设为server.port=8300。

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.web.client.RestTemplateBuilder;
import org.springframework.cloud.client.circuitbreaker.EnableCircuitBreaker;
import org.springframework.cloud.netflix.hystrix.dashboard.EnableHystrixDashboard;
import org.springframework.context.annotation.Bean;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.client.RestTemplate;

@EnableHystrixDashboard
@EnableCircuitBreaker
@RestController
@SpringBootApplication
public class SpringcloudHystrixClientApplication {

	@Autowired
	private MessageService messageService;

	@Bean
	public RestTemplate rest(RestTemplateBuilder builder) {
		return builder.build();
	}

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

	@RequestMapping("/message")
	public String getMessge() {
		return messageService.getMessage();
	}
}

启动客户端后，如果在浏览器里看到页面能正常获取服务端的数据，说明当前客户端与服务端运作都是正常的。

然后，停止服务端，让情况出现异常。

刷新页面，可以看到这次的结果也在预料之内，当客户端调用服务端失败后，通过Hystrix的作用，自动切换至调用预设的回调方法。

仪表盘

Hystrix自带可视化仪表盘，在上面的客户端代码中，入口方法除了增加了@EnableCircuitBreaker标记外，还有@EnableHystrixDashboard。这样的设置便可以启用Hystrix的仪表盘。

不过在application.properties文件还需要加上以下配置，以避免“Unable to connect to Command Metric Stream”错误。

management.endpoints.web.exposure.include=hystrix.stream
management.endpoints.web.base-path=/

当客户端被启动后，使用http://localhost:8300/hystrix路径可以直接访问仪表盘。

之后在Hystrix Dashboard下面的地址栏内填上http://localhost:8300/hystrix.stream，再点击Monitor Stream按钮，监控结果一览无遗。