Smooks转换设计
背景
不同的合作银行对应的外部接口是不一样的,我们需要把外部这些变化不定的接口格式,转换为我们银保通系统可以识别的内部接口.Smooks可以很好的解决这一问题.并且,当合作银行的接口随着业务的变化而发生变化时,smooks只需要通过变更转换模板,就可以实现对变化后接口的支持。
Smooks框架可以在smooks的官网www.smooks.org (需要FQ软)下载。本文smooks的版本是smooks-1.4。在其lib文件夹中是所需要的jar包。将所有jar包导入你的工程中，就能使用smooks进行报文解析了。
现在说明下面两种种转换：XmlToXml,CsvToXml.
1. Xml To Xml
说明xml转换为xml在smooks的配置中有两种方式，一种是通过xsl模板控制，一种是通过freemaker模板控制。其中后者比较灵活，格式容易控制，推荐使用后者。
1.1 use xsl Templating
工程名为MyXmlToXml①.需要转换的报文：文件名在程序中定为input-message.xml
<?xml version="1.0" encoding="GBK"?>     <PACKET type="REQUEST" version="1.0">    <HEAD>          <TRANSTYPE>SYN</TRANSTYPE>       <TRANSCODE>100006</TRANSCODE>        <USER>eies</USER>         <PASSWORD>eies</PASSWORD>     <SVCSEQNO></SVCSEQNO >      </HEAD>      <THIRD>          <EXTENTERPCODE>19002020102</EXTENTERPCODE>          <EXTPROVCODE>24</EXTPROVCODE>         <EXTAREACODE>0187</EXTAREACODE>      <EXTSITECODE>0187</EXTSITECODE>          <EXTSEQUENCENO>200804060001</EXTSEQUENCENO>          <TRANSDATE>2009-08-06</TRANSDATE>          <TRANSTIME>12:30:30</TRANSTIME>          <EXTOPERATORCODE>2020</EXTOPERATORCODE>      </THIRD>     <BODY>        <POLICYNO>110880829200904000016</POLICYNO>       <C_PASSWORD />     </BODY> </PACKET>②.配置转化的配置文件，在程序中名为smooks-config.xml：
<?xml version='1.0' encoding='UTF-8'?>
<smooks-resource-list xmlns="http://www.milyn.org/xsd/smooks-1.0.xsd"><!-- HEAD --><resource-config selector="HEAD"><resource type="xsl"><![CDATA[<HEAD><SVCTYPE><xsl:value-of select="./TRANSTYPE" /></SVCTYPE><SVCCODE><xsl:value-of select="./TRANSCODE" /></SVCCODE><SVCNAME><xsl:value-of select="./USER" /></SVCNAME><SVCSEQNO><xsl:value-of select="./PASSWORD" /></SVCSEQNO><SVCSTATUS>000000</SVCSTATUS><SVCMESSAGE></SVCMESSAGE><SVCDETAIL>QueryPolicyByProposalNoService</SVCDETAIL></HEAD>]]></resource><param name="is-xslt-templatelet">true</param></resource-config><!-- THIRD --><resource-config selector="THIRD"><resource type="xsl"><![CDATA[<THIRD><EXTENTERPCODE><xsl:value-of select="./EXTENTERPCODE" /></EXTENTERPCODE><EXTPROVCODE><xsl:value-of select="./EXTPROVCODE" /></EXTPROVCODE><EXTAREACODE><xsl:value-of select="./EXTAREACODE" /></EXTAREACODE><EXTSITECODE><xsl:value-of select="./EXTSITECODE" /></EXTSITECODE><EXTSEQUENCENO><xsl:value-of select="./EXTSEQUENCENO" /></EXTSEQUENCENO><TRANSDATE><xsl:value-of select="./TRANSDATE" /></TRANSDATE><TRANSTIME><xsl:value-of select="./TRANSTIME" /></TRANSTIME><EXTOPERATORCODE><xsl:value-of select="./EXTOPERATORCODE" /></EXTOPERATORCODE></THIRD>]]></resource><param name="is-xslt-templatelet">true</param></resource-config>      <!-- BODY --><resource-config selector="BODY"><resource type="xsl"><![CDATA[<BASE_LIST><BASE_DATA><C_PLY_NO><xsl:value-of select="./POLICYNO" /></C_PLY_NO><C_PASSWORD><xsl:value-of select="./C_PASSWORD" /></C_PASSWORD>                                   </BASE_DATA></BASE_LIST>                       ]]></resource><param name="is-xslt-templatelet">true</param></resource-config>
</smooks-resource-list>说明此配置文件的作用是通过内置xsl的配置将input-message.xml中的一些标签名替换掉，例如：
将<TRANSTYPE>替换成</SVCTYPE>，新增加一些丢失的标签例如<SVCDETAIL>QueryPolicyByProposalNoService</SVCDETAIL>，并且将<BODY>  标签下的内容改为一个list类型的标签。结果请对照下面out.xml。
③．通过如下程序可读取输入报文input-message.xml和配置文件smooks-config.xml，并产生输出文件out.xml.
package example;import org.milyn.Smooks;
import org.milyn.SmooksException;
import org.milyn.io.StreamUtils;
import org.xml.sax.SAXException;import javax.xml.transform.stream.StreamSource;
import javax.xml.transform.stream.StreamResult;
import java.io.*;public class Main {//读入输入报文private static byte[] messageIn = readInputMessage();/*** 主方法*/public static void main(String[] args) throws IOException, SAXException, SmooksException {String messageOut = Main.runSmooksTransform();StreamUtils.writeFile(new File("out.xml"),messageOut.getBytes()); //将输出报文写出到文件out.xml
    }/*** 根据配置文件输入报文的byte[]转化为输出报文的String* 利用smooks进行转化*/protected static String runSmooksTransform() throws IOException, SAXException, SmooksException {// 读取配置文件smooks-config.xmlSmooks smooks = new Smooks("smooks-config.xml");try {CharArrayWriter outputWriter = new CharArrayWriter();  //存入smooks的转化结果存入CharArrayWriter的对象，该类继承java.io.writer//调用smooks.filterSource方法，进行smooks转化。smooks.filterSource(new StreamSource(new ByteArrayInputStream(messageIn)), new StreamResult(outputWriter));return outputWriter.toString();  //将转化结果转化为字符串} finally {smooks.close();}}/*** 读入输入报文* @return 输入报文的byte[]*/private static byte[] readInputMessage() {try {return StreamUtils.readStream(new FileInputStream("input-message.xml"));} catch (IOException e) {e.printStackTrace();return "<no-message/>".getBytes();}}
}④．输出的报文out.xml:<PACKET type="REQUEST" version="1.0">    <HEAD><SVCTYPE>SYN</SVCTYPE><SVCCODE>100006</SVCCODE><SVCNAME>eies</SVCNAME><SVCSEQNO>eies</SVCSEQNO><SVCSTATUS>000000</SVCSTATUS><SVCMESSAGE></SVCMESSAGE><SVCDETAIL>QueryPolicyByProposalNoService</SVCDETAIL></HEAD>      <THIRD><EXTENTERPCODE>19002020102</EXTENTERPCODE><EXTPROVCODE>24</EXTPROVCODE><EXTAREACODE>0187</EXTAREACODE><EXTSITECODE>0187</EXTSITECODE><EXTSEQUENCENO>200804060001</EXTSEQUENCENO><TRANSDATE>2009-08-06</TRANSDATE><TRANSTIME>12:30:30</TRANSTIME><EXTOPERATORCODE>2020</EXTOPERATORCODE></THIRD>     <BASE_LIST><BASE_DATA><C_PLY_NO>110880829200904000016</C_PLY_NO><C_PASSWORD></C_PASSWORD></BASE_DATA></BASE_LIST>
</PACKET>
1.2 use freemaker Templating
工程名为：MyXmlToXmlWithFreemaker①.需要转换的报文：文件名在程序中定为input-message.xml
<order id='332'>   <header>        <customer number="123">Joe</customer>    </header>    <order-items>        <order-item id='1'>           <product>1</product>            <quantity>2</quantity>            <price>8.80</price>        </order-item>         <order-item id='2'>           <product>2</product>            <quantity>3</quantity>            <price>10.90</price>        </order-item><!--可能还有  -->     </order-items>
</order>②.配置转化的配置文件，在程序中名为smooks-config.xml：
<?xml version="1.0"?><smooks-resource-list xmlns="http://www.milyn.org/xsd/smooks-1.1.xsd"                     xmlns:ftl="http://www.milyn.org/xsd/smooks/freemarker-1.1.xsd">  <!-- Filter the message using the SAX Filter (i.e. not DOM, so no    intermediate DOM for the "complete" message - there are "mini" DOMs    for the NodeModels below)....    -->    <params>       <param name="stream.filter.type">SAX</param>       <param name="default.serialization.on">false</param>    </params>     <!-- Create 2 NodeModels.  One high level model for the "order"    (header etc) and then one per "order-item".     These models are used in the FreeMarker templating resources   defined below.  You need to make sure you set the selector such    that the total memory footprint is as low as possible.  In this example, the "order" model will contain everything accept the    <order-item> data (the main bulk of data in the message).  The  "order-item" model only contains the current <order-item> data   (i.e. there's max 1 order-item in memory at any one time).    -->    <resource-config selector="order,order-item">        <resource>org.milyn.delivery.DomModelCreator</resource>    </resource-config><!-- Apply the first part of the template when we reach the startof the <order-items> element.  Apply the second part when we    reach the end.     Note the <?TEMPLATE-SPLIT-PI?> Processing Instruction in the    template.  This tells Smooks where to split the template,    resulting in the order-items being inserted at this point.    -->   <ftl:freemarker applyOnElement="order-items">        <ftl:template><!--<?xml version="1.0" encoding="GBK"?>
<salesorder type="REQUEST" version="1.0">    <details>        <orderid>${order.@id}</orderid>       <customer>            <id>${order.header.customer.@number}</id>            <name>${order.header.customer}</name>        </customer>    </details>    <itemList>        <?TEMPLATE-SPLIT-PI?>    </itemList>
</salesorder>--></ftl:template>    </ftl:freemarker>     <!--    Output the <order-items> elements.  This will appear in the    output message where the <?TEMPLATE-SPLIT-PI?> token appears in the    order-items template.   -->    <ftl:freemarker applyOnElement="order-item">        <ftl:template><!--        <item>            <id>${.vars["order-item"].@id}</id>            <productId>${.vars["order-item"].product}</productId>            <quantity>${.vars["order-item"].quantity}</quantity>            <price>${.vars["order-item"].price}</price>        </item>--></ftl:template>    </ftl:freemarker>
</smooks-resource-list>说明此配置文件的作用是通过内置freemaker模板将input-message.xml中的格式进行转换。结果请对照下面out.xml。
③．通过如下程序可读取输入报文input-message.xml和配置文件smooks-config.xml，并产生输出文件out.xml.
package example;import org.milyn.Smooks;
import org.milyn.SmooksException;
import org.milyn.io.StreamUtils;
import org.xml.sax.SAXException;import javax.xml.transform.stream.StreamResult;
import javax.xml.transform.stream.StreamSource;
import java.io.*;/*** smooks转换类* @author zhangzheng*/
public class Main {//读入输入报文private static byte[] messageIn = readInputMessage();/*** 主方法*/public static void main(String[] args) throws IOException, SAXException, SmooksException {String messageOut=Main.runSmooks();  //调用smooks转换方法System.out.println(messageOut);     //打印输出结果StreamUtils.writeFile(new File("out.xml"), messageOut.getBytes());  //将输出报文写出到文件out.xml
    }/*** 根据配置文件输入报文的byte[]转化为输出报文的String* 利用smooks进行转化*/protected static String runSmooks() throws IOException, SAXException, SmooksException {// 读取配置文件smooks-config.xmlSmooks smooks = new Smooks("smooks-config.xml");CharArrayWriter outputWriter = new CharArrayWriter(); //存入smooks的转化结果存入CharArrayWriter的对象，该类继承java.io.writertry {//调用smooks.filterSource方法，进行smooks转化。smooks.filterSource(new StreamSource(new ByteArrayInputStream(messageIn)), new StreamResult(outputWriter));return outputWriter.toString();} finally {smooks.close();}}private static byte[] readInputMessage() {try {return StreamUtils.readStream(new FileInputStream("input-message.xml"));} catch (IOException e) {e.printStackTrace();return "<no-message/>".getBytes();}}
}④．输出的报文out.xml:<?xml version="1.0" encoding="GBK"?>
<salesorder type="REQUEST" version="1.0">    <details>        <orderid>332</orderid>       <customer>            <id>123</id>            <name>Joe</name>        </customer>    </details>    <itemList>        <item>            <id>1</id>            <productId>1</productId>            <quantity>2</quantity>            <price>8.80</price>        </item><item>            <id>2</id>            <productId>2</productId>            <quantity>3</quantity>            <price>10.90</price>        </item></itemList>
</salesorder>2. Csv To Xml
Csv转化成xml的配置也有两种（xsl和freemaker），由于freemaker模板易于控制，下面介绍freemaker方法。
工程名：MyCsvToXml
①.需要转换的报文：文件名在程序中定为input-message.csv
说明cvs文件一般是用","分隔，如果分隔符为"|"符号，需要在配置文件smooks-config.xml <csv:reader> 中增加一个属性separator="|"，对于其他分隔符号同样适用。
SYN,100006,eies,eies,19002020102,24,0187,0187,200804060001,2009-08-06,12:30:30,2020,110880829200904000016,②.配置转化的配置文件，在程序中名为smooks-config.xml：
<?xml version="1.0"?>
<smooks-resource-list xmlns="http://www.milyn.org/xsd/smooks-1.1.xsd"xmlns:csv="http://www.milyn.org/xsd/smooks/csv-1.2.xsd"xmlns:core="http://www.milyn.org/xsd/smooks/smooks-core-1.3.xsd"xmlns:ftl="http://www.milyn.org/xsd/smooks/freemarker-1.1.xsd"><csv:reader fields="SVCTYPE,SVCCODE,SVCNAME,SVCSEQNO,
                        EXTENTERPCODE,EXTPROVCODE,EXTAREACODE,EXTSITECODE,EXTSEQUENCENO,TRANSDATE,TRANSTIME,EXTOPERATORCODE,C_PLY_NO,C_PASSWORD" rootElementName="PACKET" recordElementName="PACKET"><csv:singleBinding beanId="PACKET" class="java.util.HashMap"/></csv:reader><!-- Use the SAX filter - more memory efficient and handle huge streams. --><core:filterSettings type="SAX" /><!-- Apply a FreeMarker template to each CSV record, generating a different XML structure based on the gender value... --><ftl:freemarker applyOnElement="PACKET"><ftl:template><!--<PACKET type="REQUEST" version="1.0">    <HEAD><SVCTYPE>${PACKET.SVCTYPE}</SVCTYPE><SVCCODE>${PACKET.SVCCODE}</SVCCODE><SVCNAME>${PACKET.SVCNAME}</SVCNAME><SVCSEQNO>${PACKET.SVCSEQNO}</SVCSEQNO><SVCSTATUS>000000</SVCSTATUS><SVCMESSAGE></SVCMESSAGE><SVCDETAIL>QueryPolicyByProposalNoService</SVCDETAIL></HEAD><THIRD><EXTENTERPCODE>${PACKET.EXTENTERPCODE}</EXTENTERPCODE><EXTPROVCODE>${PACKET.EXTPROVCODE}</EXTPROVCODE><EXTAREACODE>${PACKET.EXTAREACODE}</EXTAREACODE><EXTSITECODE>${PACKET.EXTSITECODE}</EXTSITECODE><EXTSEQUENCENO>${PACKET.EXTSEQUENCENO}</EXTSEQUENCENO><TRANSDATE>${PACKET.TRANSDATE}</TRANSDATE><TRANSTIME>${PACKET.TRANSTIME}</TRANSTIME><EXTOPERATORCODE>${PACKET.EXTOPERATORCODE}</EXTOPERATORCODE></THIRD>     <BASE_LIST><BASE_DATA><C_PLY_NO>${PACKET.C_PLY_NO}</C_PLY_NO><C_PASSWORD>${PACKET.C_PASSWORD}</C_PASSWORD></BASE_DATA></BASE_LIST>
</PACKET>--></ftl:template><ftl:use><ftl:inline directive="replace"/></ftl:use></ftl:freemarker></smooks-resource-list>说明此配置文件的总用是将input-message.csv中的信息加上相应的标签头，转换成xml，并在生成的xml 中加入csv中缺失的标签。结果请对照下面out.xml。
③．通过如下程序可读取输入报文input-message.csv和配置文件smooks-config.xml，运行程序，产生输出文件out.xml.
package example;import org.milyn.Smooks;
import org.milyn.SmooksException;
import org.milyn.io.StreamUtils;
import org.xml.sax.SAXException;import javax.xml.transform.stream.StreamSource;
import javax.xml.transform.stream.StreamResult;
import java.io.*;/*** csvToXMl* @author zhangzheng*/
public class Main {//读入输入报文private static byte[] messageIn = readInputMessage();/*** 主方法*/public static void main(String[] args) throws IOException, SAXException, SmooksException {String messageOut = Main.runSmooksTransform();StreamUtils.writeFile(new File("out.xml"), messageOut.getBytes());}/*** 根据配置文件输入报文的byte[]转化为输出报文的String* 利用smooks进行转化*/protected static String runSmooksTransform() throws IOException, SAXException, SmooksException {Smooks smooks = new Smooks("smooks-config.xml");try {StringWriter writer = new StringWriter();smooks.filterSource(new StreamSource(new InputStreamReader(new ByteArrayInputStream(messageIn), "UTF-8")), new StreamResult(writer));return writer.toString();} finally {smooks.close();}}/*** 读入输入报文* @return 输入报文的byte[]*/private static byte[] readInputMessage() {try {return StreamUtils.readStream(new FileInputStream("input-message.csv"));} catch (IOException e) {e.printStackTrace();return "<no-message/>".getBytes();}}
}④．输出的报文out.xml:<PACKET type="REQUEST" version="1.0">    <HEAD><SVCTYPE>SYN</SVCTYPE><SVCCODE>100006</SVCCODE><SVCNAME>eies</SVCNAME><SVCSEQNO>eies</SVCSEQNO><SVCSTATUS>000000</SVCSTATUS><SVCMESSAGE></SVCMESSAGE><SVCDETAIL>QueryPolicyByProposalNoService</SVCDETAIL></HEAD>      <THIRD><EXTENTERPCODE>19002020102</EXTENTERPCODE><EXTPROVCODE>24</EXTPROVCODE><EXTAREACODE>0187</EXTAREACODE><EXTSITECODE>0187</EXTSITECODE><EXTSEQUENCENO>200804060001</EXTSEQUENCENO><TRANSDATE>2009-08-06</TRANSDATE><TRANSTIME>12:30:30</TRANSTIME><EXTOPERATORCODE>2020</EXTOPERATORCODE></THIRD>     <BASE_LIST><BASE_DATA><C_PLY_NO>110880829200904000016</C_PLY_NO><C_PASSWORD></C_PASSWORD></BASE_DATA></BASE_LIST>
</PACKET>3. 拓展
Smooks 还可以进行Json, EDI 等常用数据格式的文件转化。具体方法请参加从smooks官网下载下来的smooks-1.4文件夹中/docs/SmooksUserGuide_v1.4.html的说明。具体的程序可以参加\examples下的例子。

转载于:https://www.cnblogs.com/svennee/p/4078883.html

Smooks转换设计相关推荐

  1. ad如何选中当前层上的器件_82条AD转换设计经验总结！

    看到一片关于AD转换设计中的基本问题整理博文,特地转载过来和大家共分享. 了解数据转换器错误及参数 1.如何选择高速模数转换之前的信号调理器件;如何解决多路模数转换的同步问题? ADC之前的信号调理, ...

  2. 关于AD转换设计经验总结82条

    看到一片关于AD转换设计中的基本问题整理博文,特地转载过来和大家共分享. 了解数据转换器错误及参数 1如何选择高速模数转换之前的信号调理器件;如何解决多路模数转换的同步问题? ADC之前的信号调理,最 ...

  3. 转一篇很好的AD转换设计中的基本问题整理

    弟看到一片关于AD转换设计中的基本问题整理博文,特地转载过来和大家共分享. 原文地址 http://blog.eccn.com/space.php?uid=170730&do=blog& ...

  4. 关于AD转换设计的一些经验总结(转载)

    关于AD转换设计的一些经验总结 2017-04-01 12:51 看到一片关于AD转换设计中的基本问题整理博文,特地转载过来和大家共分享. 了解数据转换器错误及参数 1.如何选择高速模数转换之前的信号 ...

  5. 替代LT6711A功能方案| 完全替代LT6711A芯片|高性价比HDMI转EDP转换设计

    替代LT6711A功能方案| 完全替代LT6711A芯片|高性价比HDMI转EDP转换设计 LT6711A是一款HDMI2.0转eDP / DP1.2支持4K 60Hz音视频转换芯片.LT6711A芯 ...

  6. 电压越低采集的ad值反而变大_80多条关于AD转换设计的经验总结

    1.如何选择高速模数转换之前的信号调理器件;如何解决多路模数转换的同步问题? ADC之前的信号调理,最根本的原则就是信号调理引起的噪声和误差要在ADC的1个LSB之内.根据这个目的,可以需要选择指标合 ...

  7. 基于51单片机的AD转换设计

    一.设计目的 掌握AD转换芯片的基本工作原理: 掌握一个完整的C语言程序结构: 熟悉AD转换与单片机的使用的编程. 二.设计环境 Keil开发环境 Proteus软件. 三.设计及调试 (1) 设计内 ...

  8. Verilog学习之数据大小端转换设计

    文章目录 前言 一.题目描述 二.实现思路 1.函数的概念 2.具体思路 三.代码展示 总结 前言 今天我们做的是第十道题--使用函数实现数据大小端转换,这道题其实也比较简单,就是逆向输出一个数据,但 ...

  9. 关于ADC转换设计中的基本问题（82问）

    1.如何选择高速模数转换之前的信号调理器件;如何解决多路模数转换的同步问题? ADC之前的信号调理,最根本的原则就是信号调理引起的噪声和误差要在ADC的1个LSB之内.根据这个原则,可以选择指标合适的 ...

最新文章

  1. Sql存储过程加密和解密
  2. HDU1392（凸包求周长模版）
  3. 记一次Redis和NetMQ的测试
  4. Android Studio --- [学习笔记]Button、TextView、EditText
  5. 使用 nuget server 的 API 来实现搜索安装 nuget 包
  6. c语言幼儿园积木游戏,幼儿园《积木游戏》课件【三篇】
  7. Python | 程序以字符串长度打印单词
  8. extern、static
  9. php控制器教程,laravel基础教程 -- 控制器
  10. 【elasticsearch】elasticsearch 升级
  11. 【Hadoop】HDFS笔记（三）：HDFS的Shell操作
  12. python制作查询工具发给别人使用_利用Python制作简单的小程序：IP查
  13. 将Go的main包拆分为多个文件
  14. 搜狗输入法纯净_最新PC端搜狗输入法，无广告弹窗纯净版
  15. 项目进度管理-活动历时估算工具技术：三点估算
  16. 201671030113 词频统计软件项目报告
  17. VSCode 代码换行快捷键设置为Shift + Enter
  18. C#WinForm判断界面上多个TextBox控件的值是否为空
  19. 面试过程中如何回答面试官的问题，才能让你顺利拿到Offer？冰河想以经典的事务问题对你说这些！！（建议收藏）
  20. L3-020 至多删三个字符 (30 分)

热门文章

  1. [react] React为什么要搞一个Hooks？
  2. react学习(15)-getTime selectedRowKeys是this.props取值的
  3. [html] 请使用一个div写出有三条横线的小图标
  4. 工作294:for[item.key]使用
  5. 前端学习（2685）：重读vue电商网站6之如何重置表单
  6. 前端学习（2505）：小游戏设计
  7. 前端学习（2243）硅谷外卖项目展示
  8. 前端学习（1840）：前端面试题之mpvue和小程序
  9. 前端学习（1107）:函数进阶
  10. 前端学习（517）：两列布局的第三种解决方案的优缺点