|
For the latest news and information visit The GNU Crypto project |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectgnu.crypto.util.ExpirableObject
public abstract class ExpirableObject
The base class for objects with sensitive data that are automatically
destroyed after a timeout elapses. On creation, an object that extends
this class will automatically be added to a Timer
object that,
once a timeout elapses, will automatically call the Destroyable.destroy()
method.
Concrete subclasses must implement the doDestroy()
method
instead of Destroyable.destroy()
; the behavior of that method
should match exactly the behavior desired of destroy()
.
Note that if a DestroyFailedException
occurs when the timeout
expires, it will not be reported.
Destroyable
Field Summary | |
---|---|
static long |
DEFAULT_TIMEOUT
The default timeout, used in the default constructor. |
Constructor Summary | |
---|---|
protected |
ExpirableObject()
Create a new expirable object that will expire after one hour. |
protected |
ExpirableObject(long delay)
Create a new expirable object that will expire after the specified timeout. |
Method Summary | |
---|---|
void |
destroy()
Destroys this object. |
protected abstract void |
doDestroy()
Subclasses must implement this method instead of the Destroyable.destroy() method. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Methods inherited from interface javax.security.auth.Destroyable |
---|
isDestroyed |
Field Detail |
---|
public static final long DEFAULT_TIMEOUT
Constructor Detail |
---|
protected ExpirableObject()
protected ExpirableObject(long delay)
delay
- The delay before expiration.
IllegalArgumentException
- If delay is negative, or if
delay + System.currentTimeMillis()
is negative.Method Detail |
---|
public final void destroy() throws DestroyFailedException
doDestroy
, then, if
no exception is thrown, cancels the task that would destroy this object
when the timeout is reached.
destroy
in interface Destroyable
DestroyFailedException
- If this operation fails.protected abstract void doDestroy() throws DestroyFailedException
Destroyable.destroy()
method.
DestroyFailedException
- If this operation fails.
|
For the latest news and information visit The GNU Crypto project |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |