Smooks ユーザーガイド

手順3.1 タスク

1. 新しい Smooks 設定を作成します。これは、<xxx> 要素の visitBefore および visitAfter イベントでビジターロジックを適用するために使用されます。
2. visitBefore および visitAfter イベントのロジックをイベントストリーム全体の特定の要素に適用します。ビジターロジックは、<xxx> 要素のイベントに適用されます。
3. FreeMarker で Smooks を使用して、巨大なメッセージに XML から XML への変換を実行します。
4. 次のソース形式を挿入します。

   <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>
   Â 
           <!-- etc etc -->
   Â 
       </order-items>
   </order>
   

   Copy to Clipboard Toggle word wrap
5. このターゲット形式を挿入します。

   <salesorder>
       <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>        
    
           <!-- etc etc -->
    
       </itemList>
   </salesorder>
   

   Copy to Clipboard Toggle word wrap
6. 次の Smooks 設定を使用します。

   <?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 start
       of 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><!--<salesorder>
       <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>
   

   Copy to Clipboard Toggle word wrap
7. このコードを使用して、実行します。

   Smooks smooks = new Smooks("smooks-config.xml");
   try {
       smooks.filterSource(new StreamSource(new FileInputStream("input-message.xml")), new StreamResult(System.out));
   } finally {
       smooks.close();
   }
   

   Copy to Clipboard Toggle word wrap
8. その結果、XML から XML への変換が行われます。

手順3.2 タスク

• コア設定 namespace によって namespace の接頭辞から URI へのマッピングを設定し、次の XML コードを変更して、使用する namespace を含めます。

  <?xml version="1.0"?>
  <smooks-resource-list xmlns="http://www.milyn.org/xsd/smooks-1.1.xsd"
      xmlns:core="http://www.milyn.org/xsd/smooks/smooks-core-1.3.xsd">
  
      <core:namespaces>
          <core:namespace prefix="a" uri="http://a"/>
          <core:namespace prefix="b" uri="http://b"/>
          <core:namespace prefix="c" uri="http://c"/>
          <core:namespace prefix="d" uri="http://d"/>
      </core:namespaces>
  
      <resource-config selector="c:item[@c:code = '8655']/d:units[text() = 1]">
          <resource>com.acme.visitors.MyCustomVisitorImpl</resource>
      </resource-config>
  
  </smooks-resource-list>
  

  Copy to Clipboard Toggle word wrap

1. Smooks 内から DomModelCreator を設定して、order および注文品目メッセージフラグメントのモデルを作成します。以下の例を参照してください。

   <resource-config selector="order,order-item">
       <resource>org.milyn.delivery.DomModelCreator</resource>
   </resource-config>
   

   Copy to Clipboard Toggle word wrap
2. 次のように、order のメモリー内モデルを設定します。

   <order id='332'>
        <header>
            <customer number="123">Joe</customer>
        </header>
        <order-items />
   </order>
   

   Copy to Clipboard Toggle word wrap
   注記
   新しいモデルごとに前のモデルが上書きされるため、一度に複数の 注文品目 モデルがメモリーに存在することはありません。

1. Smooks.filterSource プロセスの最後に Bean コンテキストのコンテンツを返すには、Smooks.filterSource メソッドの呼び出しで org.milyn.delivery.java.JavaResult オブジェクトを指定します。この例は、次の方法を示しています。

    //Get the data to filter
   StreamSource source = new StreamSource(getClass().getResourceAsStream("data.xml"));
   
   //Create a Smooks instance (cachable)
   Smooks smooks = new Smooks("smooks-config.xml");
   
   //Create the JavaResult, which will contain the filter result after filtering
   JavaResult result = new JavaResult();
   
   //Filter the data from the source, putting the result into the JavaResult
   smooks.filterSource(source, result);
   
   //Getting the Order bean which was created by the Javabean cartridge
   Order order = (Order)result.getBean("order");
   

   Copy to Clipboard Toggle word wrap
2. 起動時に Bean コンテキストにアクセスするには、これを BeanContext オブジェクトで指定します。 getBeanContext() メソッドで ExecutionContext から取得できます。
3. BeanContext からオブジェクトを追加または取得する場合は、まず、beanIdStore から beanId オブジェクトを取得してください。(beanId オブジェクトは、文字列キーもサポートされていますが、文字列キーよりも高いパフォーマンスを保証する特殊なキーです。)
4. getbeanIdStore() メソッドを使用して、ApplicationContext から beanIdStore を取得する必要があります。
5. beanId オブジェクトを作成するには、 register("beanId name") メソッドを呼び出します。(beanId がすでに登録されていることがわかっている場合は、 getbeanId("beanId name") メソッドを呼び出すと、取得できます)。
6. beanId オブジェクトは ApplicationContext スコープのオブジェクトです。それらをカスタムビジター実装の初期化メソッドに登録してから、ビジターオブジェクトにプロパティーとして配置します。その後、それらを visitBefore および visitAfter メソッドで使用できます。(beanId オブジェクトと beanIdStore はスレッドセーフです。)

• API に見られるように、複数の結果インスタンスを Smooks に提供します。

  public void filterSource(Source source, Result... results) throws SmooksException
  

  Copy to Clipboard Toggle word wrap
  注記
  Smooks は、同じタイプの複数の結果インスタンスからの結果データの取得をサポートしていません。たとえば、 Smooks.filterSource メソッド呼び出しで複数の StreamResult インスタンスを指定できますが、Smooks は、これらの StreamResult インスタンスのうち 1 つ (最初の 1 つ) のみに出力します。

1. Smooks から実行レポートを取得するには、レポートを生成するように、ExecutionContext クラスを設定する必要があります。(Smooks は、メッセージを処理する際、イベントを発行します。) 次のサンプルコードは、HTML レポートを生成するように、Smooks を設定する方法を示しています。

   Smooks smooks = new Smooks("/smooks/smooks-transform-x.xml");
   ExecutionContext execContext = smooks.createExecutionContext();
   
   execContext.setEventListener(new HtmlReportGenerator("/tmp/smooks-report.html"));
   smooks.filterSource(execContext, new StreamSource(inputStream), new StreamResult(outputStream));
   

   Copy to Clipboard Toggle word wrap
2. HtmlReportGenerator 機能を使用すると、デバッグ時に役立ちます。
   注記
   Web ページ http://www.milyn.org/docs/smooks-report/report.html でサンプルレポートを確認できます。
   注記
   また、カスタムの ExecutionEventListener 実装を作成できます。

