定損工具V1.8.0.0接口文檔(20121020)

1、1. 概述1.1. 名詞解釋名稱簡(jiǎn)稱說(shuō)明1.2. 方案概述2. 系統(tǒng)環(huán)境3. 流程設(shè)計(jì)4. 接口設(shè)計(jì)4.1. 接口實(shí)現(xiàn)方式數(shù)據(jù)交換的基礎(chǔ)網(wǎng)絡(luò)協(xié)議采用TCP/IP，數(shù)據(jù)采用HTTP包格式來(lái)封裝。定損系統(tǒng)與新理賠系統(tǒng)采用HTTP協(xié)議訪問servlet的方式來(lái)進(jìn)行交互。4.2. 接口數(shù)據(jù)定義4.2.1. 定損請(qǐng)求交互.1. 功能描述該接口主要是完成理賠系統(tǒng)向定損系統(tǒng)傳遞一些初始化參數(shù)的功能。定損系統(tǒng)根據(jù)傳過來(lái)的初始化參數(shù)輔助生成定損單表和定價(jià)信息。.1.1. 接口方法接口方法名稱： ClaimFittingInterfaceServlet.2. 接口入?yún)?.

2、.1. 字段說(shuō)明請(qǐng)求報(bào)文中共有兩部分組成：Ø 頭報(bào)文段，它其中的主要參數(shù)如表4-1所示：表4-1頭報(bào)文參數(shù)序號(hào)名稱代碼數(shù)據(jù)類型非空備注1.用戶名UserCodeCHAR(30)Y2.密碼PasswordVARCHAR(30)Y3.請(qǐng)求類型RequestTypeCHAR(2)Y請(qǐng)求類型代碼數(shù)據(jù)字典4.換件折扣率ChgDisCountRateNUMBER(14,2)Y可能大于100%5.返回URLReturnURLVarchar(200)返回到理賠系統(tǒng)的地址Ø 數(shù)據(jù)報(bào)文段，它里面的參數(shù)如表4-2所示：表4-2數(shù)據(jù)報(bào)文參數(shù)序號(hào)名稱代碼數(shù)據(jù)類型非空備注1.定損流程類型

3、EvalFlowTypeChar（1）Y2-定核報(bào)1-定報(bào)核僅第一次傳入時(shí)有用2.修理廠代碼RepairFactoryCodeVarchar（60）N3.修理廠名稱RepairFactoryNameVarchar（60）N4.修理廠類型RepairFactoryTypeChar（1）Y1-4s店2-一類廠店3-二類廠店4-三類廠店5.修理廠品牌代碼RepairBrandCodeVarchar（60）N6.修理廠品牌名稱RepairBrandNameVarchar（60）N7.修理廠工時(shí)單價(jià)RepairBrandManHourNumber(14,2)Y*元/小時(shí)8.修理廠噴漆系數(shù)RepairBr

4、andPaintRateNumber(14,2)N默認(rèn)值為19.修理廠工時(shí)上調(diào)比例RepairManHourAdjustRateNumber(14,2)N默認(rèn)值為110.修理廠換件上調(diào)比例RepairFitsAdjustRateNumber(14,2)N默認(rèn)值為111.報(bào)案號(hào)碼RegistNoChar(22)Y12.定損單號(hào)LossNoDecimal(19,0)Y13.參考定損單號(hào)ReferLossNoDecimal(19,0)N14.車輛序號(hào)LossItemCodeVarchar(4)Y15.定損員市級(jí)機(jī)構(gòu)代碼CityComCodeChar(8)16.定損員省級(jí)機(jī)構(gòu)代碼ProComCodeC

5、har(8)17.定損員所屬機(jī)構(gòu)代碼ComCodeChar(8)18.車型代碼VehicleCodeChar(20)19.車型名稱VehicleNameVarchar(150)20.VINNOVINNoVarchar(18)21.定損員代碼HanderCodeChar(10)22.定損員名稱HanderNameVarchar20）23.駕駛證初登日期AcceptLicenseDateDateY24.返回地址ReturnURLVarchar（200）25.車牌號(hào)LicenseNoVARCHAR(20).2.2. 數(shù)據(jù)格式數(shù)據(jù)采用XML格式的文件，字符編碼為GBK。<?xml

