Package org.apache.catalina.webresources
Class StandardRoot
- java.lang.Object
-
- org.apache.catalina.util.LifecycleBase
-
- org.apache.catalina.util.LifecycleMBeanBase
-
- org.apache.catalina.webresources.StandardRoot
-
- All Implemented Interfaces:
javax.management.MBeanRegistration
,JmxEnabled
,Lifecycle
,WebResourceRoot
- Direct Known Subclasses:
ExtractingRoot
public class StandardRoot extends LifecycleMBeanBase implements WebResourceRoot
Provides the resources implementation for a web application. The
Lifecycle
of this class should be aligned with that of the associatedContext
.This implementation assumes that the base attribute supplied to
createWebResourceSet( org.apache.catalina.WebResourceRoot.ResourceSetType, String, String, String, String)
represents the absolute path to a file.
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from interface org.apache.catalina.Lifecycle
Lifecycle.SingleUse
-
Nested classes/interfaces inherited from interface org.apache.catalina.WebResourceRoot
WebResourceRoot.CacheStrategy, WebResourceRoot.ResourceSetType
-
-
Field Summary
Fields Modifier and Type Field Description protected static StringManager
sm
-
Fields inherited from interface org.apache.catalina.Lifecycle
AFTER_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 Summary
Constructors Constructor Description StandardRoot()
Creates a new standard implementation ofWebResourceRoot
.StandardRoot(Context context)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description protected void
addClassResources(WebResourceSet webResourceSet)
void
addJarResources(WebResourceSet webResourceSet)
Adds the provided WebResourceSet to this web application as a 'Jar' resource.void
addPostResources(WebResourceSet webResourceSet)
Adds the provided WebResourceSet to this web application as a 'Post' resource.void
addPreResources(WebResourceSet webResourceSet)
Adds the provided WebResourceSet to this web application as a 'Pre' resource.void
backgroundProcess()
This method will be invoked by the context on a periodic basis and allows the implementation a method that executes periodic tasks, such as purging expired cache entries.protected WebResourceSet
createMainResourceSet()
void
createWebResourceSet(WebResourceRoot.ResourceSetType type, java.lang.String webAppMount, java.lang.String base, java.lang.String archivePath, java.lang.String internalPath)
Creates a newWebResourceSet
for thisWebResourceRoot
based on the provided parameters.void
createWebResourceSet(WebResourceRoot.ResourceSetType type, java.lang.String webAppMount, java.net.URL url, java.lang.String internalPath)
Creates a newWebResourceSet
for thisWebResourceRoot
based on the provided parameters.void
deregisterTrackedResource(TrackedWebResource trackedResource)
Stop tracking specified resource, once it no longer needs to free resources.protected void
destroyInternal()
Sub-classes wishing to perform additional clean-up should override this method, ensuring that super.destroyInternal() is the last call in the overriding method.void
gc()
Implementations may cache some information to improve performance.boolean
getAllowLinking()
Determine if this resources allow the use of symbolic links.java.util.List<java.net.URL>
getBaseUrls()
long
getCacheMaxSize()
Get the maximum permitted size for the cache.int
getCacheObjectMaxSize()
Get the maximum permitted size for a single object in the cache.WebResourceRoot.CacheStrategy
getCacheStrategy()
Obtain the current caching strategy.long
getCacheTtl()
Get the Time-To-Live (TTL) for cache entries.WebResource
getClassLoaderResource(java.lang.String path)
Obtain the object that represents the class loader resource at the given path.WebResource[]
getClassLoaderResources(java.lang.String path)
Obtain the objects that represent the class loader resource at the given path.protected WebResourceSet[]
getClassResources()
Context
getContext()
protected java.lang.String
getDomainInternal()
Method implemented by sub-classes to identify the domain in which MBeans should be registered.WebResourceSet[]
getJarResources()
protected java.lang.String
getObjectNameKeyProperties()
Allow sub-classes to specify the key properties component of theObjectName
that will be used to register this component.WebResourceSet[]
getPostResources()
WebResourceSet[]
getPreResources()
WebResource
getResource(java.lang.String path)
Obtain the object that represents the resource at the given path.protected WebResource
getResource(java.lang.String path, boolean validate, boolean useClassLoaderResources)
protected WebResource
getResourceInternal(java.lang.String path, boolean useClassLoaderResources)
WebResource[]
getResources(java.lang.String path)
Obtain the objects that represent the resource at the given path.protected WebResource[]
getResourcesInternal(java.lang.String path, boolean useClassLoaderResources)
java.util.List<java.lang.String>
getTrackedResources()
boolean
getTrackLockedFiles()
Has the track locked files feature been enabled?protected void
initInternal()
Sub-classes wishing to perform additional initialization should override this method, ensuring that super.initInternal() is the first call in the overriding method.boolean
isCachingAllowed()
protected boolean
isPackedWarFile()
java.lang.String[]
list(java.lang.String path)
Obtain the list of the names of all of the files and directories located in the specified directory.WebResource[]
listResources(java.lang.String path)
Obtain the list of all of the WebResources in the specified directory.protected WebResource[]
listResources(java.lang.String path, boolean validate)
java.util.Set<java.lang.String>
listWebAppPaths(java.lang.String path)
Obtain the Set of the web applications pathnames of all of the files and directories located in the specified directory.boolean
mkdir(java.lang.String path)
Create a new directory at the given path.protected void
processWebInfLib()
Class loader resources are handled by treating JARs in WEB-INF/lib as resource JARs (without the internal META-INF/resources/ prefix) mounted at WEB-INF/classes (rather than the web app root).void
registerTrackedResource(TrackedWebResource trackedResource)
Add a specified resource to track to be able to later release resources on stop.protected void
registerURLStreamHandlerFactory()
void
setAllowLinking(boolean allowLinking)
Configure if this resources allow the use of symbolic links.void
setCacheMaxSize(long cacheMaxSize)
Set the maximum permitted size for the cache.void
setCacheObjectMaxSize(int cacheObjectMaxSize)
Set the maximum permitted size for a single object in the cache.void
setCacheStrategy(WebResourceRoot.CacheStrategy strategy)
Set the current caching strategy.void
setCacheTtl(long cacheTtl)
Set the Time-To-Live (TTL) for cache entries.void
setCachingAllowed(boolean cachingAllowed)
Set whether or not caching is permitted for this web application.void
setContext(Context context)
Set the web application this WebResourceRoot is associated with.protected void
setMainResources(WebResourceSet main)
For unit testing.void
setTrackLockedFiles(boolean trackLockedFiles)
Controls whether the track locked files feature is enabled.protected void
startInternal()
Sub-classes must ensure that the state is changed toLifecycleState.STARTING
during the execution of this method.protected void
stopInternal()
Sub-classes must ensure that the state is changed toLifecycleState.STOPPING
during the execution of this method.boolean
write(java.lang.String path, java.io.InputStream is, boolean overwrite)
Create a new resource at the requested path using the provided InputStream.-
Methods inherited from class org.apache.catalina.util.LifecycleMBeanBase
getDomain, getObjectName, postDeregister, postRegister, preDeregister, preRegister, register, setDomain, unregister, unregister
-
Methods inherited from class org.apache.catalina.util.LifecycleBase
addLifecycleListener, destroy, findLifecycleListeners, fireLifecycleEvent, getState, getStateName, getThrowOnFailure, init, removeLifecycleListener, setState, setState, setThrowOnFailure, start, stop
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface org.apache.catalina.Lifecycle
addLifecycleListener, destroy, findLifecycleListeners, getState, getStateName, init, removeLifecycleListener, start, stop
-
-
-
-
Field Detail
-
sm
protected static final StringManager sm
-
-
Constructor Detail
-
StandardRoot
public StandardRoot()
Creates a new standard implementation ofWebResourceRoot
. A no argument constructor is required for this to work with the digester.setContext(Context)
must be called before this component is initialized.
-
StandardRoot
public StandardRoot(Context context)
-
-
Method Detail
-
list
public java.lang.String[] list(java.lang.String path)
Description copied from interface:WebResourceRoot
Obtain the list of the names of all of the files and directories located in the specified directory.- Specified by:
list
in interfaceWebResourceRoot
- Parameters:
path
- The path for the resource of interest relative to the root of the web application. It must start with '/'.- Returns:
- The list of resources. If path does not refer to a directory then a zero length array will be returned.
-
listWebAppPaths
public java.util.Set<java.lang.String> listWebAppPaths(java.lang.String path)
Description copied from interface:WebResourceRoot
Obtain the Set of the web applications pathnames of all of the files and directories located in the specified directory. Paths representing directories will end with a '/' character.- Specified by:
listWebAppPaths
in interfaceWebResourceRoot
- Parameters:
path
- The path for the resource of interest relative to the root of the web application. It must start with '/'.- Returns:
- The Set of resources. If path does not refer to a directory then null will be returned.
-
mkdir
public boolean mkdir(java.lang.String path)
Description copied from interface:WebResourceRoot
Create a new directory at the given path.- Specified by:
mkdir
in interfaceWebResourceRoot
- Parameters:
path
- The path for the new resource to create relative to the root of the web application. It must start with '/'.- Returns:
true
if the directory was created, otherwisefalse
-
write
public boolean write(java.lang.String path, java.io.InputStream is, boolean overwrite)
Description copied from interface:WebResourceRoot
Create a new resource at the requested path using the provided InputStream.- Specified by:
write
in interfaceWebResourceRoot
- Parameters:
path
- The path to be used for the new Resource. It is relative to the root of the web application and must start with '/'.is
- The InputStream that will provide the content for the new Resource.overwrite
- Iftrue
and the resource already exists it will be overwritten. Iffalse
and the resource already exists the write will fail.- Returns:
true
if and only if the new Resource is written
-
getResource
public WebResource getResource(java.lang.String path)
Description copied from interface:WebResourceRoot
Obtain the object that represents the resource at the given path. Note that the resource at that path may not exist. If the resource does not exist, the WebResource returned will be associated with the main WebResourceSet.- Specified by:
getResource
in interfaceWebResourceRoot
- Parameters:
path
- The path for the resource of interest relative to the root of the web application. It must start with '/'.- Returns:
- The object that represents the resource at the given path
-
getResource
protected WebResource getResource(java.lang.String path, boolean validate, boolean useClassLoaderResources)
-
getClassLoaderResource
public WebResource getClassLoaderResource(java.lang.String path)
Description copied from interface:WebResourceRoot
Obtain the object that represents the class loader resource at the given path. WEB-INF/classes is always searched prior to searching JAR files in WEB-INF/lib. The search order for JAR files will be consistent across subsequent calls to this method until the web application is reloaded. No guarantee is made as to what the search order for JAR files may be.- Specified by:
getClassLoaderResource
in interfaceWebResourceRoot
- Parameters:
path
- The path of the class loader resource of interest relative to the the root of class loader resources for this web application.- Returns:
- The object that represents the class loader resource at the given path
-
getClassLoaderResources
public WebResource[] getClassLoaderResources(java.lang.String path)
Description copied from interface:WebResourceRoot
Obtain the objects that represent the class loader resource at the given path. Note that the resource at that path may not exist. If the path does not exist, the WebResource returned will be associated with the main WebResourceSet. This will include all matches even if the resource would not normally be accessible (e.g. because it was overridden by another resource)- Specified by:
getClassLoaderResources
in interfaceWebResourceRoot
- Parameters:
path
- The path for the class loader resource of interest relative to the root of the class loader resources for the web application. It must start with '/'.- Returns:
- The objects that represents the class loader resources at the given path. There will always be at least one element although that element may represent a resource that is not present.
-
getResourceInternal
protected final WebResource getResourceInternal(java.lang.String path, boolean useClassLoaderResources)
-
getResources
public WebResource[] getResources(java.lang.String path)
Description copied from interface:WebResourceRoot
Obtain the objects that represent the resource at the given path. Note that the resource at that path may not exist. If the resource does not exist, the WebResource returned will be associated with the main WebResourceSet. This will include all matches even if the resource would not normally be accessible (e.g. because it was overridden by another resource)- Specified by:
getResources
in interfaceWebResourceRoot
- Parameters:
path
- The path for the resource of interest relative to the root of the web application. It must start with '/'.- Returns:
- The objects that represents the resource at the given path
-
getResourcesInternal
protected WebResource[] getResourcesInternal(java.lang.String path, boolean useClassLoaderResources)
-
listResources
public WebResource[] listResources(java.lang.String path)
Description copied from interface:WebResourceRoot
Obtain the list of all of the WebResources in the specified directory.- Specified by:
listResources
in interfaceWebResourceRoot
- Parameters:
path
- The path for the resource of interest relative to the root of the web application. It must start with '/'.- Returns:
- The list of resources. If path does not refer to a directory then a zero length array will be returned.
-
listResources
protected WebResource[] listResources(java.lang.String path, boolean validate)
-
createWebResourceSet
public void createWebResourceSet(WebResourceRoot.ResourceSetType type, java.lang.String webAppMount, java.net.URL url, java.lang.String internalPath)
Description copied from interface:WebResourceRoot
Creates a newWebResourceSet
for thisWebResourceRoot
based on the provided parameters.- Specified by:
createWebResourceSet
in interfaceWebResourceRoot
- Parameters:
type
- The type ofWebResourceSet
to createwebAppMount
- The path within the web application that the resources should be published at. It must start with '/'.url
- The URL of the resource (must locate a JAR, file or directory)internalPath
- The path within the resource where the content is to be found. It must start with '/'.
-
createWebResourceSet
public void createWebResourceSet(WebResourceRoot.ResourceSetType type, java.lang.String webAppMount, java.lang.String base, java.lang.String archivePath, java.lang.String internalPath)
Description copied from interface:WebResourceRoot
Creates a newWebResourceSet
for thisWebResourceRoot
based on the provided parameters.- Specified by:
createWebResourceSet
in interfaceWebResourceRoot
- Parameters:
type
- The type ofWebResourceSet
to createwebAppMount
- The path within the web application that the resources should be published at. It must start with '/'.base
- The location of the resourcesarchivePath
- The path within the resource to the archive where the content is to be found. If there is no archive then this should benull
.internalPath
- The path within the archive (or the resource if the archivePath isnull
where the content is to be found. It must start with '/'.
-
addPreResources
public void addPreResources(WebResourceSet webResourceSet)
Description copied from interface:WebResourceRoot
Adds the provided WebResourceSet to this web application as a 'Pre' resource.- Specified by:
addPreResources
in interfaceWebResourceRoot
- Parameters:
webResourceSet
- the resource set to use
-
getPreResources
public WebResourceSet[] getPreResources()
- Specified by:
getPreResources
in interfaceWebResourceRoot
- Returns:
- the list of WebResourceSet configured to this web application as a 'Pre' resource.
-
addJarResources
public void addJarResources(WebResourceSet webResourceSet)
Description copied from interface:WebResourceRoot
Adds the provided WebResourceSet to this web application as a 'Jar' resource.- Specified by:
addJarResources
in interfaceWebResourceRoot
- Parameters:
webResourceSet
- the resource set to use
-
getJarResources
public WebResourceSet[] getJarResources()
- Specified by:
getJarResources
in interfaceWebResourceRoot
- Returns:
- the list of WebResourceSet configured to this web application as a 'Jar' resource.
-
addPostResources
public void addPostResources(WebResourceSet webResourceSet)
Description copied from interface:WebResourceRoot
Adds the provided WebResourceSet to this web application as a 'Post' resource.- Specified by:
addPostResources
in interfaceWebResourceRoot
- Parameters:
webResourceSet
- the resource set to use
-
getPostResources
public WebResourceSet[] getPostResources()
- Specified by:
getPostResources
in interfaceWebResourceRoot
- Returns:
- the list of WebResourceSet configured to this web application as a 'Post' resource.
-
getClassResources
protected WebResourceSet[] getClassResources()
-
addClassResources
protected void addClassResources(WebResourceSet webResourceSet)
-
setAllowLinking
public void setAllowLinking(boolean allowLinking)
Description copied from interface:WebResourceRoot
Configure if this resources allow the use of symbolic links.- Specified by:
setAllowLinking
in interfaceWebResourceRoot
- Parameters:
allowLinking
-true
if symbolic links are allowed.
-
getAllowLinking
public boolean getAllowLinking()
Description copied from interface:WebResourceRoot
Determine if this resources allow the use of symbolic links.- Specified by:
getAllowLinking
in interfaceWebResourceRoot
- Returns:
true
if symbolic links are allowed
-
setCachingAllowed
public void setCachingAllowed(boolean cachingAllowed)
Description copied from interface:WebResourceRoot
Set whether or not caching is permitted for this web application.- Specified by:
setCachingAllowed
in interfaceWebResourceRoot
- Parameters:
cachingAllowed
-true
to enable caching, elsefalse
-
isCachingAllowed
public boolean isCachingAllowed()
- Specified by:
isCachingAllowed
in interfaceWebResourceRoot
- Returns:
true
if caching is permitted for this web application.
-
getCacheStrategy
public WebResourceRoot.CacheStrategy getCacheStrategy()
Description copied from interface:WebResourceRoot
Obtain the current caching strategy.The default implementation returns
null
. Sub-classes wishing to utilise aWebResourceRoot.CacheStrategy
should provide an appropriate implementation.- Specified by:
getCacheStrategy
in interfaceWebResourceRoot
- Returns:
- the current caching strategy or
null
if no strategy has been configured
-
setCacheStrategy
public void setCacheStrategy(WebResourceRoot.CacheStrategy strategy)
Description copied from interface:WebResourceRoot
Set the current caching strategy.The default implementation is a NO-OP. Sub-classes wishing to utilise a
WebResourceRoot.CacheStrategy
should provide an appropriate implementation.- Specified by:
setCacheStrategy
in interfaceWebResourceRoot
- Parameters:
strategy
- The new strategy to use ornull
for no strategy
-
getCacheTtl
public long getCacheTtl()
Description copied from interface:WebResourceRoot
Get the Time-To-Live (TTL) for cache entries.- Specified by:
getCacheTtl
in interfaceWebResourceRoot
- Returns:
- TTL in milliseconds
-
setCacheTtl
public void setCacheTtl(long cacheTtl)
Description copied from interface:WebResourceRoot
Set the Time-To-Live (TTL) for cache entries.- Specified by:
setCacheTtl
in interfaceWebResourceRoot
- Parameters:
cacheTtl
- TTL in milliseconds
-
getCacheMaxSize
public long getCacheMaxSize()
Description copied from interface:WebResourceRoot
Get the maximum permitted size for the cache.- Specified by:
getCacheMaxSize
in interfaceWebResourceRoot
- Returns:
- Maximum cache size in kilobytes
-
setCacheMaxSize
public void setCacheMaxSize(long cacheMaxSize)
Description copied from interface:WebResourceRoot
Set the maximum permitted size for the cache.- Specified by:
setCacheMaxSize
in interfaceWebResourceRoot
- Parameters:
cacheMaxSize
- Maximum cache size in kilobytes
-
setCacheObjectMaxSize
public void setCacheObjectMaxSize(int cacheObjectMaxSize)
Description copied from interface:WebResourceRoot
Set the maximum permitted size for a single object in the cache. Note that the maximum size in bytes may not exceedInteger.MAX_VALUE
.- Specified by:
setCacheObjectMaxSize
in interfaceWebResourceRoot
- Parameters:
cacheObjectMaxSize
- Maximum size for a single cached object in kilobytes
-
getCacheObjectMaxSize
public int getCacheObjectMaxSize()
Description copied from interface:WebResourceRoot
Get the maximum permitted size for a single object in the cache. Note that the maximum size in bytes may not exceedInteger.MAX_VALUE
.- Specified by:
getCacheObjectMaxSize
in interfaceWebResourceRoot
- Returns:
- Maximum size for a single cached object in kilobytes
-
setTrackLockedFiles
public void setTrackLockedFiles(boolean trackLockedFiles)
Description copied from interface:WebResourceRoot
Controls whether the track locked files feature is enabled. If enabled, all calls to methods that return objects that lock a file and need to be closed to release that lock (e.g.WebResource.getInputStream()
will perform a number of additional tasks.- The stack trace at the point where the method was called will be recorded and associated with the returned object.
- The returned object will be wrapped so that the point where close() (or equivalent) is called to release the resources can be detected. Tracking of the object will cease once the resources have been released.
- All remaining locked resources on web application shutdown will be logged and then closed.
- Specified by:
setTrackLockedFiles
in interfaceWebResourceRoot
- Parameters:
trackLockedFiles
-true
to enable it,false
to disable it
-
getTrackLockedFiles
public boolean getTrackLockedFiles()
Description copied from interface:WebResourceRoot
Has the track locked files feature been enabled?- Specified by:
getTrackLockedFiles
in interfaceWebResourceRoot
- Returns:
true
if it has been enabled, otherwisefalse
-
getTrackedResources
public java.util.List<java.lang.String> getTrackedResources()
-
getContext
public Context getContext()
- Specified by:
getContext
in interfaceWebResourceRoot
- Returns:
- the web application this WebResourceRoot is associated with.
-
setContext
public void setContext(Context context)
Description copied from interface:WebResourceRoot
Set the web application this WebResourceRoot is associated with.- Specified by:
setContext
in interfaceWebResourceRoot
- Parameters:
context
- the associated context
-
processWebInfLib
protected void processWebInfLib() throws LifecycleException
Class loader resources are handled by treating JARs in WEB-INF/lib as resource JARs (without the internal META-INF/resources/ prefix) mounted at WEB-INF/classes (rather than the web app root). This enables reuse of the resource handling plumbing. These resources are marked as class loader only so they are only used in the methods that are explicitly defined to return class loader resources. This prevents calls to getResource("/WEB-INF/classes") returning from one or more of the JAR files.- Throws:
LifecycleException
- If an error occurs that should stop the web application from starting
-
setMainResources
protected final void setMainResources(WebResourceSet main)
For unit testing.- Parameters:
main
- The main resources
-
backgroundProcess
public void backgroundProcess()
Description copied from interface:WebResourceRoot
This method will be invoked by the context on a periodic basis and allows the implementation a method that executes periodic tasks, such as purging expired cache entries.- Specified by:
backgroundProcess
in interfaceWebResourceRoot
-
gc
public void gc()
Description copied from interface:WebResourceRoot
Implementations may cache some information to improve performance. This method triggers the clean-up of those resources.- Specified by:
gc
in interfaceWebResourceRoot
-
registerTrackedResource
public void registerTrackedResource(TrackedWebResource trackedResource)
Description copied from interface:WebResourceRoot
Add a specified resource to track to be able to later release resources on stop.- Specified by:
registerTrackedResource
in interfaceWebResourceRoot
- Parameters:
trackedResource
- the resource that will be tracked
-
deregisterTrackedResource
public void deregisterTrackedResource(TrackedWebResource trackedResource)
Description copied from interface:WebResourceRoot
Stop tracking specified resource, once it no longer needs to free resources.- Specified by:
deregisterTrackedResource
in interfaceWebResourceRoot
- Parameters:
trackedResource
- the resource that was tracked
-
getBaseUrls
public java.util.List<java.net.URL> getBaseUrls()
- Specified by:
getBaseUrls
in interfaceWebResourceRoot
- Returns:
- the set of
WebResourceSet.getBaseUrl()
for allWebResourceSet
s used by this root.
-
isPackedWarFile
protected boolean isPackedWarFile()
-
getDomainInternal
protected java.lang.String getDomainInternal()
Description copied from class:LifecycleMBeanBase
Method implemented by sub-classes to identify the domain in which MBeans should be registered.- Specified by:
getDomainInternal
in classLifecycleMBeanBase
- Returns:
- The name of the domain to use to register MBeans.
-
getObjectNameKeyProperties
protected java.lang.String getObjectNameKeyProperties()
Description copied from class:LifecycleMBeanBase
Allow sub-classes to specify the key properties component of theObjectName
that will be used to register this component.- Specified by:
getObjectNameKeyProperties
in classLifecycleMBeanBase
- Returns:
- The string representation of the key properties component of the
desired
ObjectName
-
initInternal
protected void initInternal() throws LifecycleException
Description copied from class:LifecycleMBeanBase
Sub-classes wishing to perform additional initialization should override this method, ensuring that super.initInternal() is the first call in the overriding method.- Overrides:
initInternal
in classLifecycleMBeanBase
- Throws:
LifecycleException
- If the initialisation fails
-
registerURLStreamHandlerFactory
protected void registerURLStreamHandlerFactory()
-
startInternal
protected void startInternal() throws LifecycleException
Description copied from class:LifecycleBase
Sub-classes must ensure that the state is changed toLifecycleState.STARTING
during the execution of this method. Changing state will trigger theLifecycle.START_EVENT
event. If a component fails to start it may either throw aLifecycleException
which 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:
startInternal
in classLifecycleBase
- Throws:
LifecycleException
- Start error occurred
-
createMainResourceSet
protected WebResourceSet createMainResourceSet()
-
stopInternal
protected void stopInternal() throws LifecycleException
Description copied from class:LifecycleBase
Sub-classes must ensure that the state is changed toLifecycleState.STOPPING
during the execution of this method. Changing state will trigger theLifecycle.STOP_EVENT
event.- Specified by:
stopInternal
in classLifecycleBase
- Throws:
LifecycleException
- Stop error occurred
-
destroyInternal
protected void destroyInternal() throws LifecycleException
Description copied from class:LifecycleMBeanBase
Sub-classes wishing to perform additional clean-up should override this method, ensuring that super.destroyInternal() is the last call in the overriding method.- Overrides:
destroyInternal
in classLifecycleMBeanBase
- Throws:
LifecycleException
- If the destruction fails
-
-