dubbox REST服务使用fastjson替换jackson

上一节讲解了resteasy如何使用fastjson来替换默认的jackson，虽然dubbox内部采用的就是resteasy，但是大多数情况下，dubbox服务是一个独立的app，并不需要以war包形式部署在外置容器中，也就没有web.xml。好在dubbox扩展性不错，很容易扩展，有此类需求的可以参考下面的做法：

一、rest协议指定fastjson做为序列化

<dubbo:protocol name="rest" port="8080"  server="tomcat" contextpath="/" serialization="fastjson" charset="GBK"/>

注意这里的：serialization="fastjson" charset="GBK" 这里指定了采用fastjson作为json序列化的框架，同时字符编码格式为GBK。

二、修改BaseRestServer源码

dubbo采用了"URL总线"设计思想，所有服务的信息，最终都拼成一个URL注册到zk中， com.alibaba.dubbo.rpc.protocol.rest.BaseRestServer的start方法里，可以拿到这些URL的信息，参考以下代码：

public void start(URL url) {
getDeployment().getMediaTypeMappings().put("json", "application/json");
getDeployment().getMediaTypeMappings().put("xml", "text/xml");
getDeployment().getProviderClasses().add(RpcContextFilter.class.getName());

//增加对serialization、charset的解析 杨俊明 2017-04-26
String serialization = url.getParameter("serialization");
if (StringUtils.isNotEmpty(serialization)) {
String charset = url.getParameter("charset", "UTF-8");
if (serialization.equals("fastjson")) {
getDeployment().setRegisterBuiltin(false);
getDeployment().getScannedProviderClasses().clear();
FastJsonConfig fastJsonConfig = new FastJsonConfig();
fastJsonConfig.setSerializerFeatures(SerializerFeature.DisableCircularReferenceDetect);
fastJsonConfig.setCharset(Charset.forName(charset));
FastJsonProvider jsonProvider = new FastJsonProvider();
jsonProvider.setCharset(Charset.forName(charset));
jsonProvider.setFastJsonConfig(fastJsonConfig);
ResteasyProviderFactory.getInstance().register(jsonProvider);
getDeployment().setProviderFactory(ResteasyProviderFactory.getInstance());
}
}

getDeployment().getProviderClasses().add(RpcExceptionMapper.class.getName());
loadProviders(url.getParameter(Constants.EXTENSION_KEY, ""));
doStart(url);
}

上述代码7-22行，解释下，如果URL里指定了serialization而且是fastjson，就把默认的其它已经扫描到的provider清空，同时注册一个FastJsonProvider。为了满足各种编码格式的要求，对charset也一并做了解析，并传递到FastJsonConfig中。　　

注：上述代码已经提交到github的个人dubbox分支，需要的朋友们直接down最新源码即可。

三、405 Method Not Allowed 等状态码的处理

与上一节的处理方式类似，自己扩展一个ExceptionHandler即可，然后在dubbox中参考以下配置：

<dubbo:protocol name="rest" ...
extension="xxx.xxx.NotAllowedExceptionHandler,xxx.xxx.NotSupportedExceptionHandler" serialization="fastjson"
/>

extension这里可以随意扩展，多个扩展之间用英文逗号分隔即可，读取extensions的源代码见com.alibaba.dubbo.rpc.protocol.rest.BaseRestServer#loadProviders

protected void loadProviders(String value) {
for (String clazz : Constants.COMMA_SPLIT_PATTERN.split(value)) {
if (!StringUtils.isEmpty(clazz)) {
getDeployment().getProviderClasses().add(clazz.trim());
}
}
}