6、version="1.0" encoding="GB2312"?><LossReqRequestData> <LossReqHead> <UserCode>jy01</UserCode> <Password>jy01</Password> <RequestType>001</RequestType> <ReturnURL>:8080/test/ClaimResultInterfaceServlet</Ret

7、urnURL> <ChgDisCountRate>0.8</ChgDisCountRate> </LossReqHead> <LossReqBody> <EvalFlowType>1</EvalFlowType> <RepairFactoryCode>RFC0001</RepairFactoryCode> <RepairFactoryName>修理廠0001</RepairFactoryName> <RepairFactoryType>1</Repai

8、rFactoryType> <RepairBrandCode>DZ01</RepairBrandCode> <RepairBrandName>上海大眾</RepairBrandName> <RepairBrandManHour>10</RepairBrandManHour> <RepairBrandPaintRate>0.95</RepairBrandPaintRate> <RepairManHourAdjustRate>0.95</RepairManHourAdjustRa

9、te> <RepairFitsAdjustRate>0.95</RepairFitsAdjustRate> <RegistNo>R001</RegistNo> <LossNo>987654321</LossNo> <ReferLossNo>P002</ReferLossNo> <LossItemCode>1234</LossItemCode> <CityComCode>01010000</CityComCode> <ProComCode&g

10、t;01000000</ProComCode> <ComCode>01010000</ComCode> <VehicleCode>BMI1046DGB</VehicleCode> <VehicleName>寶馬5系</VehicleName> <VINNo>LBVVA960BMCN0008</VINNo> <HandlerCode>0000000000</HandlerCode> <HandlerName>定損員001</HandlerName&

11、gt; <AcceptLicenseDate>2007-08-30</AcceptLicenseDate> <ReturnURL>:8080/test/ClaimResultInterfaceServlet</ReturnURL> <LicenseNo>987654321</LicenseNo> </LossReqBody>.3. 接口返回.3.1. 字段說(shuō)明 Ø 數(shù)據(jù)報(bào)文段，它里面的參數(shù)如下所示：數(shù)據(jù)報(bào)文參數(shù)序號(hào)名稱代碼數(shù)據(jù)類型非空編碼備注1

12、.返回類型代碼RESPONSE_CODECHAR(2)YY返回類型編碼字典2.錯(cuò)誤號(hào)ERROR_NOCHAR(10)第三方定損系統(tǒng)內(nèi)部錯(cuò)誤號(hào)3.錯(cuò)誤描述ERROR_MESSAGEVARCHAR(600)Y4.URL地址URL.3.2. 數(shù)據(jù)格式數(shù)據(jù)采用XML格式的文件，字符編碼為GBK。<?xml version="1.0" encoding="GBK"?><LossReqReturnData> <RESPONSE_CODE>000</RESPONSE_CODE> <ERROR_No&g

13、t;000</ERROR_No> <ERROR_MESSAGE>請(qǐng)求成功</ERROR_MESSAGE> <URL>:8080/pjbjrb/DsServlet?url=ds.do&amp;dbId=4028f8fe3796905c01379692622b0001.xml&amp;systemNo=987654321</URL></LossReqReturnData>.4. 接口樣例package com.jy.pjbj.web.action.dsd;import

14、 java.io.ByteArrayOutputStream;import java.io.File;import java.io.FileOutputStream;import java.io.IOException;import java.io.InputStream;import java.io.PrintWriter;import javax.servlet.ServletContext;import javax.servlet.ServletException;import javax.servlet.http.HttpServlet;import javax.servlet.htt

15、p.HttpServletRequest;import javax.servlet.http.HttpServletResponse;import org.apache.log4j.Logger;import org.dom4j.Document;import org.dom4j.DocumentException;import org.dom4j.DocumentHelper;import org.dom4j.Element;import org.dom4j.Node;import org.dom4j.io.OutputFormat;import org.dom4j.io.XMLWriter

16、;import org.springframework.web.context.WebApplicationContext;import org.springframework.web.context.support.WebApplicationContextUtils;import com.jy.framework.util.DomService;import com.jy.framework.util.UUIDPK;import com.jy.pjbj.dto.LossRequestDataDTO;import com.jy.pjbj.dto.manhour.ClaimXmlDTO;imp

