jdbc.bind-parameters

eclipselink.jdbc.bind-parametersを使用して、問合せでパラメータ・バインド(パラメータ化されたSQL)を使用するかどうかを指定します。

値

表4-13は、この問合せヒントの有効値を説明しています。

表4-13 org.eclipse.persistence.config.HintValuesの有効値

Value	説明
`TRUE`	すべてのパラメータがバインドされます。
`FALSE`	すべてのパラメータがバインドされるわけではありません。
`PERSISTENCE_UNIT_DEFAULT`	(デフォルト) EclipseLinkセッションのデータベース・ログイン時に行ったパラメータ・バインド設定が使用されます(デフォルトではtrue)。

使用方法

デフォルトでは、Oracle TopLinkでのパラメータ・バインドおよび文のキャッシュは有効化されています。これにより、Oracle TopLinkではプリコンパイルされた文を使用し、すべてのSQLパラメータをバインドして、プリコンパイルされた文をキャッシュします。この問合せを再実行するときにはSQLのプリコンパイルが不要になるため、パフォーマンスが向上します。

persistence.xmlファイルで、永続性ユニットのパラメータ・バインドを構成することもできます(Java SE環境で使用する場合)。

例

例4-27に、JPA問合せでこのヒントを使用する方法を示します。

例4-27 JPA問合せでのbind-parametersの使用

import org.eclipse.persistence.config.HintValues;
 import org.eclipse.persistence.config.QueryHints;
 query.setHint(QueryHints.BIND_PARAMETERS, HintValues.TRUE);

例4-28に、@QueryHint注釈でこのヒントを使用する方法を示します。

例4-28 @QueryHint注釈でのbind-parametersの使用

import org.eclipse.persistence.config.HintValues;
 import org.eclipse.persistence.config.TargetDatabase;
 @QueryHint(name=QueryHints.BIND_PARAMETERS, value=HintValues.TRUE);

例4-29に、永続性ユニットpersistence.xmlファイルでパラメータ・バインドを構成する方法を示します。

例4-29 パラメータ・バインド永続性ユニット・プロパティの指定

<property name="eclipselink.jdbc.bind-parameters" value="false"/>

または、次のようにpropertyマップをインポートします。

import org.eclipse.persistence.config.PersistenceUnitProperties;
propertiesMap.put(PersistenceUnitProperties.NATIVE_SQL, "true");