Package org.apache.catalina.util
Class SessionIdGeneratorBase
java.lang.Object
org.apache.catalina.util.LifecycleBase
org.apache.catalina.util.SessionIdGeneratorBase
- All Implemented Interfaces:
- Lifecycle,- SessionIdGenerator
- Direct Known Subclasses:
- StandardSessionIdGenerator
- 
Nested Class SummaryNested classes/interfaces inherited from interface org.apache.catalina.LifecycleLifecycle.SingleUse
- 
Field SummaryFieldsFields inherited from interface org.apache.catalina.LifecycleAFTER_DESTROY_EVENT, AFTER_INIT_EVENT, AFTER_START_EVENT, AFTER_STOP_EVENT, BEFORE_DESTROY_EVENT, BEFORE_INIT_EVENT, BEFORE_START_EVENT, BEFORE_STOP_EVENT, CONFIGURE_START_EVENT, CONFIGURE_STOP_EVENT, PERIODIC_EVENT, START_EVENT, STOP_EVENT
- 
Constructor SummaryConstructors
- 
Method SummaryModifier and TypeMethodDescriptionprotected voidSub-classes implement this method to perform any instance destruction required.Generate and return a new session identifier.Return the node identifier associated with this node which will be included in the generated session ID.protected voidgetRandomBytes(byte[] bytes) Get the name of the algorithm used to create theSecureRandominstances which generate new session IDs.Get the class name of theSecureRandomimplementation used to generate session IDs.Get the name of the provider used to create theSecureRandominstances which generate new session IDs.intReturn the number of bytes for a session IDprotected voidSub-classes implement this method to perform any instance initialisation required.voidsetJvmRoute(String jvmRoute) Specify the node identifier associated with this node which will be included in the generated session ID.voidsetSecureRandomAlgorithm(String secureRandomAlgorithm) Specify a non-default algorithm to use to create instances ofSecureRandomwhich are used to generate session IDs.voidsetSecureRandomClass(String secureRandomClass) Specify a non-defaultSecureRandomimplementation to use.voidsetSecureRandomProvider(String secureRandomProvider) Specify a non-default provider to use to create instances ofSecureRandomwhich are used to generate session IDs.voidsetSessionIdLength(int sessionIdLength) Specify the number of bytes for a session IDprotected voidSub-classes must ensure that the state is changed toLifecycleState.STARTINGduring the execution of this method.protected voidSub-classes must ensure that the state is changed toLifecycleState.STOPPINGduring the execution of this method.Methods inherited from class org.apache.catalina.util.LifecycleBaseaddLifecycleListener, destroy, findLifecycleListeners, fireLifecycleEvent, getState, getStateName, getThrowOnFailure, init, removeLifecycleListener, setState, setState, setThrowOnFailure, start, stopMethods inherited from class java.lang.Objectclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface org.apache.catalina.SessionIdGeneratorgenerateSessionId
- 
Field Details- 
DEFAULT_SECURE_RANDOM_ALGORITHM
 
- 
- 
Constructor Details- 
SessionIdGeneratorBasepublic SessionIdGeneratorBase()
 
- 
- 
Method Details- 
getSecureRandomClassGet the class name of theSecureRandomimplementation used to generate session IDs.- Returns:
- The fully qualified class name. nullindicates that the JRE providedSecureRandomimplementation will be used
 
- 
setSecureRandomClassSpecify a non-defaultSecureRandomimplementation to use. The implementation must be self-seeding and have a zero-argument constructor. If not specified, an instance ofSecureRandomwill be generated.- Parameters:
- secureRandomClass- The fully-qualified class name
 
- 
getSecureRandomAlgorithmGet the name of the algorithm used to create theSecureRandominstances which generate new session IDs.- Returns:
- The name of the algorithm. nullor the empty string means that platform default will be used
 
- 
setSecureRandomAlgorithmSpecify a non-default algorithm to use to create instances ofSecureRandomwhich are used to generate session IDs. If no algorithm is specified, SHA1PRNG will be used. If SHA1PRNG is not available, the platform default will be used. To use the platform default (which may be SHA1PRNG), specifynullor the empty string. If an invalid algorithm and/or provider is specified theSecureRandominstances will be created using the defaults for thisSessionIdGeneratorimplementation. If that fails, theSecureRandominstances will be created using platform defaults.- Parameters:
- secureRandomAlgorithm- The name of the algorithm
 
- 
getSecureRandomProviderGet the name of the provider used to create theSecureRandominstances which generate new session IDs.- Returns:
- The name of the provider. nullor the empty string means that platform default will be used
 
- 
setSecureRandomProviderSpecify a non-default provider to use to create instances ofSecureRandomwhich are used to generate session IDs. If no provider is specified, the platform default is used. To use the platform default specifynullor the empty string. If an invalid algorithm and/or provider is specified theSecureRandominstances will be created using the defaults for thisSessionIdGeneratorimplementation. If that fails, theSecureRandominstances will be created using platform defaults.- Parameters:
- secureRandomProvider- The name of the provider
 
- 
getJvmRouteReturn the node identifier associated with this node which will be included in the generated session ID.- Specified by:
- getJvmRoutein interface- SessionIdGenerator
- Returns:
- the node identifier associated with this node which will be included in the generated session ID.
 
- 
setJvmRouteSpecify the node identifier associated with this node which will be included in the generated session ID.- Specified by:
- setJvmRoutein interface- SessionIdGenerator
- Parameters:
- jvmRoute- The node identifier
 
- 
getSessionIdLengthpublic int getSessionIdLength()Return the number of bytes for a session ID- Specified by:
- getSessionIdLengthin interface- SessionIdGenerator
- Returns:
- the number of bytes for a session ID
 
- 
setSessionIdLengthpublic void setSessionIdLength(int sessionIdLength) Specify the number of bytes for a session ID- Specified by:
- setSessionIdLengthin interface- SessionIdGenerator
- Parameters:
- sessionIdLength- Number of bytes
 
- 
generateSessionIdGenerate and return a new session identifier.- Specified by:
- generateSessionIdin interface- SessionIdGenerator
- Returns:
- the newly generated session id
 
- 
getRandomBytesprotected void getRandomBytes(byte[] bytes) 
- 
initInternalDescription copied from class:LifecycleBaseSub-classes implement this method to perform any instance initialisation required.- Specified by:
- initInternalin class- LifecycleBase
- Throws:
- LifecycleException- If the initialisation fails
 
- 
startInternalDescription copied from class:LifecycleBaseSub-classes must ensure that the state is changed toLifecycleState.STARTINGduring the execution of this method. Changing state will trigger theLifecycle.START_EVENTevent. If a component fails to start it may either throw aLifecycleExceptionwhich will cause it's parent to fail to start or it can place itself in the error state in which caseLifecycleBase.stop()will be called on the failed component but the parent component will continue to start normally.- Specified by:
- startInternalin class- LifecycleBase
- Throws:
- LifecycleException- Start error occurred
 
- 
stopInternalDescription copied from class:LifecycleBaseSub-classes must ensure that the state is changed toLifecycleState.STOPPINGduring the execution of this method. Changing state will trigger theLifecycle.STOP_EVENTevent.- Specified by:
- stopInternalin class- LifecycleBase
- Throws:
- LifecycleException- Stop error occurred
 
- 
destroyInternalDescription copied from class:LifecycleBaseSub-classes implement this method to perform any instance destruction required.- Specified by:
- destroyInternalin class- LifecycleBase
- Throws:
- LifecycleException- If the destruction fails
 
 
-