org.apache.turbine.services.cache
Class CachedObject

java.lang.Object
  org.apache.turbine.services.cache.CachedObject

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

RefreshableCachedObject

public class CachedObject

extends java.lang.Object

implements java.io.Serializable

Wrapper for an object you want to store in a cache for a period of time.

Version:

$Id: CachedObject.java 534527 2007-05-02 16:10:59Z tv $

Author:

Dave Bryson, Henning P. Schmiedehausen

See Also:

Serialized Form

Field Summary

protected long	created When created.
static int	DEFAULT Cache the object with the Default TTL
static int	FOREVER Do not expire the object

Constructor Summary

CachedObject(java.lang.Object o)
Constructor; sets the object to expire in the default time (30 minutes).

CachedObject(java.lang.Object o, long expires)
Constructor.

Method Summary

java.lang.Object	getContents() Returns the cached object.
long	getCreated() Returns the creation time for the object.
long	getExpires() Returns the expiration time for the object.
boolean	getStale() Get the stale status for the object.
boolean	isStale() Is the object stale?
void	setExpires(long expires) Set the expiration interval for the object.
void	setStale(boolean stale) Set the stale status for the object.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT

public static final int DEFAULT

Cache the object with the Default TTL

See Also:

Constant Field Values

FOREVER

public static final int FOREVER

Do not expire the object

See Also:

Constant Field Values

created

protected long created

When created.

Constructor Detail

CachedObject

public CachedObject(java.lang.Object o)

Constructor; sets the object to expire in the default time (30 minutes).

Parameters:

o - The object you want to cache.

CachedObject

public CachedObject(java.lang.Object o,
                    long expires)

Constructor.

Parameters:

o - The object to cache.

expires - How long before the object expires, in ms, e.g. 1000 = 1 second.

Method Detail

getContents

public java.lang.Object getContents()

Returns the cached object.

Returns:

The cached object.

getCreated

public long getCreated()

Returns the creation time for the object.

Returns:

When the object was created.

getExpires

public long getExpires()

Returns the expiration time for the object.

Returns:

When the object expires.

setExpires

public void setExpires(long expires)

Set the expiration interval for the object.

Parameters:

expires - Expiration interval in millis ( 1 second = 1000 millis)

setStale

public void setStale(boolean stale)

Set the stale status for the object.

Parameters:

stale - Whether the object is stale or not.

getStale

public boolean getStale()

Get the stale status for the object.

Returns:

Whether the object is stale or not.

isStale

public boolean isStale()

Is the object stale?

Returns:

True if the object is stale.