org.openqa.jetty.http

Class ResourceCache

java.lang.Object

org.openqa.jetty.http.ResourceCache

All Implemented Interfaces:

Serializable, LifeCycle

public class ResourceCache
extends Object
implements LifeCycle, Serializable

Version:

$Id: ResourceCache.java,v 1.13 2006/04/04 22:28:02 gregwilkins Exp $

Author:

Greg Wilkins

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	ResourceCache.ResourceMetaData MetaData associated with a context Resource.

Field Summary

Fields

Modifier and Type	Field and Description
protected Map	_cache
protected int	_cacheSize
protected org.openqa.jetty.http.ResourceCache.CachedMetaData	_leastRecentlyUsed
protected org.openqa.jetty.http.ResourceCache.CachedMetaData	_mostRecentlyUsed

Constructor Summary

Constructors

Constructor and Description
ResourceCache() Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
void	destroy() Destroy a context.
void	flushCache()
Resource	getBaseResource() Get the base resource.
String	getEncodingByMimeType(String type) Get char encoding by mime type.
Map	getEncodingMap() Get the map of mime type to char encoding.
int	getMaxCachedFileSize()
int	getMaxCacheSize()
String	getMimeByExtension(String filename) Get the MIME type by filename extension.
Map	getMimeMap()
Resource	getResource(String pathInContext) Get a resource from the context.
String	getResourceBase() Set the Resource Base.
ResourceCache.ResourceMetaData	getResourceMetaData(Resource resource) Get Resource MetaData.
boolean	isStarted()
void	setBaseResource(Resource base) Set the base resource.
void	setEncodingMap(Map encodingMap) Set the map of mime type to char encoding.
void	setMaxCachedFileSize(int maxCachedFileSize)
void	setMaxCacheSize(int maxCacheSize)
void	setMimeMap(Map mimeMap) Also sets the org.openqa.jetty.http.mimeMap context attribute
void	setMimeMapping(String extension, String type) Set a mime mapping
void	setResourceBase(String resourceBase) Set the Resource Base.
void	setTypeEncoding(String mimeType, String encoding) Set the encoding that should be used for a mimeType.
void	start() Start the LifeCycle.
void	stop() Stop the context.

Methods inherited from class java.lang.Object

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

Field Detail

_cache

protected transient Map _cache

_cacheSize

protected transient int _cacheSize

_mostRecentlyUsed

protected transient org.openqa.jetty.http.ResourceCache.CachedMetaData _mostRecentlyUsed

_leastRecentlyUsed

protected transient org.openqa.jetty.http.ResourceCache.CachedMetaData _leastRecentlyUsed

Constructor Detail

ResourceCache

public ResourceCache()

Constructor.

Method Detail

getResourceBase

public String getResourceBase()

Set the Resource Base. The base resource is the Resource to use as a relative base for all context resources. The ResourceBase attribute is a string version of the baseResource. If a relative file is passed, it is converted to a file URL based on the current working directory.

Returns:

The file or URL to use as the base for all resources within the context.

setResourceBase

public void setResourceBase(String resourceBase)

Set the Resource Base. The base resource is the Resource to use as a relative base for all context resources. The ResourceBase attribute is a string version of the baseResource. If a relative file is passed, it is converted to a file URL based on the current working directory.

Parameters:

resourceBase - A URL prefix or directory name.

getBaseResource

public Resource getBaseResource()

Get the base resource. The base resource is the Resource to use as a relative base for all context resources. The ResourceBase attribute is a string version of the baseResource.

Returns:

The resourceBase as a Resource instance

setBaseResource

public void setBaseResource(Resource base)

Set the base resource. The base resource is the Resource to use as a relative base for all context resources. The ResourceBase attribute is a string version of the baseResource.

Parameters:

base - The resourceBase as a Resource instance

getMaxCachedFileSize

public int getMaxCachedFileSize()

setMaxCachedFileSize

public void setMaxCachedFileSize(int maxCachedFileSize)

getMaxCacheSize

public int getMaxCacheSize()

setMaxCacheSize

public void setMaxCacheSize(int maxCacheSize)

flushCache

public void flushCache()

getResource

public Resource getResource(String pathInContext)
                     throws IOException

Get a resource from the context. Cached Resources are returned if the resource fits within the LRU cache. Directories may have CachedResources returned, but the caller must use the CachedResource.setCachedData method to set the formatted directory content.

Parameters:

pathInContext -

Returns:

Resource

Throws:

IOException

getMimeMap

public Map getMimeMap()

setMimeMap

public void setMimeMap(Map mimeMap)

Also sets the org.openqa.jetty.http.mimeMap context attribute

Parameters:

mimeMap -

getMimeByExtension

public String getMimeByExtension(String filename)

Get the MIME type by filename extension.

Parameters:

filename - A file name

Returns:

MIME type matching the longest dot extension of the file name.

setMimeMapping

public void setMimeMapping(String extension,
                  String type)

Set a mime mapping

Parameters:

extension -

type -

getEncodingMap

public Map getEncodingMap()

Get the map of mime type to char encoding.

Returns:

Map of mime type to character encodings.

setEncodingMap

public void setEncodingMap(Map encodingMap)

Set the map of mime type to char encoding. Also sets the org.openqa.jetty.http.encodingMap context attribute

Parameters:

encodingMap - Map of mime type to character encodings.

getEncodingByMimeType

public String getEncodingByMimeType(String type)

Get char encoding by mime type.

Parameters:

type - A mime type.

Returns:

The prefered character encoding for that type if known.

setTypeEncoding

public void setTypeEncoding(String mimeType,
                   String encoding)

Set the encoding that should be used for a mimeType.

Parameters:

mimeType -

encoding -

start

public void start()
           throws Exception

Description copied from interface: LifeCycle

Start the LifeCycle.

Specified by:

start in interface LifeCycle

Throws:

Exception - An arbitrary exception may be thrown.

isStarted

public boolean isStarted()

Specified by:

isStarted in interface LifeCycle

Returns:

True if the LifeCycle has been started.

stop

public void stop()
          throws InterruptedException

Stop the context.

Specified by:

stop in interface LifeCycle

Throws:

InterruptedException - Stopping a lifecycle is rarely atomic and may be interrupted by another thread. If this happens InterruptedException is throw and the component will be in an indeterminant state and should probably be discarded.

destroy

public void destroy()

Destroy a context. Destroy a context and remove it from the HttpServer. The HttpContext must be stopped before it can be destroyed.

getResourceMetaData

public ResourceCache.ResourceMetaData getResourceMetaData(Resource resource)

Get Resource MetaData.

Parameters:

resource -

Returns:

Meta data for the resource.