Copy Page

You are not logged in. Any changes you make will be marked as anonymous. You may want to Log In if you already have an account. You can also Sign Up for a new account.

<p>This tutorial is an extension of the <a class="confluence-link" href="/display/MILYN/Smooks+Example+-+edi-to-xml" data-linked-resource-id="24248659" data-linked-resource-type="page" data-linked-resource-default-alias="Smooks Example - edi-to-xml" data-base-url="http://docs.codehaus.org">edi-to-xml</a> and <a class="confluence-link" href="/display/MILYN/Smooks+Example+-+xml-to-java" data-linked-resource-id="78868" data-linked-resource-type="page" data-linked-resource-default-alias="Smooks Example - xml-to-java" data-base-url="http://docs.codehaus.org">javabean-populator</a> tutorials.  It illustrates how to go from (transform) an EDI message to a populated Java Object Model.</p>
<img class="editor-inline-macro" src="/plugins/servlet/confluence/placeholder/macro?definition=e3RvYzppbmRlbnQ9MjBweHxzdHlsZT1kaXNjfQ&amp;locale=en_GB&amp;version=2" data-macro-name="toc" data-macro-parameters="indent=20px|style=disc">
<p> <br />
<strong><a href="http://svn.codehaus.org/milyn/trunk/smooks-examples/edi-to-java"><strong>SVN</strong></a></strong> - <strong><a class="confluence-link unresolved" data-content-title="downloads" data-linked-resource-default-alias="downloads" href="#"><strong>Download</strong></a></strong> - <strong><a class="confluence-link" href="/display/MILYN/Tutorials" data-linked-resource-id="49525" data-linked-resource-type="page" data-linked-resource-default-alias="Tutorials" data-base-url="http://docs.codehaus.org"><strong>Other Tutorials</strong></a></strong></p>

<p>Other Relevant Info:</p>
<ul>
	<li><a class="confluence-link" href="/display/MILYN/Smooks+Example+-+edi-to-xml" data-linked-resource-id="24248659" data-linked-resource-type="page" data-linked-resource-default-alias="Smooks Example - edi-to-xml" data-base-url="http://docs.codehaus.org">edi-to-xml</a> tutorial.</li>
	<li><a class="confluence-link" href="/display/MILYN/Smooks+Example+-+xml-to-java" data-linked-resource-id="78868" data-linked-resource-type="page" data-linked-resource-default-alias="Smooks Example - xml-to-java" data-base-url="http://docs.codehaus.org">javabean-populator</a> tutorial.</li>
</ul>

<p> <br />
<span style="text-decoration: underline;">To Build</span>: &quot;mvn clean install&quot;<br />
<span style="text-decoration: underline;">To Run</span>: &quot;mvn exec:java&quot;</p>

<h1>Transforming from an EDI to Javabean Object Graph</h1>

<p>Something to note when looking at this example is that Smooks doesn't perform this EDI-to-Java transform in a 2 step &quot;pipeline&quot; like process.  It doesn't generate and intermediate XML, which it then has to parse and process etc. Smooks takes the EDI message and, using the EdiSax parser, goes straight to a DOM representation of the EDI message.  This is then used by Smooks, through the Javabean Cartridge, to populate the Java Object Graph.</p>

<p>If you haven't already looked at the <a class="confluence-link" href="/display/MILYN/Smooks+Example+-+xml-to-java" data-linked-resource-id="78868" data-linked-resource-type="page" data-linked-resource-default-alias="Smooks Example - xml-to-java" data-base-url="http://docs.codehaus.org">javabean-populator</a> tutorial, you may be interested in looking at that before looking at this example.</p>

<p>So here's the source edi file that is to be transformed:</p>
<table class="wysiwyg-macro" data-macro-name="noformat" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e25vZm9ybWF0fQ&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>
HDR*1*0*59.97*64.92*4.95*Wed Nov 15 13:45:28 EST 2006
CUS*user1*Harry^Fletcher*SD
ORD*1*1*364*The 40-Year-Old Virgin*29.98
ORD*2*1*299*Pulp Fiction*29.99

</pre></td></tr></table>
<p>And this is the expected result of our transformation (i.e. a simple System.out of the populated <a href="http://svn.codehaus.org/milyn/trunk/smooks-examples/edi-to-java/src/main/java/example/model/">Object Model</a> - see the <a href="http://svn.codehaus.org/milyn/trunk/smooks-examples/edi-to-java/src/main/java/example/model/Order.java">toString method in the Order class</a>):</p>
<table class="wysiwyg-macro" data-macro-name="noformat" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e25vZm9ybWF0fQ&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>
==============EDI as Java Object Graph=============
Order Header:
        Customer: Fletcher, Harry
        Date: Wed Nov 15 19:45:28 CET 2006
        Details: ID=1, Status=0, Total=64.92
