报错信息
调用HSF服务时,报错信息如下。
There is no TOP transformer for Service:[${serviceUniqueName}].
解决方案
TOP调用方式是为了避免网关应用依赖后端服务的API包,TOP调用在服务端进行转换时,没有找到对应的transformer
。
客户端设置
客户端使用com.taobao.hsf.app.spring.util.SuperHSFSpringConsumerBeanTop
,该类无需服务端的接口包。通过com.taobao.hsf.app.spring.util.SuperHSFSpringConsumerBeanTop#invoke
发起调用。
示例代码如下。
/**
* TOP调用该方法来访问远程HSF服务。
* <p>
* 这里需要注意的是parameterTypes参数,该参数表示要调用的方法的参数类型。 必须是完整的Java类名,而且如果参数是原子类型,这里的类型就是原子类型的名称。
* </p>
*
* @return 对端业务响应或业务异常
*
* @throws HSFException
* 如果本侧或对端HSF层出现错误,则抛出HSFException
* @throws Throwable
* 如果服务端业务出现异常,则抛出Exception
*/
public Object invoke(String methodName, String[] parameterTypes, Object[] args) throws HSFException, Throwable {
return consumerBeanTop.invoke(methodName, parameterTypes, args);
}
代码中的args
不是真正的服务端业务类型。
服务端
服务端初始化时,需要通过com.taobao.hsf.ServiceInvokeTransform.Helper#register
注册一个transformer
。
示例代码如下。
/**
* 用于把服务的调用参数转换成服务可以接受的形式。
*
* @param methodName
* 要调用的服务方法名
* @param args
* 转换前的调用参数
* @param parameterTypes
* 要调用的服务方法的真实参数类型
*/
abstract public Object[] transformRequest(String methodName, Object[] args, String[] parameterTypes)
throws Exception;
/**
* 转换请求参数类型
*
* @param methodName
* @param args
* @param parameterTypes
* @return
* @throws Exception
*/
abstract public String[] transformRequestTypes(String methodName, Object[] args, String[] parameterTypes)
throws Exception;
该transformer
服务在服务端将客户端传递的参数转化为真实的业务类型,HSF使用转化后的参数进行业务调用,然后使用 transformer
将业务结果进行转化后返回给TOP客户端。