8 Understanding Caching

This chapter introduces and describes caching. The EclipseLink cache is an in-memory repository that stores recently read or written objects based on class and primary key values. The cache improves performance by holding recently read or written objects and accessing them in-memory to minimize database access, manage locking and isolation level, and manage object identity.

The entity caching annotations defined by EclipseLink are listed in "Caching Annotations" in Jakarta Persistence API (JPA) Extensions Reference for EclipseLink.

EclipseLink also provides a number of persistence unit properties that you can specify to configure the EclipseLink cache. These properties may compliment or provide an alternative to annotations. For a list of these properties, see "Caching" in Jakarta Persistence API (JPA) Extensions Reference for EclipseLink.

This chapter includes the following sections:

• About Cache Architecture

• About Cache Type and Size

• About Queries and the Cache

• About Handling Stale Data

• About Explicit Query Refreshes

• About Cache Indexes

• Database Event Notification and Oracle CQN

• About Query Results Cache

• About Cache Coordination

• Clustering and Cache Coordination

• Clustering and Cache Consistency

• Cache Interceptors