1. メッセージの最後に到達する前に、Smooks フィルタリングプロセスを終了するには、<core:terminate> 設定を Smooks 設定に追加します。(これは SAX で機能し、DOM では必要ありません。)
   メッセージの顧客フラグメントの最後でフィルタリングを終了する設定例は次のとおりです。

   <smooks-resource-list xmlns="http://www.milyn.org/xsd/smooks-1.1.xsd" 
      xmlns:core="http://www.milyn.org/xsd/smooks/smooks-core-1.3.xsd">
   
       <!-- Visitors... -->
       <core:terminate onElement="customer" />
   
   </smooks-resource-list>

   Copy to Clipboard Toggle word wrap
2. メッセージの先頭で終了するには (visitBeforeイベント)、次のコードを使用します。

   <smooks-resource-list xmlns="http://www.milyn.org/xsd/smooks-1.1.xsd" 
      xmlns:core="http://www.milyn.org/xsd/smooks/smooks-core-1.3.xsd">
   
      <!-- Visitors... -->
   
      <core:terminate onElement="customer" terminateBefore="true" />
   
   </smooks-resource-list>

   Copy to Clipboard Toggle word wrap

1. 次のように、グローバルパラメーターは、<params> 要素で指定されます。

   <params>
       <param name="xyz.param1">param1-val</param>
   </params>
   

   Copy to Clipboard Toggle word wrap
2. ExecutionContext でグローバルパラメーターにアクセスします。

   <smooks-resource-list xmlns="http://www.milyn.org/xsd/smooks-1.1.xsd" 
       xmlns:xsl="http://www.milyn.org/xsd/smooks/xsl-1.1.xsd" 
       default-selector="order">
   
       <resource-config>
           <resource>com.acme.VisitorA</resource>
           ...
       </resource-config>
   
       <resource-config>
           <resource>com.acme.VisitorB</resource>
           ...
       </resource-config>
   
   <smooks-resource-list>
   

   Copy to Clipboard Toggle word wrap

• フィルタリングオプションを設定するには、smooks-core 設定 namespace を使用します。以下の例を参照してください。

  ;smooks-resource-list xmlns="http://www.milyn.org/xsd/smooks-1.1.xsd" 
     xmlns:core="http://www.milyn.org/xsd/smooks/smooks-core-1.3.xsd">
     <core:filterSettings type="SAX" defaultSerialization="true" 
        terminateOnException="true" readerPoolSize="3" closeSource="true" 
        closeResult="true" rewriteEntities="true" />
  
        .. Other visitor configs etc...
  
  </smooks-resource-list>
  

  Copy to Clipboard Toggle word wrap

• デフォルトでは、Smooks は XML データを読み取ります。デフォルトの XML リーダーに機能を設定するには、設定からクラス名を省略します。

  <reader>
      <features>
          <setOn feature="http://a" />
          <setOn feature="http://b" />
          <setOff feature="http://c" />
          <setOff feature="http://d" />
      </features>
  </reader>
  

  Copy to Clipboard Toggle word wrap

1. リーダーを設定するには、http://www.milyn.org/xsd/smooks/csv-1.2.xsd 設定 namespace を使用します。
   基本的な設定は次のとおりです。

   <?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">
    
       <!--
       Configure the CSV to parse the message into a stream of SAX events.
       -->
       <csv:reader fields="firstname,lastname,gender,age,country" separator="|" quote="'" skipLines="1" />
    
   </smooks-resource-list>
   

   Copy to Clipboard Toggle word wrap
2. 次のイベントストリームが表示されます。

   <csv-set>
       <csv-record>
           <firstname>Tom</firstname>
           <lastname>Fennelly</lastname>
           <gender>Male</gender>
           <age>21</age>
           <country>Ireland</country>
       </csv-record>
       <csv-record>
           <firstname>Tom</firstname>
           <lastname>Fennelly</lastname>
           <gender>Male</gender>
           <age>21</age>
           <country>Ireland</country>
       </csv-record>
   </csv-set>
   

   Copy to Clipboard Toggle word wrap

1. XML 設定でフィールドを定義するには、 fields 属性で名前のコンマ区切りリストを使用する必要があります。
2. フィールド名が XML 要素名と同じ命名規則に従っていることを確認してください。
3. • 文字、数字、その他の文字を含めることができる
   • 数字または句読点で始めることはできない
   • 文字 xml (または XML や Xml など) で開始することはできない
   • スペースを含めることはできない
4. csv-set および csv-record 要素名を変更できるように、rootElementName および recordElementName 属性を設定します。これらの名前にも同じルールが適用されます。
5. フィールドごとに文字列操作関数を定義できます。これらの関数は、データが SAX イベントに変換される前に、実行されます。フィールド名の後に定義し、2 つを疑問符で区切ります。

   <?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">
    
       <csv:reader fields="lastname?trim.capitalize,country?upper_case" />
    
   </smooks-resource-list>
   
   

   Copy to Clipboard Toggle word wrap
6. Smooks が CSV レコードのフィールドを無視するようにするには、フィールドの設定値として $ignore$ トークンを指定する必要があります。$ignore$ トークンの後に数字を続けるだけで、無視するフィールドの数を指定します (したがって、$ignore$3 を使用して、次の 3 つのフィールドを無視します)。 $ignore$+ を使用して、CSV レコードの最後まで、すべてのフィールドを無視します。

   <?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">
    
       <csv:reader fields="firstname,$ignore$2,age,$ignore$+" />
    
   </smooks-resource-list>
   
   

   Copy to Clipboard Toggle word wrap

1. CSV レコードを Java オブジェクトに変換する方法については、以下をお読みください。この例では、CSV レコードを個人に使用します。

   Tom,Fennelly,Male,4,Ireland
   Mike,Fennelly,Male,2,Ireland
   

   Copy to Clipboard Toggle word wrap
2. このコードを入力して、レコードを個人にバインドします。

   public class Person {
       private String firstname;
       private String lastname;
       private String country;
       private Gender gender;
       private int age;
   }
    
   public enum Gender {
       Male, 
       Female;
   }
   
   

   Copy to Clipboard Toggle word wrap
3. 次のコードを入力し、タスクに合わせて、変更します。

   <?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">
    
       <csv:reader fields="firstname,lastname,gender,age,country">
           <!-- Note how the field names match the property names on the Person class. -->
           <csv:listBinding beanId="people" class="org.milyn.csv.Person" />
       </csv:reader>
    
   </smooks-resource-list>
   

   Copy to Clipboard Toggle word wrap
4. 設定を実行するには、次のコードを使用します。

   Smooks smooks = new Smooks(configStream);
   JavaResult result = new JavaResult();
    
   smooks.filterSource(new StreamSource(csvStream), result);
    
   List<Person> people = (List<Person>) result.getBean("people");
   

   Copy to Clipboard Toggle word wrap
5. CSV レコードセットからマップを作成できます。

   <?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">
    
       <csv:reader fields="firstname,lastname,gender,age,country">
           <csv:mapBinding beanId="people" class="org.milyn.csv.Person" keyField="firstname" />
       </csv:reader>
    
   </smooks-resource-list>
   
   

   Copy to Clipboard Toggle word wrap
