Smooks转换设计.doc

Smooks转换设计背景不同的合作银行对应的外部接口是不一样的,我们需要把外部这些变化不定的接口格式,转换为我们银保通系统可以识别的内部接口.Smooks可以很好的解决这一问题.并且,当合作银行的接口随着业务的变化而发生变化时,smooks只需要通过变更转换模板,就可以实现对变化后接口的支持。Smooks框架可以在smooks的官网 (需要翻墙软)下载。本文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 SYN 100006 eies eies 19002020102 24 0187 0187 200804060001 2009-08-06 12:30:30 2020 110880829200904000016 .配置转化的配置文件，在程序中名为smooks-config.xml： !CDATA 000000 QueryPolicyByProposalNoService true !CDATA true !CDATA true说明此配置文件的作用是通过内置xsl的配置将input-message.xml中的一些标签名替换掉，例如：将替换成，新增加一些丢失的标签例如QueryPolicyByProposalNoService，并且将 标签下的内容改为一个list类型的标签。结果请对照下面out.xml。通过如下程序可读取输入报文input-message.xml和配置文件smooks-config.xml，并产生输出文件out.xml.package example;import yn.Smooks;import yn.SmooksException;import yn.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.xml Smooks 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 .getBytes(); 输出的报文out.xml: SYN 100006 eies eies 000000 QueryPolicyByProposalNoService 19002020102 24 0187 0187 200804060001 2009-08-06 12:30:30 2020 110880829200904000016 1.2 use freemaker Templating 工程名为：MyXmlToXmlWithFreemaker.需要转换的报文：文件名在程序中定为input-message.xml Joe 1 2 8.80 2 3 10.90 .配置转化的配置文件，在程序中名为smooks-config.xml： SAX false !- 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 data (the main bulk of data in the message). The order-item model only contains the current data (i.e. theres max 1 order-item in memory at any one time). - yn.delivery.DomModelCreator !- Apply the first part of the template when we reach the startof the element. Apply the second part when we reach the end. Note the Processing Instruction in the template. This tells Smooks where to split the template, resulting in the order-items being inserted at this point. - !- $order.id $order.header.customer.number $order.header.customer - !- Output the elements. This will appear in the output message where the token appears in the order-items template. - !- $.varsorder-item.id $.duct $.varsorder-item.quantity $.varsorder-item.price - 说明此配置文件的作用是通过内置freemaker模板将input-message.xml中的格式进行转换。结果请对照下面out.xml。通过如下程序可读取输入报文input-message.xml和配置文件smooks-config.xml，并产生输出文件out.xml.package example;import yn.Smooks;import yn.SmooksException;import yn.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.xml Smooks smooks = new Smooks(smooks-config.xml); CharArrayWriter outputWriter = new CharArrayWriter(); /存入smooks的转化结果存入CharArrayWriter的对象，该类继承java.io.writer try /调用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 .getBytes(); 输出的报文out.xml: 332 123 Joe 1 1 2 8.80 2 2 3 10.90 2. Csv To XmlCsv转化成xml的配置也有两种（xsl和freemaker），由于freemaker模板易于控制，下面介绍freemaker方法。工程名：MyCsvToXml.需要转换的报文：文件名在程序中定为input-message.csv说明cvs文件一般是用,分隔，如果分隔符为|符号，需要在配置文件smooks-config.xml 中增加一个属性separator=|，对于其他分隔符号同样适用。SYN,100006,eies,eies,19002020102,24,0187,0187,200804060001,2009-08-06,12:30:30,2020,110880829200904000016, .配置转化的配置文件，在程序中名为smooks-config.xml： !- $PACKET.SVCTYPE $PACKET.SVCCODE $PACKET.SVCNAME $PACKET.SVCSEQNO 000000 QueryPolicyByProposalNoService $PACKET.EXTENTERPCODE $PACKET.EXTPROVCODE $PACKET.EXTAREACODE $PACKET.EXTSITECODE $PACKET.EXTSEQUENCENO $PACKET.TRANSDATE $PACKET.TRANSTIME $PACKET.EXTOPERATORCODE $PACKET.C_PLY_NO$PACKET.C_PASSWORD - 说明此配置文件的总用是将input-message.csv中的信息加上相应的标签头，转换成xml，并在生成的xml 中加入csv中缺失的标签。结果请对照下面out.xml。通过如下程序可读取输入报文input-message.csv和配置文件smooks-config.xml，运行程序，产生输出文件out.xml.package example;import yn.Smooks;import yn.SmooksException;import yn.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(s