泛化实现

泛化实现，用于在提供方没有 API（SDK）的情况下，对外提供和发布服务

注意

请注意区分上一篇文档介绍的 泛化调用，泛化调用是给消费端用的，而泛化实现是给提供端用的。

泛接口实现方式主要用于服务器端没有 API 接口及模型类元的情况，参数及返回值中的所有 POJO 均用 Map 表示，通常用于框架集成，比如：实现一个通用的远程服务 Mock 框架，可通过实现 GenericService 接口处理所有服务请求。

使用场景

  • 注册服务: 服务提供者在服务注册表中注册服务，例如 Zookeeper，服务注册表存储有关服务的信息，例如其接口、实现类和地址。
  • 部署服务: 服务提供商将服务部署在服务器并使其对消费者可用。
  • 调用服务: 使用者使用服务注册表生成的代理调用服务，代理将请求转发给服务提供商，服务提供商执行服务并将响应发送回消费者。
  • 监视服务：提供者和使用者可以使用 Dubbo 框架监视服务，允许他们查看服务的执行情况，并在必要时进行调整。

使用方式

本示例的完整源码请参考 dubbo-samples-generic-impl。

在 Java 代码中实现 GenericService 接口

1. package com.foo;
2. public class MyGenericService implements GenericService {

4. public Object $invoke(String methodName, String[] parameterTypes, Object[] args) throws GenericException {
5. if ("sayHello".equals(methodName)) {
6. return "Welcome " + args[0];
7. }
8. }
9. }

通过 Spring 暴露泛化实现

在 Spring XML 配置申明服务的实现

1. <bean id="genericService" class="com.foo.MyGenericService" />
2. <dubbo:service interface="com.foo.BarService" ref="genericService" />

通过 API 方式暴露泛化实现

1. ...
2. // 用org.apache.dubbo.rpc.service.GenericService可以替代所有接口实现
3. GenericService xxxService = new XxxGenericService();

5. // 该实例很重量，里面封装了所有与注册中心及服务提供方连接，请缓存
6. ServiceConfig<GenericService> service = new ServiceConfig<GenericService>();
7. // 弱类型接口名
8. service.setInterface("com.xxx.XxxService");
9. // if you need to set different version for service
10. service.setVersion("1.0.0");
11. // 指向一个通用服务实现
12. service.setRef(xxxService);

14. // 暴露及注册服务
15. service.export();
  1. 在设置 ServiceConfig 时，使用setGeneric("true")来开启泛化调用
  2. 在设置 ServiceConfig 时，使用 setRef 指定实现类时，要设置一个 GenericService 的对象。而不是真正的服务实现类对象
  3. 其他设置与正常 Api 服务启动一致即可

最后修改 September 13, 2024: Refactor website structure (#2860) (1a4b998f54b)