Hitachi

Cosminexus V11 アプリケーションサーバ リファレンス API編


2.1.7 javax.persistenceパッケージに含まれるアノテーションのサポート範囲

javax.persistenceパッケージのアノテーションの適用範囲を説明します。ここでは,JPAコンテナに依存するアノテーションについて,コンポーネントごとに記述できるアノテーションを説明します。この項に記載がないアノテーションについては,JPA標準仕様およびJPAプロバイダの仕様に依存します。各仕様に依存するアノテーションについては,各仕様のドキュメントを参照してください。

〈この項の構成〉

(1) WARファイル(Servlet 4.0/Servlet 3.1/Servlet 3.0対応)

WARファイルに記述できるアノテーションの一覧を示します。

表2‒19 WARファイル(Servlet 4.0/Servlet 3.1/Servlet 3.0対応)に記述できるアノテーション(javax.persistenceパッケージ)

アノテーション名

Servlet仕様

JSP仕様

インターセプタ(CDI対象)

例外クラス

ManagedBean(JSF)

その他のクラス

サーブレット

サーブレット(API)

サーブレットフィルタ

サーブレットフィルタ(API)

イベントリスナ

イベントリスナ(API)

JSPファイル

タグハンドラ

タグライブラリイベントリスナ

クラシックタグハンドラ

シンプルタグハンドラ

@PersistenceContext

×

@PersistenceContexts

×

×

@PersistenceProperty

×

@PersistenceUnit

×

@PersistenceUnits

×

×

(凡例)

○:対応する。

×:アプリケーションサーバでは対応しない。

−:標準仕様で対応していない。

(2) WARファイル(Servlet 2.5対応)

WARファイルに記述できるアノテーションの一覧を示します。

表2‒20 WARファイル(Servlet 2.5対応)に記述できるアノテーション(javax.persistenceパッケージ)

アノテーション名

Servlet仕様

JSP仕様

その他のクラス

サーブレット

サーブレットフィルタ

イベントリスナ

JSPファイル

タグハンドラ

タグライブラリイベントリスナ

クラシックタグハンドラ

シンプルタグハンドラ

@PersistenceContext

×

@PersistenceContexts

×

@PersistenceProperty

×

@PersistenceUnit

×

@PersistenceUnits

×

(凡例)

○:対応する。

×:アプリケーションサーバでは対応しない。

−:標準仕様で対応していない。

(3) EJB-JARファイル(EJB3.1/EJB3.0対応)

EJB-JARファイルに記述できるアノテーションの一覧を示します。

表2‒21 EJB-JARファイル(EJB3.1/EJB3.0対応)に記述できるアノテーション(javax.persistenceパッケージ)

アノテーション名

Enterprise Bean

インターセプタ(CDI対象)

例外クラス

その他のクラス

インタフェース

Session Bean

Entity Bean

Message-driven Bean

インターセプタ

デフォルトインターセプタ以外

デフォルトインターセプタ

@PersistenceContext

×

@PersistenceContexts

×

×

@PersistenceProperty

×

@PersistenceUnit

×

@PersistenceUnits

×

×

(凡例)

○:対応する。

×:アプリケーションサーバでは対応しない。

−:標準仕様で対応していない。

注※

DIの実行可否は,インターセプタの指定方法やインターセプタメソッドの種類によって非サポートの場合があります。詳細については,マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「15. Interceptors」を参照してください。

(4) ライブラリJARのServlet/JSP仕様のクラス

ライブラリJARのServlet/JSP仕様のクラスに記述できるアノテーションの一覧を示します。

表2‒22 ライブラリJAR(Servlet/JSP)に記述できるアノテーション(javax.persistenceパッケージ)

アノテーション名

Servlet仕様

JSP仕様

サーブレット

サーブレット(API)

サーブレットフィルタ

サーブレットフィルタ(API)

イベントリスナ

イベントリスナ(API)

JSPファイル

タグハンドラ

タグライブラリイベントリスナ

クラシックタグハンドラ

シンプルタグハンドラ

@PersistenceContext

×

@PersistenceContexts

×

@PersistenceProperty

×

@PersistenceUnit

×

@PersistenceUnits

×

(凡例)

○:対応する。

×:アプリケーションサーバでは対応しない。

−:標準仕様で対応していない。

(5) ライブラリJARのその他のクラス

ライブラリJARのその他のクラスに記述できるアノテーションの一覧を示します。

表2‒23 ライブラリJARのその他のクラスに記述できるアノテーション(javax.persistenceパッケージ)

アノテーション名

Enterprise Bean

インターセプタ(CDI対象)

例外クラス

その他のクラス

インタフェース

Session Bean

Entity Bean

Message-driven Bean

インターセプタ

@PersistenceContext

@PersistenceContexts

×

@PersistenceProperty

@PersistenceUnit

@PersistenceUnits

×

(凡例)

○:対応する。

×:アプリケーションサーバでは対応しない。

−:標準仕様で対応していない。

注※

DIの実行可否は,インターセプタの指定方法やインターセプタメソッドの種類によって非サポートの場合があります。詳細については,マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「15. Interceptors」を参照してください。