com.gargoylesoftware.htmlunit
Class Cache

java.lang.Object
  com.gargoylesoftware.htmlunit.Cache

All Implemented Interfaces:

Serializable

public class Cache
extends Object
implements Serializable

Simple cache implementation which caches compiled JavaScript files and parsed CSS snippets. Caching compiled JavaScript files avoids unnecessary web requests and additional compilation overhead, while caching parsed CSS snippets avoids very expensive CSS parsing.

Version:

$Revision: 5724 $

Author:

Marc Guillemot, Daniel Gredler

See Also:

Serialized Form

Constructor Summary

Cache()

Method Summary

void	cache(String css, org.w3c.dom.css.CSSStyleSheet styleSheet) Caches the parsed version of the specified CSS snippet.
void	cacheIfPossible(WebRequest request, WebResponse response, Object toCache) Caches the specified object, if the corresponding request and response objects indicate that it is cacheable.
void	clear() Clears the cache.
protected void	deleteOverflow() Truncates the cache to the maximal number of entries.
Object	getCachedObject(WebRequest request) Returns the cached object corresponding to the specified request.
org.w3c.dom.css.CSSStyleSheet	getCachedStyleSheet(String css) Returns the cached parsed version of the specified CSS snippet.
int	getMaxSize() Returns the cache's maximum size.
int	getSize() Returns the number of entries in the cache.
protected boolean	isCacheable(WebRequest request, WebResponse response) Determines if the specified response can be cached.
protected boolean	isDynamicContent(WebResponse response) Tries to guess if the content is dynamic or not.
protected boolean	isJavaScript(WebResponse webResponse) Returns true if the provided response is JavaScript content.
protected Date	parseDateHeader(WebResponse response, String headerName) Parses and returns the specified date header of the specified response.
void	setMaxSize(int maxSize) Sets the cache's maximum size.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Cache

public Cache()

Method Detail

cacheIfPossible

public void cacheIfPossible(WebRequest request,
                            WebResponse response,
                            Object toCache)

Caches the specified object, if the corresponding request and response objects indicate that it is cacheable.

Parameters:

request - the request corresponding to the specified compiled script

response - the response corresponding to the specified compiled script

toCache - the object that is to be cached, if possible (may be for instance a compiled script or simply a WebResponse)

cache

public void cache(String css,
                  org.w3c.dom.css.CSSStyleSheet styleSheet)

Caches the parsed version of the specified CSS snippet. We key the cache based on CSS snippets (rather than requests and responses as is done above) because a) this allows us to cache inline CSS, b) CSS is extremely expensive to parse, so we want to avoid it as much as possible, c) CSS files aren't usually nearly as large as JavaScript files, so memory bloat won't be too bad, and d) caching on requests and responses requires checking dynamicity (see isDynamicContent(WebResponse)), and headers often aren't set up correctly, disallowing caching when in fact it should be allowed.

Parameters:

css - the CSS snippet from which styleSheet is derived

styleSheet - the parsed version of css

deleteOverflow

protected void deleteOverflow()

Truncates the cache to the maximal number of entries.

isCacheable

protected boolean isCacheable(WebRequest request,
                              WebResponse response)

Determines if the specified response can be cached.

Parameters:

request - the performed request

response - the received response

Returns:

true if the response can be cached

isDynamicContent

protected boolean isDynamicContent(WebResponse response)

Tries to guess if the content is dynamic or not.

"Since origin servers do not always provide explicit expiration times, HTTP caches typically assign heuristic expiration times, employing algorithms that use other header values (such as the Last-Modified time) to estimate a plausible expiration time".

The current implementation considers as dynamic content everything except responses with a Last-Modified header with a date older than 10 minutes or with an Expires header specifying expiration in more than 10 minutes.

Parameters:

response - the response to examine

Returns:

true if the response should be considered as dynamic and therefore uncacheable

See Also:

RFC 2616

parseDateHeader

protected Date parseDateHeader(WebResponse response,
                               String headerName)

Parses and returns the specified date header of the specified response. This method returns null if the specified header cannot be found or cannot be parsed as a date.

Parameters:

response - the response

headerName - the header name

Returns:

the specified date header of the specified response

isJavaScript

protected boolean isJavaScript(WebResponse webResponse)

Returns true if the provided response is JavaScript content. This method checks file extensions in addition to content types, because many web applications are badly configured and have incorrect headers.

Parameters:

webResponse - the response to analyze

Returns:

true if it can be considered as JavaScript

getCachedObject

public Object getCachedObject(WebRequest request)

Returns the cached object corresponding to the specified request. If there is no corresponding cached object, this method returns null.

Parameters:

request - the request whose corresponding cached compiled script is sought

Returns:

the cached object corresponding to the specified request if any

getCachedStyleSheet

public org.w3c.dom.css.CSSStyleSheet getCachedStyleSheet(String css)

Returns the cached parsed version of the specified CSS snippet. If there is no corresponding cached stylesheet, this method returns null.

Parameters:

css - the CSS snippet whose cached stylesheet is sought

Returns:

the cached stylesheet corresponding to the specified CSS snippet

getMaxSize

public int getMaxSize()

Returns the cache's maximum size. This is the maximum number of files that will be cached. The default is 25.

Returns:

the cache's maximum size

setMaxSize

public void setMaxSize(int maxSize)

Sets the cache's maximum size. This is the maximum number of files that will be cached. The default is 25.

Parameters:

maxSize - the cache's maximum size (must be >= 0)

getSize

public int getSize()

Returns the number of entries in the cache.

Returns:

the number of entries in the cache

clear

public void clear()

Clears the cache.