wildone / sling-caching-filter Goto Github PK

Introduction

Cache bundle is a OSGi bundle that provides caching mechanisms for pages or components. Cache bundle uses for it cache filter.

Installation

Add following dependency to your project:

<dependency>
    <groupId>com.cognifide.cq</groupId>
    <artifactId>sling-caching-filter</artifactId>
    <version>0.9.0-SNAPSHOT</version>
</dependency>

or download the sources and use the maven-sling-plugin:

mvn clean package sling:install

Cache filter

General description

Cache filter is able to cache all pages/renderers/components. It is configured to filter all sling requests on the component level. The only limit is that the whole component is being cached - to cache only a part of a component please use the cache tag.

It is strongly discouraged to enable cache filter on the author instance since this produces issues with CQ js code.

Configuration

Cache filter can be configured in two places: in the OSGi console (filter configuration and components configurations). Under the hood jcache with ehcache are used.

OSGi console - Sling Caching Filter

OSGi console allows to modify the following properties:

• Enabled - enables/disables cache filter
• Validity itme - Maximum default time (in seconds) after which cache entry must be refreshed
• Path aliases - define aliases for paths, syntax $<alias name>|<path 1>|<path 2>|..., where $ is a mandatory character before alias name, and | is a separator between paths
• Max entries in cache - defines max entries in cache, disc and heap. 0 means unlimited.
• Eviction policy - sets eviction policy, possible values: LRU, LFU, FIFO.

OSGi console - Sling Caching Filter Resource Type Definition

OSGi console allows to add configuration per component/resource type.

Allowed values for the Cache level:

• -1 - Each instance is cached separately (resource path is used to create cache key).
• 0 - There is only one instance of the component on the whole site. To determine which instance is cached, the first-renderer rule applies (the first rednered component is cached and used on other pages)
• any positive value - Component is cached per path. The value of cache level determines how many parts of the request URI (separated by the "/" character) will be used to generate cache key. For example, when this value is set to 3 and the path is /content/acme/en_gb/home.html, then only "/content/acme/en_gb" will be used to generate the key meaning that component will be cached per language.

TODOs

Things/ideas left out for the future:

• implement (if ever required) different caching strategies for different selectors
• add configuration of paths that are (or are not) filtered by the cache filter