6. 上記の設定では、個人ごとの firstname 値に応じた個人インスタンスのマップが生成されます。実行方法は次のとおりです。

   Smooks smooks = new Smooks(configStream);
   JavaResult result = new JavaResult();
    
   smooks.filterSource(new StreamSource(csvStream), result);
    
   Map<String, Person> people = (Map<String, Person>) result.getBean("people");
    
   Person tom = people.get("Tom");
   Person mike = people.get("Mike");
   
   

   Copy to Clipboard Toggle word wrap
   仮想モデルもサポートされているため、class 属性を java.util.Map として定義し、CSV フィールド値をバインドして、インスタンスをマッピングし、リストまたはマップに追加できます。

1. CSV リーダーを使用して、Smooks インスタンスを設定し、個人レコードセットを読み取るには、以下のコードを使用します。レコードを個人インスタンスのリストにバインドします。

   Smooks smooks = new Smooks();
    
   smooks.setReaderConfig(new CSVReaderConfigurator("firstname,lastname,gender,age,country")
                     .setBinding(new CSVBinding("people", Person.class, CSVBindingType.LIST)));
    
   JavaResult result = new JavaResult();
   smooks.filterSource(new StreamSource(csvReader), result);
    
   List<Person> people = (List<Person>) result.getBean("people");
   
   

   Copy to Clipboard Toggle word wrap
   注記
   オプションで Java Bean を設定することもできます。代わりに (または追加で)、他のビジター実装を使用して、CSV レコードセットを処理するように、Smooks インスタンスをプログラムで設定できます。
2. CSV レコードのデータを反映する Java 型のリストまたはマップに CSV のレコードをバインドするには、CSVListBinder または CSVMapBinder クラスを使用します。

   // Note: The binder instance should be cached and reused...
   CSVListBinder binder = new CSVListBinder("firstname,lastname,gender,age,country", Person.class);
    
   List<Person> people = binder.bind(csvStream);
   
   CSVMapBinder:
   
   // Note: The binder instance should be cached and reused...
   CSVMapBinder binder = new CSVMapBinder("firstname,lastname,gender,age,country", Person.class, "firstname");
    
   Map<String, Person> people = binder.bind(csvStream);
   
   

   Copy to Clipboard Toggle word wrap
   バインドプロセスをさらに制御する必要がある場合は、下位レベルの API の使用に戻ります。

1. 固定長リーダーを設定するには、次のように、http://www.milyn.org/xsd/smooks/fixed-length-1.3.xsd 設定 namespace を変更します。

   <?xml version="1.0"?>
   <smooks-resource-list xmlns="http://www.milyn.org/xsd/smooks-1.1.xsd" xmlns:fl="http://www.milyn.org/xsd/smooks/fixed-length-1.3.xsd">
    
       <!--
       Configure the Fixed length to parse the message into a stream of SAX events.
       -->
       <fl:reader fields="firstname[10],lastname[10],gender[1],age[2],country[2]" skipLines="1" />
    
   </smooks-resource-list>
   
   

   Copy to Clipboard Toggle word wrap
   入力ファイルの例は次のとおりです。

   #HEADER
   Tom       Fennelly  M 21 IE
   Maurice  Zeijen     M 27 NL
   

   Copy to Clipboard Toggle word wrap
   生成されるイベントストリームは次のとおりです。

   <set>
       <record>
           <firstname>Tom       </firstname>
           <lastname>Fennelly  </lastname>
           <gender>M</gender>
           <age> 21</age>
           <country>IE</country>
       </record>
       <record>
           <firstname>Maurice  </firstname>
           <lastname>Zeijen     </lastname>
           <gender>M</gender>
           <age>27</age>
           <country>NL</country>
       </record>
   </set>
   ]]>
   

   Copy to Clipboard Toggle word wrap
2. 次のように、文字列操作関数を定義します。

   <?xml version="1.0"?>
   <smooks-resource-list xmlns="http://www.milyn.org/xsd/smooks-1.1.xsd" xmlns:fl="http://www.milyn.org/xsd/smooks/fixed-length-1.3.xsd">
    
       <!--
       Configure the fixed length reader to parse the message into a stream of SAX events.
       -->
       <fl:reader fields="firstname[10]?trim,lastname[10]trim.capitalize,gender[1],age[2],country[2]" skipLines="1" />
    
   </smooks-resource-list>
   
   

   Copy to Clipboard Toggle word wrap
3. 選択した場合は、これらのフィールドを無視することもできます。

   <?xml version="1.0"?>
   <smooks-resource-list xmlns="http://www.milyn.org/xsd/smooks-1.1.xsd" xmlns:fl="http://www.milyn.org/xsd/smooks/fixed-length-1.3.xsd">
    
       <fl:reader fields="firstname,$ignore$[2],age,$ignore$[10]" />
    
   </smooks-resource-list>
   
   

   Copy to Clipboard Toggle word wrap