Order Items:
        (0): ProductID=364, Quantity=1, Title='The 40-Year-Old Virgin', Price=29.98
        (1): ProductID=299, Quantity=1, Title='Pulp Fiction', Price=29.99

======================================
</pre></td></tr></table>
<p>This transformation could be taken a step further, whereby the EDI populated Object Model is used as part of a Model Driven Transformation.  See the <a class="confluence-link" href="/display/MILYN/Smooks+Example+-+model-driven-basic" data-linked-resource-id="9240869" data-linked-resource-type="page" data-linked-resource-default-alias="Smooks Example - model-driven-basic" data-base-url="http://docs.codehaus.org">model-driven-basic</a> tutorial.</p>

<h1>The Smooks Configuration</h1>

<p>The Smooks configuration for this transformation contains:</p>
<ol>
	<li>A configuration for generating an XML model (SAX event stream) from the input EDI, as with the <a class="confluence-link" href="/display/MILYN/Smooks+Example+-+edi-to-xml" data-linked-resource-id="24248659" data-linked-resource-type="page" data-linked-resource-default-alias="Smooks Example - edi-to-xml" data-base-url="http://docs.codehaus.org">edi-to-xml</a> tutorial.</li>
	<li>A set of Javabean population configuration for populating the <a href="http://svn.codehaus.org/milyn/trunk/smooks-examples/edi-to-java/src/main/java/example/model/">Object Model</a>, as with the <a class="confluence-link" href="/display/MILYN/Smooks+Example+-+xml-to-java" data-linked-resource-id="78868" data-linked-resource-type="page" data-linked-resource-default-alias="Smooks Example - xml-to-java" data-base-url="http://docs.codehaus.org">javabean-populator</a> tutorial.</li>
</ol>

<p><br class="atl-forced-newline" />
Here's the configuration (&quot;smooks-config.xml&quot;):</p>
<table class="wysiwyg-macro" data-macro-name="noformat" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e25vZm9ybWF0fQ&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>
&lt;?xml version="1.0"?>
&lt;smooks-resource-list xmlns="http://www.milyn.org/xsd/smooks-1.1.xsd" xmlns:jb="http://www.milyn.org/xsd/smooks/javabean-1.1.xsd">

&lt;!--
    Configure the EDI Reader to parse the message stream into a stream of SAX events.
    -->
    &lt;reader class="org.milyn.smooks.edi.SmooksEDIReader">
        &lt;params>
            &lt;!-- Generate the event stream based on this "mapping model". -->
            &lt;param name="mapping-model">/example/edi-to-xml-order-mapping.xml&lt;/param>
        &lt;/params>
    &lt;/reader>

&lt;!--
    Create an "example.beans.Order" bean instance when we visit the start of the &lt;order> element.
    Assign the new bean instance to the beanId of "order".
    The "header" and "orderItemList" beans are wired in.
    -->
    &lt;jb:bindings beanId="order" class="example.model.Order" createOnElement="order">
        &lt;jb:wiring property="header" beanIdRef="header" />
        &lt;jb:wiring property="orderItems" beanIdRef="orderItemList" />
    &lt;/jb:bindings>

&lt;!--
    Create an "example.beans.Header" bean instance when we visit the start of the &lt;order> element.
    Note, we're creating this bean instance before we encounter the actual &lt;header> element.
    This bean is wired into the "order" bean.
    -->
    &lt;jb:bindings beanId="header" class="example.model.Header" createOnElement="order">
        &lt;jb:wiring property="customer" beanIdRef="customer" />
        &lt;jb:value property="orderId" data="header/order-id" />
        &lt;jb:value property="orderStatus" decoder="Long" data="header/status-code" />
        &lt;jb:value property="netAmount" decoder="BigDecimal" data="header/net-amount" />
        &lt;jb:value property="totalAmount" decoder="BigDecimal" data="header/total-amount" />
        &lt;jb:value property="tax" decoder="BigDecimal" data="header/tax" />
        &lt;jb:value property="date" decoder="Date" data="header/date">
            &lt;jb:decodeParam name="format">EEE MMM dd HH:mm:ss z yyyy&lt;/jb:decodeParam>
        &lt;/jb:value>
    &lt;/jb:bindings>

&lt;!--
    Create an "example.beans.Customer" bean instance when we visit the start of the
    &lt;customer-details> element. 
	This bean is wired into the "header" bean.
    -->
    &lt;jb:bindings beanId="customer" class="example.model.Customer" createOnElement="customer-details">
        &lt;!-- Customer bindings... -->
        &lt;jb:value property="userName" data="customer-details/username" />
        &lt;jb:value property="firstName" data="customer-details/name/firstname" />
        &lt;jb:value property="lastName" data="customer-details/name/lastname" />
        &lt;jb:value property="state" data="customer-details/state" />
    &lt;/jb:bindings>
	
	&lt;!-- 
	Create an ArrayList when we visit the start of the &lt;order> element.
	The "orderItem" beans are wired into this list and this list is wired into the "order" bean.
	 -->
    &lt;jb:bindings beanId="orderItemList" class="java.util.ArrayList" createOnElement="order">
        &lt;jb:wiring beanIdRef="orderItem" />
    &lt;/jb:bindings>

