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

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

〈この項の構成〉

(1)　WARファイル（Servlet 4.0/Servlet 3.1/Servlet 3.0対応）
(2)　WARファイル（Servlet 2.5対応）
(3)　EJB-JARファイル（EJB3.1/EJB3.0対応）
(4)　ライブラリJARのServlet/JSP仕様のクラス
(5)　ライブラリJARのその他のクラス

(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ファイル	タグハンドラ		タグライブラリイベントリスナ
	サーブレット	サーブレット（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ファイル	タグハンドラ		タグライブラリイベントリスナ
	サーブレット	サーブレットフィルタ	イベントリスナ	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	インターセプタ
	インタフェース	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ファイル	タグハンドラ		タグライブラリイベントリスナ
	サーブレット	サーブレット（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	インターセプタ	インターセプタ（CDI対象）	例外クラス	その他のクラス
@PersistenceContext	−	−	−	−	○^※	○	−	○
@PersistenceContexts	−	−	−	−	○^※	×	−	−
@PersistenceProperty	−	−	−	−	○^※	○	−	○
@PersistenceUnit	−	−	−	−	○^※	○	−	○
@PersistenceUnits	−	−	−	−	○^※	×	−	−

（凡例）

○：対応する。

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

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

注※

ページの先頭へ

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

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

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

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

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

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

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

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

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

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

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

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