--- schema_version: "1" id: 4461ea6b9478815887bcee4f5226467a812b4b4c4dd9c6e11532af316476a00b title: XML Module の移行 collection: mulesoft version: current locale: ja-jp portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/mule-runtime/4.9/migration-connectors-xml.md canonical_url: https://docs.mulesoft.com/jp/mule-runtime/4.9/migration-connectors-xml source_site: docs.mulesoft.com content_type: documentation content_hash: ac81fe6cb8008f3ff31a05c9e992801f88c64b3859d9239d01f8545741a3b596 description: MuleSoft Documentation Site release: "4.9" latest: false --- # XML Module の移行 Mule 3 にバンドルされていた XML Module が、Mule 4 で新しい XML Module に置き換わります。主な変更は次のとおりです。 - Mule 3.6 で非推奨となったコンポーネント、式、関数、エバリュエーターの削除。 - jxpath-filter - jaxen-filter - jxpath-extractor-transformer - is-xml-filter - xpath-filter - 新しい Mule 4 コンポーネントとの一貫性を保つために、主に次に関して XPath、XSLT、XQuery コンポーネントで行われた変更。 - `mxml`​ から ​`xml-module`​ に変更された DSL 名前空間プレフィックス - 戻り値の型の一貫性 - 構文と UX の変更 - `xpath()`​ 関数と ​`xpath3()`​ 関数が ​`XmlModule::xpath()`​ 関数に置き換わりました。 - スキーマ検証機能のエラーレポートが改善されました。 - `schema-validation-filter`​ が ​`schema-validator`​ に置き換わりました。 - Java との関連付けがなくなり、SAX、StaX、DOM 型は使用されなくなりました。Mule 4 では、厳密に型指定されるようになり、どのデータが XML 形式なのかについて MIME タイプの情報を把握しています。残りは Runtime によって自動的に行われます。すべての XML ドキュメントは、文字列またはストリームのいずれかとして表されます。つまり、次は存在しません (不要になりました)。 - dom-to-xml-transformer - dom-to-output-handler-transformer - xml-to-dom-transformer - xml-prettyprinter-transformer - jaxb-object-to-xml-transformer - jaxb-xml-to-object-transformer - jaxb-context - object-to-xml-transformer - xml-to-object-transformer ## [](#xslt-操作の移行)XSLT 操作の移行 ### [](#外部ファイルでの-xsl-スタイルシートの使用)外部ファイルでの XSL スタイルシートの使用 Mule 3 の例: 外部ファイルでの XSL シートの使用方法 ```xml ``` Mule 4 の場合: Mule 4 の例: 外部ファイルでの XSL シートの使用方法 ```xml ${file:::cities.xslt} ``` ### [](#コンテキストプロパティの使用)コンテキストプロパティの使用 Mule 3 の例: コンテキストプロパティの設定方法 ```xml ``` Mule 4 の例: コンテキストプロパティの設定方法 ```xml ${file::cities.xslt} #[{'output_location': vars.outputFile, 'user_id': vars.userId}] ``` ## [](#xpath-操作と式の移行)XPath 操作と式の移行 ### [](#xpath-抽出器トランスフォーマーの使用)XPath 抽出器トランスフォーマーの使用 XPath extractor (XPath エクストラクター) では、カスタム ​`resultType`​ パラメーターがサポートされなくなりました。一致するすべての要素を含む文字列のリストが常に返されるようになります。 Mule 3 の例: XPath extractor (Xpath エクストラクター) の使用方法 ```xml ``` Mule 4 の例: XPath extractor (Xpath エクストラクター) の使用方法 ```xml ``` ### [](#xpath-式関数の使用)XPath 式関数の使用 Mule 3 には元々、​`xpath()`​ MEL 関数がありました。それが Mule 3.6 で非推奨となり、新しい ​`xpath3()`​ 関数が使用されました。今回は、両方の関数が新しい ​`XmlModule::xpath()`​ DataWeave 関数に置き換わります。これは、アプリケーションにモジュールを追加すると使用可能になります。 Mule 3 の例: xpath3 関数の使用 ```xml ``` Mule 3 の ​`xpath3()`​ 関数では、XPath 式と入力値を指定でき、予期される出力では、​`BOOLEAN`​、​`STRING`​、​`NUMBER`​、​`NODESET`​、または ​`NODE`​ というさまざまなオプションが用意されていました。​`NODESET`​ と ​`NODE`​ の場合は、Java の DOM ツリー表現を理解している必要がありました。 また、新しい関数は XPath 式と入力を受け入れますが、次の点で異なります。 - カスタムコンテキストプロパティのサポートが追加される。 - 出力タイプを指定できない。​``​ と同様に、常に文字列のリストが返される。 Mule 4 の例: xpath 関数の使用 ```xml ```
この関数は、どの DataWeave 変換内でも使用できます。
### [](#カスタム名前空間を指定した-xpath-の使用)カスタム名前空間を指定した XPath の使用 Mule 3 でカスタム名前空間プレフィックスをマップするには ​``​ が必要です。 Mule 3 の例: カスタム名前空間の使用 ```xml ``` このアプローチには、アプリケーションごとに使用できる namespace-manager は 1 つだけという制限があります。Mule 4 では、必要な数だけ ​`namespace-directory`​ 要素を宣言し、各操作で必要なものを参照できます。 Mule 4 の例: カスタム名前空間の使用 ```xml ``` さらに、「namespace-directory」を宣言しないことも可能で、代わりに名前空間をインラインでマップできます。 Mule 4 の例: インラインのカスタム名前空間マッピング ```xml ``` ## [](#xquery-操作の移行)XQuery 操作の移行 主な違いは、Mule 3 ではこのトランスフォーマーの出力タイプは変換の結果に応じて異なるということです。 - 変換で要素が多数生成される場合は、リストが返されます。 - 変換に応じて、そのリストの要素は文字列になるか、​`Node`​ などの汎用 Java 表現になります。 - 変換により要素が 1 つだけ生成される場合は、その要素が返されます。 Mule 4 では、常に文字列のリストが返されます。 それ以外の変更は、構文に関するもののみです。 Mule 3 の例: XQuery トランスフォーマーの使用 ```xml { for $b in $books/BOOKLIST/BOOKS/ITEM, $c in $cities/cities/city return } ]]> ``` Mule 4 の場合: Mule 4 の例: XQuery トランスフォーマーの使用 ```xml { for $b in fn:doc($books)/BOOKLIST/BOOKS/ITEM, $c in fn:doc($cities)/cities/city return } ]]> #[{'books' : vars.books, 'cities': vars.cities}] ``` ## [](#スキーマに対する-xml-の検証)スキーマに対する XML の検証 Mule 3 では、検索条件を使用してスキーマの検証が行われていました。 Mule 3 の例: Schema validation filter (スキーマ検証検索条件) ```xml ``` 検証が失敗すると、メッセージは放棄されます。 Mule 4 では、検索条件がバリデーターに置き換わりました。 Mule 4 の例: スキーマバリデーター ```xml ``` このバリデーターは、​`XML-MODULE:SCHEMA_NOT_HONOURED`​ エラーを発生させます。 ## [](#xml-module-のインストール)XML Module のインストール XML Module を使用するには、Studio のパレットを使用してアプリケーションに追加するか、​`pom.xml`​ ファイルで次の連動関係を追加します。 ```xml org.mule.modules mule-xml-module 1.1.0 mule-plugin ``` ## [](#関連情報)関連情報 - [XML Module](https://docs.mulesoft.com/jp/xml-module/latest/)