&lt;!--
    Create an "example.beans.OrderItem" bean instance when we visit the start of the &lt;order-item> element.
    This bean is wired into the "orderItemList" ArrayList.
    -->
    &lt;jb:bindings beanId="orderItem" class="example.model.OrderItem" createOnElement="order-item">
        &lt;!-- OrderItem bindings... -->
        &lt;jb:value property="quantity" decoder="Integer" data="order-item/quantity" />
        &lt;jb:value property="productId" decoder="String" data="order-item/product-id" />
        &lt;jb:value property="price" decoder="BigDecimal" data="order-item/price" />
        &lt;jb:value property="title" data="order-item/title" />
    &lt;/jb:bindings>

&lt;/smooks-resource-list>
</pre></td></tr></table>
<p>Here's the edi mapping (&quot;/src/main/java/example/edi-to-xml-order-mapping.xml&quot;).  See the <a class="confluence-link" href="/display/MILYN/Smooks+Example+-+edi-to-xml" data-linked-resource-id="24248659" data-linked-resource-type="page" data-linked-resource-default-alias="Smooks Example - edi-to-xml" data-base-url="http://docs.codehaus.org">edi-to-xml</a> tutorial for more details on this mapping:
<br class="atl-forced-newline" /></p>
<table class="wysiwyg-macro" data-macro-name="noformat" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e25vZm9ybWF0fQ&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>
&lt;?xml version="1.0" encoding="UTF-8"?>
&lt;medi:edimap xmlns:medi="http://www.milyn.org/schema/edi-message-mapping-1.0.xsd">

&lt;medi:description name="DVD Order" version="1.0" />

&lt;medi:delimiters segment="&amp;#10;" field="*" component="^" sub-component="~" />

&lt;medi:segments xmltag="Order">

&lt;medi:segment segcode="HDR" xmltag="header">
			&lt;medi:field xmltag="order-id" />
			&lt;medi:field xmltag="status-code" />
			&lt;medi:field xmltag="net-amount" />
			&lt;medi:field xmltag="total-amount" />
			&lt;medi:field xmltag="tax" />
			&lt;medi:field xmltag="date" />
		&lt;/medi:segment>

&lt;medi:segment segcode="CUS" xmltag="customer-details">
			&lt;medi:field xmltag="username" />
			&lt;medi:field xmltag="name">
				&lt;medi:component xmltag="firstname" />
				&lt;medi:component xmltag="lastname" />
			&lt;/medi:field>
			&lt;medi:field xmltag="state" />
		&lt;/medi:segment>

&lt;medi:segment segcode="ORD" xmltag="order-item" maxOccurs="-1">
			&lt;medi:field xmltag="position" />
			&lt;medi:field xmltag="quantity" />
			&lt;medi:field xmltag="product-id" />
			&lt;medi:field xmltag="title" />
			&lt;medi:field xmltag="price" />
		&lt;/medi:segment>

&lt;/medi:segments>

&lt;/medi:edimap>
</pre></td></tr></table>
<p><img class="editor-inline-macro" src="/plugins/servlet/confluence/placeholder/macro?definition=e2FuY2hvcjpleGVjdXRpb259&amp;locale=en_GB&amp;version=2" data-macro-name="anchor" data-macro-default-parameter="execution"></p>

<h1>Executing The Transformation</h1>

<p>Again, it's exactly the same as with the <a class="confluence-link" href="/display/MILYN/Smooks+Example+-+java-basic" data-linked-resource-id="78566" data-linked-resource-type="page" data-linked-resource-default-alias="Smooks Example - java-basic" data-base-url="http://docs.codehaus.org">java-basic</a> tutorial:</p>
<table class="wysiwyg-macro" data-macro-name="noformat" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e25vZm9ybWF0fQ&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>
// Instantiate Smooks with the config...
Smooks smooks = new Smooks("smooks-config.xml");
JavaResult result = new JavaResult();

// Filter the input message to the JavaResult...
smooks.filter(new StreamSource(messageIn), result);

return (Order) result.getBean("order");
</pre></td></tr></table>
<p>Of course, you'd typically cache the <a class="confluence-link" href="http://milyn.codehaus.org/javadoc/smooks/org/milyn/Smooks.html" shortcut-key="milyn_public_html" shortcut-parameter="javadoc/smooks/org/milyn/Smooks.html" data-linked-resource-default-alias="unnamed link" data-base-url="http://docs.codehaus.org">Smooks</a> instance.</p>

<p>See the <a href="http://svn.codehaus.org/milyn/trunk/smooks-examples/edi-to-java/src/main/java/example/Main.java">example/Main.java</a> in the example source.</p>