答案: 微服务架构是单机架构的未来, 但不是银弹多用于增长型业务!
如果你是一位软件行业从业者,尤其是从事服务器端或者后台系统软件开发,相信近年来一定被层出不穷的商业名词所包围:NoSQL、Big Data、Web-scale、Sharding、Eventual consistency、ACID、CAP理论、云服务、MapReduce和Real-time等,所有这些其实都围绕着如何构建高效存储与数据处理这一核心主题。
过去十年,在数据库领域与分布式系统方面涌现了许多引人瞩目的进展,由此深刻地影响了如何构建上层应用系统。分析这些激动人心的变化背后,你会发现有以下几个非常重要的驱动因素:
互联网公司,包括Google、Yahoo! 、Amazon、Facebook、LinkedIn、Microsoft,以及Twitter等,它们每天都在面对海量数据和负载,迫使其不断创新,并改进支撑系统以更有效地处理这种量级的数据。商业方面因素,如敏捷开发、测试驱动和对市场机会做出快速反应等,都要求尽量缩短产品开发周期,因此系统中的数据模型也要足够灵活以方便调整。
硬件方面,CPU主频增长日趋缓慢,而多核系统成为新常态,网络速度则依旧保持快速发展,这就意味着并行分布式系统将会成为业界主流。
<数据密集型应用系统设计>
答案: 先有微服务后有SpringCloud !
2014年3月25日 敏捷开发教父 Martin Fowler 在 Microservices 一文中 对于 Microservice Architecture 进行了条理清晰的论述, 向世人展示了进可攻退可守的微服务架构思想, 奠定了后来者对 微服务的认知.
早期 SpringCloud & Angel 系列基于Spring Boot 1.2.x, 而1.2版本最早诞生于 2014年12月11日,也就是说至少晚了8个月多! 其中很多设计思想也来源于前者!
(数据来源: github) 又一个活生生的学术界驱动工业界的例子. 所以大家有空还是要关注一下 学术界大牛们的新作.才能保证走在技术最前沿.
笔者通过翻阅 Martin Fowler 发表的文章 Microservices , 将微服务理念梳理为以下 7 点
通过服务进行组件化: 组件是独立可替换和可升级的软件单元。微服务架构将使用库,但是它们将自己的软件组成组件的主要方式是分解成服务。我们将库定义为链接到程序并使用内存中函数调用进行调用的组件,而服务则是进程外组件,它们通过某种机制(例如Web服务请求或远程过程调用)进行通信。
分散治理: 集中治理的后果之一是倾向于在单一技术平台上实现标准化。经验表明,这种方法是束手无策的-并非每个问题都是钉子,也不是每个解决方案都是锤子。我们更喜欢使用正确的工具来完成工作,而整体式应用程序可以在一定程度上利用不同的语言,但这并不常见。
分散数据管理: 数据管理的分散化以多种不同的方式呈现。从最抽象的角度讲,这意味着系统的世界概念模型将有所不同。在大型企业中进行集成时,这是一个常见问题,客户的销售视图将与支持视图不同。在销售视图中被称为客户的某些内容可能根本不会出现在支持视图中。那些具有相同属性的属性可能具有不同的语义,并且(更差的)公共属性具有不同的语义。
智能端点和哑管道: 在不同流程之间建立通信结构时,我们已经看到了许多产品和方法,这些产品和方法强调在通信机制本身中投入大量智慧。一个很好的例子是企业服务总线(ESB),其中ESB产品通常包括用于消息路由,编排,转换和应用业务规则的复杂工具。
基础设施自动化: 我们希望尽可能地放心我们的软件正在运行,因此我们运行了许多自动化测试。升级工作软件的渠道意味着我们可以自动部署 到每个新环境。
失败设计: 使用服务作为组件的结果是,需要对应用程序进行设计,以便它们可以容忍服务故障。由于供应商不可用,任何服务呼叫都可能失败,客户必须尽可能优雅地响应此请求。与单片设计相比,这是一个缺点,因为它引入了额外的处理复杂性。结果是微服务团队不断反思服务故障如何影响用户体验。Netflix的Simian Army 在工作日内导致服务甚至数据中心发生故障,以测试应用程序的弹性和监视能力。
进化设计: 每当您尝试将软件系统分解为组件时,您都会面临如何划分各个部分的决定-我们决定对应用程序进行分割的原则是什么?组件的关键属性是独立替换和可升级性的概念[13] -这意味着我们寻找可以想象重写组件而不影响其协作者的观点。实际上,许多微服务组通过明确期望许多服务将被废弃而不是长期发展而将其进一步发展。
没接触过微服务的小伙伴看完晕倒了过去, 过一会醒来疯狂挠头, 这知识不过脑子啊 !
轻点,注意发量哈
其实每一个点对应的都是一种微服务场景的解决方案。 而这些解决方案可能是 Spring 官方提供,有可能是 别的公司提供. 或者两者都有…
笔者才毕业时那会业内流行 Dubbo , 只要涉及到有点难度的项目 别管并发,数据量怎么样, 都一律上 Dubbo 生产者消费者分离, 和今天小伙伴们使用 SpringCloud 的热情如出一辙, 但是那时候 微服务这个概念并不是很火热 !
Dubbo 官方定义: Apache Dubbo |ˈdʌbəʊ| 是一款高性能、轻量级的开源Java RPC框架,它提供了三大核心能力:面向接口的远程方法调用,智能容错和负载均衡,以及服务自动注册和发现。
SpringCloud 官方定义: SpringCloud基于SpringBoot为开发人员提供了组件,以快速构建分布式系统中的一些常见模式(例如,配置中心,服务发现,断路器,智能路由,微代理,控制总线,一次性令牌,全局锁,领导选举,分布式会话,群集状态)。分布式系统的协调导致样板式样,并且使用Spring Cloud开发人员可以快速站起来实现这些样板的服务和应用程序。它们可以在任何分布式环境中正常工作,包括开发人员自己的笔记本电脑,裸机数据中心以及Cloud Foundry等托管平台。
从技术栈上来看
dubbo:zookeeper+dubbo+springmvc/springboot
通信方式:rpc
注册中心:zookeeper,nacos
配置中心:diamond(淘宝开发)
spring cloud:spring+Netflix
通信方式:http restful
注册中心:eureka,consul,nacos
配置中心:config
断路器:hystrix
网关:zuul,gateway
分布式追踪系统:sleuth+zipkin
诚然 Dubbo 已经跟不上目前 微服务思想的发展了, 我们在做微服务的时候 首选 SpringCloud.那 SpringCloud 有那么多组合我们选哪个好呢?
SpringCloud 有哪些主流组合呢?
两者的优缺点: SpringCloud 是一项标准而不是一门技术, 你可以在它们互相兼容的前提下同时使用两大阵营的组件, 两者最大的不同在于, Netflix 的服务通信基于 Feign 组件倾向于 HTTP RestFul, 而 Alibaba 的服务通信 基于 Dubbo 组件 的 RPC 调用, 从这里不难看出来, 它们的基本盘分别是 SpringBoot 与 Dubbo, 如果你的项目基于 SpringBoot 就首选 Netflix , 如果你的项目基于 Dubbo 就首选 Alibaba 这样对于重构系统来说会减少很多工作量, 从社区的角度看, 大家都知道 2018-12-12日,Netflix宣布Spring Cloud Netflix 除了 Eureka 其它组件都进入维护状态(不会推出新功能), 但不等于 Netflix 就毫无希望, 最近 Netflix 推出了 PRE 3.0 M1 对 Eureka 进行迭代, 而 Alibaba 这个后起之秀的 GitHub Fork 数为 3.8 K 而 Netflix 为 2K 近乎两倍, 对拥有国内 70% 市场的 Netflix 来说 进入维护状态的 组件可以, 用别的组件来替代就可以, 而如果使用了 Alibaba 就被被捆绑销售了 一堆自己的技术以及阿里云的东西 … 技术选型上面没有银弹, 选择最适合项目的技术即可 !
推荐 SpringCloud-Netflix组合
服务注册与发现组件:Eureka,Zookeeper,Consul,Nacos等。Eureka基于REST风格的。
服务调用组件:Hystrix(熔断降级,在出现依赖服务失效的情况下,通过隔离 系统依赖服务 的方式,防止服务级联失败,同时提供失败回滚机制,使系统能够更快地从异常中恢复),Ribbon(客户端负载均衡,用于提供客户端的软件负载均衡算法,提供了一系列完善的配置项:连接超时、重试等),OpenFeign(优雅的封装Ribbon,是一个声明式RESTful网络请求客户端,它使编写Web服务客户端变得更加方便和快捷)。
网关:路由和过滤。Zuul,Gateway。
配置中心:提供了配置集中管理,动态刷新配置的功能;配置通过Git或者其它方式来存储。
消息组件:Spring Cloud Stream(对分布式消息进行抽象,包括发布订阅、分组消费等功能,实现了微服务之间的异步通信)和Spring Cloud Bus(主要提供服务间的事件通信,如刷新配置)
安全控制组件:Spring Cloud Security 基于OAuth2.0开放网络的安全标准,提供了单点登录、资源授权和令牌管理等功能。
链路追踪组件:Spring Cloud Sleuth(收集调用链路上的数据),Zipkin(对Sleuth收集的信息,进行存储,统计,展示)
微服务概念 | 技术栈 | 实现原理 | 类似方案 |
---|---|---|---|
通过服务进行组件化: 组件是独立可替换和可升级的软件单元。 | Eureka , OpenFeign | 服务注册与发现组件后使用服务调用组件,组件之间可以通过HTTP复用 | Dubbo |
分散治理: 集中治理的后果之一是倾向于在单一技术平台上实现标准化。 | Zuul,Eureka | 通过网关路由给服务生产者, 网关,生产者可以拥有多实例 | Nginx |
分散数据管理: 那些具有相同属性的属性可能具有不同的语义,并且(更差的)公共属性具有不同的语义。 | SpringCloud Config ,Bus | 提供了配置集中管理,动态刷新配置的功能;每个微服务都可以有自己的数据配置. | yml |
智能端点和哑管道: 一个很好的例子是企业服务总线(ESB),其中ESB产品通常包括用于消息路由,编排,转换和应用业务规则的复杂工具。 | SpringCloudStream | 对分布式消息进行抽象,包括发布订阅、分组消费等功能,实现了微服务之间的异步通信. | ApplicationEvent |
基础设施自动化: 升级工作软件的渠道意味着我们可以自动部署 到每个新环境。 | Jenkins, Docker, ,SpringCloudSleuth, Zipkin | 使用 Jenkins 进行 CI/CD到微服务到 Docker 后用 Sleuth,Zipkin 监控. | elk |
失败设计: 使用服务作为组件的结果是,需要对应用程序进行设计,以便它们可以容忍服务故障。 | Hystrix | Hystrix 熔断降级,在出现依赖服务失效的情况下,通过隔离 系统依赖服务 的方式,防止服务级联失败,同时提供失败回滚机制,使系统能够更快地从异常中恢复. | Nginx+Lua |
进化设计: 组件的关键属性是独立替换和可升级性的概念[13] -这意味着我们寻找可以想象重写组件而不影响其协作者的观点。 | k8s , Eureka, Ribbon,Sleuth,zipkin | 我认为这里表述的是可维护性, 也就是说 运维能力, 使用Sleuth,zipkin 监控服务流量, 在热点服务流量几何形增长时用 k8s 进行扩容, 基于 Eureka 与 Ribbon 进行流量分发 | OpenStack |
注册中心 (场景: 服务注册与服务发现, 可以理解为 IM服务器)
从eureka-core 包中的 AbstractInstanceRegistry 类看起
* Handles all registry requests from eureka clients. * * * Primary operations that are performed are the * Registers, Renewals, Cancels, Expirations, and Status Changes The * registry also stores only the delta operations * * @author Karthik Ranganathan * */ private final ConcurrentHashMap<String, Map<String, Lease<InstanceInfo>>> registry = new ConcurrentHashMap<String, Map<String, Lease<InstanceInfo>>>();
- 第一层的 Map , K 是应用名称. V 是Map 多实例元信息
- 第二层 Map 为保持更多实例信息, K 为 实例名称, V 为实例详细信息(注册信息,ip地址,实例id,端口, 状态等)
- Eureka 通过维护 这个
ConcurrentHashMap
实现服务注册以及发现.建议可以从 193行 public void register(InstanceInfo registrant, int leaseDuration, boolean isReplication) 微服务注册方法看起
API 网关 (场景: 动态路由, 监控, 可以理解为 快递揽件配送)
从 org.springframework.cloud.netflix.zuul.filters.support FilterConstants 类看起
这个类中是有和 上面的Filters 相关的常量
// Zuul Filter TYPE constants ----------------------------------- /** * {@link ZuulFilter#filterType()} error type. */ public static final String ERROR_TYPE = "error"; /** * {@link ZuulFilter#filterType()} post type. */ public static final String POST_TYPE = "post"; /** * {@link ZuulFilter#filterType()} pre type. */ public static final String PRE_TYPE = "pre"; /** * {@link ZuulFilter#filterType()} route type. */ public static final String ROUTE_TYPE = "route"; // OTHER constants -----------------------------------
对这几个 常量全局搜索 会找到与上述功能相同的过滤器类
PreDecorationFilter
SendForwardFilter
SendResponseFilter
SendErrorFilter
PreDecorationFilter 128行 初始化请求参数映射
RequestContext ctx = RequestContext.getCurrentContext(); ...
之后 通过转发过滤实现上述功能 !
RequestDispatcher dispatcher = ctx.getRequest().getRequestDispatcher(path);
RestTemplate (场景: 简化 HTTP 通信方式,统一了RESTful的标准并为 执行复杂任务提供了一种具有默认行为的简化方法, 可以理解为 GOF中的 模板模式)
Spring 核心 HTTP 消息转换器
HttpMessageConverter
Rest自描述信息: 媒体类型 (
MediaType
) : text/html; text/xml; application/jsonHTTP 协议特点: 纯文本协议 ,需要自我描述
- REST 客户端
- REST 服务端
反序列化 : 文本(通信) —> 对象(程序使用)
序列化: 对象(程序) ----> 文本(通信)
分析 HttpMessageConverter
// 策略接口,它指定了一个转换器,可以将请求和响应转换为HTTP请求和响应。 public interface HttpMessageConverter<T> { // 判断当前
泛型是否可以反序列化 boolean canRead(Class<?> clazz, @Nullable MediaType mediaType); // 判断当前泛型是否可以序列化 boolean canWrite(Class<?> clazz, @Nullable MediaType mediaType); // 当前支持的媒体类型 List<MediaType> getSupportedMediaTypes(); // 反序列化对象 T read(Class<? extends T> clazz, HttpInputMessage inputMessage) throws IOException, HttpMessageNotReadableException; }特别提醒: SpringWebMVC 依赖于 Servlet, Spring 在设计早期时, 它就考虑到了去 Servlet 化.
HttpInputMessage 类似于 HttpServletRequest
RestTemplate
利用HttpMessageConverter
对一些媒体类型进行通用的序列化和反序列化
- JSON
- XML
- TEXT
- ByteArrays
它不依赖于
Servlet
它自定义实现, 对于 服务端而言. 将ServletAPI
适配或HttpInputMessage
以及HttpOutputMessage
.
RestTemplate 对应多个 HttpMessageConverter 那么如何决策正确的媒体类型
将各种常用 HttpMessageConverter 支持的MediaType 和 JavaType 以及对应关系总结在此处:
类名 支持的JavaType 支持的MediaType ByteArrayHttpMessageConverter byte[] application/octet-stream, / StringHttpMessageConverter String text/plain, / MappingJackson2HttpMessageConverter Object application/json, application/*+json AllEncompassingFormHttpMessageConverter Map > application/x-www-form-urlencoded, multipart/form-data SourceHttpMessageConverter Source application/xml, text/xml, application/*+xml RestTemplate 对应多个
HttpMessageConverter
, 那么如何决策正确媒体类型 ?// 同志们 顺着方法调用栈追踪源码. 别怕, 前方安全, 有注释 ! // 建议 Debug 行点. // RestTemplate: 190,419,673,769,850 // HttpMessageConverterExtractor: 89 @Test public void getForObject() throws Exception { RestTemplate restTemplate = new RestTemplate( new HttpComponentsClientHttpRequestFactory()); // restTemplate = new RestTemplate(); // restTemplate = new RestTemplate(new OkHttp3ClientHttpRequestFactory()); // 设置拦截器记录HTTP请求到响应时间 restTemplate.setInterceptors(Arrays.asList(new TimeInterceptor())); String result = restTemplate.getForObject("https://example.com",String.class); } // 记录响应时间拦截器 class TimeInterceptor implements ClientHttpRequestInterceptor { @Override public ClientHttpResponse intercept(HttpRequest request, byte[] body, ClientHttpRequestExecution execution) throws IOException { // 举一反三: 也可以在请求前进行负载均衡到具体 IP long frontNow = System.currentTimeMillis(); ClientHttpResponse response = execution.execute(request, body); // 获取请求消耗时间 System.out.println("消耗时间"+ (System.currentTimeMillis() - frontNow) / 1000 + "秒"); return response; } }
从 SpringWeb包 org.springframework.web.client.RestTemplate 类看起
public class RestTemplate extends InterceptingHttpAccessor implements RestOperations{ private final List<HttpMessageConverter<?>> messageConverters = new ArrayList<>(); static { // 初始化时 判断 第三方 HttpMessageConverter 实现是否存在 ClassLoader classLoader = RestTemplate.class.getClassLoader(); jackson2XmlPresent = ClassUtils.isPresent("com.fasterxml.jackson.dataformat.xml.XmlMapper", classLoader); gsonPresent = ClassUtils.isPresent("com.google.gson.Gson", classLoader); ... } public RestTemplate() { // 存在的默认内置 HttpMessageConverter以及第三方实现 按顺序装入 messageConverters this.messageConverters.add(new ByteArrayHttpMessageConverter()); if (jackson2XmlPresent) { this.messageConverters.add(new MappingJackson2XmlHttpMessageConverter()); } if(..){...} .... } public RestTemplate(ClientHttpRequestFactory requestFactory) { this(); // 设置 requestFactory 适配器进行 http 请求 this.setRequestFactory(requestFactory); } @Override @Nullable public <T> T getForObject(String url, Class<T> responseType, Object... uriVariables) throws RestClientException { // 用期望 返回对象.class 初始 RequestCallback 对象, 响应后的用于反序列化 RequestCallback requestCallback = acceptHeaderRequestCallback(responseType); // 根据 HttpMessageConverter 初始化 HttpMessageConverterExtractor 用来处理拿到响应后的反序列化策略 HttpMessageConverterExtractor<T> responseExtractor = new HttpMessageConverterExtractor<>(responseType, getMessageConverters(), logger); // 调用抽象执行层 return execute(url, HttpMethod.GET, requestCallback, responseExtractor,uriVariables); } @Override @Nullable public <T> T execute(String url, HttpMethod method, @Nullable RequestCallback requestCallback, @Nullable ResponseExtractor<T> responseExtractor, Object... uriVariables) throws RestClientException { // 将 URL 与 动态参数 拼装为 真实URL URI expanded = getUriTemplateHandler().expand(url, uriVariables); return doExecute(expanded, method, requestCallback, responseExtractor); } @Nullable protected <T> T doExecute(URI url, @Nullable HttpMethod method, @Nullable RequestCallback requestCallback, @Nullable ResponseExtractor<T> responseExtractor) throws RestClientException { // URL 与 method 不可为空 Assert.notNull(url, "URI is required"); Assert.notNull(method, "HttpMethod is required"); ClientHttpResponse response = null; try { // 创建通用 ClientHttpRequestFactory 请求对象 ClientHttpRequest request = createRequest(url, method); if (requestCallback != null) { // 给请求头 Accept 设置 可序列化的 HttpMessageConverter.MediaType 策略 requestCallback.doWithRequest(request); } // 执行请求拦截器链并使用 ClientHttpRequestFactory 适配实现类发送请求, 获取 响应文本报文 response = request.execute(); // 处理给定的响应,执行适当的日志记录并调用 ResponseErrorHandler 处理异常 handleResponse(url, method, response); // 使用 extractData() 将文本数据按 messageConverters匹配顺序反序列化为 期望返回对象 return (responseExtractor != null ? responseExtractor.extractData(response) : null); } catch (IOException ex) { String resource = url.toString(); String query = url.getRawQuery(); resource = (query != null ? resource.substring(0, resource.indexOf('?')) : resource); throw new ResourceAccessException("I/O error on " + method.name() + " request for \"" + resource + "\": " + ex.getMessage(), ex); } finally { if (response != null) { // 因为当前 response 对象是 接口所以无法使用 jdk7自动关闭流, 需手动关闭 response.close(); } } } public void doWithRequest(ClientHttpRequest request) throws IOException { if (this.responseType != null) { List<MediaType> allSupportedMediaTypes = (List)RestTemplate.this.getMessageConverters().stream().filter((converter) -> { return this.canReadResponse(this.responseType, converter); }).flatMap(this::getSupportedMediaTypes).distinct().sorted(MediaType.SPECIFICITY_COMPARATOR).collect(Collectors.toList()); // debug 模式 打印日志 if (RestTemplate.this.logger.isDebugEnabled()) { RestTemplate.this.logger.debug("Accept=" + allSupportedMediaTypes); } // 给请求头 Accept 设置 可序列化的 HttpMessageConverter.MediaType 策略 request.getHeaders().setAccept(allSupportedMediaTypes); } } } // 其实可以看出来 源码阅读不是很难, 读者朋友们以后可以和面试官吹你看过 spring http 的核心源码了
SpringCloudOpenFeign 服务调用(场景: Feign 是一个声明式Web Service客户端。使用Feign能让编写Web Service客户端更加简单, 它的使用方法是定义一个接口,然后在上面添加注解,同时也支持JAX-RS标准的注解。Feign 也支持可拔插式的编码器和解码器。SpringCloud对Feign 进行了封装,使其支持了Spring MVC标准注解和HttpMessageConverters 从而成为 SpringCloudOpenFeign 。SpringCloudOpenFeign可以与Eureka和Ribbon组合使用以支持负载均衡,或者与Hystrix组合使用支持FallBack 服务降级。可以理解为 标准化调用流程)
REST 服务端框架纵向比较
Feign 的灵感来自于 JAX-RS(Java REST 标准), 但是太多人基于 JAX-RS 重复发明轮子了
JAX-RS: Java_REST标准. 可移植性高, Jersey (Servlet 容器), Weblogic.
JSR-RS 参考链接: https://github.com/mercyblitz/jsr/tree/master/REST
技术栈 | HTTP请求方式表达 | 变量路径 | 请求参数 |
---|---|---|---|
JAX-RS | @Get | @RathParam | @FormParam |
Feign | @RequestLine("GET | @Param | @Param |
Spring Web MVC | @GetMapping | @PathVariable | @RequestParam |
SpringCloudOpenFeign | @GetMapping | @PathVariable | @RequestParam |
举个栗子: SpringCloudOpenFeign-Demo
<dependency>
<groupId>org.springframework.cloudgroupId>
<artifactId>spring-cloud-starter-openfeignartifactId>
dependency>
// SpringCloudOpenFeign 配置类 , 如要运行 demo 请对 TODO 进行替换
@Configuration
@EnableFeignClients(basePackages = "com.my.TODO")
public class FeignConfiguration {
/**
* Set the Feign specific log level to log client REST requests.
*/
@Bean
feign.Logger.Level feignLoggerLevel() {
return feign.Logger.Level.BASIC;
}
}
import feign.hystrix.FallbackFactory;
import lombok.extern.slf4j.Slf4j;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.http.MediaType;
import org.springframework.stereotype.Component;
import org.springframework.web.bind.annotation.*;
// 如要运行 demo 请对 TODO 进行替换
@FeignClient(value = "TODO 你要调用微服务的 spring.application.name", fallbackFactory = UserServiceFallbackFactory.class)
public interface DemoServiceClient {
@PutMapping(value = "/demo/keys/{key}", produces = MediaType.APPLICATION_JSON_VALUE)
public Boolean setKey(@PathVariable(value = "key") String key, @RequestParam("value") String value);
@GetMapping(value = "/demo/keys/{key}", produces = MediaType.APPLICATION_JSON_VALUE)
public String getKey(@PathVariable(value = "key") String key);
}
@Component
@Slf4j
class UserServiceFallbackFactory implements FallbackFactory<DemoServiceClient> {
@Override
public DemoServiceClient create(final Throwable throwable) {
return new DemoServiceClient() {
@Override
public Boolean setKey(String key, String value) {
log.warn("Fallback reason={}", throwable.getMessage());
return false;
}
@Override
public String getKey(String key) {
log.warn("Fallback reason={}", throwable.getMessage());
return null;
}
};
}
}
客户端web接口代码
import io.swagger.annotations.ApiImplicitParam;
import io.swagger.annotations.ApiImplicitParams;
import io.swagger.annotations.ApiOperation;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;
@RestController
@RequestMapping("/openfeign-demo")
@Slf4j
public class DemoResource {
@Autowired
private DemoServiceClient demoServiceClient;
@ApiOperation(value = "根据 K 查看 V值", notes="根据 K 查看 V值 notes")
@ApiImplicitParams({
@ApiImplicitParam(name = "key" , value = "key", required = true, dataType = "string", paramType = "path"),
})
@GetMapping(value = "/{key}", produces = "application/json;charset=UTF-8")
public String getValue(@PathVariable String key) {
return demoServiceClient.getKey(key);
}
@ApiOperation(value = "设置 K/V", notes="设置 K/V notes")
@ApiImplicitParams({
@ApiImplicitParam(name = "key", value = "key", required = true, dataType = "string", paramType = "path"),
@ApiImplicitParam(name = "value", value = "value", required = true, dataType = "string", paramType = "query")
})
@PutMapping(value = "/{key}", produces = "application/json;charset=UTF-8")
public Boolean setValue(@PathVariable String key, @RequestParam("value") String value) {
return demoServiceClient.setKey(key,value);
}
}
spring:
application:
name: TODO
服务端Web接口代码
import io.swagger.annotations.ApiImplicitParam;
import io.swagger.annotations.ApiImplicitParams;
import io.swagger.annotations.ApiOperation;
import org.springframework.web.bind.annotation.*;
import java.util.concurrent.ConcurrentHashMap;
@RestController
@RequestMapping("/demo")
public class DemoController {
private static volatile ConcurrentHashMap<String,String> kv = new ConcurrentHashMap(20);
static {
kv.put("1024","hello OpenFeign");
}
@ApiOperation(value = "根据 K 查看 V值", notes="根据 K 查看 V值 notes")
@ApiImplicitParams({
@ApiImplicitParam(name = "key" , value = "key", required = true, dataType = "string", paramType = "path"),
})
@GetMapping(value = "/keys/{key}", produces = "application/json;charset=UTF-8")
public String getValue(@PathVariable String key) {
return String.valueOf(kv.get(key));
}
@ApiOperation(value = "设置 K/V", notes="设置 K/V notes")
@ApiImplicitParams({
@ApiImplicitParam(name = "key", value = "key", required = true, dataType = "string", paramType = "path"),
@ApiImplicitParam(name = "value", value = "value", required = true, dataType = "string", paramType = "query")
})
@PutMapping(value = "/keys/{key}", produces = "application/json;charset=UTF-8")
public Boolean setValue(@PathVariable String key, @RequestParam("value") String value) {
Object put = kv.put(key, value);
return kv.containsKey(key);
}
}
import org.junit.Test;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.http.HttpEntity;
import org.springframework.http.HttpHeaders;
import org.springframework.http.HttpMethod;
import org.springframework.http.client.HttpComponentsClientHttpRequestFactory;
import org.springframework.web.client.RestTemplate;
import static org.junit.Assert.assertEquals;
@SpringBootTest(classes = TODORun.class)
public class DemoResourceTest {
@SneakyThrows
@Test
public void b_Key() throws Exception {
RestTemplate restTemplate = new RestTemplate(new HttpComponentsClientHttpRequestFactory());
Boolean setKeyRespond = restTemplate.exchange("http://TODO客户端ip端口/openfeign-demo/1025?value=gczy",HttpMethod.PUT,new HttpEntity<Void>(new HttpHeaders()),Boolean.class).getBody();
String getKeyRespond = restTemplate.getForObject("http://localhost:8081/openfeign-demo/1024", String.class);
String getsetKeyRespond = restTemplate.getForObject("http://TODO客户端ip端口/openfeign-demo/1025", String.class);
assertEquals(setKeyRespond,Boolean.TRUE);
assertEquals(getKeyRespond, "hello OpenFeign");
assertEquals(getsetKeyRespond, "gczy");
}
}
// 节选部分源码 SpringCloudOpenFeign-core 2.2.2
// 同志们 顺着方法调用栈追踪源码. 别怕, 前方安全, 有注释 !
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
@Documented
@Import(FeignClientsRegistrar.class)
public @interface EnableFeignClients {
String[] basePackages() default {};
}
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface FeignClient {
@AliasFor("name")
String value() default "";
}
// 实现接口的中的方法完成 Feign 注册bean
class FeignClientsRegistrar implements ImportBeanDefinitionRegistrar, ResourceLoaderAware, EnvironmentAware {
private ResourceLoader resourceLoader;
private Environment environment;
@Override
public void registerBeanDefinitions(AnnotationMetadata metadata, BeanDefinitionRegistry registry) {
//
registerDefaultConfiguration(metadata, registry);
registerFeignClients(metadata, registry);
}
@Override
public void setResourceLoader(ResourceLoader resourceLoader) {
this.resourceLoader = resourceLoader;
}
@Override
public void setEnvironment(Environment environment) {
this.environment = environment;
}
private void registerDefaultConfiguration(AnnotationMetadata metadata,
BeanDefinitionRegistry registry) {
// 获得 @EnableFeignClients() 注解的自定义属性
Map<String, Object> defaultAttrs = metadata
.getAnnotationAttributes(EnableFeignClients.class.getName(), true);
// 当前项目是否使用 SpringCloudOpenFeign - @EnableFeignClients()
if (defaultAttrs != null && defaultAttrs.containsKey("defaultConfiguration")) {
String name;
// 判断当前标识 @EnableFeignClients() 的配置类是否为封闭类
if (metadata.hasEnclosingClass()) {
name = "default." + metadata.getEnclosingClassName();
}
else {
name = "default." + metadata.getClassName();
}
// 初始化注册客户端配置为bean
registerClientConfiguration(registry, name,
defaultAttrs.get("defaultConfiguration"));
}
}
public void registerFeignClients(AnnotationMetadata metadata,
BeanDefinitionRegistry registry) {
// 初始化包扫描器和类加载器
ClassPathScanningCandidateComponentProvider scanner = getScanner();
scanner.setResourceLoader(this.resourceLoader);
Set<String> basePackages;
// 获得 @EnableFeignClients() 注解的自定义属性
Map<String, Object> attrs = metadata
.getAnnotationAttributes(EnableFeignClients.class.getName());
// 初始化包含类型筛选器
AnnotationTypeFilter annotationTypeFilter = new AnnotationTypeFilter(
FeignClient.class);
// 查看 @EnableFeignClients() clients属性是否指定 FeignClient客户端
final Class<?>[] clients = attrs == null ? null
: (Class<?>[]) attrs.get("clients");
// 如果没有指定就根据 @EnableFeignClients() 属性获得客户端全部包名
if (clients == null || clients.length == 0) {
scanner.addIncludeFilter(annotationTypeFilter);
basePackages = getBasePackages(metadata);
}
else {
// 指定clients属性则走原有逻辑
final Set<String> clientClasses = new HashSet<>();
basePackages = new HashSet<>();
for (Class<?> clazz : clients) {
basePackages.add(ClassUtils.getPackageName(clazz));
clientClasses.add(clazz.getCanonicalName());
}
AbstractClassTestingTypeFilter filter = new AbstractClassTestingTypeFilter() {
@Override
protected boolean match(ClassMetadata metadata) {
String cleaned = metadata.getClassName().replaceAll("\\$", ".");
return clientClasses.contains(cleaned);
}
};
scanner.addIncludeFilter(
new AllTypeFilter(Arrays.asList(filter, annotationTypeFilter)));
}
// 根据全部自定义包名寻找 @FeignClient 类客户端
for (String basePackage : basePackages) {
// 将 @FeignClient 类全部初始化为 bean
Set<BeanDefinition> candidateComponents = scanner
.findCandidateComponents(basePackage);
for (BeanDefinition candidateComponent : candidateComponents) {
if (candidateComponent instanceof AnnotatedBeanDefinition) {
// verify annotated class is an interface
AnnotatedBeanDefinition beanDefinition = (AnnotatedBeanDefinition) candidateComponent;
AnnotationMetadata annotationMetadata = beanDefinition.getMetadata();
// 过滤 @FeignClient 非接口形式的客户端.
Assert.isTrue(annotationMetadata.isInterface(),
"@FeignClient can only be specified on an interface");
// 获取 @FeignClient 类的全部属性
Map<String, Object> attributes = annotationMetadata
.getAnnotationAttributes(
FeignClient.class.getCanonicalName());
// 获取调用微服务名称
String name = getClientName(attributes);
// 注册 @FeignClient 类为bean
registerClientConfiguration(registry, name,
attributes.get("configuration"));
// 将@FeignClient 服务接口形成代理实现 @RequestParam() @GetMapping()
registerFeignClient(registry, annotationMetadata, attributes);
}
}
}
}
}
深入浅出分享 Java 干货 , 找回对代码的 Passion , 助力月入 20K+