OpenAPI自定义报文二开手册

适用版本：850、860、861、862

    （后续回迁之后会更新各版本对应的补丁号，此贴持续更新）

    850版本需要更新补丁：

    860版本需要更新补丁：先更新sp1PTM（PTM150382）升级861，再更新sp2PTM升级862（PTM158682）

    861版本需要更新补丁：PTM158682

    OpenAPI支持AOP自定义注册扩展处理器，可依照需求进行前置处理、后置处理以及自定义报文格式处理。

    请注意事务问题，既有require事务情况下，handler发生异常原有事务不会回滚。

    若自定义报文，请使用postman调用。

1.     前台配置

   对应OpenAPI方案中某个具体需要实现报文自定义的方法中填写扩展处理器的全路径名，注意和代码中自定义实现类的全路径保持一致。
   

   
   

2.     后台实现

   自定义实现类继承AbstractOpenAPIExtHandler类，重写报文转换方法。

   数据转换可以参考使用 com.kingdee.bos.openapi.util.json.JSONUtils.convertObjectToJson(Context, Object)以及 com.kingdee.bos.openapi.util.json.JSONUtils.convertJsonToObject(String, Class<T>)

   
   

3.     调用结果

   原始请求报文：

{
    "api": "",
    "data": "[""]"
}

        原始返回报文：

{
  "errCode": 0,
  "errMsg": null,
  "errStackTrace": null,
  "data": "{\"taskId\":null,\"result\":null}",
  "description": null,
  "description_cn": null
}

        3.1    单入参