虽然有Json,可是接口报文大部分时候采用的XML。接口开发中最麻烦的是接口报文不断变化,使用数据库记录报文结构当然能够应对接口的变化,可是有些时候缓存没法设计,好比以下这个报文的BODY部分:java
<BODY> <LOOP> <NAME>jerry</NAME> <AGE>21</AGE> </LOOP> <LOOP> <NAME>mark</NAME> <AGE>22</AGE> </LOOP> </BODY>
在上面的报文BODY部分,两个LOOP存在的状况,没法经过其余属性来标识两个LOOP的差别属性,在作缓存的时候,没法经过key去区分这两个LOOP的缓存信息。还有一种状况正则表达式
<BODY> <LOOP_NUM>2<LOOP_NUM> <LOOP> <CUST_NAME>阿毛</CUST_NAME> <CUST_IDCARD_NO>11111111111111111</CUST_IDCARD_NO> </LOOP> <LOOP> <AGENT_NAME>阿狗</CUST_NAME> <AGENT_IDCARD_NO>2222222222222222</CUST_IDCARD_NO> <TRAN_TIME>20140411</TRAN_TIME> </LOOP> </BODY>
两个Loop里面的内容还不一致。这样的报文结构设计,哎……当咱们去从别人的系统中获取数据或者提交数据,也会碰到,这样的报文结构若是存入数据库中,如何缓存到内存中呢?我没有找到比较好的方法。因而我就采用了最笨的方法是用StringBuilder(或者StringBuffer去拼接xml字符串),固然可以完成工做,可是每一个交易的报文拼接要写几百行的代码,并且不易维护,若是别人来维护个人代码,我估计他要疯了。数据库
因而我开始寻找一些方法,去解决这些问题。后面我想到了一个方案,不知道好很差,可是可以解决个人问题,并且不用修改代码了。缓存
个人方案是每一个交易的报文写成一个xml文件,采用相似EL表达式同样的法则去给报文赋值。以下所示:ide
<BODY> <LOOP_NUM>${LOOP_NUM}<LOOP_NUM> <LOOP> <CUST_NAME>${CUST_NAME}</CUST_NAME> <CUST_IDCARD_NO>${CUST_IDCARD_NO}</CUST_IDCARD_NO> </LOOP> <LOOP> <AGENT_NAME>${AGENT_NAME}</CUST_NAME> <AGENT_IDCARD_NO>${AGENT_IDCARD_NO}</CUST_IDCARD_NO> <TRAN_TIME>${TRAN_TIME}</TRAN_TIME> </LOOP> </BODY>
这样的好处有以下两点:oop
1.修改接口报文不须要修改代码或者数据库了,直接改xml文件。单元测试
2.接口报文赋值修改只须要将${name}修改成${name_1}.测试
对于其余竞争公司常常修改报文故意刁难本身的时候,不要担忧这个他们疯狂的接口变动了!!让他们自做孽去吧!ui
闲话很少说了。开始设计。spa
首先应该读取xml文件并缓存。
/*** * * @author 零下三度(huangqian866@163.com) * */ public class FileIOUtils { /*** * 默认类路径 */ public static final String DEFAULT_CLASS_PATH = System .getProperty("user.dir") + File.separator + "src"; public static final String CHARSET = "UTF-8"; /*** * 文件过滤器,过滤出xml文件 */ private static FileFilter filter = new FileFilter() { @Override public boolean accept(File pathname) { if (pathname.isFile() && pathname.getName().toLowerCase().endsWith(".xml")) { return true; } return false; } }; /*** * 获取指定目录下的全部xml文件的绝对路径 * * @param dirPath * 目录路径 * @return */ public static List<String> getXmlFileAbspath(String dirPath) { ArrayList<String> fileNames = new ArrayList<String>(); if (dirPath == null || dirPath.trim().isEmpty()) { dirPath = DEFAULT_CLASS_PATH; } File dir = new File(dirPath); if (dir.exists()) {// 文件存在 if (dir.isDirectory()) {// 文件为目录路径 File[] xmlFiles = dir.listFiles(filter); for (File file : xmlFiles) { fileNames.add(file.getAbsolutePath()); System.out.println(file.getAbsolutePath()); } } } return fileNames; } /*** * 根据文件路径,获取文件内容 * * @param filePath * @return */ public static String getContent(String filePath) { String context = ""; try { File file = new File(filePath); if (file.exists() && file.isFile()) { FileInputStream fis = new FileInputStream(file); byte buffer[] = new byte[fis.available()]; fis.read(buffer, 0, fis.available()); context = new String(buffer, CHARSET); fis.close(); } } catch (FileNotFoundException e) { e.printStackTrace(); } catch (IOException e) { e.printStackTrace(); } return context; } }
缓存类代码以下:
/*** * * @author 零下三度(huangqian866@163.com) * */ public class FileIOUtils { /*** * 默认类路径 */ public static final String DEFAULT_CLASS_PATH = System .getProperty("user.dir") + File.separator + "src"; public static final String CHARSET = "UTF-8"; /*** * 文件过滤器,过滤出xml文件 */ private static FileFilter filter = new FileFilter() { @Override public boolean accept(File pathname) { if (pathname.isFile() && pathname.getName().toLowerCase().endsWith(".xml")) { return true; } return false; } }; /*** * 获取指定目录下的全部xml文件的绝对路径 * * @param dirPath * 目录路径 * @return */ public static List<String> getXmlFileAbspath(String dirPath) { ArrayList<String> fileNames = new ArrayList<String>(); if (dirPath == null || dirPath.trim().isEmpty()) { dirPath = DEFAULT_CLASS_PATH; } File dir = new File(dirPath); if (dir.exists()) {// 文件存在 if (dir.isDirectory()) {// 文件为目录路径 File[] xmlFiles = dir.listFiles(filter); for (File file : xmlFiles) { fileNames.add(file.getAbsolutePath()); System.out.println(file.getAbsolutePath()); } } } return fileNames; } /*** * 根据文件路径,获取文件内容 * * @param filePath * @return */ public static String getContent(String filePath) { String context = ""; try { File file = new File(filePath); if (file.exists() && file.isFile()) { FileInputStream fis = new FileInputStream(file); byte buffer[] = new byte[fis.available()]; fis.read(buffer, 0, fis.available()); context = new String(buffer, CHARSET); fis.close(); } } catch (FileNotFoundException e) { e.printStackTrace(); } catch (IOException e) { e.printStackTrace(); } return context; } }
完成文件读取和内容缓存,接下来就是格式化替代的工做了。java中有一个自带的MessageFormat类,其麻烦支出在于参数必须按照顺序给,不然就乱了。接口开发的时候尽可能要使用者方便一些,因此在这里采用正则表达式去替换。
格式化类代码以下:
/*** * * @author huangqian(huangqian866@163.com) * */ public class XmlMessageFormat implements Formatable { /*** * XML中值替换的正则表达式模式,例如${name} */ public static final String REGEX_PATTERN = "(\\$\\{)(\\w+)(\\})"; @Override public String format(Map<String,String> data,String srcXmlMessage) { Pattern pattern = Pattern.compile(REGEX_PATTERN); Matcher matcher = pattern.matcher(srcXmlMessage); while(matcher.find()){ String key = matcher.group(2); String val = data.get(key); val = val==null ? "" : val.trim(); String replaceRegexPattern = "\\$\\{"+key+"\\}"; srcXmlMessage = srcXmlMessage.replaceAll(replaceRegexPattern, val); } return srcXmlMessage; } }
在完成读取xml文件和字符串格式化类后,接下来的就是报文工厂了,代码以下:
/*** * * @author 零下三度(huangqian866@163.com) * */ public class MessageFactory { private static final Formatable format = new XmlMessageFormat(); public static String creatXmlMessage(String tranNo,HashMap<String,String> data) throws NoSuchTranException { if(tranNo == null || tranNo.trim().isEmpty()){//交易号为null || isEmpty throw new NoSuchTranException("tranNo is Empty or null"); } String content = FileCache.getInstance().getData(tranNo.trim()); if(content == null){//未能在缓存中找到以tranNo为key的数据 throw new NoSuchTranException("not found file content in FileCache"); } return format.format(data, content); } }
好了。以上是基础的架子,写出来了,尚未完,必须单元测试一下。这里就不详细测试各个方法了,只写一个creatXmlMessage方法的测试用例。
/*** * * @author 零下三度(huangqian866@163.com) * */ public class MessageFactoryTest { @Test public void test() { String tranNo = "1009"; HashMap<String,String> data = new HashMap<String,String>(); data.put("SEQ_NO", "2014022800010502"); data.put("TRAN_DATE", "20140418"); data.put("SERVICE_ID", "Y001"); data.put("BANK_CODE", "9901"); data.put("TRAN_TIME", "095104"); data.put("CHANNEL_ID", "04"); data.put("USER_ID", "001"); data.put("BUSINESS_ID", "Y001"); data.put("TYPE", "Z2"); data.put("YTD_IP", "66.12.18.20"); data.put("LOOPNUM", "1"); data.put("ZHUCZJ", "1111111111.11"); data.put("HANGYL", "0"); data.put("ZZZCDZ", "北京市东城区北京市东城区"); data.put("SFRENMC", "阿毛"); data.put("SUSDDM", "320100"); data.put("FRENMC", "111"); String xml = MessageFactory.creatXmlMessage(tranNo, data); System.out.println(xml); } }
报文xml文件1009.xml其中内容是:
<?xml version="1.0" encoding="GBK"?> <Transaction> <BODY> <YTD_IP>${YTD_IP}</YTD_IP> <QUEUE_NO>${QUEUE_NO}</QUEUE_NO> <LOOPNUM>${LOOPNUM}</LOOPNUM> <LOOP> <CODERECORD> <ZHUCZJ>${ZHUCZJ}</ZHUCZJ> <HANGYL>${HANGYL}</HANGYL> <ZZZCDZ>${ZZZCDZ}</ZZZCDZ> <SFRENMC>${SFRENMC}</SFRENMC> <SUSDDM>${SUSDDM}</SUSDDM> <FRENMC>${FRENMC}</FRENMC> <SJZGZH>${SJZGZH}</SJZGZH> </CODERECORD> <TRANCODE></TRANCODE> </LOOP> <TYPE>Z2</TYPE> </BODY> <HEAD> <EXT_HEAD> <BUSINESS_ID>${BUSINESS_ID}</BUSINESS_ID> <MAC_INDEX></MAC_INDEX> <MAC_VALUE></MAC_VALUE> </EXT_HEAD> <TRAN_TERM></TRAN_TERM> <USER_ID>${USER_ID}</USER_ID> <CHANNEL_ID>${CHANNEL_ID}</CHANNEL_ID> <TRAN_TIME>${TRAN_TIME}</TRAN_TIME> <BANK_CODE>${BANK_CODE}</BANK_CODE> <SERVER_ID></SERVER_ID> <AUTH_ID></AUTH_ID> <AUTH_CONTEXT></AUTH_CONTEXT> <SERVICE_ID>${SERVICE_ID}</SERVICE_ID> <TRAN_DATE>${TRAN_DATE}</TRAN_DATE> <SEQ_NO>${SEQ_NO}</SEQ_NO> </HEAD> </Transaction>
运行测试用例,测试结果以下:
<?xml version="1.0" encoding="GBK"?>
<Transaction>
<BODY>
<YTD_IP>66.12.18.20</YTD_IP>
<QUEUE_NO></QUEUE_NO>
<LOOPNUM>1</LOOPNUM>
<LOOP>
<CODERECORD>
<ZHUCZJ>1111111111.11</ZHUCZJ>
<HANGYL>0</HANGYL>
<ZZZCDZ>北京市东城区北京市东城区</ZZZCDZ>
<SFRENMC>阿毛</SFRENMC>
<SUSDDM>320100</SUSDDM>
<FRENMC>111</FRENMC>
<SJZGZH></SJZGZH>
</CODERECORD>
<TRANCODE></TRANCODE>
</LOOP>
<TYPE>Z2</TYPE>
</BODY>
<HEAD>
<EXT_HEAD>
<BUSINESS_ID>Y001</BUSINESS_ID>
<MAC_INDEX></MAC_INDEX>
<MAC_VALUE></MAC_VALUE>
</EXT_HEAD>
<TRAN_TERM></TRAN_TERM>
<USER_ID>001</USER_ID>
<CHANNEL_ID>04</CHANNEL_ID>
<TRAN_TIME>095104</TRAN_TIME>
<BANK_CODE>9901</BANK_CODE>
<SERVER_ID></SERVER_ID>
<AUTH_ID></AUTH_ID>
<AUTH_CONTEXT></AUTH_CONTEXT>
<SERVICE_ID>Y001</SERVICE_ID>
<TRAN_DATE>20140418</TRAN_DATE>
<SEQ_NO>2014022800010502</SEQ_NO>
</HEAD>
</Transaction>
完成了功能。
思考
这里有一个问题。没法完成foreach的能。好比说,我要查询学生表的前20条记录的响应报文,这个功能如今还不能根据实际个数去循环组转报文,这个是后续努力的方向。若是这个实现了,那么组装报文就一切都很简单了。