You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by re...@apache.org on 2024/04/26 13:09:44 UTC
(tomcat) branch main updated: Remove redundant override javadoc
This is an automated email from the ASF dual-hosted git repository.
remm pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/tomcat.git
The following commit(s) were added to refs/heads/main by this push:
new c1664157ce Remove redundant override javadoc
c1664157ce is described below
commit c1664157ce1e8b26a85acfd4b9b800eaea626409
Author: remm <re...@apache.org>
AuthorDate: Fri Apr 26 15:09:15 2024 +0200
Remove redundant override javadoc
---
java/org/apache/catalina/core/ContainerBase.java | 142 -----
java/org/apache/catalina/core/StandardContext.java | 572 ++-------------------
java/org/apache/catalina/core/StandardEngine.java | 48 +-
java/org/apache/catalina/core/StandardHost.java | 97 +---
.../org/apache/catalina/core/StandardPipeline.java | 64 ---
java/org/apache/catalina/core/StandardServer.java | 93 +---
java/org/apache/catalina/core/StandardService.java | 65 +--
java/org/apache/catalina/core/StandardWrapper.java | 159 +-----
.../apache/catalina/util/LifecycleMBeanBase.java | 26 -
9 files changed, 60 insertions(+), 1206 deletions(-)
diff --git a/java/org/apache/catalina/core/ContainerBase.java b/java/org/apache/catalina/core/ContainerBase.java
index 7963ededb9..1a3220f52c 100644
--- a/java/org/apache/catalina/core/ContainerBase.java
+++ b/java/org/apache/catalina/core/ContainerBase.java
@@ -257,32 +257,18 @@ public abstract class ContainerBase extends LifecycleMBeanBase implements Contai
}
- /**
- * Get the delay between the invocation of the backgroundProcess method on this container and its children. Child
- * containers will not be invoked if their delay value is not negative (which would mean they are using their own
- * thread). Setting this to a positive value will cause a thread to be spawn. After waiting the specified amount of
- * time, the thread will invoke the executePeriodic method on this container and all its children.
- */
@Override
public int getBackgroundProcessorDelay() {
return backgroundProcessorDelay;
}
- /**
- * Set the delay between the invocation of the execute method on this container and its children.
- *
- * @param delay The delay in seconds between the invocation of backgroundProcess methods
- */
@Override
public void setBackgroundProcessorDelay(int delay) {
backgroundProcessorDelay = delay;
}
- /**
- * Return the Logger for this Container.
- */
@Override
public Log getLogger() {
if (logger != null) {
@@ -293,9 +279,6 @@ public abstract class ContainerBase extends LifecycleMBeanBase implements Contai
}
- /**
- * @return the abbreviated name of this container for logging messages
- */
@Override
public String getLogName() {
@@ -320,10 +303,6 @@ public abstract class ContainerBase extends LifecycleMBeanBase implements Contai
}
- /**
- * Return the Cluster with which this Container is associated. If there is no associated Cluster, return the Cluster
- * associated with our parent Container (if any); otherwise return <code>null</code>.
- */
@Override
public Cluster getCluster() {
Lock readLock = clusterLock.readLock();
@@ -358,11 +337,6 @@ public abstract class ContainerBase extends LifecycleMBeanBase implements Contai
}
- /**
- * Set the Cluster with which this Container is associated.
- *
- * @param cluster The newly associated Cluster
- */
@Override
public void setCluster(Cluster cluster) {
@@ -406,25 +380,12 @@ public abstract class ContainerBase extends LifecycleMBeanBase implements Contai
}
- /**
- * Return a name string (suitable for use by humans) that describes this Container. Within the set of child
- * containers belonging to a particular parent, Container names must be unique.
- */
@Override
public String getName() {
return name;
}
- /**
- * Set a name string (suitable for use by humans) that describes this Container. Within the set of child containers
- * belonging to a particular parent, Container names must be unique.
- *
- * @param name New name of this container
- *
- * @exception IllegalStateException if this Container has already been added to the children of a parent Container
- * (after which the name may not be changed)
- */
@Override
public void setName(String name) {
if (name == null) {
@@ -459,24 +420,12 @@ public abstract class ContainerBase extends LifecycleMBeanBase implements Contai
}
- /**
- * Return the Container for which this Container is a child, if there is one. If there is no defined parent, return
- * <code>null</code>.
- */
@Override
public Container getParent() {
return parent;
}
- /**
- * Set the parent Container to which this Container is being added as a child. This Container may refuse to become
- * attached to the specified Container by throwing an exception.
- *
- * @param container Container to which this Container is being added as a child
- *
- * @exception IllegalArgumentException if this Container refuses to become attached to the specified Container
- */
@Override
public void setParent(Container container) {
@@ -487,10 +436,6 @@ public abstract class ContainerBase extends LifecycleMBeanBase implements Contai
}
- /**
- * Return the parent class loader (if any) for this web application. This call is meaningful only
- * <strong>after</strong> a Loader has been configured.
- */
@Override
public ClassLoader getParentClassLoader() {
if (parentClassLoader != null) {
@@ -503,13 +448,6 @@ public abstract class ContainerBase extends LifecycleMBeanBase implements Contai
}
- /**
- * Set the parent class loader (if any) for this web application. This call is meaningful only
- * <strong>before</strong> a Loader has been configured, and the specified value (if non-null) should be passed as
- * an argument to the class loader constructor.
- *
- * @param parent The new parent class loader
- */
@Override
public void setParentClassLoader(ClassLoader parent) {
ClassLoader oldParentClassLoader = this.parentClassLoader;
@@ -519,19 +457,12 @@ public abstract class ContainerBase extends LifecycleMBeanBase implements Contai
}
- /**
- * Return the Pipeline object that manages the Valves associated with this Container.
- */
@Override
public Pipeline getPipeline() {
return this.pipeline;
}
- /**
- * Return the Realm with which this Container is associated. If there is no associated Realm, return the Realm
- * associated with our parent Container (if any); otherwise return <code>null</code>.
- */
@Override
public Realm getRealm() {
@@ -561,11 +492,6 @@ public abstract class ContainerBase extends LifecycleMBeanBase implements Contai
}
}
- /**
- * Set the Realm with which this Container is associated.
- *
- * @param realm The newly associated Realm
- */
@Override
public void setRealm(Realm realm) {
@@ -613,20 +539,6 @@ public abstract class ContainerBase extends LifecycleMBeanBase implements Contai
// ------------------------------------------------------ Container Methods
- /**
- * Add a new child Container to those associated with this Container, if supported. Prior to adding this Container
- * to the set of children, the child's <code>setParent()</code> method must be called, with this Container as an
- * argument. This method may thrown an <code>IllegalArgumentException</code> if this Container chooses not to be
- * attached to the specified Container, in which case it is not added
- *
- * @param child New child Container to be added
- *
- * @exception IllegalArgumentException if this exception is thrown by the <code>setParent()</code> method of the
- * child Container
- * @exception IllegalArgumentException if the new child does not have a name unique from that of existing children
- * of this Container
- * @exception IllegalStateException if this Container does not support child Containers
- */
@Override
public void addChild(Container child) {
if (log.isDebugEnabled()) {
@@ -659,34 +571,18 @@ public abstract class ContainerBase extends LifecycleMBeanBase implements Contai
}
- /**
- * Add a container event listener to this component.
- *
- * @param listener The listener to add
- */
@Override
public void addContainerListener(ContainerListener listener) {
listeners.add(listener);
}
- /**
- * Add a property change listener to this component.
- *
- * @param listener The listener to add
- */
@Override
public void addPropertyChangeListener(PropertyChangeListener listener) {
support.addPropertyChangeListener(listener);
}
- /**
- * Return the child Container, associated with this Container, with the specified name (if any); otherwise, return
- * <code>null</code>
- *
- * @param name Name of the child Container to be retrieved
- */
@Override
public Container findChild(String name) {
if (name == null) {
@@ -701,10 +597,6 @@ public abstract class ContainerBase extends LifecycleMBeanBase implements Contai
}
- /**
- * Return the set of children Containers associated with this Container. If this Container has no children, a
- * zero-length array is returned.
- */
@Override
public Container[] findChildren() {
childrenLock.readLock().lock();
@@ -716,21 +608,12 @@ public abstract class ContainerBase extends LifecycleMBeanBase implements Contai
}
- /**
- * Return the set of container listeners associated with this Container. If this Container has no registered
- * container listeners, a zero-length array is returned.
- */
@Override
public ContainerListener[] findContainerListeners() {
return listeners.toArray(new ContainerListener[0]);
}
- /**
- * Remove an existing child Container from association with this parent Container.
- *
- * @param child Existing child Container to be removed
- */
@Override
public void removeChild(Container child) {
@@ -773,22 +656,12 @@ public abstract class ContainerBase extends LifecycleMBeanBase implements Contai
}
- /**
- * Remove a container event listener from this component.
- *
- * @param listener The listener to remove
- */
@Override
public void removeContainerListener(ContainerListener listener) {
listeners.remove(listener);
}
- /**
- * Remove a property change listener from this component.
- *
- * @param listener The listener to remove
- */
@Override
public void removePropertyChangeListener(PropertyChangeListener listener) {
@@ -969,10 +842,6 @@ public abstract class ContainerBase extends LifecycleMBeanBase implements Contai
}
- /**
- * Check this container for an access log and if none is found, look to the parent. If there is no parent and still
- * none is found, use the NoOp access log.
- */
@Override
public void logAccess(Request request, Response response, long time, boolean useDefault) {
@@ -1036,10 +905,6 @@ public abstract class ContainerBase extends LifecycleMBeanBase implements Contai
}
- /**
- * Execute a periodic task, such as reloading, etc. This method will be invoked inside the classloading context of
- * this container. Unexpected throwables will be caught and logged.
- */
@Override
public synchronized void backgroundProcess() {
@@ -1100,13 +965,6 @@ public abstract class ContainerBase extends LifecycleMBeanBase implements Contai
// ------------------------------------------------------ Protected Methods
- /**
- * Notify all container event listeners that a particular event has occurred for this Container. The default
- * implementation performs this notification synchronously using the calling thread.
- *
- * @param type Event type
- * @param data Event data
- */
@Override
public void fireContainerEvent(String type, Object data) {
diff --git a/java/org/apache/catalina/core/StandardContext.java b/java/org/apache/catalina/core/StandardContext.java
index e2872b09e0..4879e90244 100644
--- a/java/org/apache/catalina/core/StandardContext.java
+++ b/java/org/apache/catalina/core/StandardContext.java
@@ -1218,56 +1218,36 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Set to <code>true</code> to allow requests mapped to servlets that do not explicitly declare @MultipartConfig or
- * have <multipart-config> specified in web.xml to parse multipart/form-data requests.
- *
- * @param allowCasualMultipartParsing <code>true</code> to allow such casual parsing, <code>false</code> otherwise.
- */
@Override
public void setAllowCasualMultipartParsing(boolean allowCasualMultipartParsing) {
this.allowCasualMultipartParsing = allowCasualMultipartParsing;
}
/**
- * Returns <code>true</code> if requests mapped to servlets without "multipart config" to parse multipart/form-data
- * requests anyway.
- *
- * @return <code>true</code> if requests mapped to servlets without "multipart config" to parse multipart/form-data
- * requests, <code>false</code> otherwise.
+ * {@inheritDoc}
+ * <p>
+ * The default value for this implementation is {@code false}.
*/
@Override
public boolean getAllowCasualMultipartParsing() {
return this.allowCasualMultipartParsing;
}
- /**
- * Set to <code>false</code> to disable request data swallowing after an upload was aborted due to size constraints.
- *
- * @param swallowAbortedUploads <code>false</code> to disable swallowing, <code>true</code> otherwise (default).
- */
@Override
public void setSwallowAbortedUploads(boolean swallowAbortedUploads) {
this.swallowAbortedUploads = swallowAbortedUploads;
}
/**
- * Returns <code>true</code> if remaining request data will be read (swallowed) even the request violates a data
- * size constraint.
- *
- * @return <code>true</code> if data will be swallowed (default), <code>false</code> otherwise.
+ * {@inheritDoc}
+ * <p>
+ * The default value for this implementation is {@code false}.
*/
@Override
public boolean getSwallowAbortedUploads() {
return this.swallowAbortedUploads;
}
- /**
- * Add a ServletContainerInitializer instance to this web application.
- *
- * @param sci The instance to add
- * @param classes The classes in which the initializer expressed an interest
- */
@Override
public void addServletContainerInitializer(ServletContainerInitializer sci, Set<Class<?>> classes) {
initializers.put(sci, classes);
@@ -1351,12 +1331,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Store the set of initialized application lifecycle listener objects, in the order they were specified in the web
- * application deployment descriptor, for this application.
- *
- * @param listeners The set of instantiated listener objects.
- */
@Override
public void setApplicationLifecycleListeners(Object listeners[]) {
applicationLifecycleListenersObjects = listeners;
@@ -1477,12 +1451,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Set the "correctly configured" flag for this Context. This can be set to false by startup listeners that detect a
- * fatal configuration error to avoid the application from being made available.
- *
- * @param configured The new correctly configured flag
- */
@Override
public void setConfigured(boolean configured) {
@@ -1499,11 +1467,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Set the "use cookies for session ids" flag.
- *
- * @param cookies The new flag
- */
@Override
public void setCookies(boolean cookies) {
@@ -1514,22 +1477,12 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Gets the name to use for session cookies. Overrides any setting that may be specified by the application.
- *
- * @return The value of the default session cookie name or null if not specified
- */
@Override
public String getSessionCookieName() {
return sessionCookieName;
}
- /**
- * Sets the name to use for session cookies. Overrides any setting that may be specified by the application.
- *
- * @param sessionCookieName The name to use
- */
@Override
public void setSessionCookieName(String sessionCookieName) {
String oldSessionCookieName = this.sessionCookieName;
@@ -1539,9 +1492,9 @@ public class StandardContext extends ContainerBase implements Context, Notificat
/**
- * Gets the value of the use HttpOnly cookies for session cookies flag.
- *
- * @return <code>true</code> if the HttpOnly flag should be set on session cookies
+ * {@inheritDoc}
+ * <p>
+ * The default value for this implementation is {@code true}.
*/
@Override
public boolean getUseHttpOnly() {
@@ -1549,11 +1502,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Sets the use HttpOnly cookies for session cookies flag.
- *
- * @param useHttpOnly Set to <code>true</code> to use HttpOnly cookies for session cookies
- */
@Override
public void setUseHttpOnly(boolean useHttpOnly) {
boolean oldUseHttpOnly = this.useHttpOnly;
@@ -1576,22 +1524,12 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Gets the domain to use for session cookies. Overrides any setting that may be specified by the application.
- *
- * @return The value of the default session cookie domain or null if not specified
- */
@Override
public String getSessionCookieDomain() {
return sessionCookieDomain;
}
- /**
- * Sets the domain to use for session cookies. Overrides any setting that may be specified by the application.
- *
- * @param sessionCookieDomain The domain to use
- */
@Override
public void setSessionCookieDomain(String sessionCookieDomain) {
String oldSessionCookieDomain = this.sessionCookieDomain;
@@ -1600,22 +1538,12 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Gets the path to use for session cookies. Overrides any setting that may be specified by the application.
- *
- * @return The value of the default session cookie path or null if not specified
- */
@Override
public String getSessionCookiePath() {
return sessionCookiePath;
}
- /**
- * Sets the path to use for session cookies. Overrides any setting that may be specified by the application.
- *
- * @param sessionCookiePath The path to use
- */
@Override
public void setSessionCookiePath(String sessionCookiePath) {
String oldSessionCookiePath = this.sessionCookiePath;
@@ -1636,17 +1564,17 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
+ /**
+ * {@inheritDoc}
+ * <p>
+ * The default value for this implementation is {@code false}.
+ */
@Override
public boolean getCrossContext() {
return this.crossContext;
}
- /**
- * Set the "allow crossing servlet contexts" flag.
- *
- * @param crossContext The new cross contexts flag
- */
@Override
public void setCrossContext(boolean crossContext) {
@@ -1718,29 +1646,18 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * @return the display name of this web application.
- */
@Override
public String getDisplayName() {
return this.displayName;
}
- /**
- * @return the alternate Deployment Descriptor name.
- */
@Override
public String getAltDDName() {
return altDDName;
}
- /**
- * Set an alternate Deployment Descriptor name.
- *
- * @param altDDName The new name
- */
@Override
public void setAltDDName(String altDDName) {
this.altDDName = altDDName;
@@ -1750,11 +1667,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Set the display name of this web application.
- *
- * @param displayName The new display name
- */
@Override
public void setDisplayName(String displayName) {
@@ -1765,18 +1677,15 @@ public class StandardContext extends ContainerBase implements Context, Notificat
/**
- * @return the distributable flag for this web application.
+ * {@inheritDoc}
+ * <p>
+ * The default value for this implementation is {@code false}.
*/
@Override
public boolean getDistributable() {
return this.distributable;
}
- /**
- * Set the distributable flag for this web application.
- *
- * @param distributable The new distributable flag
- */
@Override
public void setDistributable(boolean distributable) {
boolean oldDistributable = this.distributable;
@@ -1925,7 +1834,9 @@ public class StandardContext extends ContainerBase implements Context, Notificat
/**
- * @return the boolean on the annotations parsing.
+ * {@inheritDoc}
+ * <p>
+ * The default value for this implementation is {@code false}.
*/
@Override
public boolean getIgnoreAnnotations() {
@@ -1933,11 +1844,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Set the boolean on the annotations parsing for this web application.
- *
- * @param ignoreAnnotations The boolean on the annotations parsing
- */
@Override
public void setIgnoreAnnotations(boolean ignoreAnnotations) {
boolean oldIgnoreAnnotations = this.ignoreAnnotations;
@@ -1960,20 +1866,12 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * @return the login configuration descriptor for this web application.
- */
@Override
public LoginConfig getLoginConfig() {
return this.loginConfig;
}
- /**
- * Set the login configuration descriptor for this web application.
- *
- * @param config The new login configuration
- */
@Override
public void setLoginConfig(LoginConfig config) {
@@ -2012,9 +1910,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * @return the naming resources associated with this web application.
- */
@Override
public NamingResourcesImpl getNamingResources() {
if (namingResources == null) {
@@ -2024,11 +1919,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Set the naming resources for this web application.
- *
- * @param namingResources The new naming resources
- */
@Override
public void setNamingResources(NamingResourcesImpl namingResources) {
@@ -2074,20 +1964,12 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * @return the context path for this Context.
- */
@Override
public String getPath() {
return path;
}
- /**
- * Set the context path for this Context.
- *
- * @param path The new context path
- */
@Override
public void setPath(String path) {
boolean invalid = false;
@@ -2114,20 +1996,12 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * @return the public identifier of the deployment descriptor DTD that is currently being parsed.
- */
@Override
public String getPublicId() {
return this.publicId;
}
- /**
- * Set the public identifier of the deployment descriptor DTD that is currently being parsed.
- *
- * @param publicId The public identifier
- */
@Override
public void setPublicId(String publicId) {
@@ -2143,7 +2017,9 @@ public class StandardContext extends ContainerBase implements Context, Notificat
/**
- * @return the reloadable flag for this web application.
+ * {@inheritDoc}
+ * <p>
+ * The default value for this implementation is {@code false}.
*/
@Override
public boolean getReloadable() {
@@ -2152,7 +2028,9 @@ public class StandardContext extends ContainerBase implements Context, Notificat
/**
- * @return the default context override flag for this web application.
+ * {@inheritDoc}
+ * <p>
+ * The default value for this implementation is {@code false}.
*/
@Override
public boolean getOverride() {
@@ -2179,10 +2057,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * @return the parent class loader (if any) for this web application. This call is meaningful only
- * <strong>after</strong> a Loader has been configured.
- */
@Override
public ClassLoader getParentClassLoader() {
if (parentClassLoader != null) {
@@ -2198,7 +2072,9 @@ public class StandardContext extends ContainerBase implements Context, Notificat
/**
- * @return the privileged flag for this web application.
+ * {@inheritDoc}
+ * <p>
+ * The default value for this implementation is {@code false}.
*/
@Override
public boolean getPrivileged() {
@@ -2206,11 +2082,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Set the privileged flag for this web application.
- *
- * @param privileged The new privileged flag
- */
@Override
public void setPrivileged(boolean privileged) {
@@ -2221,11 +2092,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Set the reloadable flag for this web application.
- *
- * @param reloadable The new reloadable flag
- */
@Override
public void setReloadable(boolean reloadable) {
@@ -2236,11 +2102,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Set the default context override flag for this web application.
- *
- * @param override The new override flag
- */
@Override
public void setOverride(boolean override) {
@@ -2265,9 +2126,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * @return the servlet context for which this Context is a facade.
- */
@Override
public ServletContext getServletContext() {
/*
@@ -2285,7 +2143,9 @@ public class StandardContext extends ContainerBase implements Context, Notificat
/**
- * @return the default session timeout (in minutes) for this web application.
+ * {@inheritDoc}
+ * <p>
+ * The default value for this implementation is 30 minutes.
*/
@Override
public int getSessionTimeout() {
@@ -2293,11 +2153,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Set the default session timeout (in minutes) for this web application.
- *
- * @param timeout The new default session timeout
- */
@Override
public void setSessionTimeout(int timeout) {
@@ -2313,7 +2168,9 @@ public class StandardContext extends ContainerBase implements Context, Notificat
/**
- * @return the value of the swallowOutput flag.
+ * {@inheritDoc}
+ * <p>
+ * The default value for this implementation is {@code false}.
*/
@Override
public boolean getSwallowOutput() {
@@ -2321,12 +2178,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Set the value of the swallowOutput flag. If set to true, the system.out and system.err will be redirected to the
- * logger during a servlet execution.
- *
- * @param swallowOutput The new value
- */
@Override
public void setSwallowOutput(boolean swallowOutput) {
@@ -2401,23 +2252,12 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * @return the Java class name of the Wrapper implementation used for servlets registered in this Context.
- */
@Override
public String getWrapperClass() {
return this.wrapperClassName;
}
- /**
- * Set the Java class name of the Wrapper implementation used for servlets registered in this Context.
- *
- * @param wrapperClassName The new wrapper class name
- *
- * @throws IllegalArgumentException if the specified wrapper class cannot be found or is not a subclass of
- * StandardWrapper
- */
@Override
public void setWrapperClass(String wrapperClassName) {
@@ -2723,11 +2563,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
// -------------------------------------------------------- Context Methods
- /**
- * Add a new Listener class name to the set of Listeners configured for this application.
- *
- * @param listener Java class name of a listener class
- */
@Override
public void addApplicationListener(String listener) {
if (applicationListeners.addIfAbsent(listener)) {
@@ -2738,11 +2573,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Add a new application parameter for this application.
- *
- * @param parameter The new application parameter
- */
@Override
public void addApplicationParameter(ApplicationParameter parameter) {
@@ -2762,13 +2592,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Add a child Container, only if the proposed child is an implementation of Wrapper.
- *
- * @param child Child container to be added
- *
- * @exception IllegalArgumentException if the proposed container is not an implementation of Wrapper
- */
@Override
public void addChild(Container child) {
@@ -2804,11 +2627,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Add a security constraint to the set for this web application.
- *
- * @param constraint the new security constraint
- */
@Override
public void addConstraint(SecurityConstraint constraint) {
@@ -2838,11 +2656,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Add an error page for the specified error or Java exception.
- *
- * @param errorPage The error page definition to be added
- */
@Override
public void addErrorPage(ErrorPage errorPage) {
// Validate the input parameters
@@ -2866,11 +2679,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Add a filter definition to this Context.
- *
- * @param filterDef The filter definition to be added
- */
@Override
public void addFilterDef(FilterDef filterDef) {
@@ -2882,14 +2690,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Add a filter mapping to this Context at the end of the current set of filter mappings.
- *
- * @param filterMap The filter mapping to be added
- *
- * @exception IllegalArgumentException if the specified filter name does not match an existing filter definition, or
- * the filter mapping is malformed
- */
@Override
public void addFilterMap(FilterMap filterMap) {
validateFilterMap(filterMap);
@@ -2899,15 +2699,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Add a filter mapping to this Context before the mappings defined in the deployment descriptor but after any other
- * mappings added via this method.
- *
- * @param filterMap The filter mapping to be added
- *
- * @exception IllegalArgumentException if the specified filter name does not match an existing filter definition, or
- * the filter mapping is malformed
- */
@Override
public void addFilterMapBefore(FilterMap filterMap) {
validateFilterMap(filterMap);
@@ -2943,12 +2734,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Add a Locale Encoding Mapping (see Sec 5.4 of Servlet spec 2.4)
- *
- * @param locale locale to map an encoding for
- * @param encoding encoding to be used for a give locale
- */
@Override
public void addLocaleEncodingMappingParameter(String locale, String encoding) {
getCharsetMapper().addCharsetMappingFromDeploymentDescriptor(locale, encoding);
@@ -2970,12 +2755,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Add a new MIME mapping, replacing any existing mapping for the specified extension.
- *
- * @param extension Filename extension being mapped
- * @param mimeType Corresponding MIME type
- */
@Override
public void addMimeMapping(String extension, String mimeType) {
@@ -2987,15 +2766,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Add a new context initialization parameter.
- *
- * @param name Name of the new parameter
- * @param value Value of the new parameter
- *
- * @exception IllegalArgumentException if the name or value is missing, or if this context initialization parameter
- * has already been registered
- */
@Override
public void addParameter(String name, String value) {
// Validate the proposed context initialization parameter
@@ -3014,12 +2784,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Add a security role reference for this web application.
- *
- * @param role Security role used in the application
- * @param link Actual security role to check for
- */
@Override
public void addRoleMapping(String role, String link) {
@@ -3031,11 +2795,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Add a new security role for this web application.
- *
- * @param role New security role
- */
@Override
public void addSecurityRole(String role) {
@@ -3049,15 +2808,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Add a new servlet mapping, replacing any existing mapping for the specified pattern.
- *
- * @param pattern URL pattern to be mapped
- * @param name Name of the corresponding servlet to execute
- * @param jspWildCard true if name identifies the JspServlet and pattern contains a wildcard; false otherwise
- *
- * @exception IllegalArgumentException if the specified servlet name is not known to this Context
- */
@Override
public void addServletMappingDecoded(String pattern, String name, boolean jspWildCard) {
// Validate the proposed mapping
@@ -3086,11 +2836,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Add a new watched resource to the set recognized by this Context.
- *
- * @param name New watched resource file name
- */
@Override
public void addWatchedResource(String name) {
@@ -3103,11 +2848,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Add a new welcome file to the set recognized by this Context.
- *
- * @param name New welcome file name
- */
@Override
public void addWelcomeFile(String name) {
@@ -3129,11 +2869,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Add the classname of a LifecycleListener to be added to each Wrapper appended to this Context.
- *
- * @param listener Java class name of a LifecycleListener class
- */
@Override
public void addWrapperLifecycle(String listener) {
@@ -3147,11 +2882,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Add the classname of a ContainerListener to be added to each Wrapper appended to this Context.
- *
- * @param listener Java class name of a ContainerListener class
- */
@Override
public void addWrapperListener(String listener) {
@@ -3165,11 +2895,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Factory method to create and return a new Wrapper instance, of the Java implementation class appropriate for this
- * Context implementation. The constructor of the instantiated Wrapper will have been called, but no properties will
- * have been set.
- */
@Override
public Wrapper createWrapper() {
@@ -3218,18 +2943,12 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Return the set of application listener class names configured for this application.
- */
@Override
public String[] findApplicationListeners() {
return applicationListeners.toArray(new String[0]);
}
- /**
- * Return the set of application parameters for this application.
- */
@Override
public ApplicationParameter[] findApplicationParameters() {
@@ -3240,20 +2959,12 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Return the security constraints for this web application. If there are none, a zero-length array is returned.
- */
@Override
public SecurityConstraint[] findConstraints() {
return constraints;
}
- /**
- * Return the error page entry for the specified HTTP error code, if any; otherwise return <code>null</code>.
- *
- * @param errorCode Error code to look up
- */
@Override
public ErrorPage findErrorPage(int errorCode) {
return errorPageSupport.find(errorCode);
@@ -3266,20 +2977,12 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Return the set of defined error pages for all specified error codes and exception types.
- */
@Override
public ErrorPage[] findErrorPages() {
return errorPageSupport.findAll();
}
- /**
- * Return the filter definition for the specified filter name, if any; otherwise return <code>null</code>.
- *
- * @param filterName Filter name to look up
- */
@Override
public FilterDef findFilterDef(String filterName) {
synchronized (filterDefs) {
@@ -3288,9 +2991,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * @return the set of defined filters for this Context.
- */
@Override
public FilterDef[] findFilterDefs() {
synchronized (filterDefs) {
@@ -3299,9 +2999,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * @return the set of filter mappings for this Context.
- */
@Override
public FilterMap[] findFilterMaps() {
return filterMaps.asArray();
@@ -3331,20 +3028,12 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * @return the MIME type to which the specified extension is mapped, if any; otherwise return <code>null</code>.
- *
- * @param extension Extension to map to a MIME type
- */
@Override
public String findMimeMapping(String extension) {
return mimeMappings.get(extension.toLowerCase(Locale.ENGLISH));
}
- /**
- * @return the extensions for which MIME mappings are defined. If there are none, a zero-length array is returned.
- */
@Override
public String[] findMimeMappings() {
synchronized (mimeMappings) {
@@ -3353,36 +3042,18 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * @return the value for the specified context initialization parameter name, if any; otherwise return
- * <code>null</code>.
- *
- * @param name Name of the parameter to return
- */
@Override
public String findParameter(String name) {
return parameters.get(name);
}
- /**
- * @return the names of all defined context initialization parameters for this Context. If no parameters are
- * defined, a zero-length array is returned.
- */
@Override
public String[] findParameters() {
return parameters.keySet().toArray(new String[0]);
}
- /**
- * For the given security role (as used by an application), return the corresponding role name (as defined by the
- * underlying Realm) if there is one. Otherwise, return the specified role unchanged.
- *
- * @param role Security role to map
- *
- * @return the role name
- */
@Override
public String findRoleMapping(String role) {
String realRole = null;
@@ -3397,12 +3068,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * @return <code>true</code> if the specified security role is defined for this application; otherwise return
- * <code>false</code>.
- *
- * @param role Security role to verify
- */
@Override
public boolean findSecurityRole(String role) {
@@ -3418,10 +3083,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * @return the security roles defined for this application. If none have been defined, a zero-length array is
- * returned.
- */
@Override
public String[] findSecurityRoles() {
synchronized (securityRolesLock) {
@@ -3430,11 +3091,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * @return the servlet name mapped by the specified pattern (if any); otherwise return <code>null</code>.
- *
- * @param pattern Pattern for which a mapping is requested
- */
@Override
public String findServletMapping(String pattern) {
synchronized (servletMappingsLock) {
@@ -3443,10 +3099,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * @return the patterns of all defined servlet mappings for this Context. If no mappings are defined, a zero-length
- * array is returned.
- */
@Override
public String[] findServletMappings() {
synchronized (servletMappingsLock) {
@@ -3455,12 +3107,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * @return <code>true</code> if the specified welcome file is defined for this Context; otherwise return
- * <code>false</code>.
- *
- * @param name Welcome file to verify
- */
@Override
public boolean findWelcomeFile(String name) {
@@ -3476,9 +3122,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * @return the set of watched resources for this Context. If none are defined, a zero length array will be returned.
- */
@Override
public String[] findWatchedResources() {
synchronized (watchedResourcesLock) {
@@ -3487,9 +3130,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * @return the set of welcome files defined for this Context. If none are defined, a zero-length array is returned.
- */
@Override
public String[] findWelcomeFiles() {
synchronized (welcomeFilesLock) {
@@ -3498,9 +3138,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * @return the set of LifecycleListener classes that will be added to newly created Wrappers automatically.
- */
@Override
public String[] findWrapperLifecycles() {
synchronized (wrapperLifecyclesLock) {
@@ -3509,9 +3146,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * @return the set of ContainerListener classes that will be added to newly created Wrappers automatically.
- */
@Override
public String[] findWrapperListeners() {
synchronized (wrapperListenersLock) {
@@ -3521,15 +3155,13 @@ public class StandardContext extends ContainerBase implements Context, Notificat
/**
- * Reload this web application, if reloading is supported.
+ * {@inheritDoc}
* <p>
* <b>IMPLEMENTATION NOTE</b>: This method is designed to deal with reloads required by changes to classes in the
* underlying repositories of our class loader and changes to the web.xml file. It does not handle changes to any
* context.xml file. If the context.xml has changed, you should stop this Context and create (and start) a new
* Context instance instead. Note that there is additional code in <code>CoyoteAdapter#postParseRequest()</code> to
* handle mapping requests to paused Contexts.
- *
- * @exception IllegalStateException if the <code>reloadable</code> property is set to <code>false</code>.
*/
@Override
public synchronized void reload() {
@@ -3567,11 +3199,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Remove the specified application listener class from the set of listeners for this application.
- *
- * @param listener Java class name of the listener to be removed
- */
@Override
public void removeApplicationListener(String listener) {
if (applicationListeners.remove(listener)) {
@@ -3581,11 +3208,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Remove the application parameter with the specified name from the set for this application.
- *
- * @param name Name of the application parameter to remove
- */
@Override
public void removeApplicationParameter(String name) {
@@ -3621,13 +3243,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Add a child Container, only if the proposed child is an implementation of Wrapper.
- *
- * @param child Child container to be added
- *
- * @exception IllegalArgumentException if the proposed container is not an implementation of Wrapper
- */
@Override
public void removeChild(Container child) {
@@ -3640,11 +3255,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Remove the specified security constraint from this web application.
- *
- * @param constraint Constraint to be removed
- */
@Override
public void removeConstraint(SecurityConstraint constraint) {
@@ -3680,12 +3290,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Remove the error page for the specified error code or Java language exception, if it exists; otherwise, no action
- * is taken.
- *
- * @param errorPage The error page definition to be removed
- */
@Override
public void removeErrorPage(ErrorPage errorPage) {
errorPageSupport.remove(errorPage);
@@ -3693,11 +3297,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Remove the specified filter definition from this Context, if it exists; otherwise, no action is taken.
- *
- * @param filterDef Filter definition to be removed
- */
@Override
public void removeFilterDef(FilterDef filterDef) {
@@ -3709,11 +3308,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Remove a filter mapping from this Context.
- *
- * @param filterMap The filter mapping to be removed
- */
@Override
public void removeFilterMap(FilterMap filterMap) {
filterMaps.remove(filterMap);
@@ -3737,11 +3331,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Remove the MIME mapping for the specified extension, if it exists; otherwise, no action is taken.
- *
- * @param extension Extension to remove the mapping for
- */
@Override
public void removeMimeMapping(String extension) {
@@ -3753,11 +3342,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Remove the context initialization parameter with the specified name, if it exists; otherwise, no action is taken.
- *
- * @param name Name of the parameter to remove
- */
@Override
public void removeParameter(String name) {
parameters.remove(name);
@@ -3765,11 +3349,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Remove any security role reference for the specified name
- *
- * @param role Security role (as used in the application) to remove
- */
@Override
public void removeRoleMapping(String role) {
@@ -3781,11 +3360,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Remove any security role with the specified name.
- *
- * @param role Security role to remove
- */
@Override
public void removeSecurityRole(String role) {
@@ -3821,11 +3395,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Remove any servlet mapping for the specified pattern, if it exists; otherwise, no action is taken.
- *
- * @param pattern URL pattern of the mapping to remove
- */
@Override
public void removeServletMapping(String pattern) {
@@ -3841,11 +3410,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Remove the specified watched resource name from the list associated with this Context.
- *
- * @param name Name of the watched resource to be removed
- */
@Override
public void removeWatchedResource(String name) {
@@ -3880,11 +3444,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Remove the specified welcome file name from the list recognized by this Context.
- *
- * @param name Name of the welcome file to be removed
- */
@Override
public void removeWelcomeFile(String name) {
@@ -3922,11 +3481,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Remove a class name from the set of LifecycleListener classes that will be added to newly created Wrappers.
- *
- * @param listener Class name of a LifecycleListener class to be removed
- */
@Override
public void removeWrapperLifecycle(String listener) {
@@ -3963,11 +3517,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Remove a class name from the set of ContainerListener classes that will be added to newly created Wrappers.
- *
- * @param listener Class name of a ContainerListener class to be removed
- */
@Override
public void removeWrapperListener(String listener) {
@@ -4108,11 +3657,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Return the real path for a given virtual path, if possible; otherwise return <code>null</code>.
- *
- * @param path The path to the desired resource
- */
@Override
public String getRealPath(String path) {
// The WebResources API expects all paths to start with /. This is a
@@ -4616,13 +4160,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Start this component and implement the requirements of
- * {@link org.apache.catalina.util.LifecycleBase#startInternal()}.
- *
- * @exception LifecycleException if this component detects a fatal error that prevents this component from being
- * used
- */
@Override
protected void startInternal() throws LifecycleException {
@@ -5027,13 +4564,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Stop this component and implement the requirements of
- * {@link org.apache.catalina.util.LifecycleBase#stopInternal()}.
- *
- * @exception LifecycleException if this component detects a fatal error that prevents this component from being
- * used
- */
@Override
protected void stopInternal() throws LifecycleException {
@@ -5311,11 +4841,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Are we processing a version 2.2 deployment descriptor?
- *
- * @return <code>true</code> if running a legacy Servlet 2.2 application
- */
@Override
public boolean isServlet22() {
return XmlIdentifiers.WEB_22_PUBLIC.equals(publicId);
@@ -5544,9 +5069,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * @return the request processing paused flag for this Context.
- */
@Override
public boolean getPaused() {
return this.paused;
@@ -5874,12 +5396,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Remove a JMX notificationListener
- *
- * @see javax.management.NotificationEmitter#removeNotificationListener(javax.management.NotificationListener,
- * javax.management.NotificationFilter, java.lang.Object)
- */
@Override
public void removeNotificationListener(NotificationListener listener, NotificationFilter filter, Object object)
throws ListenerNotFoundException {
@@ -5888,11 +5404,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
private MBeanNotificationInfo[] notificationInfo;
- /**
- * Get JMX Broadcaster Info
- *
- * @see javax.management.NotificationBroadcaster#getNotificationInfo()
- */
@Override
public MBeanNotificationInfo[] getNotificationInfo() {
if (notificationInfo == null) {
@@ -5917,12 +5428,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Add a JMX NotificationListener
- *
- * @see javax.management.NotificationBroadcaster#addNotificationListener(javax.management.NotificationListener,
- * javax.management.NotificationFilter, java.lang.Object)
- */
@Override
public void addNotificationListener(NotificationListener listener, NotificationFilter filter, Object object)
throws IllegalArgumentException {
@@ -5930,11 +5435,6 @@ public class StandardContext extends ContainerBase implements Context, Notificat
}
- /**
- * Remove a JMX-NotificationListener
- *
- * @see javax.management.NotificationBroadcaster#removeNotificationListener(javax.management.NotificationListener)
- */
@Override
public void removeNotificationListener(NotificationListener listener) throws ListenerNotFoundException {
broadcaster.removeNotificationListener(listener);
diff --git a/java/org/apache/catalina/core/StandardEngine.java b/java/org/apache/catalina/core/StandardEngine.java
index 59cc280fa3..bc9c692ac7 100644
--- a/java/org/apache/catalina/core/StandardEngine.java
+++ b/java/org/apache/catalina/core/StandardEngine.java
@@ -90,11 +90,6 @@ public class StandardEngine extends ContainerBase implements Engine {
// ------------------------------------------------------------- Properties
- /**
- * Obtain the configured Realm and provide a default Realm implementation when no explicit configuration is set.
- *
- * @return configured realm, or a {@link NullRealm} by default
- */
@Override
public Realm getRealm() {
Realm configured = super.getRealm();
@@ -108,20 +103,12 @@ public class StandardEngine extends ContainerBase implements Engine {
}
- /**
- * Return the default host.
- */
@Override
public String getDefaultHost() {
return defaultHost;
}
- /**
- * Set the default host.
- *
- * @param host The new default host
- */
@Override
public void setDefaultHost(String host) {
@@ -139,41 +126,24 @@ public class StandardEngine extends ContainerBase implements Engine {
}
- /**
- * Set the cluster-wide unique identifier for this Engine. This value is only useful in a load-balancing scenario.
- * <p>
- * This property should not be changed once it is set.
- */
@Override
public void setJvmRoute(String routeId) {
jvmRouteId = routeId;
}
- /**
- * Retrieve the cluster-wide unique identifier for this Engine. This value is only useful in a load-balancing
- * scenario.
- */
@Override
public String getJvmRoute() {
return jvmRouteId;
}
- /**
- * Return the <code>Service</code> with which we are associated (if any).
- */
@Override
public Service getService() {
return this.service;
}
- /**
- * Set the <code>Service</code> with which we are associated (if any).
- *
- * @param service The service that owns this Engine
- */
@Override
public void setService(Service service) {
this.service = service;
@@ -183,9 +153,9 @@ public class StandardEngine extends ContainerBase implements Engine {
/**
- * Add a child Container, only if the proposed child is an implementation of Host.
- *
- * @param child Child container to be added
+ * {@inheritDoc}
+ * <p>
+ * The child must be an implementation of <code>Host</code>.
*/
@Override
public void addChild(Container child) {
@@ -221,13 +191,6 @@ public class StandardEngine extends ContainerBase implements Engine {
}
- /**
- * Start this component and implement the requirements of
- * {@link org.apache.catalina.util.LifecycleBase#startInternal()}.
- *
- * @exception LifecycleException if this component detects a fatal error that prevents this component from being
- * used
- */
@Override
protected void startInternal() throws LifecycleException {
@@ -242,6 +205,8 @@ public class StandardEngine extends ContainerBase implements Engine {
/**
+ * {@inheritDoc}
+ * <p>
* Override the default implementation. If no access log is defined for the Engine, look for one in the Engine's
* default host and then the default host's ROOT context. If still none is found, return the default NoOp access
* log.
@@ -300,9 +265,6 @@ public class StandardEngine extends ContainerBase implements Engine {
}
- /**
- * Return the parent class loader for this component.
- */
@Override
public ClassLoader getParentClassLoader() {
if (parentClassLoader != null) {
diff --git a/java/org/apache/catalina/core/StandardHost.java b/java/org/apache/catalina/core/StandardHost.java
index 2c901b3ff6..c8008ddc50 100644
--- a/java/org/apache/catalina/core/StandardHost.java
+++ b/java/org/apache/catalina/core/StandardHost.java
@@ -291,18 +291,12 @@ public class StandardHost extends ContainerBase implements Host {
}
- /**
- * ({@inheritDoc}
- */
@Override
public String getXmlBase() {
return this.xmlBase;
}
- /**
- * ({@inheritDoc}
- */
@Override
public void setXmlBase(String xmlBase) {
String oldXmlBase = this.xmlBase;
@@ -311,9 +305,6 @@ public class StandardHost extends ContainerBase implements Host {
}
- /**
- * ({@inheritDoc}
- */
@Override
public File getConfigBaseFile() {
if (hostConfigBase != null) {
@@ -347,27 +338,24 @@ public class StandardHost extends ContainerBase implements Host {
/**
- * @return <code>true</code> if the Host will attempt to create directories for appBase and xmlBase unless they
- * already exist.
+ * {@inheritDoc}
+ * <p>
+ * The default value for this implementation is {@code true}.
*/
@Override
public boolean getCreateDirs() {
return createDirs;
}
- /**
- * Set to <code>true</code> if the Host should attempt to create directories for xmlBase and appBase upon startup
- *
- * @param createDirs the new flag value
- */
@Override
public void setCreateDirs(boolean createDirs) {
this.createDirs = createDirs;
}
/**
- * @return the value of the auto deploy flag. If true, it indicates that this host's child webapps will be
- * dynamically deployed.
+ * {@inheritDoc}
+ * <p>
+ * The default value for this implementation is {@code true}.
*/
@Override
public boolean getAutoDeploy() {
@@ -375,11 +363,6 @@ public class StandardHost extends ContainerBase implements Host {
}
- /**
- * Set the auto deploy flag value for this host.
- *
- * @param autoDeploy The new auto deploy flag
- */
@Override
public void setAutoDeploy(boolean autoDeploy) {
@@ -390,20 +373,12 @@ public class StandardHost extends ContainerBase implements Host {
}
- /**
- * @return the Java class name of the context configuration class for new web applications.
- */
@Override
public String getConfigClass() {
return this.configClass;
}
- /**
- * Set the Java class name of the context configuration class for new web applications.
- *
- * @param configClass The new context configuration class
- */
@Override
public void setConfigClass(String configClass) {
@@ -437,8 +412,9 @@ public class StandardHost extends ContainerBase implements Host {
/**
- * @return the value of the deploy on startup flag. If <code>true</code>, it indicates that this host's child
- * webapps should be discovered and automatically deployed at startup time.
+ * {@inheritDoc}
+ * <p>
+ * The default value for this implementation is {@code true}.
*/
@Override
public boolean getDeployOnStartup() {
@@ -446,11 +422,6 @@ public class StandardHost extends ContainerBase implements Host {
}
- /**
- * Set the deploy on startup flag value for this host.
- *
- * @param deployOnStartup The new deploy on startup flag
- */
@Override
public void setDeployOnStartup(boolean deployOnStartup) {
@@ -519,22 +490,12 @@ public class StandardHost extends ContainerBase implements Host {
}
- /**
- * @return the canonical, fully qualified, name of the virtual host this Container represents.
- */
@Override
public String getName() {
return name;
}
- /**
- * Set the canonical, fully qualified, name of the virtual host this Container represents.
- *
- * @param name Virtual host name
- *
- * @exception IllegalArgumentException if name is null
- */
@Override
public void setName(String name) {
@@ -587,10 +548,6 @@ public class StandardHost extends ContainerBase implements Host {
}
- /**
- * @return the regular expression that defines the files and directories in the host's {@link #getAppBase} that will
- * be ignored by the automatic deployment process.
- */
@Override
public String getDeployIgnore() {
if (deployIgnore == null) {
@@ -600,22 +557,12 @@ public class StandardHost extends ContainerBase implements Host {
}
- /**
- * @return the compiled regular expression that defines the files and directories in the host's {@link #getAppBase}
- * that will be ignored by the automatic deployment process.
- */
@Override
public Pattern getDeployIgnorePattern() {
return this.deployIgnore;
}
- /**
- * Set the regular expression that defines the files and directories in the host's {@link #getAppBase} that will be
- * ignored by the automatic deployment process.
- *
- * @param deployIgnore the regexp
- */
@Override
public void setDeployIgnore(String deployIgnore) {
String oldDeployIgnore;
@@ -658,11 +605,6 @@ public class StandardHost extends ContainerBase implements Host {
// --------------------------------------------------------- Public Methods
- /**
- * Add an alias name that should be mapped to this same Host.
- *
- * @param alias The alias to be added
- */
@Override
public void addAlias(String alias) {
@@ -687,9 +629,9 @@ public class StandardHost extends ContainerBase implements Host {
/**
- * Add a child Container, only if the proposed child is an implementation of Context.
- *
- * @param child Child container to be added
+ * {@inheritDoc}
+ * <p>
+ * The child must be an implementation of <code>Context</code>.
*/
@Override
public void addChild(Container child) {
@@ -756,9 +698,6 @@ public class StandardHost extends ContainerBase implements Host {
return result.toArray(new String[0]);
}
- /**
- * @return the set of alias names for this Host. If none are defined, a zero length array is returned.
- */
@Override
public String[] findAliases() {
synchronized (aliasesLock) {
@@ -767,11 +706,6 @@ public class StandardHost extends ContainerBase implements Host {
}
- /**
- * Remove the specified alias name from the aliases for this Host.
- *
- * @param alias Alias name to be removed
- */
@Override
public void removeAlias(String alias) {
@@ -809,13 +743,6 @@ public class StandardHost extends ContainerBase implements Host {
}
- /**
- * Start this component and implement the requirements of
- * {@link org.apache.catalina.util.LifecycleBase#startInternal()}.
- *
- * @exception LifecycleException if this component detects a fatal error that prevents this component from being
- * used
- */
@Override
protected void startInternal() throws LifecycleException {
diff --git a/java/org/apache/catalina/core/StandardPipeline.java b/java/org/apache/catalina/core/StandardPipeline.java
index 2158a198f1..fc1d0adfcd 100644
--- a/java/org/apache/catalina/core/StandardPipeline.java
+++ b/java/org/apache/catalina/core/StandardPipeline.java
@@ -126,20 +126,12 @@ public class StandardPipeline extends LifecycleBase implements Pipeline {
// ------------------------------------------------------ Contained Methods
- /**
- * Return the Container with which this Pipeline is associated.
- */
@Override
public Container getContainer() {
return this.container;
}
- /**
- * Set the Container with which this Pipeline is associated.
- *
- * @param container The new associated container
- */
@Override
public void setContainer(Container container) {
this.container = container;
@@ -152,12 +144,6 @@ public class StandardPipeline extends LifecycleBase implements Pipeline {
}
- /**
- * Start {@link Valve}s) in this pipeline and implement the requirements of {@link LifecycleBase#startInternal()}.
- *
- * @exception LifecycleException if this component detects a fatal error that prevents this component from being
- * used
- */
@Override
protected void startInternal() throws LifecycleException {
@@ -177,12 +163,6 @@ public class StandardPipeline extends LifecycleBase implements Pipeline {
}
- /**
- * Stop {@link Valve}s) in this pipeline and implement the requirements of {@link LifecycleBase#stopInternal()}.
- *
- * @exception LifecycleException if this component detects a fatal error that prevents this component from being
- * used
- */
@Override
protected void stopInternal() throws LifecycleException {
@@ -211,9 +191,6 @@ public class StandardPipeline extends LifecycleBase implements Pipeline {
}
- /**
- * Return a String representation of this component.
- */
@Override
public String toString() {
return ToStringUtil.toString(this);
@@ -223,27 +200,12 @@ public class StandardPipeline extends LifecycleBase implements Pipeline {
// ------------------------------------------------------- Pipeline Methods
- /**
- * <p>
- * Return the Valve instance that has been distinguished as the basic Valve for this Pipeline (if any).
- */
@Override
public Valve getBasic() {
return this.basic;
}
- /**
- * <p>
- * Set the Valve instance that has been distinguished as the basic Valve for this Pipeline (if any). Prior to
- * setting the basic Valve, the Valve's <code>setContainer()</code> will be called, if it implements
- * <code>Contained</code>, with the owning Container as an argument. The method may throw an
- * <code>IllegalArgumentException</code> if this Valve chooses not to be associated with this Container, or
- * <code>IllegalStateException</code> if it is already associated with a different Container.
- * </p>
- *
- * @param valve Valve to be distinguished as the basic Valve
- */
@Override
public void setBasic(Valve valve) {
@@ -302,21 +264,6 @@ public class StandardPipeline extends LifecycleBase implements Pipeline {
}
- /**
- * <p>
- * Add a new Valve to the end of the pipeline associated with this Container. Prior to adding the Valve, the Valve's
- * <code>setContainer()</code> method will be called, if it implements <code>Contained</code>, with the owning
- * Container as an argument. The method may throw an <code>IllegalArgumentException</code> if this Valve chooses not
- * to be associated with this Container, or <code>IllegalStateException</code> if it is already associated with a
- * different Container.
- * </p>
- *
- * @param valve Valve to be added
- *
- * @exception IllegalArgumentException if this Container refused to accept the specified Valve
- * @exception IllegalArgumentException if the specified Valve refuses to be associated with this Container
- * @exception IllegalStateException if the specified Valve is already associated with a different Container
- */
@Override
public void addValve(Valve valve) {
@@ -356,10 +303,6 @@ public class StandardPipeline extends LifecycleBase implements Pipeline {
}
- /**
- * Return the set of Valves in the pipeline associated with this Container, including the basic Valve (if any). If
- * there are no such Valves, a zero-length array is returned.
- */
@Override
public Valve[] getValves() {
@@ -395,13 +338,6 @@ public class StandardPipeline extends LifecycleBase implements Pipeline {
}
- /**
- * Remove the specified Valve from the pipeline associated with this Container, if it is found; otherwise, do
- * nothing. If the Valve is found and removed, the Valve's <code>setContainer(null)</code> method will be called if
- * it implements <code>Contained</code>.
- *
- * @param valve Valve to be removed
- */
@Override
public void removeValve(Valve valve) {
diff --git a/java/org/apache/catalina/core/StandardServer.java b/java/org/apache/catalina/core/StandardServer.java
index 29330e4edc..241c57ed1a 100644
--- a/java/org/apache/catalina/core/StandardServer.java
+++ b/java/org/apache/catalina/core/StandardServer.java
@@ -222,9 +222,6 @@ public final class StandardServer extends LifecycleMBeanBase implements Server {
}
- /**
- * Return the global naming resources context.
- */
@Override
public javax.naming.Context getGlobalNamingContext() {
return this.globalNamingContext;
@@ -241,20 +238,12 @@ public final class StandardServer extends LifecycleMBeanBase implements Server {
}
- /**
- * Return the global naming resources.
- */
@Override
public NamingResourcesImpl getGlobalNamingResources() {
return this.globalNamingResources;
}
- /**
- * Set the global naming resources.
- *
- * @param globalNamingResources The new global naming resources
- */
@Override
public void setGlobalNamingResources(NamingResourcesImpl globalNamingResources) {
@@ -296,20 +285,12 @@ public final class StandardServer extends LifecycleMBeanBase implements Server {
}
- /**
- * Return the port number we listen to for shutdown commands.
- */
@Override
public int getPort() {
return this.port;
}
- /**
- * Set the port number we listen to for shutdown commands.
- *
- * @param port The new port number
- */
@Override
public void setPort(int port) {
this.port = port;
@@ -345,57 +326,35 @@ public final class StandardServer extends LifecycleMBeanBase implements Server {
}
- /**
- * Return the address on which we listen to for shutdown commands.
- */
@Override
public String getAddress() {
return this.address;
}
- /**
- * Set the address on which we listen to for shutdown commands.
- *
- * @param address The new address
- */
@Override
public void setAddress(String address) {
this.address = address;
}
- /**
- * Return the shutdown command string we are waiting for.
- */
@Override
public String getShutdown() {
return this.shutdown;
}
- /**
- * Set the shutdown command we are waiting for.
- *
- * @param shutdown The new shutdown command
- */
@Override
public void setShutdown(String shutdown) {
this.shutdown = shutdown;
}
- /**
- * Return the outer Catalina startup/shutdown component if present.
- */
@Override
public Catalina getCatalina() {
return catalina;
}
- /**
- * Set the outer Catalina startup/shutdown component if present.
- */
@Override
public void setCatalina(Catalina catalina) {
this.catalina = catalina;
@@ -499,11 +458,6 @@ public final class StandardServer extends LifecycleMBeanBase implements Server {
// --------------------------------------------------------- Server Methods
- /**
- * Add a new Service to the set of defined Services.
- *
- * @param service The Service to be added
- */
@Override
public void addService(Service service) {
@@ -553,10 +507,6 @@ public final class StandardServer extends LifecycleMBeanBase implements Server {
}
}
- /**
- * Wait until a proper shutdown command is received, then return. This keeps the main thread alive - the thread pool
- * listening for http connections is daemon threads.
- */
@Override
public void await() {
// Negative values - don't wait on port - tomcat is embedded or we just don't like ports
@@ -685,11 +635,6 @@ public final class StandardServer extends LifecycleMBeanBase implements Server {
}
- /**
- * @return the specified Service (if it exists); otherwise return <code>null</code>.
- *
- * @param name Name of the Service to be returned
- */
@Override
public Service findService(String name) {
if (name == null) {
@@ -711,9 +656,6 @@ public final class StandardServer extends LifecycleMBeanBase implements Server {
}
- /**
- * @return The array of Services defined within this Server.
- */
@Override
public Service[] findServices() {
servicesReadLock.lock();
@@ -743,11 +685,6 @@ public final class StandardServer extends LifecycleMBeanBase implements Server {
}
- /**
- * Remove the specified Service from the set associated from this Server.
- *
- * @param service The Service to be removed
- */
@Override
public void removeService(Service service) {
@@ -842,9 +779,6 @@ public final class StandardServer extends LifecycleMBeanBase implements Server {
}
- /**
- * Return a String representation of this component.
- */
@Override
public String toString() {
return "StandardServer[" + getPort() + ']';
@@ -917,13 +851,6 @@ public final class StandardServer extends LifecycleMBeanBase implements Server {
}
- /**
- * Start nested components ({@link Service}s) and implement the requirements of
- * {@link org.apache.catalina.util.LifecycleBase#startInternal()}.
- *
- * @exception LifecycleException if this component detects a fatal error that prevents this component from being
- * used
- */
@Override
protected void startInternal() throws LifecycleException {
@@ -967,12 +894,6 @@ public final class StandardServer extends LifecycleMBeanBase implements Server {
}
- /**
- * Stop nested components ({@link Service}s) and implement the requirements of
- * {@link org.apache.catalina.util.LifecycleBase#stopInternal()}.
- *
- * @exception LifecycleException if this component detects a fatal error that needs to be reported
- */
@Override
protected void stopInternal() throws LifecycleException {
@@ -1008,7 +929,9 @@ public final class StandardServer extends LifecycleMBeanBase implements Server {
}
/**
- * Invoke a pre-startup initialization. This is used to allow connectors to bind to restricted ports under Unix
+ * {@inheritDoc}
+ * <p>
+ * This is used to allow connectors to bind to restricted ports under Unix
* operating environments.
*/
@Override
@@ -1052,9 +975,6 @@ public final class StandardServer extends LifecycleMBeanBase implements Server {
super.destroyInternal();
}
- /**
- * Return the parent class loader for this component.
- */
@Override
public ClassLoader getParentClassLoader() {
if (parentClassLoader != null) {
@@ -1066,11 +986,6 @@ public final class StandardServer extends LifecycleMBeanBase implements Server {
return ClassLoader.getSystemClassLoader();
}
- /**
- * Set the parent class loader for this server.
- *
- * @param parent The new parent class loader
- */
@Override
public void setParentClassLoader(ClassLoader parent) {
ClassLoader oldParentClassLoader = this.parentClassLoader;
@@ -1083,7 +998,7 @@ public final class StandardServer extends LifecycleMBeanBase implements Server {
private ObjectName onameMBeanFactory;
/**
- * Obtain the MBean domain for this server. The domain is obtained using the following search order:
+ * @return the MBean domain for this server. The domain is obtained using the following search order:
* <ol>
* <li>Name of first {@link org.apache.catalina.Engine}.</li>
* <li>Name of first {@link Service}.</li>
diff --git a/java/org/apache/catalina/core/StandardService.java b/java/org/apache/catalina/core/StandardService.java
index 461d8aa62b..724dde9668 100644
--- a/java/org/apache/catalina/core/StandardService.java
+++ b/java/org/apache/catalina/core/StandardService.java
@@ -173,40 +173,24 @@ public class StandardService extends LifecycleMBeanBase implements Service {
}
- /**
- * Return the name of this Service.
- */
@Override
public String getName() {
return name;
}
- /**
- * Set the name of this Service.
- *
- * @param name The new service name
- */
@Override
public void setName(String name) {
this.name = name;
}
- /**
- * Return the <code>Server</code> with which we are associated (if any).
- */
@Override
public Server getServer() {
return this.server;
}
- /**
- * Set the <code>Server</code> with which we are associated (if any).
- *
- * @param server The server that owns this Service
- */
@Override
public void setServer(Server server) {
this.server = server;
@@ -215,11 +199,6 @@ public class StandardService extends LifecycleMBeanBase implements Service {
// --------------------------------------------------------- Public Methods
- /**
- * Add a new Connector to the set of defined Connectors, and associate it with this Service's Container.
- *
- * @param connector The Connector to be added
- */
@Override
public void addConnector(Connector connector) {
@@ -273,9 +252,6 @@ public class StandardService extends LifecycleMBeanBase implements Service {
}
- /**
- * Find and return the set of Connectors associated with this Service.
- */
@Override
public Connector[] findConnectors() {
Lock readLock = connectorsLock.readLock();
@@ -289,12 +265,6 @@ public class StandardService extends LifecycleMBeanBase implements Service {
}
- /**
- * Remove the specified Connector from the set associated from this Service. The removed Connector will also be
- * disassociated from our Container.
- *
- * @param connector The Connector to be removed
- */
@Override
public void removeConnector(Connector connector) {
@@ -348,9 +318,6 @@ public class StandardService extends LifecycleMBeanBase implements Service {
}
- /**
- * Return a String representation of this component.
- */
@Override
public String toString() {
StringBuilder sb = new StringBuilder("StandardService[");
@@ -360,11 +327,6 @@ public class StandardService extends LifecycleMBeanBase implements Service {
}
- /**
- * Adds a named executor to the service
- *
- * @param ex Executor
- */
@Override
public void addExecutor(Executor ex) {
boolean added = false;
@@ -387,11 +349,6 @@ public class StandardService extends LifecycleMBeanBase implements Service {
}
- /**
- * Retrieves all executors
- *
- * @return Executor[]
- */
@Override
public Executor[] findExecutors() {
executorsLock.readLock().lock();
@@ -403,13 +360,6 @@ public class StandardService extends LifecycleMBeanBase implements Service {
}
- /**
- * Retrieves executor by name, null if not found
- *
- * @param executorName String
- *
- * @return Executor
- */
@Override
public Executor getExecutor(String executorName) {
executorsLock.readLock().lock();
@@ -426,11 +376,6 @@ public class StandardService extends LifecycleMBeanBase implements Service {
}
- /**
- * Removes an executor from the service
- *
- * @param ex Executor
- */
@Override
public void removeExecutor(Executor ex) {
boolean removed = false;
@@ -552,6 +497,8 @@ public class StandardService extends LifecycleMBeanBase implements Service {
/**
* Invoke a pre-startup initialization. This is used to allow connectors to bind to restricted ports under Unix
* operating environments.
+ *
+ * @exception LifecycleException if this component detects a fatal error that needs to be reported
*/
@Override
protected void initInternal() throws LifecycleException {
@@ -602,9 +549,6 @@ public class StandardService extends LifecycleMBeanBase implements Service {
}
- /**
- * Return the parent class loader for this component.
- */
@Override
public ClassLoader getParentClassLoader() {
if (parentClassLoader != null) {
@@ -617,11 +561,6 @@ public class StandardService extends LifecycleMBeanBase implements Service {
}
- /**
- * Set the parent class loader for this server.
- *
- * @param parent The new parent class loader
- */
@Override
public void setParentClassLoader(ClassLoader parent) {
ClassLoader oldParentClassLoader = this.parentClassLoader;
diff --git a/java/org/apache/catalina/core/StandardWrapper.java b/java/org/apache/catalina/core/StandardWrapper.java
index dff9813187..bb38df260e 100644
--- a/java/org/apache/catalina/core/StandardWrapper.java
+++ b/java/org/apache/catalina/core/StandardWrapper.java
@@ -238,26 +238,12 @@ public class StandardWrapper extends ContainerBase implements ServletConfig, Wra
this.overridable = overridable;
}
- /**
- * Return the available date/time for this servlet, in milliseconds since the epoch. If this date/time is
- * Long.MAX_VALUE, it is considered to mean that unavailability is permanent and any request for this servlet will
- * return an SC_NOT_FOUND error. If this date/time is in the future, any request for this servlet will return an
- * SC_SERVICE_UNAVAILABLE error. If it is zero, the servlet is currently available.
- */
@Override
public long getAvailable() {
return this.available;
}
- /**
- * Set the available date/time for this servlet, in milliseconds since the epoch. If this date/time is
- * Long.MAX_VALUE, it is considered to mean that unavailability is permanent and any request for this servlet will
- * return an SC_NOT_FOUND error. If this date/time is in the future, any request for this servlet will return an
- * SC_SERVICE_UNAVAILABLE error.
- *
- * @param available The new available date/time
- */
@Override
public void setAvailable(long available) {
long oldAvailable = this.available;
@@ -278,9 +264,6 @@ public class StandardWrapper extends ContainerBase implements ServletConfig, Wra
}
- /**
- * @return the load-on-startup order value (negative value means load on first call).
- */
@Override
public int getLoadOnStartup() {
@@ -296,11 +279,6 @@ public class StandardWrapper extends ContainerBase implements ServletConfig, Wra
}
- /**
- * Set the load-on-startup order value (negative value means load on first call).
- *
- * @param value New load-on-startup value
- */
@Override
public void setLoadOnStartup(int value) {
@@ -356,20 +334,12 @@ public class StandardWrapper extends ContainerBase implements ServletConfig, Wra
}
- /**
- * @return the run-as identity for this servlet.
- */
@Override
public String getRunAs() {
return this.runAs;
}
- /**
- * Set the run-as identity for this servlet.
- *
- * @param runAs New run-as identity value
- */
@Override
public void setRunAs(String runAs) {
@@ -380,20 +350,12 @@ public class StandardWrapper extends ContainerBase implements ServletConfig, Wra
}
- /**
- * @return the fully qualified servlet class name for this servlet.
- */
@Override
public String getServletClass() {
return this.servletClass;
}
- /**
- * Set the fully qualified servlet class name for this servlet.
- *
- * @param servletClass Servlet class name
- */
@Override
public void setServletClass(String servletClass) {
@@ -419,9 +381,6 @@ public class StandardWrapper extends ContainerBase implements ServletConfig, Wra
}
- /**
- * @return <code>true</code> if the Servlet has been marked unavailable.
- */
@Override
public boolean isUnavailable() {
@@ -480,18 +439,12 @@ public class StandardWrapper extends ContainerBase implements ServletConfig, Wra
}
- /**
- * @return the associated servlet instance.
- */
@Override
public Servlet getServlet() {
return instance;
}
- /**
- * Set the associated servlet instance.
- */
@Override
public void setServlet(Servlet servlet) {
instance = servlet;
@@ -500,10 +453,6 @@ public class StandardWrapper extends ContainerBase implements ServletConfig, Wra
// --------------------------------------------------------- Public Methods
- /**
- * Execute a periodic task, such as reloading, etc. This method will be invoked inside the classloading context of
- * this container. Unexpected throwables will be caught and logged.
- */
@Override
public synchronized void backgroundProcess() {
super.backgroundProcess();
@@ -554,12 +503,6 @@ public class StandardWrapper extends ContainerBase implements ServletConfig, Wra
}
- /**
- * Add a new servlet initialization parameter for this servlet.
- *
- * @param name Name of this initialization parameter to add
- * @param value Value of this initialization parameter to add
- */
@Override
public void addInitParameter(String name, String value) {
@@ -574,11 +517,6 @@ public class StandardWrapper extends ContainerBase implements ServletConfig, Wra
}
- /**
- * Add a mapping associated with the Wrapper.
- *
- * @param mapping The new wrapper mapping
- */
@Override
public void addMapping(String mapping) {
@@ -595,12 +533,6 @@ public class StandardWrapper extends ContainerBase implements ServletConfig, Wra
}
- /**
- * Add a new security role reference record to the set of records for this servlet.
- *
- * @param name Role name used within this servlet
- * @param link Role name used within the web application
- */
@Override
public void addSecurityReference(String name, String link) {
@@ -615,12 +547,6 @@ public class StandardWrapper extends ContainerBase implements ServletConfig, Wra
}
- /**
- * Allocate an initialized instance of this Servlet that is ready to have its <code>service()</code> method called.
- *
- * @exception ServletException if the servlet init() method threw an exception
- * @exception ServletException if a loading error occurs
- */
@Override
public Servlet allocate() throws ServletException {
@@ -669,24 +595,12 @@ public class StandardWrapper extends ContainerBase implements ServletConfig, Wra
}
- /**
- * Decrement the allocation count for this servlet.
- *
- * @param servlet The servlet to be returned
- *
- * @exception ServletException if a deallocation error occurs
- */
@Override
public void deallocate(Servlet servlet) throws ServletException {
countAllocated.decrementAndGet();
}
- /**
- * Return the value for the specified initialization parameter name, if any; otherwise return <code>null</code>.
- *
- * @param name Name of the requested initialization parameter
- */
@Override
public String findInitParameter(String name) {
@@ -700,9 +614,6 @@ public class StandardWrapper extends ContainerBase implements ServletConfig, Wra
}
- /**
- * Return the names of all defined initialization parameters for this servlet.
- */
@Override
public String[] findInitParameters() {
@@ -716,9 +627,6 @@ public class StandardWrapper extends ContainerBase implements ServletConfig, Wra
}
- /**
- * Return the mappings associated with this wrapper.
- */
@Override
public String[] findMappings() {
@@ -732,12 +640,6 @@ public class StandardWrapper extends ContainerBase implements ServletConfig, Wra
}
- /**
- * Return the security role link for the specified security role reference name, if any; otherwise return
- * <code>null</code>.
- *
- * @param name Security role reference used within this servlet
- */
@Override
public String findSecurityReference(String name) {
String reference = null;
@@ -763,10 +665,6 @@ public class StandardWrapper extends ContainerBase implements ServletConfig, Wra
}
- /**
- * Return the set of security role reference names associated with this servlet, if any; otherwise return a
- * zero-length array.
- */
@Override
public String[] findSecurityReferences() {
@@ -781,17 +679,12 @@ public class StandardWrapper extends ContainerBase implements ServletConfig, Wra
/**
- * Load and initialize an instance of this servlet, if there is not already at least one initialized instance. This
- * can be used, for example, to load servlets that are marked in the deployment descriptor to be loaded at server
- * startup time.
+ * {@inheritDoc}
* <p>
* <b>IMPLEMENTATION NOTE</b>: Servlets whose classnames begin with <code>org.apache.catalina.</code> (so-called
* "container" servlets) are loaded by the same classloader that loaded this class, rather than the classloader for
* the current web application. This gives such classes access to Catalina internals, which are prevented for
* classes loaded for web applications.
- *
- * @exception ServletException if the servlet init() method threw an exception
- * @exception ServletException if some other loading problem occurs
*/
@Override
public synchronized void load() throws ServletException {
@@ -939,11 +832,6 @@ public class StandardWrapper extends ContainerBase implements ServletConfig, Wra
}
}
- /**
- * Remove the specified initialization parameter from this servlet.
- *
- * @param name Name of the initialization parameter to remove
- */
@Override
public void removeInitParameter(String name) {
@@ -958,11 +846,6 @@ public class StandardWrapper extends ContainerBase implements ServletConfig, Wra
}
- /**
- * Remove a mapping associated with the wrapper.
- *
- * @param mapping The pattern to remove
- */
@Override
public void removeMapping(String mapping) {
@@ -979,11 +862,6 @@ public class StandardWrapper extends ContainerBase implements ServletConfig, Wra
}
- /**
- * Remove any security role reference for the specified role name.
- *
- * @param name Security role used within this servlet to be removed
- */
@Override
public void removeSecurityReference(String name) {
@@ -998,12 +876,6 @@ public class StandardWrapper extends ContainerBase implements ServletConfig, Wra
}
- /**
- * Process an UnavailableException, marking this servlet as unavailable for the specified amount of time.
- *
- * @param unavailable The exception that occurred, or <code>null</code> to mark this servlet as permanently
- * unavailable
- */
@Override
public void unavailable(UnavailableException unavailable) {
getServletContext().log(sm.getString("standardWrapper.unavailable", getName()));
@@ -1022,13 +894,6 @@ public class StandardWrapper extends ContainerBase implements ServletConfig, Wra
}
- /**
- * Unload all initialized instances of this servlet, after calling the <code>destroy()</code> method for each
- * instance. This can be used, for example, prior to shutting down the entire servlet engine, or prior to reloading
- * all of the classes from the Loader associated with our Loader's repository.
- *
- * @exception ServletException if an exception is thrown by the destroy() method
- */
@Override
public synchronized void unload() throws ServletException {
@@ -1393,12 +1258,6 @@ public class StandardWrapper extends ContainerBase implements ServletConfig, Wra
}
- /**
- * Remove a JMX notificationListener
- *
- * @see javax.management.NotificationEmitter#removeNotificationListener(javax.management.NotificationListener,
- * javax.management.NotificationFilter, java.lang.Object)
- */
@Override
public void removeNotificationListener(NotificationListener listener, NotificationFilter filter, Object object)
throws ListenerNotFoundException {
@@ -1407,11 +1266,6 @@ public class StandardWrapper extends ContainerBase implements ServletConfig, Wra
protected MBeanNotificationInfo[] notificationInfo;
- /**
- * Get JMX Broadcaster Info
- *
- * @see javax.management.NotificationBroadcaster#getNotificationInfo()
- */
@Override
public MBeanNotificationInfo[] getNotificationInfo() {
if (notificationInfo == null) {
@@ -1433,12 +1287,6 @@ public class StandardWrapper extends ContainerBase implements ServletConfig, Wra
}
- /**
- * Add a JMX-NotificationListener
- *
- * @see javax.management.NotificationBroadcaster#addNotificationListener(javax.management.NotificationListener,
- * javax.management.NotificationFilter, java.lang.Object)
- */
@Override
public void addNotificationListener(NotificationListener listener, NotificationFilter filter, Object object)
throws IllegalArgumentException {
@@ -1446,11 +1294,6 @@ public class StandardWrapper extends ContainerBase implements ServletConfig, Wra
}
- /**
- * Remove a JMX-NotificationListener
- *
- * @see javax.management.NotificationBroadcaster#removeNotificationListener(javax.management.NotificationListener)
- */
@Override
public void removeNotificationListener(NotificationListener listener) throws ListenerNotFoundException {
broadcaster.removeNotificationListener(listener);
diff --git a/java/org/apache/catalina/util/LifecycleMBeanBase.java b/java/org/apache/catalina/util/LifecycleMBeanBase.java
index 37217af711..e6ba64aa53 100644
--- a/java/org/apache/catalina/util/LifecycleMBeanBase.java
+++ b/java/org/apache/catalina/util/LifecycleMBeanBase.java
@@ -40,11 +40,6 @@ public abstract class LifecycleMBeanBase extends LifecycleBase
private String domain = null;
private ObjectName oname = null;
- /**
- * Sub-classes wishing to perform additional initialization should override
- * this method, ensuring that super.initInternal() is the first call in the
- * overriding method.
- */
@Override
protected void initInternal() throws LifecycleException {
// If oname is not null then registration has already happened via
@@ -55,32 +50,18 @@ public abstract class LifecycleMBeanBase extends LifecycleBase
}
- /**
- * Sub-classes wishing to perform additional clean-up should override this
- * method, ensuring that super.destroyInternal() is the last call in the
- * overriding method.
- */
@Override
protected void destroyInternal() throws LifecycleException {
unregister(oname);
}
- /**
- * Specify the domain under which this component should be registered. Used
- * with components that cannot (easily) navigate the component hierarchy to
- * determine the correct domain to use.
- */
@Override
public final void setDomain(String domain) {
this.domain = domain;
}
- /**
- * Obtain the domain under which this component will be / has been
- * registered.
- */
@Override
public final String getDomain() {
if (domain == null) {
@@ -104,9 +85,6 @@ public abstract class LifecycleMBeanBase extends LifecycleBase
protected abstract String getDomainInternal();
- /**
- * Obtain the name under which this component has been registered with JMX.
- */
@Override
public final ObjectName getObjectName() {
return oname;
@@ -219,10 +197,6 @@ public abstract class LifecycleMBeanBase extends LifecycleBase
}
- /**
- * Allows the object to be registered with an alternative
- * {@link MBeanServer} and/or {@link ObjectName}.
- */
@Override
public final ObjectName preRegister(MBeanServer server, ObjectName name)
throws Exception {
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org