Dubbo Rpc服务测试

Apache Dubbo 是一款高性能、轻量级的开源 Java RPC 框架,它提供了三大核心能力:面向接口的远程方法调用,智能容错和负载均衡,以及服务自动注册和发现。

官方主页:https://dubbo.apache.org/zh-cn/index.html

架构

image

节点角色说明:

节点 角色说明
Provider 暴露服务的服务提供方
Consumer 调用远程服务的服务消费方
Registry 服务注册与发现的注册中心
Monitor 统计服务的调用次数和调用时间的监控中心
Container 服务运行容器

调用关系说明

  1. 服务容器负责启动,加载,运行服务提供者。
  2. 服务提供者在启动时,向注册中心注册自己提供的服务。
  3. 服务消费者在启动时,向注册中心订阅自己所需的服务。
  4. 注册中心返回服务提供者地址列表给消费者,如果有变更,注册中心将基于长连接推送变更数据给消费者。
  5. 服务消费者,从提供者地址列表中,基于软负载均衡算法,选一台提供者进行调用,如果调用失败,再选另一台调用。
  6. 服务消费者和提供者,在内存中累计调用次数和调用时间,定时每分钟发送一次统计数据到监控中心。

Dubbo 架构具有以下几个特点,分别是连通性、健壮性、伸缩性、以及向未来架构的升级性。

Dubbo demo

在了解之后,应该编写一个demo用例来加深下印象。
这里可以参考首页的例子:https://dubbo.apache.org/zh-cn/docs/user/quick-start.html

测试

测试 Dubbo 接口有四种方式,下面一一来进行介绍。

基于telnet的简单调试接口

任何一个 Dubbo 服务都支持一个简单的 telent 交互。

telnet 命令参考手册:
https://dubbo.apache.org/zh-cn/docs/user/references/telnet.html

xshell 中进入指定机器,如 127.0.0.1 ,然后输入命令:

telnet 127.0.0.1 20880
ls -l
invoke com.xxx.xxx.xxx.xxxx.helper.OrderHelper.getById(1147512345672545L)

注意:这种方式只能用来简单验证接口的可用。

传统的基于 xml 配置的 Dubbo 的测试方法

直连

添加 pom.xml 依赖:

<!-- https://mvnrepository.com/artifact/com.alibaba/dubbo -->
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>dubbo</artifactId>
    <version>2.5.3</version>
</dependency>

创建 dubbo-consumer.xml 文件:

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:dubbo="http://code.alibabatech.com/schema/dubbo"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://code.alibabatech.com/schema/dubbo http://code.alibabatech.com/schema/dubbo/dubbo.xsd">
    <dubbo:application name="xxx-xxx-xxx-dubbo"/>
    <dubbo:reference id="OrderHelper" interface="com.xxx.xxx.xxx.xxxx.helper.OrderHelper" version="1.0.0" url="dubbo://127.0.0.1:20888"/>
    <dubbo:reference id="OrderHelper" interface="com.xxx.xxx.xxx.xxxx.helper.OrderHelper" version="1.0.0" />
</beans>

DubboXml.java 代码开始调用:

package Dubbo;

import com.xxx.xxx.xxx.xxxx.helper.OrderHelper;
import org.springframework.context.support.ClassPathXmlApplicationContext;

public class DubboXml {
    public static void main(String[] args) {
        ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext(
                new String[]{"spring/dubbo-consumer.xml"});
        context.start();
        OrderHelper orderHelper = (OrderHelper) context.getBean("OrderHelper");
        System.out.println(orderHelper.getById(1147511234772545L).getOrderId());
    }
}

通过注册中心连接

关于 zookeeper 注册中心的介绍可以参看这篇博客:https://dubbo.apache.org/zh-cn/docs/user/references/registry/zookeeper.html

添加 pom.xml 依赖:

<dependency>
    <groupId>com.xxx.dubbo</groupId>
    <artifactId>dubbo</artifactId>
    <version>3.0.2-SNAPSHOT</version>
