Cache configuration

From Resin 3.0

Revision as of 06:53, 7 March 2006 by Cpufreak04 (Talk | contribs)
Jump to: navigation, search

See Proxy Caching for Resin's proxy caching. Documentation is at



The <cache> tag in the <server> block enables and configures the proxy cache. If the <cache> tag is missing, then caching is disabled.

Attribute Description default
path Location of the cache file cache/cache.db
enable True if the cache is enabled true
enable-range True if the cache should support HTTP Range requests true
entries Number of LRU entries in the cache 8192
memory-size How much memory to allocate to memory buffers 8M
max-entry-size Largest page size to be cached 1M
disk-size The maximum size of the cache 2G

The sizes use the Bytes Configuration syntax for the sizes.


<resin xmlns="">
    <cache path="cache" memory-size="32M"/>


<cache-mapping> sets the Expires or Cache-Control: max-age headers on a cacheable page. Non-cacheable pages or pages with Expires headers or Cache-Control: max-age are not affected.

A cacheable page is a page with an Last-Modified or an ETag header. Resin's FileServlet, for example, sets both headers but does not set an Expires tag.

In other words, a JSP page or servlet that does not set any headers will not be affected by <cache-mapping> (since Resin doesn't consider it cacheable.)

<cache-mapping> uses the Period Configuration for its expire time.


<web-app xmlns="">
  <cache-mapping url-pattern="*.html" expires="60s"/>

Personal tools