client_hessian.md 3.68 KB

前端调用接口简介


  1. 调用服务端接口需通过富深开发的jar包访问接口
  2. 开发示例(java示例)

    FrameInvokeServiceClient client = new FrameInvokeServiceClient();  
    
    //此处填写公积金中心的服务地址  
    client.setUrl("http://xxxxxxxxxx/esb/service/invokeService);  
    client.setEncode("GBK");  
    
    //invoke方法完成 编码压缩、发送、获得返回报文、解压和签名对比  
    //retxml是获得的返回明文  
    String retxml = client.invoke("发送json报文明文");  
    
    System.out.println(retxml);
  1. 请求报文

    1. 请求报文格式示例

      {
      "head":{ 
              "appid":"78",
              "transcode":"010101",
              "trantime":"20110710150312",
              "iseqno":"201107101503120011"
              },
      "body":{
              "head":{
                      "type": "cas",
                      "logname":"320382199504285013",
                      "xingming":"张三"
                      },
              "list":{}
              }
      }
      1. 请求报文格式说明  
      1. 报文由head和body两部分组成,其中head中元素及格式固定,body中元素及格式根据具体业务会不同。
      1. head元素列表  
          <table width='100%'>
          <tr align='left'><th width='10%'>出现位置</th><th width='10%'>信息项英文名称</th><th width='10%'>信息项名称</th><th width='60%'>描述</th></tr>
          <tr align='left'><td>请求、应答</td><td>sender</td><td>发送方</td><td>固定值</td></tr>
          <tr align='left'><td>请求、应答</td><td>receiver</td><td>接收方</td><td>固定值</td></tr>
          <tr align='left'><td>请求、应答</td><td>appid</td><td>应用系统</td><td>固定值</td></tr>
          <tr align='left'><td>请求、应答</td><td>transcode</td><td>报文交易代码</td><td>用于区分各业务功能,是最重要的参数</td></tr>
          <tr align='left'><td>请求</td><td>trantime</td><td>发送时间</td><td>yyyyMMddhhmmss</td></tr>
          <tr align='left'><td>请求、应答</td><td>iseqno</td><td>报文流水号</td><td>示例:201107101503120011,由前端生成</td></tr>
          <tr align='left'><td>应答</td><td>retcode</td><td>应答代码</td><td>retcode只有两种值,code=0001表示请求成功,code=9999,表示请求失败,这个时候你们取retmsg(请求失败原因)</td></tr>
          <tr align='left'><td>应答</td><td>retmsg</td><td>应答信息</td><td>提示信息(只有retcode=9999的时候取)</td></tr>
          </table>
      1. body结构  
      一般包括head和list两部分,具体内容会根据业务进行详细说明  
  2. 应答报文

    1. 应答报文格式示例 ``` { "head":{ "appid":"78", "transcode":"010101", "trantime":"20110710150312", "iseqno":"201107101503120011", "retcode":"0001" }, "body":{ "list":{ "acc_info":{
      "dwmc": "信宝行汽车销售服务有限公司", ...中间省略,具体字段参考上表... } } } } 1. 应答报文说明 retcode:0001表示请求成功,9999,表示请求失败;当请求失败时,可获取retmsg显示失败原因。