</dependency>
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-context</artifactId>
    <version>4.3.12.RELEASE</version>
</dependency>
<dependency>
    <groupId>org.apache.curator</groupId>
    <artifactId>curator-framework</artifactId>
    <version>2.9.1</version>
</dependency>
<dependency>
    <groupId>org.apache.curator</groupId>
    <artifactId>curator-client</artifactId>
    <version>2.9.1</version>
</dependency>

创建 dubbo-consumer.xml 文件:

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:dubbo="http://code.alibabatech.com/schema/dubbo"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://code.alibabatech.com/schema/dubbo http://code.alibabatech.com/schema/dubbo/dubbo.xsd">
    <dubbo:application name="xxx-xxx-xxx-dubbo"/>
    <dubbo:registry protocol="zookeeper" address="zktest1.service.xxdns.cn:2181" group="xxx_services_betab" id="aaaaaa" client="curator"/>
    <dubbo:reference id="OrderHelper" interface="com.xxx.xxx.xxx.xxxx.helper.OrderHelper" version="1.0.0" registry="aaaaaa" />
</beans>

DubboXml.java 代码开始调用:

package Dubbo;

import com.xxx.xxx.xxx.xxxx.helper.OrderHelper;
import org.springframework.context.support.ClassPathXmlApplicationContext;

public class DubboXml {
    public static void main(String[] args) {
        ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext(
                new String[]{"spring/dubbo-consumer.xml"});
        context.start();
        OrderHelper orderHelper = (OrderHelper) context.getBean("OrderHelper");
        System.out.println(orderHelper.getById(1147511234772545L).getOrderId());
    }
}

基于 API 的 Dubbo 测试方法

其实除了 xml 配置之外,官方也提供了一份直接通过 API 进行配置的方式。

可参考官方 API 配置文档:https://dubbo.apache.org/zh-cn/docs/user/configuration/api.html

添加 pom.xml 依赖:

<!-- https://mvnrepository.com/artifact/com.alibaba/dubbo -->
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>dubbo</artifactId>
    <version>2.5.3</version>
</dependency>

代码调用 Dubbo 接口:

package Dubbo;

import com.alibaba.dubbo.config.ApplicationConfig;
import com.alibaba.dubbo.config.ReferenceConfig;
import com.xxx.xxx.xxx.xxxx.helper.OrderHelper;

public class DubboInvoke {
    public static void main(String[] args) {
        ApplicationConfig application = new ApplicationConfig();// 此实例很重,封装了与注册中心的连接以及与提供者的连接,请自行缓存,否则可能造成内存和连接泄漏
        application.setName("itest");

        ReferenceConfig<OrderHelper> reference = new ReferenceConfig<OrderHelper>();
        reference.setApplication(application);

        // 如果点对点直连,可以用reference.setUrl()指定目标地址,设置url后将绕过注册中心,
        // 其中,协议对应provider.setProtocol()的值,端口对应provider.setPort()的值,
        // 路径对应service.setPath()的值,如果未设置path,缺省path为接口名
        reference.setUrl(String.format("dubbo://%s:%s/","127.0.0.1","20888"));
        reference.setVersion("1.0.0");
        reference.setTimeout(10000);
        reference.setInterface("com.xxx.xxx.xxx.xxxx.helper.OrderHelper");
        OrderHelper orderHelper = reference.get();
        System.out.println(orderHelper.getById(1147512345672545L).getOrderId());
    }
}

泛化调用

泛化调用主要用于消费端没有 API 接口的情况;不需要引入接口 jar 包,而是直接通过 GenericService 接口来发起服务调用,参数及返回值中的所有 POJO 均用 Map 表示。泛化调用对于服务端无需关注,按正常服务进行暴露即可。

泛化调用的使用可参考官方文档:http://dubbo.apache.org/zh-cn/docs/user/demos/generic-reference.html

下面来看消费端如何使用泛化调用进行服务调用。

