6.6.2 永続性ユニットの共有キャッシュ

永続性ユニットはEntityクラスごとに共有キャッシュを管理しています。このキャッシュはすべての永続性コンテキストから参照できます。
このキャッシュのライフサイクルは永続性ユニットと同じなので、エンティティマネージャファクトリの作成からクローズまで使用されます。

以下に永続性ユニットの共有キャッシュの特徴を説明します。

共有キャッシュの参照タイミング

共有キャッシュの参照タイミングについては、「6.6.1 永続性コンテキストキャッシュ」を参照してください。

共有キャッシュの更新タイミング

永続性コンテキストをクローズする時、キャッシュ内のEntityインスタンスがコピーされ、共有キャッシュにマージされます。

以下に、永続性コンテキストキャッシュと共有キャッシュの関係図と検索順番を示します。

クライアントからの要求により検索メソッドが実行される場合、まずは永続性コンテキストキャッシュから検索します。
永続性コンテキストキャッシュにある場合、そのEntityインスタンスを返却します。ない場合は共有キャッシュを検索します。
共有キャッシュにある場合、そのEntityインスタンスのコピーを作成してコピーを永続性コンテキストキャッシュに格納し、アプリケーションに返却します。共有キャッシュにもない場合、データベースへ問い合わせします。

データ更新の場合は、共有キャッシュ内のデータとデータベースのデータの整合性を保つために、キャッシュ機能を行のロック機能と合わせて使用してください。行のロック機能については、「2.11.7 行のロック機能」を参照してください。

共有キャッシュの解放タイミング

共有キャッシュ内に格納されているEntityインスタンスはエンティティマネージャファクトリがクローズされるタイミングで解放されます。コンテナ管理のエンティティマネージャを使用した場合、アプリケーションの停止時にエンティティマネージャファクトリがクローズされます。チューニング設定により、Entityインスタンスがガーベッジコレクション(以降、GC)により破棄されます。

以下に、共有キャッシュに格納されるEntityインスタンスがGC対象になるタイミングを制御するオプションを説明します。
この永続性ユニットプロパティを、deployment descriptor (persistence.xml)またはjavax.persistence.PersistenceのcreateEntityManagerFactory(String, Map)メソッドに指定してください。

プロパティ名	値 (太字:省略値)	説明
eclipselink.cache.type.<ENTITY>	Full Weak HardWeak SoftWeak	特定のEntityに対応する共有キャッシュのタイプです。
eclipselink.cache.type.default	Full Weak HardWeak SoftWeak	その他のEntityの共有キャッシュのタイプです。
eclipselink.cache.size.<ENTITY>	0～MAX_INTEGER 省略値:100	特定のEntityに対応する共有キャッシュタイプによるサイズです。
eclipselink.cache.size.default	0～MAX_INTEGER 省略値:100	その他のEntityの共有キャッシュタイプによるサイズです。
eclipselink.cache.shared.<ENTITY>	true false	特定のEntityに対応する共有キャッシュを有効・無効にします。
eclipselink.cache.shared.default	true false	その他のEntityの共有キャッシュを有効・無効にします。

値は大文字と小文字を区別します。

プロパティの<ENTITY>に、Entity名またはパッケージ名を含むEntityクラス名を記載します。定義しないEntityには、defaultを記載したプロパティの設定または省略値が使用されます。

フィールドの更新を行わずにテーブルからいつも最新の情報を取得したい場合は、共有キャッシュを無効にしますが、一般的には共有キャッシュを無効にする必要はありません。
特定のEntityに対応する共有キャッシュを無効にした場合、データの一貫性を保つためにそのEntityとrelationshipが持つEntityの共有キャッシュも無効にしてください。

各共有キャッシュタイプについて以下に説明します。

キャッシュタイプ	意味	推奨条件
Full	Entityは削除されない限りメモリからフラッシュされません。指定したキャッシュサイズは初期サイズとして使用され、上限サイズの設定はありません。	データが少なく、メモリが多い場合に使用します。
Weak	弱い参照(java.lang.ref.WeakReference)でEntityインスタンスを参照することにより、Fullよりメモリ使用量が少なくなります。指定したキャッシュサイズは初期サイズとして使用され、上限サイズの設定はありません。	Java VM上でオブジェクトの参照がなくなるとEntityインスタンスがGCにより破棄される可能性があるため、開始したトランザクションがサーバー側で継続される場合だけ使用します。
HardWeak	Weakに似ていますが、ハード参照を参照するサブキャッシュも持っています。サブキャッシュサイズを超えると使用頻度が低いEntityインスタンスがサブキャッシュから弱い参照を使用しているキャッシュに移動されます。指定したキャッシュサイズはサブキャッシュに格納するEntityインスタンスの最大数です。	ハード参照されるEntityインスタンスが破棄されないため、キャッシュするインスタンスの最大数をトランザクション中に参照するEntityインスタンスの最大数と同じに設定してください。
SoftWeak	HardWeakとほぼ同じですが、サブキャッシュにソフト参照(java.lang.ref.SoftReference)を使用しています。指定したキャッシュサイズはサブキャッシュに格納するEntityインスタンスの最大数です。	通常の環境でこのタイプを使用します。キャッシュするインスタンスの最大数をトランザクション中に参照するEntityインスタンスの最大数と同じに設定してください。アプリケーションの運用でサブキャッシュにキャッシュされるオブジェクトが頻繁にGCにより破棄される場合、HardWeakの使用を検討してください。

例

共有キャッシュタイプの定義例

  <persistence xmlns="http://java.sun.com/xml/ns/persistence"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://java.sun.com/xml/ns/persistence
          http://xmlns.jcp.org/xml/ns/persistence/persistence_2_1.xsd"
      version="2.1">
    <persistence-unit name="com.company.my.pu">
      <jta-data-source>jdbc/myDatasource</jta-data-source>
      <properties>
        <property name="eclipselink.cache.type.CountryCode" value="Full"/>
        <property name="eclipselink.cache.size.CountryCode" value="100"/>
        <property name="eclipselink.cache.shared.StockQuote" value="false"/>
        <property name="eclipselink.cache.size.default" value="200"/>
      </properties>
    </persistence-unit>
  </persistence>

JPA2.0以降、以下の2つのチューニングオプションが追加されました。

shared-cache-mode
Cache mode properties