# rpcui4d

**Repository Path**: kingwtd/rpcui4d

## Basic Information

- **Project Name**: rpcui4d
- **Description**: RpcUI4D 适用于Dubbo(x)开发人员的测试工具
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 46
- **Forks**: 13
- **Created**: 2017-07-10
- **Last Updated**: 2025-07-11

## Categories & Tags

**Categories**: testing

**Tags**: None

## README

# RpcUI4D - 适用于Dubbo(x)开发人员的测试工具

## 运行环境与配置

项目使用**Ant1.9**进行打包，依赖**JDK1.8**来运行。安装好Ant后，在项目目录下打开DOS界面，输入`ant`命令后会生成target目录（或输入`ant zip`命令，将会打包项目并生成zip压缩文件），进入到target目录，双击`run.bat`即可运行，在主界面中将会输出运行日志。

## 使用的操作步骤

### 配置运行环境参数
- 点击**Setup -> Settings**，通过`Connection`设置Dubbo服务器连接参数，`Generation`设置API的类读取过滤

### 添加Dubbo服务的API

1. 点击**Setup -> Api Jar Files -> Add**，添加需要加载的API的jar包；

2. 输入API的jar包的`Group Id`、`Artifact Id`、`Version`（如果有依赖jar包，点击Add依次添加依赖的jar包）；

3. 点击**OK -> Save**保存API的jar包。（注：如果出现异常，一般是缺少依赖的jar包，点击**Setup -> Restart**后，重复上述操作，添加缺少的依赖jar包即可）。

### 运行Dubbo服务的API

1. 点击**Run -> Run As**，选择需要运行的API的方法，点击**OK -> Apply**保存运行配置（注：已经存在的配置不需要此步骤）；

2. 点击**Run -> Run Configurations**，选择需要运行的API方法的配置，在配置中输入参数的值（参数配置见以说明），点击`Run`即可。

### 运行操作界面例图

![Main](https://git.oschina.net/uploads/images/2017/0719/093931_9fd65da9_409346.png "main.png")

![Setting](https://git.oschina.net/uploads/images/2017/0719/094015_7d187625_409346.png "setting.png")

![Add API JAR](https://git.oschina.net/uploads/images/2017/0719/094037_cc9b7183_409346.png "add-api-jar.png")

![Run As](https://git.oschina.net/uploads/images/2017/0719/094058_e29241fd_409346.png "run-as.png")

![Run Configuration](https://git.oschina.net/uploads/images/2017/0719/094119_98507e60_409346.png "run-config.png")

## 支持API的参数类型

- 基本类型
    - byte / java.lang.Byte
    - boolean / java.lang.Boolean
    - char / java.lang.Character
    - short / java.lang.Short
    - int / java.lang.Integer
    - long / java.lang.Long
    - float / java.lang.Float
    - double / java.lang.Double
    - java.lang.String
- 枚举类型
    - java.lang.Enum
- 大小数类型
    - java.math.BigDecimal
- 日期类型
    - java.util.Date
- 集合类型
    - java.util.List
    - java.util.Set
    - java.util.Collection
    - java.util.Map
- 数组类型
    - 由以上类型构成的数组类型
- 自定义类型
    - 由以上类型构成的复合类型

## 属性与配置参数

- 有参构造器，添加`constructor-args`结点，如：
``` xml
<employee class="com.jwiki.api.entity.Employee">
    <constructor-args>
        <arg0 class="java.lang.String">bob</arg0>
    </constructor-args>
</employee>
```

- 特殊设置值的方法名，添加`setter`属性，如：
``` xml
<bCardNo class="java.lang.Boolean" setter="setbCardNo"/>
```

- `configuration`可配置Dubbo(x)相关属性与输出结果
    `group`, `version`, `check`, `timeout`, `retries`结点为Dubbo(x)的Reference的相关对应配置，`output`：配置输出结果，它的值为object或json，如：
``` xml
<configuration>
    <group></group>
    <version></version>
    <check></check>
    <timeout></timeout>
    <retries></retries>
    <output>object</output>
</configuration>
```