10.2.4. JPA キャッシュストア

手順

1. 永続性ユニット "myPersistenceUnit" を persistence.xml で定義します。

   <persistence-unit name="myPersistenceUnit">
   	...
   </persistence-unit>

2. ユーザーエンティティークラスを作成します。

   @Entity
   public class User implements Serializable {
   	@Id
   	private String username;
   	private String firstName;
   	private String lastName;
   
   	...
   }

3. JPA キャッシュストアで"usersCache"という名前のキャッシュを設定します。

   キャッシュ usersCache を設定して JPA キャッシュストアを使用するように設定できます。これにより、データをキャッシュに配置すると、JPA 設定を基にデータがデータベースに永続化されます。

   EmbeddedCacheManager cacheManager = ...;
   
   Configuration cacheConfig = new ConfigurationBuilder().persistence()
               .addStore(JpaStoreConfigurationBuilder.class)
               .persistenceUnitName("org.infinispan.loaders.jpa.configurationTest")
               .entityClass(User.class)
               .build();
   cacheManager.defineCache("usersCache", cacheConfig);
   
   Cache<String, User> usersCache = cacheManager.getCache("usersCache");
   usersCache.put("raytsang", new User(...));

   • JPA キャッシュストアを使用するキャッシュは、以下の例のように、1 種類のデータのみを保存できます。

     Cache<String, User> usersCache = cacheManager.getCache("myJPACache");
     // Cache is configured for the User entity class
     usersCache.put("username", new User());
     // Cannot configure caches to use another entity class with JPA cache stores
     Cache<Integer, Teacher> teachersCache = cacheManager.getCache("myJPACache");
     teachersCache.put(1, new Teacher());
     // The put request does not work for the Teacher entity class

   • @EmbeddedId アノテーションでは、以下の例のように複合キーを使用できます。

     @Entity
     public class Vehicle implements Serializable {
     	@EmbeddedId
     	private VehicleId id;
     	private String color;	...
     }
     
     @Embeddable
     public class VehicleId implements Serializable
     {
     	private String state;
     	private String licensePlate;
     	...
     }