第378章 XStream DataFormat
Camel バージョン 1.3 以降で利用可能
XStream は、XStream ライブラリー を使用して Java オブジェクトを XML との間でマーシャリングおよびアンマーシャリングするデータ形式です。
camel ルートで XStream を使用するには、このデータ形式を実装する camel-xstream に依存関係を追加する必要があります。
Maven ユーザーは、このコンポーネントの pom.xml に以下の依存関係を追加する必要があります。
<dependency> <groupId>org.apache.camel</groupId> <artifactId>camel-xstream</artifactId> <version>x.x.x</version> <!-- use the same version as your Camel core version --> </dependency>
378.1. オプション
XStream データ形式は、以下に示す 10 個のオプションをサポートしています。
| 名前 | デフォルト | Java タイプ | 説明 |
|---|---|---|---|
| permissions |
| xml/json から Java Bean へのアンマーシャリング中に使用できる Java パッケージおよびクラス XStream を制御するパーミッションを追加します。パーミッションは、JVM システムプロパティーを使用して、この場所またはグローバルに設定する必要があります。パーミッションは、プラス記号が許可で、マイナス記号が拒否である構文で指定できます。ワイルドカードは . を接頭辞として使用することでサポートされます。たとえば、com.foo およびすべてのサブパッケージを許可するには、com.foo を指定します。複数のパーミッションは、com.foo.,-com.foo.bar.MySecretBean のようにコンマで区切ることができます。以下のデフォルトパーミッションは常に、キー org.apache.camel.xstream.permissions で JVM システムプロパティーを指定して上書きされない限り、-,java.lang.,java.util. が含まれます。 | |
| encoding |
| 使用するエンコーディングを設定します | |
| driver |
| カスタム XStream ドライバーを使用するには。インスタンスのタイプは com.thoughtworks.xstream.io.HierarchicalStreamDriver でなければなりません | |
| driverRef |
| カスタム XStream ドライバーを参照して、レジストリーを検索します。インスタンスのタイプは com.thoughtworks.xstream.io.HierarchicalStreamDriver でなければなりません | |
| mode |
| 重複参照を処理するモード。設定可能な値は以下の通りです: NO_REFERENCES ID_REFERENCES XPATH_RELATIVE_REFERENCES XPATH_ABSOLUTE_REFERENCES SINGLE_NODE_XPATH_RELATIVE_REFERENCES SINGLE_NODE_XPATH_ABSOLUTE_REFERENCES | |
| converters |
| カスタム XStream コンバーターを使用するためのクラス名のリスト。クラスは com.thoughtworks.xstream.converters.Converter 型でなければなりません | |
| aliases |
| クラスを XML 要素で使用する短い名前にエイリアスします。 | |
| omitFields |
| フィールドがシリアライズされないようにします。フィールドを省略するには、宣言する型を常に指定する必要があり、必ずしも変換される型を指定する必要はありません。 | |
| implicitCollections |
| マップされていない XML タグに使用される既定の暗黙的なコレクションを追加します。 | |
| contentTypeHeader |
|
| データフォーマットがデータ形式を実行できる場合は、データフォーマットの型で Content-Type ヘッダーを設定するかどうか。たとえば、XML にマーシャリングするデータ形式の場合は application/xml、JSON にマーシャリングするデータ形式の場合は JSon です。 |
