第181章 JPA コンポーネント

Camel バージョン 1.0 以降で利用可能

jpa コンポーネントを使用すると、EJB 3 の Java Persistence Architecture (JPA) を使用して永続ストレージから Java オブジェクトを格納および取得できます。JPA は、OpenJPA、Hibernate、TopLink などのオブジェクト/リレーショナルマッピング (ORM) 製品をラップする標準インターフェイス層です。

Maven ユーザーは、このコンポーネントの pom.xml に以下の依存関係を追加する必要があります。 

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-jpa</artifactId>
    <version>x.x.x</version>
    <!-- use the same version as your Camel core version -->
</dependency>

181.1. エンドポイントへの送信

Java エンティティー Bean を JPA プロデューサーエンドポイントに送信することにより、データベースに格納できます。In メッセージのボディーは、エンティティー Bean (つまり、@Entity アノテーションが付けられた POJO) またはエンティティー Bean のコレクションまたは配列であると想定されます。

ボディーがエンティティーのリストである場合は、プロデューサーエンドポイントに渡される設定として entityType=java.util.ArrayList を必ず使用してください。

本文に前にリストされたタイプのいずれも含まれていない場合は、エンドポイントの前に Message Translator を配置して、最初に必要な変換を実行します。

Camel 2.19 以降では、プロデューサーにも query、namedQuery または nativeQuery を使用できます。また、parameters の値では、メッセージボディー、ヘッダーなどからパラメーター値を取得できる単純な式を使用できます。これらのクエリーは、SELECT JPQL/SQL ステートメントを使用した一連のデータの取得、および UPDATE/DELETE JPQL/SQL ステートメントを使用した一括更新/削除の実行に使用できます。camel は query や nativeQuery とは異なり、名前付きクエリーを調べないため、namedQuery で UPDATE/DELETE を実行する場合は、useExecuteUpdate を true に指定する必要があることに注意してください。