4.16. 使用泛化调用

实现一个通用的服务测试框架,可通过 GenericService 调用所有服务实现

泛化接口调用方式主要用于客户端没有 API 接口及模型类元的情况,参数及返回值中的所有 POJO 均用 Map 表示,通常用于框架集成,比如:实现一个通用的服务测试框架,可通过 GenericService 调用所有服务实现。

通过 Spring 使用泛化调用

  • 在 Spring 配置申明 generic="true"
    <dubbo:reference id="barService" interface="com.foo.BarService" generic="true" />
    
  • 在 Java 代码获取 barService 并开始泛化调用:
    GenericService barService = (GenericService) applicationContext.getBean("barService");
    Object result = barService.$invoke("sayHello", new String[] { "java.lang.String" }, new Object[] { "World" });
    

通过 API 方式使用泛化调用

import org.apache.dubbo.rpc.service.GenericService; 
... 
// 引用远程服务 
// 该实例很重量,里面封装了所有与注册中心及服务提供方连接,请缓存
ReferenceConfig<GenericService> reference = new ReferenceConfig<GenericService>(); 
// 弱类型接口名
reference.setInterface("com.xxx.XxxService");  
reference.setVersion("1.0.0");
// 声明为泛化接口 
reference.setGeneric(true);  
// 用org.apache.dubbo.rpc.service.GenericService可以替代所有接口引用  
GenericService genericService = reference.get(); 
// 基本类型以及Date,List,Map等不需要转换,直接调用 
Object result = genericService.$invoke("sayHello", new String[] {"java.lang.String"}, new Object[] {"world"}); 
// 用Map表示POJO参数,如果返回值为POJO也将自动转成Map 
Map<String, Object> person = new HashMap<String, Object>(); 
person.put("name", "xxx"); 
person.put("password", "yyy"); 
// 如果返回POJO将自动转成Map 
Object result = genericService.$invoke("findPerson", new String[]
{"com.xxx.Person"}, new Object[]{person}); 
...

有关泛化类型的进一步解释

  • 假设存在 POJO 如:
    package com.xxx;
    public class PersonImpl implements Person {
        private String name;
        private String password;
        public String getName() {
            return name;
        }
        public void setName(String name) {
            this.name = name;
        }
        public String getPassword() {
            return password;
        }
        public void setPassword(String password) {
            this.password = password;
        }
    }
    
  • 则 POJO 数据:
    Person person = new PersonImpl(); 
    person.setName("xxx"); 
    person.setPassword("yyy");
    
  • 可用下面 Map 表示:
    Map<String, Object> map = new HashMap<String, Object>(); 
    // 注意:如果参数类型是接口,或者List等丢失泛型,可通过class属性指定类型。
    map.put("class", "com.xxx.PersonImpl"); 
    map.put("name", "xxx"); 
    map.put("password", "yyy");
    
下一节:使用 IDL 定义服务