Set cacheable objects with the cachespec.xml file

 

+

Search Tips   |   Advanced Search

Use this task to define cacheable objects inside cachespec.xml, found inside the Web module WEB-INF or enterprise bean META-INF directory.

Enable the dynamic cache.

We can save a global cachespec.xml in...

APP_ROOT/properties

...but the recommended method is to place the cache configuration file with the deployment module.

The root element of the cachespec.xml file is <cache>.

The <cache-entry> element can be nested within the <cache> element or a <cache-instance> element.

• Elements nested in <cache> are cached in the default cache instance.

• Elements in <cache-instance> are cached in the instance specified by the name attribute.

 

1. Copy...

   WAS_HOME/properties/cachespec.sample.xml

   ...to cachespec.xml in Web module WEB-INF or enterprise bean META-INF directory.

2. Define the cache-entry elements necessary to identify the cacheable objects.

3. Develop cache ID rules.

   To cache an object, WAS must know how to generate unique IDs for different invocations of that object. The <cache-id> element performs that task.

   Each cache entry can have multiple cache-ID rules that run in order until either a rule returns cache-ID not empty or no more rules remain to run. If no cache-ID generation rules produce a valid cache ID, then the object is not cached. Develop the cache IDs in one of two ways:

   • Use the <component> element defined in the cache policy of a cache entry (recommended).

   • Write custom Java code to build the ID from input variables and system state.

     To configure the cache entry to use the ID generator, specify the IdGenerator in the XML file by using the <idgenerator> tag...

     <cache-entry>
         <class>servlet</class>
         <name>/servlet/CommandProcessor</name>
         <cache-id>
             <idgenerator>com.mycompany.SampleIdGeneratorImpl</idgenerator>
             <timeout>60</timeout>
         </cache-id>
     </cache-entry>
     

4. Specify dependency ID rules.

   Use dependency ID elements to specify additional cache group identifiers that associate multiple cache entries to the same group identifier.

   The dependency ID is generated by concatenating the dependency ID base string with the values returned by its component elements. If a required component returns a null value, then the entire dependency ID does not generate and is not used. We can validate the dependency IDs explicitly through the dynamic cache API, or use another cache-entry <invalidation> element.

   Multiple dependency ID rules can exist per cache entry. All dependency ID rules run separately.

5. Invalidate other cache entries as a side effect of this object start, if relevant.

   We can define invalidation rules in exactly the same manner as dependency IDs. However, the IDs that are generated by invalidation rules are used to invalidate cache entries that have those same dependency IDs.

   The invalidation ID is generated by concatenating the invalidation ID base string with the values returned by its component element. If a required component returns a null value, then the entire invalidation ID is not generated and no invalidation occurs. Multiple invalidation rules can exist per cache-entry. All invalidation rules run separately.

6. Ensure the cache policy is working correctly.

   We can modify the policies within the cachespec.xml file while the application is running. The dynamic cache reloads the updated file automatically. If caching static content and we are adding the cache policy to an application for the first time, restart the application. You do not need to restart the appserver to activate the new cache policy.

 

Next steps

Typically you declare several <cache-entry>< elements inside a cachespec.xml file.

When new versions of the cachespec.xml are detected, the old policies are replaced. Objects that cached through the old policy file are not automatically invalidated from the cache; they are either reused with the new policy or eliminated from the cache through its replacement algorithm.

For each of the three IDs (cache, dependency, invalidation) generated by cache entries, a <cache-entry> can contain multiple elements. The dynamic cache runs the <cache-id> rules in order, and the first one that successfully generates an ID is used to cache that output. If the object is to be cached, each one of the <dependency-id> elements is run to build a set of dependency IDs for that cache entry. Finally, each of the <invalidation> elements are run, building a list of IDs that the dynamic cache invalidates, whether or not this object is cached.

Verifying the cacheable page
cachespec.xml file

 

Related tasks

Task overview: Using the dynamic cache service to improve performance

 

Related information

Additional APIs