点击关注了解更多精彩内容！！
开发团队选择同样的开发框架能够更好的进行经验积累和知识共享，从而提高开发效率。在实际项目中，这个过程经常被打破。团队需要根据用户需求的变化，选择更好的开发框架来解决面对的新问题。每个开发团队都不得不采取“持续迭代演进”的方法，来改造旧系统，开发新系统。
在单体应用微服务改造实践中，分享了一种单体应用“持续迭代”改造微服务的方法。本文结合在改造过程中多微服务框架并存问题，描述一下使用CSE的开发实践。
本文假设应用已经采用网关搭建可持续演进的架构，如下图。这个架构由多种开发框架构建的基于REST的微服务组成。
本文提供的示例项目代码托管在[github](https://github.com/huaweicse/cse-java-chassis-samples/tree/master/multi-framework) 。
01
网关转发规则开发
CSE提供的Edge service默认提供的转发规则对于采用CSE开发的微服务最简单，功能也最强大。根据配置的URL规则，将请求转发到对应的微服务，只是网关核心功能之一。当Edge service将请求转发到CSE的微服务时，还具备如下功能：
实例发现和动态更新。网关可以通过微服务名称从服务中心发现实例列表，并在实例列表变化的时候，自动更新。
实例隔离和重试。当微服务存在多个实例的时候，如果一个实例出现故障，那么可以进行一次重试，将请求转发到其他实例；如果一个实例多次出现故障，需要在后续请求中将该实例隔离一段时间，避免频繁失败。
支持灰度发布。网关可以结合请求参数规则，或者版本规则，将请求转发到符合规则的实例上面去。比如将请求参数count>20的请求转发给v2版本的实例，count<=20的请求转发给v1版本的实例。
支持AZ亲和。网关需要结合微服务部署的数据中心信息，将请求转发给就近的数据中心，以提高效率。
支持流量控制。可以针对微服务、微服务的某个接口进行流量控制。
自动按照接口兼容性转发。这个场景指的是如果微服务存在多个版本，比如v1存在接口/a/b/c，v2新增了接口/x/y/z，那么当用户请求/x/y/z的时候，能够自动将请求转发给v2，而不需要做任何配置。
支持故障注入。故障注入用于模拟故障，这个在开发测试阶段比较有用。通过模拟延时等情况，能够测试网关在异常情况下是否正常工作。
上面列的功能是Edge service的部分功能，这些功能都是开箱即用，无需用户开发的。此外，CSE提供Handler的机制，同时还实现了其他大量的开箱即用功能，本文就不一一详述了。下面的例子实现了一个Edge service转发给CSE服务的Dispatcher，CSE也默认提供了几个Dispatcher，本例子参考了默认的Dispatcher代码，定制了转发的URL。
public class DefaultCseDispatcher extends AbstractEdgeDispatcher { @Override public void init(Router router) { // Dispatcher patterns. This dispatcher only forward requests to store. router.routeWithRegex("/store/(.*)").handler(CookieHandler.create()); router.routeWithRegex("/store/(.*)").handler(createBodyHandler()); router.routeWithRegex("/store/(.*)").failureHandler(this::onFailure).handler(this::onRequest); }
protected void onRequest(RoutingContext context) { Map<String, String> pathParams = context.pathParams(); String microserviceName = "store"; String path = "/" + pathParams.get("param0");
EdgeInvocation edgeInvocation = new EdgeInvocation(); edgeInvocation.init(microserviceName, context, path, httpServerFilters); edgeInvocation.edgeInvoke(); }
@Override public int getOrder() { return 10000; }}Edge service可以通过Dispatcher扩展，将请求转发给非CSE开发的REST服务。并且提供了一些扩展API供开发者使用，使用这些扩展API，能够使用CSE提供的部分功能。
其中：
DiscoveryTree 集成了实例发现和动态更新、实例隔离、AZ亲和等功能。
LoadbalanceHandler 集成了重试、灰度发布等功能。
下面例子展示了将请求转发给auth服务。
public classGenericHttpWithDiscoveryDispatcherextends AbstractEdgeDispatcher { private static Logger LOGGER = LoggerFactory.getLogger(GenericHttpWithDiscoveryDispatcher.class);
private static Vertx vertx = VertxUtils.getOrCreateVertxByName("transport", null);
private static HttpClient httpClient = vertx.createHttpClient(new HttpClientOptions());
private DiscoveryTree discoveryTree = new DiscoveryTree();
private LoadbalanceHandler loadbalanceHandler;
class RetriableHandler implements Handler { private RoutingContext context;
private String path;
private Buffer data;
private boolean isRetry = false;
public RetriableHandler(RoutingContext context, String path) { this.context = context; this.path = path; this.context.response().setChunked(true); }
@Override public void handle(Invocation invocation, AsyncResponse asyncResponse) throws Exception { URIEndpointObject endpoint = (URIEndpointObject) invocation.getEndpoint().getAddress(); HttpClientRequest clietRequest = httpClient.request(context.request().method(), endpoint.getPort(), endpoint.getHostOrIp(), "/" + path + "?" + context.request().query(), clientResponse -> { context.response().setStatusCode(clientResponse.statusCode()); VertxHttpHeaders headers = new VertxHttpHeaders(); clientResponse.headers().forEach(entry -> { headers.add(entry.getKey(), entry.getValue()); }); context.response().headers().setAll(headers); clientResponse.handler(data -> { context.response().write(data); }); clientResponse.endHandler((v) -> { context.response().end(); asyncResponse.success("OK"); }); }); clietRequest.headers().setAll(context.request().headers()); clietRequest.exceptionHandler(e -> { asyncResponse.consumerFail(e); });
if (!isRetry) { // data can not be read twice, so cache it in retry this.context.request().handler(d -> { clietRequest.write(d); data = d; });
context.request().endHandler((v) -> { clietRequest.end(); });
isRetry = true; } else { if (data != null) { clietRequest.write(data); } clietRequest.end(); } } }
public GenericHttpWithDiscoveryDispatcher() { discoveryTree.addFilter(new IsolationDiscoveryFilter()); discoveryTree.addFilter(new ServerDiscoveryFilter()); discoveryTree.sort(); loadbalanceHandler = new LoadbalanceHandler(discoveryTree); }
@Override public int getOrder() { return 10001; }
@Override public void init(Router router) { // Dispatcher patterns. This dispatcher only forward requests to auth. String regex = "/auth/(.*)"; router.routeWithRegex(regex).failureHandler(this::onFailure).handler(this::onRequest); }
protected void onRequest(RoutingContext context) { Map<String, String> pathParams = context.pathParams();
String microserviceName = "auth"; String path = pathParams.get("param0");
Invocation invocation = new NonSwaggerInvocation(RegistryUtils.getAppId(), microserviceName, "0+", new RetriableHandler(context, path)); try { loadbalanceHandler.handle(invocation, resp -> { if (resp.isFailed()) { context.response().setStatusCode(resp.getStatusCode()); context.response().write(((Exception) resp.getResult()).getMessage()); context.response().end(); } }); } catch (Exception e) { LOGGER.error("", e); } }
}由于auth服务采用Spring MVC开发，该服务在注册的时候，不会生成契约信息。因此上面列出的几个功能是不具备的：
不支持流量控制。
不支持自动按照接口兼容性转发。
不支持故障注入。
此外，CSE通过Handler扩展提供的其他开箱即用功能，也是不具备的。
最后一个服务就是将请求转发给user了。user服务没有向服务中心注册，因此没有微服务信息，也没有契约信息。需要在代码里面写上实例列表和自己定义负载均衡。
public class GenericHttpDispatcher extends AbstractEdgeDispatcher { private static Logger LOGGER = LoggerFactory.getLogger(GenericHttpDispatcher.class);
private static Vertx vertx = VertxUtils.getOrCreateVertxByName("transport", null);
private static HttpClient httpClient = vertx.createHttpClient(new HttpClientOptions());
public GenericHttpDispatcher() { }
@Override public int getOrder() { return 10001; }
@Override public void init(Router router) { // Dispatcher patterns. This dispatcher only forward requests to user. String regex = "/user/(.*)"; router.routeWithRegex(regex).failureHandler(this::onFailure).handler(this::onRequest); }
protected void onRequest(RoutingContext context) { Map<String, String> pathParams = context.pathParams();
String path = pathParams.get("param0");
HttpClientRequest clietRequest = httpClient.request(context.request().method(), // hard coded ip/port here. can use configurations. 9093, "localhost", "/" + path + "?" + context.request().query(), clientResponse -> { context.response().setStatusCode(clientResponse.statusCode()); VertxHttpHeaders headers = new VertxHttpHeaders(); clientResponse.headers().forEach(entry -> { headers.add(entry.getKey(), entry.getValue()); }); context.response().headers().setAll(headers); clientResponse.handler(data -> { context.response().write(data); }); clientResponse.endHandler((v) -> { context.response().end(); }); }); clietRequest.headers().setAll(context.request().headers()); clietRequest.exceptionHandler(e -> { LOGGER.error("", e); }); context.request().handler(data -> { clietRequest.write(data); }); context.request().endHandler((v) -> { clietRequest.end(); }); }}网关给user服务转发的过程中，没有上面列举的所有服务治理能力，只是一个单纯的HTTP转发器。
02
CSE访问第三方服务
在Edge service转发给CSE服务的过程中，介绍了一组治理能力。这组治理能力在CSE服务调用其他CSE的服务的时候，也是具备的，而且这组能力不仅体现在调用者(consumer)、提供者(provider)处理请求的时候，也会走Handler链，从而具备流控、隔离等能力。 CSE之间的微服务调用非常简单，包括RestTemplate和RPC两种开发模式，这里就不再详细介绍了，开发者可以参考开发指南进行学习。
CSE也提供了调用第三方服务的能力，通过使用CSE提供的第三方能力，这些治理能力对于调用者(consumer)一端，也是全部具备的。因此在CSE服务中调用其他第三方服务的时候，应该尽可能使用CSE提供的第三方访问能力，而不是使用普通的HTTP client。
使用CSE的http client的原理是首选通过接口的方式声明需要访问的服务端的契约。
@RequestMapping(path = "/")public interface AuthService { @GetMapping(path = "/oauth/token") Token auth(@RequestParam(name = "username") String username, @RequestParam(name = "password") String password, @RequestParam(name = "grant_type") String grant_type, @RequestParam(name = "scope") String scope, @RequestParam(name = "client_id") String clientId, @RequestParam(name = "client_secret") String clientSecret);}然后本地模拟注册一个在服务中心注册的实例。
@Componentpublic class ThirdPartyRegistry implements BootListener {
@Override public void onBootEvent(BootEvent event) { if (event.getEventType() == EventType.AFTER_REGISTRY) { DiscoveryTree discoveryTree = new DiscoveryTree(); discoveryTree.addFilter(new IsolationDiscoveryFilter()); discoveryTree.addFilter(new ServerDiscoveryFilter()); discoveryTree.sort();
DiscoveryContext context = new DiscoveryContext(); Invocation invocation = new NonSwaggerInvocation("default", "auth", "0+", null); context.setInputParameters(invocation); VersionedCache serversVersionedCache = discoveryTree.discovery(context, "default", "auth", "0+"); List<ServiceCombServer> servers = serversVersionedCache.data(); List<MicroserviceInstance> instances = new ArrayList<>(servers.size()); servers.forEach(item -> { MicroserviceInstance instance = new MicroserviceInstance(); List<String> endpoints = item.getInstance().getEndpoints(); List<String> endpointsWithoutPrefix = new ArrayList<>(endpoints.size()); endpoints.forEach(e -> { System.out.println(e); endpointsWithoutPrefix.add(e.substring(0, e.indexOf("?"))); }); instance.setEndpoints(endpointsWithoutPrefix); instances.add(instance); }); RegistryUtils.getServiceRegistry() .registerMicroserviceMapping( "authStub", "1.1.1", instances, AuthService.class); } }}最后就可以按照CSE访问CSE服务一样访问这个第三方服务。
@RpcReference(microserviceName = "authStub", schemaId="authStub") private AuthService authService;
@GetMapping("/auth") public Token auth() { return authService.auth("user_1", "123456", "password", "read", "client_2", "123456"); }03
第三方服务访问CSE
第三方访问CSE可以按照原生的第三方HTTP Client API来访问。 这个治理能力等同于第三方提供的功能，通常不包含治理能力。 这里不再详细描述。
04
总结
通过上面的例子，看到了CSE在处理多种REST开发框架并存情况下，网关转发和服务之间调用需要采用的技术。这些技术在微服务持续演进过程中会经常用到。但是微服务演进的最终目的是选择一套技术来解决问题，应该避免架构选型的多样化，这无疑会增加学习和维护的成本。同时可以看到CSE在服务治理能力方面的优势，这些优势对于微服务的可靠运行提供了非常强大的保障，这个才是CSE作为一个微服务框架核心重要的部分。
▼
往期精彩回顾
▼
扫码关注
更多精彩
你点的每个赞，我都认真当成了喜欢
戳“阅读原文”我们一起进步
扫一扫
934
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