通过 Spring 使用泛化调用

在 Spring 配置申明 generic="true",如:

<dubbo:reference id="userService" interface="com.alibaba.dubbo.samples.generic.api.IUserService" generic="true"/>

需要使用的地方,通过强制类型转化为 GenericService 进行调用:

GenericService userService = (GenericService) context.getBean("userService");
// primary param and return value
String name = (String) userService.$invoke("delete", new String[]{int.class.getName()}, new Object[]{1});
System.out.println(name);

其中:

  1. GenericService 这个接口只有一个方法,名为 $invoke ,它接受三个参数,分别为方法名、方法参数类型数组和参数值数组;
  2. 对于方法参数类型数组
    1. 如果是基本类型,如 intlong,可以使用 int.class.getName() 获取其类型;
    2. 如果是基本类型数组,如 int[],则可以使用 int[].class.getName()
    3. 如果是 POJO ,则直接使用全类名,如 com.alibaba.dubbo.samples.generic.api.Params

通过 API 方式使用泛化调用

ApplicationConfig application = new ApplicationConfig()ApplicationConfig application = new ApplicationConfig();
application.setName("api-generic-consumer");

RegistryConfig registry = new RegistryConfig();
registry.setAddress("zookeeper://127.0.0.1:2181");

application.setRegistry(registry);

ReferenceConfig<GenericService> reference = new ReferenceConfig<GenericService>();
// 弱类型接口名
reference.setInterface("com.alibaba.dubbo.samples.generic.api.IUserService");
// 声明为泛化接口
reference.setGeneric(true);

reference.setApplication(application);

// 用com.alibaba.dubbo.rpc.service.GenericService可以替代所有接口引用
GenericService genericService = reference.get();

String name = (String) genericService.$invoke("delete", new String[]{int.class.getName()}, new Object[]{1});
System.out.println(name);

通过 API 的方式,不需要像 XML 的方式需要提前将服务配置好,可以动态构建 ReferenceConfig;相对 XML 来说,API 的方式更常见。

参数或返回值是 POJO 的场景

比如方法签名是 User get(Params params);其中 Useridname 两个属性,Paramsquery 一个属性。

以下是消费端的调用代码:

String[] parameterTypes = new String[]{"com.alibaba.dubbo.samples.generic.api.Params"};
Map<String, Object> params = new HashMap<String, Object>();
param.put("class", "com.alibaba.dubbo.samples.generic.api.Params");
param.put("query", "a=b");
Object user = userService.$invoke("get", parameterTypes, new Object[]{param});
System.out.println("sample one result: " + user);

上述代码的输出结果为:

sample one result: {name=charles, id=1, class=com.alibaba.dubbo.samples.generic.api.User}

这里,Dubbo 框架会自动将 POJO 的返回值转换成 Map。可以看到,返回值 user 是一个 HashMap,里面分别存放了 nameidclass 三个 k/v

参考

https://testerhome.com/topics/10481

https://i.itest.ren/2018/05/29/Dubbo/

http://dubbo.apache.org/zh-cn/blog/dubbo-generic-invoke.html


  转载请注明: ANZHONGYU Dubbo Rpc服务测试

 本篇
Dubbo Rpc服务测试 Dubbo Rpc服务测试
Apache Dubbo 是一款高性能、轻量级的开源 Java RPC 框架,它提供了三大核心能力:面向接口的远程方法调用,智能容错和负载均衡,以及服务自动注册和发现。 官方主页:https://dubbo.apache.org/zh-cn
2019-07-30
下一篇 
Java使用ZXing生成二维码(带logo) Java使用ZXing生成二维码(带logo)
ZXing 是谷歌开源的一个 Java 类库用于解析多种格式的 1D/2D 条形码。目标是能够对 QR 编码、Data Matrix、UPC 的 1D 条形码进行解码。 其提供了多种平台下的客户端包括:J2ME、J2SE 和 Android
2019-07-24
  目录