前言
大家好,今天开始给大家分享 — Dubbo 专题之 Dubbo 服务在线测试。在前一个章节中我们介绍了 Dubbo 中的服务治理,同时我们了解到 Dubbo 为我们提供了一些常用的服务治理能力包括:调节路由、标签路由、黑白名单、动态配置、负载均衡等等。我们也学习到怎样使用 Dubbo Admin 控制台给我们的分布式服务进行服务治理。那么在本章节我们会主要讨论 Dubbo Admin 为我们提供一种在线调用服务的能力,我们可以利用这种方式进行服务的在线测试而不需要编写我们的单元测试用例。那下面就让我们快速开始吧!
1. 服务在线测试简介
在 Dubbo Admin 中为我们提供一种可以在控制台进行远程服务调用的能力,其实现原理就是利用了我们 Dubbo 提供的泛化调用在不需要 jar
包依赖的情况下对远程服务进行调用。各位小伙伴可以参考我们前面章节《Dubbo 泛化引用》中对泛化引用的讨论,其核心原理是利用服务的元数据进行远程调用,核心API
为GenericService
。
2. 示例演示
下面我们就开始我们的服务在线测试演示。首先我们创建一个服务提供方,项目结构如下:
由于这里只需要服务提供者提供服务即可,而在我们的 Dubbo Admin 中调用服务提供方,所有这里不需要消费端。下面我们看看定义的接口代码:
/**
* @author <a href="http://youngitman.tech">青年IT男</a>
* @version v1.0.0
* @className BookService
* @description
* @JunitTest: {@link }
* @date 2020-10-24 13:29
**/
public interface BookFacade {
//查询所有图书
List<Book> queryAll();
//根据请求参数过滤图书
default List<Book> queryByName(@NotNull RequestParameter request) {
return Lists.newArrayList();
}
}
3. 服务在线测试
下面我们开始 Dubbo Admin 的演示,首先我们找到使用的入口:
我们在搜索
框中输入我们调用服务方接口名称进行搜索,可以查找到相关元数据信息如下:
在搜索结果中我们可以看到暴露服务接口中的方法名称、参数列表、返回值信息。接下来我们使用queryByName
方法进行测试,点击右边的编辑图标
进入:
上面的Parameters
是我们的参数列表数组,每个位置的数组元素代表对应位置的方法参数。我们这里输入SpringBoot
参数名称查询到结果为一个列表集合,其中列表元素类型为com.muke.dubbocourse.common.domain.Book
,对象的属性name
值为SpringBoot
、desc
值为SpringBoot
实战。
4. 原理分析
Dubbo Admin 服务测试中其核心是需要方法签名信息即方法名称、参数列表、返回值类型信息,有了这些信息我们才能按照对应方法的参数进行填值,拼装出完整的服务消费者。以下图可以很好的展示其原理:
从上图可以看到我们的服务提供者注册元数据信息到注册中心(元数据中心可以是独立的服务),然后 Dubbo Admin 拉取元数据展示到页面上,同时我们在 Dubbo Admin 中配置调用的服务方法参数后发起对远程服务的调用。下面我们看看在zookeeper
中注册的元数据:
Json
格式如下:
{
"parameters": {//服务提供者配置信息
"side": "provider",
"release": "2.7.8",
"methods": "queryByName,queryAll",
"deprecated": "false",
"dubbo": "2.0.2",
"interface": "com.muke.dubbocourse.common.api.BookFacade",
"generic": "false",
"serialization": "hessian2",
"metadata-type": "remote",
"application": "demo-provider",
"dynamic": "true",
"anyhost": "true"
},
"canonicalName": "com.muke.dubbocourse.common.api.BookFacade",//接口描述
"codeSource": "file:/Users/liyong/work/workspace/course/target/classes/",//源码所在路径
//所有方法信息
"methods": [{
"name": "queryByName",//方法名称
"parameterTypes": ["com.muke.dubbocourse.common.api.RequestParameter"],//方法参数类型
"returnType": "java.util.List\u003ccom.muke.dubbocourse.common.domain.Book\u003e"//方法返回值类型
}, {
"name": "queryAll",
"parameterTypes": [],
"returnType": "java.util.List\u003ccom.muke.dubbocourse.common.domain.Book\u003e"
}],
"types": [{//所有类型描述列表
"type": "com.muke.dubbocourse.common.api.RequestParameter",//方法参数类型
"properties": {//描述所有属性字段
"name": {
"type": "java.lang.String",
"typeBuilderName": "org.apache.dubbo.metadata.definition.builder.DefaultTypeBuilder"
}
},
"typeBuilderName": "org.apache.dubbo.metadata.definition.builder.DefaultTypeBuilder"
}, {
"type": "java.lang.String",
"typeBuilderName": "org.apache.dubbo.metadata.definition.builder.DefaultTypeBuilder"
}, {
"type": "com.muke.dubbocourse.common.domain.Book",
"properties": {
"name": {
"type": "java.lang.String",
"typeBuilderName": "org.apache.dubbo.metadata.definition.builder.DefaultTypeBuilder"
},
"desc": {
"type": "java.lang.String",
"typeBuilderName": "org.apache.dubbo.metadata.definition.builder.DefaultTypeBuilder"
}
},
"typeBuilderName": "org.apache.dubbo.metadata.definition.builder.DefaultTypeBuilder"
}, {
"type": "int",
"typeBuilderName": "org.apache.dubbo.metadata.definition.builder.DefaultTypeBuilder"
}, {
"type": "char",
"typeBuilderName": "org.apache.dubbo.metadata.definition.builder.DefaultTypeBuilder"
}]
}
上面与服务测试相关的就是methods
和types
所包含的方法和类型信息,其中 Dubbo Admin 根据这些信息在控制台上显示出来,并让用户输入配置参数值。
5. 小结
在本小节中我们学习了 Dubbo Admin 中提供的服务在线测试能力。我们主要介绍了 Dubbo Admin 中在线测试的使用方式,同时我们了解到了 Dubbo Admin 在线测试的实现原理是通过 Dubbo 的泛化调用实现,其核心 API 是GenericService
。在整个在线测试中最为核心的是我们需要服务提供者的元数据,根据元数据信息在 Dubbo Admin 中对需要调用的方法进行参数配置,然后发起远程调用。
本节课程的重点如下:
理解 Dubbo Admin 在线测试
了解怎样使用在线测试
了解在线测试的实现原理
作者
个人从事金融行业,就职过易极付、思建科技、某网约车平台等重庆一流技术团队,目前就职于某银行负责统一支付系统建设。自身对金融行业有强烈的爱好。同时也实践大数据、数据存储、自动化集成和部署、分布式微服务、响应式编程、人工智能等领域。同时也热衷于技术分享创立公众号和博客站点对知识体系进行分享。关注公众号:青年IT男 获取最新技术文章推送!
博客地址: http://youngitman.tech