1. 固定長レコードを個人にバインドするには、以下の設定を参照してください。この例では、次のサンプルレコードを使用します。

   Tom       Fennelly  M 21 IE
   Maurice  Zeijen     M 27 NL
   

   Copy to Clipboard Toggle word wrap
   これは、個人にそれらをバインドする方法です。

   [
   public class Person {
       private String firstname;
       private String lastname;
       private String country;
       private String gender;
       private int age;
   }
   
   

   Copy to Clipboard Toggle word wrap
2. 次のように、レコードを設定します。

   <?xml version="1.0"?>
   <smooks-resource-list xmlns="http://www.milyn.org/xsd/smooks-1.1.xsd"  xmlns:fl="http://www.milyn.org/xsd/smooks/fixed-length-1.3.xsd">
    
       <fl:reader fields="firstname[10]?trim,lastname[10]?trim,gender[1],age[3]?trim,country[2]">
           <!-- Note how the field names match the property names on the Person class. -->
           <fl:listBinding BeanId="people" class="org.milyn.fixedlength.Person" />
       </fl:reader>
    
   </smooks-resource-list>
   
   

   Copy to Clipboard Toggle word wrap
3. 次のように、実行します。

   Smooks smooks = new Smooks(configStream);
   JavaResult result = new JavaResult();
    
   smooks.filterSource(new StreamSource(fixedLengthStream), result);
    
   List<Person> people = (List<Person>) result.getBean("people");
   
   

   Copy to Clipboard Toggle word wrap
4. オプションで、この設定を使用して、固定長レコードセットからマップを作成します。

   <?xml version="1.0"?>
   <smooks-resource-list xmlns="http://www.milyn.org/xsd/smooks-1.1.xsd"  xmlns:fl="http://www.milyn.org/xsd/smooks/fixed-length-1.3.xsd">
    
       <fl:reader fields="firstname[10]?trim,lastname[10]?trim,gender[1],age[3]?trim,country[2]">
           <fl:mapBinding BeanId="people" class="org.milyn.fixedlength.Person" keyField="firstname" />
       </fl:reader>
   

   Copy to Clipboard Toggle word wrap
5. これは、生成された個人インスタンスのマップを実行する方法です。

   Smooks smooks = new Smooks(configStream);
   JavaResult result = new JavaResult();
    
   smooks.filterSource(new StreamSource(fixedLengthStream), result);
    
   Map<String, Person> people = (Map<String, Person>) result.getBean("people");
    
   Person tom = people.get("Tom");
   Person mike = people.get("Maurice");
   

   Copy to Clipboard Toggle word wrap
   仮想モデルもサポートされているため、class 属性を java.util.Map として定義し、固定長フィールド値をバインドして、インスタンスをマッピングし、リストまたはマップに追加することができます。

1. 次のコードを使用して、個人レコードセットを読み取るように、固定長リーダーを設定し、レコードセットを個人インスタンスのリストにバインドします。

   Smooks smooks = new Smooks();
    
   smooks.setReaderConfig(new FixedLengthReaderConfigurator("firstname[10]?trim,lastname[10]?trim,gender[1],age[3]?trim,country[2]")
                     .setBinding(new FixedLengthBinding("people", Person.class, FixedLengthBindingType.LIST)));
    
   JavaResult result = new JavaResult();
   smooks.filterSource(new StreamSource(fixedLengthStream), result);
    
   List<Person> people = (List<Person>) result.getBean("people");
   

   Copy to Clipboard Toggle word wrap
   Java バインドの設定は必須ではありません。代わりに、他のビジター実装を使用して、固定長レコードセットにさまざまな形式の処理を実行するように、Smooks インスタンスをプログラムで設定できます。
2. 固定長レコードを、固定長レコードのデータを反映する Java 型のリストまたはマップに直接バインドするには、FixedLengthListBinder クラスまたは FixedLengthMapBinder クラスを使用します。

   // Note: The binder instance should be cached and reused...
   FixedLengthListBinder binder = new FixedLengthListBinder("firstname[10]?trim,lastname[10]?trim,gender[1],age[3]?trim,country[2]", Person.class);
    
   List<Person> people = binder.bind(fixedLengthStream);
   
   FixedLengthMapBinder:
   
   // Note: The binder instance should be cached and reused...
   FixedLengthMapBinder binder = new FixedLengthMapBinder("firstname[10]?trim,lastname[10]?trim,gender[1],age[3]?trim,country[2]", Person.class, "firstname");
    
   Map<String, Person> people = binder.bind(fixedLengthStream);
   

   Copy to Clipboard Toggle word wrap
   バインドプロセスをさらに制御する必要がある場合は、下位レベルの API に戻ります。

1. Smooks で EDI 処理を利用するには、http://www.milyn.org/xsd/smooks/edi-1.2.xsd 設定 namespace にアクセスします。
2. ニーズに合わせて、この設定を変更します。

   <?xml version="1.0"?>
   <smooks-resource-list xmlns="http://www.milyn.org/xsd/smooks-1.1.xsd" xmlns:edi="http://www.milyn.org/xsd/smooks/edi-1.2.xsd">    
    <!--
       Configure the EDI Reader to parse the message stream into a stream of SAX events.
       -->
       <edi:reader mappingModel="edi-to-xml-order-mapping.xml" validate="false"/>
   </smooks-resource-list>
   

   Copy to Clipboard Toggle word wrap

• 次のコードのように、EDIReaderConfigurator を使用して、EDIReader を使用するように、Smooks インスタンスをプログラムで設定します。

  Smooks smooks = new Smooks();
   
  // Create and initialise the Smooks config for the parser...
  smooks.setReaderConfig(new EDIReaderConfigurator("/edi/models/invoice.xml"));
   
  // Use the smooks as normal
  smooks.filterSource(....);
  

  Copy to Clipboard Toggle word wrap

• Maven によって Edifact Java Compiler を実行するには、POM ファイルにプラグインを追加します。

  <build>
      <plugins>
          <plugin>
              <groupId>org.milyn</groupId>
              <artifactId>maven-ejc-plugin</artifactId>
              <version>1.2</version>
              <configuration>
                  <ediMappingFile>edi-model.xml</ediMappingFile>
                  <packageName>com.acme.order.model</packageName>
              </configuration>
              <executions>
                  <execution><goals><goal>generate</goal></goals></execution>
              </executions>
          </plugin>
      </plugins>
  </build>
  

  Copy to Clipboard Toggle word wrap

• 次のように、EJC タスクを作成および実行します。

  <target name="ejc">
   
      <taskdef resource="org/milyn/ejc/ant/anttasks.properties">
          <classpath><fileset dir="/smooks-1.2/lib" includes="*.jar"/></classpath>
      </taskdef>
   
      <ejc edimappingmodel="src/main/resources/edi-model.xml"
           destdir="src/main/java"
           packagename="com.acme.order.model"/>
   
      <!-- Ant as usual from here on... compile and jar the source... -->
   
  </target>
  

  Copy to Clipboard Toggle word wrap

• 次のように、http://www.milyn.org/xsd/smooks/unedifact-1.4.xsd namespace を設定します。

  <?xml version="1.0"?>
  <smooks-resource-list xmlns="http://www.milyn.org/xsd/smooks-1.1.xsd" xmlns:unedifact="http://www.milyn.org/xsd/smooks/unedifact-1.4.xsd">
   
      <unedifact:reader mappingModel="urn:org.milyn.edi.unedifact:d03b-mapping:v1.4" ignoreNewLines="true" />
   
  </smooks-resource-list>
  

  Copy to Clipboard Toggle word wrap
  mappingModel 属性は、読者が使用するマッピングモデル ZIP セットの Maven アーティファクトを参照する URN を定義します。

1. UN/EDIFACT 交換を使用するように、Smooks をプログラムで設定するには (たとえば、UNEdifactReaderConfigurator によって)、次のコードを使用します。

   Smooks smooks = new Smooks();
    
   smooks.setReaderConfig(new UNEdifactReaderConfigurator("urn:org.milyn.edi.unedifact:d03b-mapping:v1.4"));
   

   Copy to Clipboard Toggle word wrap
2. 含まれているアプリケーションのクラスパスに次を挿入します。
   • 必要な EDI マッピングモデル
   • Smooks EDI カートリッジ
3. 設定に必要な複数の Maven 依存関係がある場合があります。以下の例を参照してください。

   <dependency>
       <groupId>org.milyn</groupId>
       <artifactId>milyn-smooks-edi</artifactId>
       <version>1.4</version>
   </dependency>
    
   <!-- Required Mapping Models -->
   <dependency>
       <groupId>org.milyn.edi.unedifact</groupId>
       <artifactId>d93a-mapping</artifactId>
       <version>v1.4</version>
   </dependency>
   <dependency>
       <groupId>org.milyn.edi.unedifact</groupId>
       <artifactId>d03b-mapping</artifactId>
       <version>v1.4</version>
   </dependency>
   

   Copy to Clipboard Toggle word wrap
4. アプリケーションがクラスパスに EDI マッピングモデルの ZIP セットを追加したら、unedifact:reader 設定の mappingModel 属性値として URN を使用して Maven アーティファクトを参照するだけで、このモデルを使用するように、Smooks を設定できます。

   <?xml version="1.0"?>
   <smooks-resource-list xmlns="http://www.milyn.org/xsd/smooks-1.1.xsd" xmlns:unedifact="http://www.milyn.org/xsd/smooks/unedifact-1.4.xsd"
    
       <unedifact:reader mappingModel="urn:org.milyn.edi.unedifact:d03b-mapping:v1.4" ignoreNewLines="true" />
    
   </smooks-resource-list>
   

   Copy to Clipboard Toggle word wrap

1. D93A マッピングモデル ZIP セットをアプリケーションクラスパスに追加するには、アプリケーションの POM ファイルに次の依存関係を設定します。

   <!-- The mapping model sip set for the D93A directory... -->
   <dependency>
       <groupId>org.milyn.edi.unedifact</groupId>
       <artifactId>d93a-mapping</artifactId>
       <version>v1.4</version>
   </dependency>
   

   Copy to Clipboard Toggle word wrap
2. 次のように、unedifact:reader 設定を Smooks 設定に追加して、この ZIP セットを使用するように、Smooks を設定します。

   <unedifact:reader mappingModel="urn:org.milyn.edi.unedifact:d93a-mapping:v1.4" />
   

   Copy to Clipboard Toggle word wrap
   Maven アーティファクトの依存情報から派生した URN を使用して、リーダーを設定する方法に注意してください。
3. 複数のマッピングモデル ZIP セットをアプリケーションのクラスパスに追加することもできます。これを行うには、URN をコンマで区切って、unedifact:reader 設定にそのすべてを追加します。
4. ツールには、事前生成された Java バインドモデルセットが用意されています (マッピングモデルの ZIP セットごとに 1 つ存在します)。これらを使用して、生成された非常に単純なファクトリークラスを使用して、UN/EDIFACT 交換を処理します。

1. D03B UN/EDIFACT メッセージ交換を処理するには、次の例に従います。

   Reading:
   
   // Create an instance of the EJC generated factory class... cache this and reuse !!!
   D03BInterchangeFactory factory = D03BInterchangeFactory.getInstance();
    
   // Deserialize the UN/EDIFACT interchange stream to Java...
   UNEdifactInterchange interchange = factory.fromUNEdifact(ediInStream);
    
   // Need to test which interchange syntax version.  Supports v4.1 at the moment...
   if(interchange instanceof UNEdifactInterchange41) {
       UNEdifactInterchange41 interchange41 = (UNEdifactInterchange41) interchange;
    
       for(UNEdifactMessage41 message : interchange41.getMessages()) {
           // Process the messages...
    
           Object messageObj = message.getMessage();
    
           if(messageObj instanceof Invoic) {
               // It's an INVOIC message....
               Invoic invoic = (Invoic) messageObj;
               ItemDescription itemDescription = invoic.getItemDescription();
               // etc etc....
           } else if(messageObj instanceof Cuscar) {
               // It's a CUSCAR message...
           } else if(etc etc etc...) {
               // etc etc etc...
           }
       }
   }
   
   
   Writing:
   
   factory.toUNEdifact(interchange, ediOutStream);
   
   

   Copy to Clipboard Toggle word wrap
2. Maven を使用して、そのディレクトリーのバインド依存関係を追加することにより、D03B メッセージ交換を処理する機能を追加します (Maven SNAPSHOT および Central リポジトリーによって配布される、事前に生成された UN/EDIFACT Java オブジェクトモデルを使用することもできます)。

   <dependency>
       <groupId>org.milyn.edi.unedifact</groupId>
       <artifactId>d03b-binding</artifactId>
       <version>v1.4</version>
   </dependency>
   

   Copy to Clipboard Toggle word wrap

1. JSON データを処理するには、JSON リーダーを設定する必要があります。

   <?xml version="1.0"?>
   <smooks-resource-list xmlns="http://www.milyn.org/xsd/smooks-1.1.xsd" xmlns:json="http://www.milyn.org/xsd/smooks/json-1.1.xsd">
    
       <json:reader/>
    
   </smooks-resource-list>
   

   Copy to Clipboard Toggle word wrap
2. 次の設定オプションを使用して、ルート、ドキュメント、および配列要素の XML 名を設定します。
   • rootName: これはルート要素の名前です。デフォルトは yaml です。
   • elementName: これはシーケンス要素の名前です。デフォルトは要素です。
3. XML 要素名で許可されていない文字をキー名で使用する場合があります。リーダーは、この問題に複数の解決策を提供します。空白、不正な文字、数字で始まるキー名の数字を検索および置換できます。これを使用して、1 つのキー名を完全に別のものに置換することもできます。次のサンプルコードは、これを行う方法を示しています。

   <?xml version="1.0"?>
   <smooks-resource-list xmlns="http://www.milyn.org/xsd/smooks-1.1.xsd" xmlns:json="http://www.milyn.org/xsd/smooks/json-1.1.xsd">
    
       <json:reader keyWhitspaceReplacement="_" keyPrefixOnNumeric="n" illegalElementNameCharReplacement=".">
           <json:keyMap>
               <json:key from="some key">someKey</json:key>
               <json:key from="some&key" to="someAndKey" />
           </json:keyMap>
       </json:reader>
    
   </smooks-resource-list>
   

   Copy to Clipboard Toggle word wrap
   • keyWhitspaceReplacement: これは、JSON マップキーの空白の置換文字です。デフォルトでは、これは定義されていないため、リーダーは空白を自動的に検索しません。
   • keyPrefixOnNumeric: これは、JSON ノード名が数字で始まる場合に追加する接頭辞文字です。デフォルトでは、これは定義されていないため、リーダーは数字で始まる要素名を検索しません。
   • illegalElementNameCharReplacement: JSON 要素名で不正な文字が検出された場合、それらはこの値に置換されます。
4. 次のオプション設定を行うこともできます。
5. • nullValueReplacement: これは、JSON null 値の置換文字列です。デフォルトは空の文字列です。
   • encoding: これは、リーダーによって処理される JSON メッセージ InputStream のデフォルトのエンコードです。デフォルトのエンコードは UTF-8 です。
     注記
     この機能は非推奨です。代わりに、 java.io.Reader を Smooks.filterSource() メソッドに指定して、JSON ストリームソースの文字エンコードを管理する必要があります。
6. JSON 設定を読み取るように、Smooks をプログラムで設定するには、JSONReaderConfigurator クラスを使用します。

   Smooks smooks = new Smooks();
    
   smooks.setReaderConfig(new JSONReaderConfigurator()
           .setRootName("root")
           .setArrayElementName("e"));
    
   // Use Smooks as normal...
   

   Copy to Clipboard Toggle word wrap

手順4.1 タスク

1. 次のように、YAML ファイルを処理するように、リーダーを設定します。

   <?xml version="1.0"?>
   <smooks-resource-list xmlns="http://www.milyn.org/xsd/smooks-1.1.xsd" xmlns:yaml="http://www.milyn.org/xsd/smooks/yaml-1.4.xsd">
    
       <yaml:reader/>
    
   </smooks-resource-list>
   

   Copy to Clipboard Toggle word wrap
2. 複数のドキュメントを含むように、YAML ストリームを設定します。リーダーは、ドキュメント要素をルート要素の子として追加して、これを処理します。1 つの空の YAML ドキュメントを含む XML シリアル化された YAML ストリームは次のようになります。

   <yaml>
       <document>
       </document>
   </yaml>
   

   Copy to Clipboard Toggle word wrap
3. YamlReaderConfigurator クラスを利用して、YAML 設定を読み取るように、Smooks をプログラムで設定します。

   Smooks smooks = new Smooks();
    
   smooks.setReaderConfig(new YamlReaderConfigurator()
           .setRootName("root")
           .setDocumentName("doc")
           .setArrayElementName("e"))
           .setAliasStrategy(AliasStrategy.REFER_RESOLVE)
           .setAnchorAttributeName("anchor")
           .setAliasAttributeName("alias");
    
   // Use Smooks as normal...
   

   Copy to Clipboard Toggle word wrap

• XML 要素名で許可されていない文字をキー名で使用できます。リーダーは、この問題に複数の解決策を提供します。空白、不正な文字、数字で始まるキー名の数字を検索および置換できます。次のように、1 つのキー名を完全に別のものに置換するように、設定できます。

  <?xml version="1.0"?>
  <smooks-resource-list xmlns="http://www.milyn.org/xsd/smooks-1.1.xsd" xmlns:yaml="http://www.milyn.org/xsd/smooks/yaml-1.4.xsd">
   
      <yaml:reader keyWhitspaceReplacement="_" keyPrefixOnNumeric="n" illegalElementNameCharReplacement=".">
          <yaml:keyMap>
              <yaml:key from="some key">someKey</yaml:key>
              <yaml:key from="some&key" to="someAndKey" />
          </yaml:keyMap>
      </yaml:reader>
   
  </smooks-resource-list>
  

  Copy to Clipboard Toggle word wrap

1. Smooks は、1 つの Java オブジェクトグラフ を別のグラフに変換できます。これを行うには、SAX 処理モデルを使用します。つまり、中間オブジェクトモデルは構成されません。代わりに、ソース Java オブジェクトグラフは、SAX イベントのストリームに直接変換され、ターゲット Java オブジェクトグラフを生成するために使用されます。
   HTML Smooks Report Generator ツールを使用すると、ソースオブジェクトモデルによって生成されるイベントストリームが次のようになることがわかります。

   <example.srcmodel.Order>
       <header>
           <customerNumber>
               </customerNumber>
              <customerName>
          </customerName>;
       </header>
       <orderItems>
           <example.srcmodel.OrderItem>
               <productId>
              </productId>
               <quantity>
               >/quantity>
               <price>
               </price>
           </example.srcmodel.OrderItem>
       </orderItems>
   </example.srcmodel.Order>
   

   Copy to Clipboard Toggle word wrap
2. このイベントストリームで Smooks Java Bean リソースを対象とします。この変換を実行するための Smooks 設定 (smooks-config.xml) は次のとおりです。

   <?xml version="1.0"?>
   <smooks-resource-list xmlns="http://www.milyn.org/xsd/smooks-1.1.xsd" xmlns:jb="http://www.milyn.org/xsd/smooks/javabean-1.4.xsd">
    
       <jb:bean BeanId="lineOrder" class="example.trgmodel.LineOrder" createOnElement="example.srcmodel.Order">
           <jb:wiring property="lineItems" BeanIdRef="lineItems" />
           <jb:value property="customerId" data="header/customerNumber" />
           <jb:value property="customerName" data="header/customerName" />
       </jb:bean<
    
       <jb:bean BeanId="lineItems" class="example.trgmodel.LineItem[]" createOnElement="orderItems">
           <jb:wiring BeanIdRef="lineItem" />
       </jb:bean>
    
    
       <jb:bean BeanId="lineItem" class="example.trgmodel.LineItem" createOnElement="example.srcmodel.OrderItem">
           <jb:value property="productCode" data="example.srcmodel.OrderItem/productId" />
           <jb:value property="unitQuantity" data="example.srcmodel.OrderItem/quantity" />
           <jb:value property="unitPrice" data="example.srcmodel.OrderItem/price" />
       </jb:bean>
    
   </smooks-resource-list>
   

   Copy to Clipboard Toggle word wrap
3. ソースオブジェクトモデルは、org.milyn.delivery.JavaSource オブジェクトによって Smooks に提供されます。コンストラクターにソースモデルのルートオブジェクトを渡して、このオブジェクトを作成します。結果としての Java ソースオブジェクトは、 Smooks#filter メソッドで使用されます。結果のコードは次のとおりです。

   protected LineOrder runSmooksTransform(Order srcOrder) throws IOException, SAXException {
       Smooks smooks = new Smooks("smooks-config.xml");
       ExecutionContext executionContext = smooks.createExecutionContext();
    
       // Transform the source Order to the target LineOrder via a
       // JavaSource and JavaResult instance...
       JavaSource source = new JavaSource(srcOrder);
       JavaResult result = new JavaResult();
    
       // Configure the execution context to generate a report...
       executionContext.setEventListener(new HtmlReportGenerator("target/report/report.html"));
    
       smooks.filterSource(executionContext, source, result);
    
       return (LineOrder) result.getBean("lineOrder");
   }
   

   Copy to Clipboard Toggle word wrap

1. このコード例を使用して、Regex ruleBase を設定します。

   <?xml version="1.0"?>
   <smooks-resource-list  xmlns="http://www.milyn.org/xsd/smooks-1.1.xsd"  xmlns:rules="http://www.milyn.org/xsd/smooks/rules-1.0.xsd">
    
       <rules:ruleBases>
           <rules:ruleBase name="customer" src="/org/milyn/validation/order/rules/customer.properties" provider="org.milyn.rules.regex.RegexProvider"/>
       </rules:ruleBases>
    
   </smooks-resource-list>
   

   Copy to Clipboard Toggle word wrap
2. 標準の .properties ファイル形式で Regex 表現を定義します。次の customer.properties Regex ルール定義ファイルの例は、その方法を示しています。

   # Customer data rules...
   customerId=[A-Z][0-9]{5}
   customerName=[A-Z][a-z]*, [A-Z][a-z]
   

   Copy to Clipboard Toggle word wrap

1. MVEL ruleBase を設定するには、以下のコードを参照してください。

   <?xml version="1.0"?>
   <smooks-resource-list  xmlns="http://www.milyn.org/xsd/smooks-1.1.xsd"  xmlns:rules="http://www.milyn.org/xsd/smooks/rules-1.0.xsd">
    
       <rules:ruleBases>
           <rules:ruleBase name="order" src="/org/milyn/validation/order/rules/order-rules.csv" provider="org.milyn.rules.mvel.MVELProvider"/>
       </rules:ruleBases>
    
   </smooks-resource-list>
   

   Copy to Clipboard Toggle word wrap
2. MVEL ルールを CSV ファイルに保存する必要があります。これらのファイルを編集する最も簡単な方法は、LibreOffice Calc や Gnumeric などのスプレッドシートアプリケーションを使用することです。各ルールレコードには、ルール名と MVEL 式が含まれています。
3. コメント行とヘッダー行を作成する場合は、最初のフィールドの前にハッシュ (#) 文字を付けます。

1. Smooks フィルター操作ごとの検証失敗の最大数を設定できます。(この最大値を超えると、例外が出力されます。) OnFail.FATAL で設定された検証は、常に例外を出力し、処理を停止します。
   検証失敗の最大数を設定するには、次のコードを Smooks 設定に追加します。

   <params>
       <param name="validation.maxFails">5</param>
   </params>
   

   Copy to Clipboard Toggle word wrap
2. 検証設定の onFail 属性は、実行するアクションを指定します。これは、検証の失敗を報告する方法を決定します。これを利用するには、必要に応じて、次のオプションを変更します。
   • OK: これを使用して、検証を OK として保存します。ValidationResults.getOks を呼び出すと、すべての検証警告が返されます。このオプションはコンテンツベースのルーティングに役立ちます。
   • WARN: これを使用して、検証を警告として保存します。ValidationResults.getWarnings を呼び出すと、すべての検証警告が返されます。
   • ERROR: これを使用して、検証をエラーとして保存します。ValidationResults.getErrors を呼び出すと、すべての検証エラーが返されます。
   • FATAL: これを使用して、検証の失敗が発生するとすぐに、ValidationException を出力します。ValidationResults.getFatal を呼び出すと、致命的な検証の失敗が表示されます。

• ルールベースには、次の形式の複合ルール名を使用します。

  <ruleProviderName>.<ruleName>
  

  Copy to Clipboard Toggle word wrap
  • ruleProviderName は、ルールプロバイダーを識別し、ruleBase 要素の name 属性にマッピングします。
  • ruleName は、ルールプロバイダーが認識している特定のルールを識別します。これは、src ファイルに定義されたルールである可能性があります。

• 検証ルールを実行するには、例のルートフォルダーに移動し、次を実行します。
  1. mvn clean install
  2. mvn exec:java

1. 注文メッセージを処理する際は、多くの検証を行う必要があります。まず、指定されたユーザー名が大文字の後に 5 桁の数字が続く形式 (たとえば、S12345 または G54321) に従っていることを確認します。この検証を実行するには、正規表現を使用する必要があります。
2. 次に、提供された電子メールアドレスが有効な形式であることを確認します。正規表現を使用して、確認します。
3. 各注文品目の productId フィールドが正確に 3 桁の形式 (123 など) に従っていることを確認します。これを行うには、正規表現を使用します。
4. 最後に、注文品目ごとの合計が 50.00 を超えていないことを確認する必要があります (価格 * 数量は 50.00 を超えていません)。MVEL 式を使用して、この検証を実行します。

1. ルールセットで MVEL 式を使用するには、Regex ルールを分割し、2 つの個別の .properties ファイルに配置します。
2. これらのルールを rules サンプルディレクトリーにドロップします。
3. MVEL 式を rules ディレクトリー内の .csv ファイルに配置します。
   customer.properties ファイルに含まれる顧客関連の Regex ルールは次のようになります。

   # Customer data rules...
   customerId=[A-Z][0-9]{5}
    
   # Email address...
   email=^[\\w-\\.]+@([\\w-]+\\.)+[\\w-]{2,4}$
   

   Copy to Clipboard Toggle word wrap
4. 製品関連の Regex ルールを product.properties ファイルに挿入します。

   # Product data rules...
   productId=[0-9]{3}
   

   Copy to Clipboard Toggle word wrap
5. order-rules.csv ファイルに、注文品目の合計チェックを実行するための MVEL 式を挿入します。
   注記
   .csv ファイルを編集する最も簡単な方法は、LibeOffice Calc や Gnumeric などのスプレッドシートアプリケーションを使用することです。
6. ルールソースファイルごとにリソースバンドルの .properties ファイルを作成します。
   注記
   これらのファイルの名前は、対応するルールファイルの名前から派生しています。
   rules/customer.properties に定義されたルールのメッセージバンドルは、rules/i18n/customer.properties ファイルにあります。

   customerId=ftl:Invalid customer number '${ruleResult.text}' at '${path}'.  
   <!--  Customer number must begin with an uppercase character, followed by 5 digits. -->
   email=ftl:Invalid email address '${ruleResult.text}' at '${path}'.  
   <!--  Email addresses match pattern '${ruleResult.pattern}'. -->
   

   Copy to Clipboard Toggle word wrap
   rules/product.properties に定義されたルールのメッセージバンドルは、rules/i18n/product.properties ファイルにあります。

   # Product data rule messages...
   productId=ftl:Invalid product ID '${ruleResult.text}' at '${path}'. 
   <!--  Product ID must match pattern '${ruleResult.pattern}'. -->
   

   Copy to Clipboard Toggle word wrap
   rules/order-rules.csv に定義されたルールのメッセージバンドルは、rules/i18n/order-rules.properties ファイルにあります。

   # <!--  Order item rule messages. The "orderDetails" and "orderItem" beans are populated by Smooks bindings - see config in following section. -->
   order_item_total=ftl:Order ${orderDetails.orderId} 
   <!-- contains an order item for product ${orderItem.productId} with a quantity of ${orderItem.quantity} and a unit price of ${orderItem.price}. This exceeds the permitted per order item total. -->
   

   Copy to Clipboard Toggle word wrap
7. この検証をルールに適用します。

   <?xml version="1.0"?>
   <smooks-resource-list xmlns="http://www.milyn.org/xsd/smooks-1.1.xsd"
                         xmlns:rules="http://www.milyn.org/xsd/smooks/rules-1.0.xsd"
                         xmlns:validation="http://www.milyn.org/xsd/smooks/validation-1.0.xsd"
                         xmlns:jb="http://www.milyn.org/xsd/smooks/javabean-1.2.xsd">
    
       <params>
           <!-- Generate a ValidationException if we get more than 5 validation failures... -->
           <param name="validation.maxFails">5</param>
       </params>
    
       <!-- Define the ruleBases that are used by the validation rules... -->
       <rules:ruleBases>
           <!-- Field value rules using regex... -->
           <rules:ruleBase name="customer" src="rules/customer.properties" provider="org.milyn.rules.regex.RegexProvider"/>
           <rules:ruleBase name="product" src="rules/product.properties" provider="org.milyn.rules.regex.RegexProvider"/>
    
           <!-- Order business rules using MVEL expressions... -->
           <rules:ruleBase name="order" src="rules/order-rules.csv" provider="org.milyn.rules.mvel.MVELProvider"/>
       </rules:ruleBases>
    
       <!-- Capture some data into the bean context - required by the business rule validations... -->
       <jb:bean beanId="orderDetails" class="java.util.HashMap" createOnElement="header">
           <jb:value data="header/*"/>
       </jb:bean>
       <jb:bean beanId="orderItem" class="java.util.HashMap" createOnElement="order-item">
           <jb:value data="order-item/*"/>
       </jb:bean>
    
       <!-- Target validation rules... -->
       <validation:rule executeOn="header/username" name="customer.customerId" onFail="ERROR"/>
       <validation:rule executeOn="email" name="customer.email" onFail="WARN"/>
       <validation:rule executeOn="order-item/productId" name="product.productId" onFail="ERROR"/>
    
       <validation:rule executeOn="order-item" name="order.order_item_total" onFail="ERROR"/>
    
   </smooks-resource-list>
   

   Copy to Clipboard Toggle word wrap
8. 次のコードを使用して、例の Main クラスから実行します。

   protected static ValidationResult runSmooks(final String messageIn) throws IOException, SAXException, SmooksException {
       // Instantiate Smooks with the config...
       final Smooks smooks = new Smooks("smooks-config.xml");
    
       try {
           // Create an exec context - no profiles....
           final ExecutionContext executionContext = smooks.createExecutionContext();
           final ValidationResult validationResult = new ValidationResult();
    
           // Configure the execution context to generate a report...
           executionContext.setEventListener(new HtmlReportGenerator("target/report/report.html"));
    
           // Filter the input message...
           smooks.filterSource(executionContext, new StringSource(messageIn), validationResult);
    
           return validationResult;
       }
       finally {
           smooks.close();
       }
   }
   

   Copy to Clipboard Toggle word wrap

1. Order XML メッセージを使用して、完全な XML to Java バインド設定を確認します。その XML メッセージから入力する必要がある Java オブジェクトは次のとおりです (ゲッターとセッターは示されていません)。

   public class Order {
       private Header header;
       private List<OrderItem> orderItems;
   }
    
   public class Header {
       private Date date;
       private Long customerNumber;
       private String customerName;
       private double total;
   }
    
   public class OrderItem {
       private long productId;
       private Integer quantity;
       private double price;
   }
   

   Copy to Clipboard Toggle word wrap
2. この設定を使用して、注文 XML からオブジェクトモデルにデータをバインドします。

   <?xml version="1.0"?>
   <smooks-resource-list xmlns="http://www.milyn.org/xsd/smooks-1.1.xsd" xmlns:jb="http://www.milyn.org/xsd/smooks/javabean-1.4.xsd">
    
   (1)   <jb:bean beanId="order" class="com.acme.Order" createOnElement="order">
   (1.a)     <jb:wiring property="header" beanIdRef="header" />
   (1.b)     <jb:wiring property="orderItems" beanIdRef="orderItems" />
         </jb:bean>
    
   (2)   <jb:bean beanId="header" class="com.acme.Header" createOnElement="order">
   (2.a)     <jb:value property="date" decoder="Date" data="header/date">
                 <jb:decodeParam name="format">EEE MMM dd HH:mm:ss z yyyy</jb:decodeParam>
             </jb:value>
   (2.b)     <jb:value property="customerNumber" data="header/customer/@number" />
   (2.c)     <jb:value property="customerName" data="header/customer" />
   (2.d)     <jb:expression property="total" execOnElement="order-item" >
                 += (orderItem.price * orderItem.quantity);
             </jb:expression>
         </jb:bean>
    
   (3)   <jb:bean beanId="orderItems" class="java.util.ArrayList" createOnElement="order">
   (3.a)     <jb:wiring beanType="com.acme.OrderItem" /> <!-- Could also wire using beanIdRef="orderItem" -->
         </jb:bean>
    
   (4)   <jb:bean beanId="orderItem" class="com.acme.OrderItem" createOnElement="order-item">
   (4.a)     <jb:value property="productId" data="order-item/product" />
   (4.b)     <jb:value property="quantity" data="order-item/quantity" />
   (4.c)     <jb:value property="price" data="order-item/price" />
         </jb:bean>
    
   </smooks-resource-list>
   

   Copy to Clipboard Toggle word wrap

1. 次のように、入力メッセージのデータに基づいて、異なる値をオブジェクトモデルにバインドするように、マッピングデコーダーを設定します。

   <jb:value property="name" decoder="Mapping" data="history/@warehouse">
       <jb:decodeParam name="1">Dublin</jb:decodeParam>
       <jb:decodeParam name="2">Belfast</jb:decodeParam>
       <jb:decodeParam name="3">Cork</jb:decodeParam>
   </jb:value>
   

   Copy to Clipboard Toggle word wrap
2. 入力データ値 1 は、name プロパティに値 Dublin としてマッピングされます。値 2 と 3 についても同様です。

1. 次の例では、入力メッセージのヘッダー/優先度フィールドに、LOW、MEDIUM、および HIGH の値が含まれています。これらを、それぞれ NOT_IMPORTANT、IMPORTANT、および VERY_IMPORTANT の LineOrderPriority 列挙型の値にマッピングする必要があります。

   <jb:value property="priority" data="header/priority" decoder="Enum">
       <jb:decodeParam name="enumType">example.trgmodel.LineOrderPriority</jb:decodeParam>
       <jb:decodeParam name="LOW">NOT_IMPORTANT</jb:decodeParam>
       <jb:decodeParam name="MEDIUM">IMPORTANT</jb:decodeParam>
       <jb:decodeParam name="HIGH">VERY_IMPORTANT</jb:decodeParam>
   </jb:value>
   

   Copy to Clipboard Toggle word wrap
2. マッピングが必要な場合は、enumType decodeParam を使用して、列挙型を指定します。