几乎每个系统都要与第三方进行交互。一般来说第三方API都会提供json或xml供系统使用。

　　我们的目标是把api集成到系统中，并降低api对系统的影响。但是随着编码的进行，有太多的坏味道散落到系统中，比如Copy的代码满天飞；配置信息分散各处；无法有效地组织API。

　　面对这些问题，系统应该主动地把api封装起来，形成独立的模块供上层系统调用。

　　

　　该模块涉及到的模式为[Template Method+Callack],[Factory]，涉及到的元素如下

　　　　1、client：Template Method的实现者；定义了与第三方交互的过程；从Callback获取数据组装成适合第三方的信息。

　　　　2、callback：每一个api，都要实现callback，它提供方法名，参数，Url等数据给client使用

　　　　3、config：各种配置信息，如appkey，加密参数等等

　　　　4、factory:对象工厂。比如每调用第三方，系统给需要生成交易码，就可以把生成的任务委托给factory

　　　　5、model：参数的封装类，利用model，可以生成json数据，也可以生成xml数据给client使用；同时也可以根据业务参数，利用factory生成各种model　　

　　以上就是模块中的各个元素。

 

　　他们之间的调用情况如下：

　　　　1、client 依靠 callback 与 第三方交互

　　　　2、callback 结合 model 创建一个完整的apiCallback

　　　　3、factory从config获取信息并结合业务要求，创建model

　　一个的调用过程如下：

Model model  = ModelFactory.getXXXModel(xx,bb,cc) ApiCallback back  = new ApiCallback(model); Client.doClient(back);

 

　　这样的设计方式解决那些问题，如何解决.

　　　　Q1.第三方提供新的API

　　　　A1.增加一个新的Model，实现一个ApiCallback，调用doClient方法

　　　　Q2.第三方系统getName函数名称变动为getUserName

　　　　A2.进入getName对应的GetNameCallback,修改方法名

　　　　Q3.加密密钥放生变化

　　　　Q4.找到对应Config，修改密钥

　　　

　　给一个demo，让大家参考一下，案例已经过缩减，不足之处，多多包涵

public interface  JsonCallback {  public String getMethodName(); 　 　public String getUrl();        public JsonRequest getJsonRequest(); public Object onResultReceived(AccountSmsResult result); }

 

public class JsonClient {
   public static final int CONN_SERVICETOKEN_TIMEOUT = 20000; private static final Logger logger = LoggerFactory.getLogger(JsonClientHelper.class); private static final Gson gson = new Gson(); /**      * 方法表述： 与远服务器进行交互，未授权 */ public static Object doUnsafeClient(JsonCallback callback) throws CException     {
           HttpClient httpClient = new HttpClient(); // 创建Post方法         PostMethod method = createUnSafePostMethod(callback); // 配置参数         configParams(httpClient); return executeMethod(httpClient, method, callback);     } /**      * 方法表述：创建未授权的Post方法 */ private static PostMethod createUnSafePostMethod(JsonCallback callback)     {
           String url = callback.getUrl() + callback.getMethodName();         PostMethod method = new PostMethod(url);         method.addRequestHeader("Content-Type", "application/json");         method.setRequestEntity(wrapToRequestEntity(callback)); return method;     } /**      * 方法表述：配置参数 */ private static void configParams(HttpClient httpClient)     {
           HttpConnectionManagerParams conParams = httpClient.getHttpConnectionManager().getParams();         conParams.setConnectionTimeout(CONN_SERVICETOKEN_TIMEOUT);         conParams.setSoTimeout(CONN_SERVICETOKEN_TIMEOUT);     } /**      * 方法表述： 执行Post方法 */ private static Object executeMethod(HttpClient httpClient, PostMethod method, JsonCallback callback) throws CException     {
           Object resultObject = null; try         {
   int result = httpClient.executeMethod(method); if (result == HttpStatus.SC_OK)             {
                   String response = method.getResponseBodyAsString(); if (!StringUtil.isNullString(response))                 {
                       resultObject = doResponseReceived(response, callback);                 }             }         } catch (Exception e){
               logger.debug(e);         } finally         {
   if (method != null)                 method.releaseConnection();         } return resultObject;     } /**      * 把Json请求对象转化为字符串，并封装到RequestEntity */ protected static RequestEntity wrapToRequestEntity(JsonCallback callback)     {
           String req = gson.toJson(callback.getJsonRequest(), JsonRequest.class); if (logger.isDebugEnabled())             logger.debug(callback.getMethodName() + " req:" + req); try         {
   return new StringRequestEntity(req, null, "utf8");         } catch (UnsupportedEncodingException e)         {
               logger.error("create StringRequestEntity failed for UnsupportedEncodingException."); throw new RuntimeException("create StringRequestEntity failed for UnsupportedEncodingException.");         }     } /**      * 方法表述：当收到服务器传递过来的信息时，如何处理 */ public static Object doResponseReceived(String response, JsonCallback callback) throws CException     {
           AccountSmsReturn rsp = gson.fromJson(response, AccountSmsReturn.class); if (rsp != null && rsp.result != null && rsp.result.resultCode.equals("0"))         {
   return callback.onResultReceived(rsp.result);         } else         {
   throw rsp.result.CException;         }     }