query-results-cache

eclipselink.query-results-cacheを使用して、問合せで結果キャッシュを使用することを指定します。

値

表4-27は、この永続性プロパティの値を説明しています。

表4-27 query-results-cacheの有効値

Value	説明
`Persistence_Unit_Default`	(デフォルト)
`True`	問合せ結果がキャッシュされます。
`False`	問合せ結果はキャッシュされません。

使用方法

デフォルトでは、問合せにより100個の問合せ結果がキャッシュされますが(「query-results-cache.size」を参照)、同じ引数を含む同じ名前付き問合せが再実行される場合、TopLinkはデータベースをスキップしてキャッシュ結果を返します。

注意:

問合せキャッシュは、オブジェクト・キャッシュに依存しない異なるキャッシュです。

例

例4-54 JPA問合せでのquery-results-cacheの使用

import org.eclipse.persistence.config.HintValues;
 import org.eclipse.persistence.config.QueryHints;
 query.setHint("eclipselink.QUERY_RESULTS_CACHE", "TRUE");

例4-55 @QueryHint注釈でのquery-results-cacheの使用

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

例4-56 orm.xmlファイルでのquery-results-cacheの使用

<?xml version="1.0"?>
<entity-mappings
    xmlns="http://www.eclipse.org/eclipselink/xsds/persistence/orm"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://www.eclipse.org/eclipselink/xsds/persistence/orm     http://www.eclipse.org/eclipselink/xsds/eclipselink_orm_2_4.xsd"
    version="2.4">
    <entity name="Employee" class="org.acme.Employee" access="FIELD">
        <named-query name="findAllEmployeesInCity" query="Select e from Employee e where e.address.city = :city">
            <hint name="eclipselink.query-results-cache" value="true"/>
            <hint name="eclipselink.query-results-cache.size" value="500"/>
        </named-query>
        ...
    </entity>
</entity-mappings>