17、ort com.jy.pjbj.dto.manhour.RepairFactTypeDictDTO;import com.jy.pjbj.entity.change.EvalTaskState;import com.jy.pjbj.service.LossRequestDataService;import com.jy.pjbj.service.aqqx.YhService;import com.jy.pjbj.service.manhour.DsContextService;import com.jy.pjbj.service.manhour.GsEvalService;import com

18、.jy.pjbj.service.manhour.ManagerService;import com.jy.pjbj.service.manhour.RepairService;import com.jy.pjbj.util.Constants;import com.jy.pjbj.util.StringUtils;public class ClaimFittingInterfaceServlet extends HttpServlet private static final long serialVersionUID = 1L;private GsEvalService gsEvalSer

19、vice;private ManagerService managerService; private DsContextService dsContextService; private LossRequestDataService lossRequestDataService; private RepairService repairService; private YhService yhService; private static final String CONTENT_TYPE = "text/html; charset=GBK"private static

20、final String EVAL_URL = "ClaimFittingInterfaceServlet"private Logger log = Logger.getLogger(this.getClass(); public ClaimFittingInterfaceServlet() super();/* * 初始化Servlet需要的bean */public void init() throws ServletException ServletContext servletContext = super.getServletContext();WebApplic

21、ationContext wac = WebApplicationContextUtils.getRequiredWebApplicationContext(servletContext);/ 注入beangsEvalService = (GsEvalService) wac.getBean("gsEvalService");managerService = (ManagerService) wac.getBean("managerService");dsContextService = (DsContextService) wac.getBean(&q

22、uot;dsContextService");lossRequestDataService = (LossRequestDataService) wac.getBean("lossRequestDataService");repairService = (RepairService)wac.getBean("repairService");yhService = (YhService)wac.getBean("yhService");/* * 流程：<br> * 1、接收理賠系統(tǒng)傳來(lái)的定損請(qǐng)求數(shù)據(jù)（XML），如果

23、為單服務(wù)器部署模式(DelplyMode=SINGLE)，將數(shù)據(jù)寫入臨時(shí)文件； * 如果是多服務(wù)器部署模式(DelplyMode=MULTI)，將數(shù)據(jù)寫數(shù)據(jù)數(shù)據(jù)庫(kù)。<br> * 2、解析xml文件為ClaimXmlDTO，獲取一些進(jìn)入定損系統(tǒng)的必要數(shù)據(jù)。<br> * 3、驗(yàn)證理賠系統(tǒng)傳來(lái)的數(shù)據(jù)是否正確，如果不正確返回錯(cuò)誤代碼；如果正確，返回正確代碼。<br> * 4、向理賠系統(tǒng)發(fā)送處理結(jié)果數(shù)據(jù)。 */public void doGet(HttpServletRequest request, HttpServletResponse response)throw

24、s ServletException, IOException / 增加異常捕捉并記錄到日志中try response.setContentType(CONTENT_TYPE);String deployMode = gsEvalService.getDeployMode();/ 接收人保發(fā)來(lái)的信息,寫XML文件InputStream in = request.getInputStream();/ 將收到的xml文件流保存到文件中ByteArrayOutputStream byteOut = new ByteArrayOutputStream();byte data = null;byte b

25、 = new byte1024;int read = 0;/ 轉(zhuǎn)換數(shù)據(jù)流while (read = in.read(b) != -1) byteOut.write(b, 0, read);data = byteOut.toByteArray();/ 接收完畢in.close();byteOut.close();String claimXmlSend = new String(data);("=理賠系統(tǒng)發(fā)送過來(lái)的xml文件流：claimXmlSend=");(claimXmlSend);String fileName = ""

26、;if (deployMode != null && deployMode.equals("SINGLE") / 保存到xml文件中String filePath = dsContextService.getTmpPath();fileName = UUIDPK.getUUID() + ".xml"String file = filePath + fileName;File fileObj = new File(file);if (!fileObj.exists() fileObj.createNewFile();FileOutputSt

27、ream fos = new FileOutputStream(file);fos.write(data);fos.close(); else LossRequestDataDTO lossRequestDataDTO = new LossRequestDataDTO();lossRequestDataDTO.setXmlData(claimXmlSend);lossRequestDataDTO = lossRequestDataService.saveLossRequestDataDTO(lossRequestDataDTO);fileName = lossRequestDataDTO.ge

28、tId() + ".xml"/ 兼容單服務(wù)器模式，因此將ID寫成文件名形式/ 解析xml文件為ClaimXmlDTOClaimXmlDTO xmlDTO = getXmlDTO(claimXmlSend);/ 確定返回代碼String reCode = xmlDTO.getReponseCode();if (Constants.XML_FORMAT_ERROR.equals(reCode) / xml文件格式錯(cuò)誤reCode = Constants.XML_FORMAT_ERROR; else / xml文件格式正確，解析請(qǐng)求類型確定返回類型if (Constants.CH

29、ECK_SYN_REQUEST.equals(xmlDTO.getRequestType()| Constants.POWER_REQUEST.equals(xmlDTO.getRequestType() / 021：用戶權(quán)限維護(hù)請(qǐng)求 023：數(shù)據(jù)一致性校驗(yàn)請(qǐng)求reCode = Constants.REQUEST_SUCCESS; else reCode = getReponseCode(xmlDTO);if (reCode = null | reCode.equals("")reCode = Constants.OTHER_ERROR; / 其它異常錯(cuò)誤(

30、"-XML信息處理結(jié)果：reCode" + reCode);/ 取得定損系統(tǒng)URLString url = request.getRequestURL().toString();String evalUrl = url.substring(0, url.indexOf(EVAL_URL);if (Constants.CHECK_SYN_REQUEST.equals(xmlDTO.getRequestType() evalUrl = gsEvalService.getEvalInfoUpdateFlag(xmlDTO.getRegistNo(), xmlDTO.getLoss

31、No();("=定損系統(tǒng)URL:" + evalUrl);/ 返回理賠系統(tǒng)的結(jié)果數(shù)據(jù)String s = buildContent(reCode, xmlDTO, evalUrl, fileName);("返回理賠系統(tǒng)的結(jié)果數(shù)據(jù):" + s);PrintWriter out = response.getWriter();out.print(s); catch (Exception ex) / 將異常信息記錄日志if (ex != null) ex.printStackTrace();StringBuffer s = new

32、 StringBuffer("nSystemError:");s.append(ex.toString().append("nMessage:").append(ex.getMessage().append("nCause:").append(ex.getCause();StackTraceElement trace = ex.getStackTrace();for (int i = 0; i < trace.length; i+) s.append("n ").append(tracei);log.erro

33、r(s.toString();/ 返回理賠系統(tǒng)的結(jié)果數(shù)據(jù)String errMsgXml = buildContent(ex.toString();log.error("返回理賠系統(tǒng)的錯(cuò)誤信息:" + errMsgXml);PrintWriter out = response.getWriter();out.print(errMsgXml);public void doPost(HttpServletRequest request, HttpServletResponse response)throws ServletException, IOException doGet

34、(request, response);/* * 將XML文件的內(nèi)容轉(zhuǎn)化為String * param document * return XML字符串 */private static String doc2String(Document document) String s = ""try / 使用輸出流來(lái)進(jìn)行轉(zhuǎn)化ByteArrayOutputStream out = new ByteArrayOutputStream();/ 使用GB2312編碼OutputFormat format = new OutputFormat(" ", true, &q

35、uot;GBK");XMLWriter writer = new XMLWriter(out, format);writer.write(document);s = out.toString("GBK"); catch (Exception ex) ex.printStackTrace();return s;/* * 生成響應(yīng)數(shù)據(jù)，響應(yīng)理賠系統(tǒng)的XML * param reCode * param xmlDTO * param evalUrl * param filename * return */private String buildContent(Strin

36、g reCode, ClaimXmlDTO xmlDTO,String evalUrl, String filename) /* 建立document對(duì)象 */Document document = DocumentHelper.createDocument();/* 建立XML文檔的根LossReqRequestData */Element rootElement = document.addElement("LossReqReturnData");/* 加入RESPONSE_CODE節(jié)點(diǎn) */Element titleElement = rootElement.addE

37、lement("RESPONSE_CODE");if (reCode != null && reCode.equals("403") / 403轉(zhuǎn)化為499titleElement.setText("499"); else titleElement.setText(reCode);/* 加入ERROR_No節(jié)點(diǎn) */titleElement = rootElement.addElement("ERROR_No");if (reCode != null && reCode.equals

38、("403") / 403轉(zhuǎn)化為499titleElement.setText("499"); else titleElement.setText(reCode);/* 加入ERROR_MESSAGE節(jié)點(diǎn) */titleElement = rootElement.addElement("ERROR_MESSAGE");String errMsg = (String) Constants.RESPONSE_CODE_MAP.get(reCode);if (reCode != null && reCode.equals(&

39、quot;403") errMsg = "用戶名稱:" + xmlDTO.getHandlerName() + " 用戶代碼:" + xmlDTO.getHandlerCode() + errMsg;titleElement.setText(errMsg);String requestType = xmlDTO.getRequestType();/* 加入U(xiǎn)RL節(jié)點(diǎn) */titleElement = rootElement.addElement("URL");if ("023".equals(reques

40、tType) titleElement.setText(evalUrl); else if (evalUrl != null && !"".equals(evalUrl) if ("021".equals(requestType) if (xmlDTO.getHandlerCode() != null&& !"".equals(xmlDTO.getHandlerCode().trim() titleElement.setText(evalUrl + "DsServlet?url=manager

41、Edit.do&dbId="+ filename + "&systemNo=P001"); else / 目前需要理賠系統(tǒng)先設(shè)置才能維護(hù)其第三方的權(quán)限，因此此列表維護(hù)的功能不會(huì)被使用titleElement.setText(evalUrl + "DsServlet?url=managerList.do&dbId="+ filename + "&systemNo=P001"); else titleElement.setText(evalUrl + "DsServlet?url=ds.

42、do&dbId="+ filename + "&systemNo=" + xmlDTO.getLossNo();return doc2String(document);/ 定損請(qǐng)求xml數(shù)據(jù)private String buildContent(String errMsg) /* 建立document對(duì)象 */Document document = DocumentHelper.createDocument();/* 建立XML文檔的根LossReqRequestData */Element rootElement = document.addEl

43、ement("LossReqReturnData");/* 加入RESPONSE_CODE節(jié)點(diǎn) */Element titleElement = rootElement.addElement("RESPONSE_CODE");titleElement.setText("499");/* 加入ERROR_No節(jié)點(diǎn) */titleElement = rootElement.addElement("ERROR_No");titleElement.setText("499");/* 加入ERROR_ME

44、SSAGE節(jié)點(diǎn) */titleElement = rootElement.addElement("ERROR_MESSAGE");titleElement.setText(String)Constants.RESPONSE_CODE_MAP.get("499")+errMsg);/* 加入U(xiǎn)RL節(jié)點(diǎn) */titleElement = rootElement.addElement("URL");titleElement.setText("Error 499");return doc2String(document);

45、/* * 較驗(yàn)理賠系統(tǒng)傳來(lái)的參數(shù)是否完整。<br> * 如數(shù)據(jù)不完整，將不能進(jìn)入定損工具。 * param xmlDTO * return */private String getReponseCode(ClaimXmlDTO xmlDTO) String RegistNo = xmlDTO.getRegistNo();/ 得到報(bào)案號(hào)碼if (RegistNo = null | RegistNo.equals("") return Constants.DATA_INTEGRITY_ERROR;/ 數(shù)據(jù)完整性錯(cuò)誤：缺少報(bào)案號(hào)String LossNo = xmlD

46、TO.getLossNo();/ 得到定損單號(hào)if (LossNo = null | LossNo.equals("") return Constants.DATA_INTEGRITY_ERROR;/ 數(shù)據(jù)完整性錯(cuò)誤：缺少定損單號(hào)String handlerCode = xmlDTO.getHandlerCode();/ 得到定損員代碼if (handlerCode = null | handlerCode.equals("") return Constants.DATA_INTEGRITY_ERROR;/ 數(shù)據(jù)完整性錯(cuò)誤：缺少定損員代碼String a

47、ppVersion = gsEvalService.getAppVersoinOfLoss(LossNo);String requestWay=xmlDTO.getRequestWay();/*EvalTaskState evalTaskState=gsEvalService.getEvalTaskStateAfterLossNo(LossNo);if(null != evalTaskState && StringUtils.notEmpty(evalTaskState.getRequestWay()&& !requestWay.equals(evalTaskS

48、tate.getRequestWay()return Constants.REQUEST_WAY_CHANGE_ERROR;/ 定損方式改變?cè)〒p單未注銷*/if(appVersion=null | !appVersion.equals(Constants.APP_VERSION_V161)/定損單號(hào)對(duì)應(yīng)的版本不存在或定損單系統(tǒng)版本不為V161時(shí)，才檢查修理廠參數(shù)zwb 09.6.19/修復(fù)定損、一次性協(xié)議定損有修理廠信息；推定全損、被代位協(xié)議定損沒有修理廠信息if(Constants.EVAL_REQUEST.equals(xmlDTO.getRequestType()String repa

49、irFactoryType = xmlDTO.getRepairFactoryType();Double unitManHour = xmlDTO.getRepairBrandManHour();Double repairBrandPaintRate=xmlDTO.getRepairBrandPaintRate();if(Constants.REQUEST_WAY_XFDS.equals(requestWay) | Constants.REQUEST_WAY_YCXYDS.equals(requestWay)if (repairFactoryType = null | repairFactor

50、yType.equals("") return Constants.DATA_INTEGRITY_ERROR;/ 數(shù)據(jù)完整性錯(cuò)誤：缺少修理廠類型RepairFactTypeDictDTO dto = repairService.getRepairFactTypeDictByCode(repairFactoryType);if (dto = null) return Constants.DATA_INTEGRITY_ERROR;/ 數(shù)據(jù)完整性錯(cuò)誤：非法的修理廠類型if (unitManHour = null | unitManHour.doubleValue() = 0) r

51、eturn Constants.DATA_INTEGRITY_ERROR;/ 數(shù)據(jù)完整性錯(cuò)誤：缺少工時(shí)單價(jià)if(repairBrandPaintRate!=null && repairBrandPaintRate.doubleValue()=0)return Constants.DATA_INTEGRITY_ERROR;/ 數(shù)據(jù)完整性錯(cuò)誤：缺少噴漆系數(shù)不為空，并且等于0else if(StringUtils.isEmpty(xmlDTO.getIsExistFactoryInfo()return Constants.DATA_INTEGRITY_ERROR;/ 數(shù)據(jù)完整性錯(cuò)誤：

52、缺少噴漆系數(shù)不為空，并且等于0else if("1".equals(xmlDTO.getIsExistFactoryInfo()RepairFactTypeDictDTO dto = repairService.getRepairFactTypeDictByCode(repairFactoryType);if (dto = null) return Constants.DATA_INTEGRITY_ERROR;/ 數(shù)據(jù)完整性錯(cuò)誤：非法的修理廠類型if (unitManHour = null | unitManHour.doubleValue() = 0) return Co

53、nstants.DATA_INTEGRITY_ERROR;/ 數(shù)據(jù)完整性錯(cuò)誤：缺少工時(shí)單價(jià)if(repairBrandPaintRate!=null && repairBrandPaintRate.doubleValue()=0)return Constants.DATA_INTEGRITY_ERROR;/ 數(shù)據(jù)完整性錯(cuò)誤：缺少噴漆系數(shù)不為空，并且等于0String comcode = dsContextService.getComCode(); if(comcode.indexOf(",")>0 )/配置了多個(gè)省級(jí)機(jī)構(gòu)if(xmlDTO.getPro

54、ComCode() = null | "".equals(xmlDTO.getProComCode().trim() | comcode.indexOf(xmlDTO.getProComCode().trim()<0)String proComcode = yhService.getProComCodeByYhid(xmlDTO.getHandlerCode();if(null = proComcode | "".equals(proComcode)/判斷當(dāng)前用戶數(shù)據(jù)庫(kù)中的省級(jí)機(jī)構(gòu)是否存在return Constants.DATA_INTEGRITY_ERROR;/ 數(shù)據(jù)完整性錯(cuò)誤：缺少用戶省級(jí)機(jī)構(gòu)或用戶省級(jí)機(jī)構(gòu)不正確if(Constants.REPORT_REQUEST.equals(xmlDTO.getRequestType()/進(jìn)入報(bào)價(jià)環(huán)節(jié)時(shí)檢查報(bào)價(jià)等級(jí)是否在確定范圍內(nèi)if(Constants.AUDIT_PRICE_LEVEL_MAP.get(xmlDTO.GetA