4 JPA問合せのカスタマイズ拡張機能

次を使用して、EclipseLink問合せヒント(JPA問合せの拡張機能)を指定できます。

• @QueryHint注釈の使用

• orm.xmlまたはeclipselink-orm.xmlファイルへのヒントの組込み

• 名前付き問合せや動的問合せ(JPQLまたは基準)の実行時におけるsetHint()メソッドの使用

Oracle TopLinkでは、次のEclipseLink問合せヒントがサポートされています。

• batch

• batch.size

• batch.type

• cache-usage

• cache-usage.indirection-policy

• composite-unit.member

• cursor

• cursor.initial-size

• cursor.page-size

• exclusive-connection

• fetch-group

• fetch-group.attribute

• fetch-group.default

• fetch-group.load

• fetch-group.name

• flush

• history.as-of

• history.as-of.scn

• inheritance.outer-join

• jdbc.allow-native-sql-queries

• jdbc.bind-parameters

• jdbc.cache-statement

• jdbc.fetch-size

• jdbc.first-result

• jdbc.max-rows

• jdbc.native-connection

• jdbc.parameter-delimiter

• jdbc.timeout

• join-fetch

• left-join-fetch

• load-group

• load-group.attribute

• maintain-cache

• partitioning

• pessimistic-lock

• prepare

• query-results-cache

• query-results-cache.expiry

• query-results-cache.expiry-time-of-day

• query-results-cache.ignore-null

• query-results-cache.randomize-expiry

• query-results-cache.size

• query-results-cache.type

• query-type

• query.redirection

• read-only

• refresh

• refresh.cascade

• result-collection-type

• sql.hint

すべてのEclipseLink問合せヒントは、org.eclipse.persistence.config package内のQueryHintsクラスに定義されています。ヒントを設定する場合は、org.eclipse.persistence.configパッケージ内の適切な構成クラスでpublic static finalフィールドを使用して、次のような値を設定できます。

• HintValues

• CacheUsage

• PessimisticLock

• QueryType

詳細は、次を参照してください。

• 『Oracle TopLinkの理解』の問合せヒントに関する項

• 『Oracle TopLinkソリューション・ガイド』の問合せに関する項

• JPA仕様(http://jcp.org/en/jsr/detail?id=317)の10.3.1項、NamedQuery注釈に関する項