跳到主要内容

调试 Dubbo 接口

定义目标服务器地址​

开始调试接口前需定义目标服务器地址，你可以通过直连服务器或通过注册中心两种方式进行调试。

直连​

点击页面右上角的环境配置按钮。

填写服务器地址，然后点击“保存”按钮。

在右上角指定刚刚配置的服务器地址，项目内的其它 Dubbo 接口也将会默认采用该地址。

如果需要单独为每个 Dubbo 接口设置不同的服务器地址，可以点击接口地址栏，选择环境并手动切换服务器地址。

确认服务地址无误后，点击右上角的“调用”按钮。

注册中心​

信息

Apifox 目前支持的注册中心为： ZooKeeper、Nacos 和阿里云 EDAS。

点击页面右上角的环境配置按钮。

填写注册中心名称，选择类型并填写地址。若注册中心配置了鉴权机制，请点击右侧齿轮按钮并进行高级配置。

在右上角指定刚刚配置的注册中心，项目内的其它 Dubbo 接口也将会默认采用该注册中心地址。

如果需要单独为每个 Dubbo 接口设置不同的注册中心，可以点击接口地址栏，选择环境并手动切换注册中心。

确认服务地址无误后，点击右上角的“调用”按钮。

配置参数​

版本号和分组​

若 Dubbo 接口配置了版本号和分组，则需要填写，否则请留空。

类名​

在接口中需要配置参数的 Java 类名。

  • 如果是简单类型，比如 string、java.lang.String，那么可以不填写类名。Apifox 会自动推断类名。
  • 如果是 List 类型，请选择 java.util.List。其它集合类型同理，即选择完整名称。

  • 如果是自定义 DTO 类型，请填写完整的 DTO 名称，即包含完整 Package 名称。比如要引用 com.dubbo.example Package 内名为 User 的 DTO，那么需要完整填写 com.dubbo.example.User。

消息​

消息体格式支持 JSON 格式。在消息体中还可以使用变量，变量的格式为 {{变量名}}，并且还支持添加“动态值”。

你也可以使用系统内置的「自动生成」功能生成请求消息体。使用该功能需提前在接口定义中添加请求参数，系统将根据请求定义自动生成请求体，详细说明请参考《接口文档——请求定义》。

DTO 内部的非简单类型​

一般情况下，Apifox 会自动推断字段的类型。但是，可能无法正确推断非简单类型，导致服务端收到消息后序列化失败。这种情况下，需要手动声明字段的 Java 类型。语法为：

{
    "$class": "字段的 Java 类名",
    "$": "字段的值"
}

假设某一个 DTO 类型内部通过 List 或其他数据结构引用了其它 DTO 类型，调用接口返回了 java.util.HashMap cannot be cast to xxx.xxx.Dto 形式的报错，这表示 Apifox 将 DTO 的类型自动推断为 java.util.HashMap。而服务器定义的是一个具体的自定义类名，两者不匹配，此时需要在调用时指定字段的类名。 假设 DTO 为：

package com.dubbo.example;

public class Address {
    public String province;
    public String city;
}

public class User {
    public String name;
    public Integer age;
    public List<Address> addresses;
}

Dubbo 接口为：

package com.dubbo.example;

public interface DemoService {
    String sayHello(User user);
}

那么使用 Apifox 调用 sayHello 方法时，需要手动指定 addresses 字段内元素的类名为 com.dubbo.example.Address，以避免其类型被自动推断为 java.util.HashMap：

{
    "name": "Tom",
    "age": 3,
    "addresses": [
        {
            "$class": "com.dubbo.example.Address",
            "$": {
                "province": "Guangdong",
                "city": "Guangzhou"
            }
        },
        {
            "$class": "com.dubbo.example.Address",
            "$": {
                "province": "Guangdong",
                "city": "Shenzhen"
            }
        }
    ]
}

即：

多参数​

若接口存在多个入参，那么可以点击左侧的“添加参数”按钮，添加多个参数。

映射关系​

Java 和 JSON 的数据类型存在着映射关系，如下表所示：

JavaJSONJSON 示例
boolean, java.lang.Booleanbooleantrue, false
char, java.lang.Characterstring"\u0066", "f"
java.lang.Stringstring"Hello World!"
byte, java.lang.Byte, short, java.lang.Short, int, java.lang.Integer, long, java.lang.Longinteger1, -10, 0
float, java.lang.Float, double, java.lang.Doublefloat1.1, -10.0, 0
java.util.List<V>, java.util.Set<V>, dataType[]array[v, …]
java.util.Map<K,V>, DTO, POJOobject{"k": v, …}
enumobject{"name": "ENUM_VALUE"}
java.util.Date, java.sql.Date, java.sql.Timestamp, java.sql.Timestring"2020-01-01 00:00:00"
java.time.LocalDateTime, java.time.LocalTimestring"2020-01-01T00:00:00"
java.time.LocalDatestring"2020-01-01"

调用接口​

点击右上角的「调用」按钮，即可得到接口的返回结果。

常见问题​

1. 传递 Long 类型的数字时，为什么服务端所收到的数字后面几位是错误的？

请使用 JSON 字符串传递 Long 类型的数字，即把数字使用双引号包裹起来，但是类名依旧保持 java.lang.Long。数字后面出现错误的原因是较大的数字超出了 JSON 的整数范围。

2. 当 JSON 对象内部的字段是日期、对象或其他非简单类型时，为什么服务端会出现序列化错误？

当日期类型使用 JSON 字符串表示时，Apifox 无法准确推断它对应着 Java 的哪一种日期类型。此时需要手动声明字段的 Java 类型，比如下面的例子，将 update_time 字段的 Java 类型声明为 java.util.Date：

{
    "name": "Apifox",
    "update_time": {
        "$class": "java.util.Date",
        "$": "2020-01-01 00:00:00"
    }
}