This is an automated email from the ASF dual-hosted git repository.
remm pushed a commit to branch 10.1.x
in repository https://gitbox.apache.org/repos/asf/tomcat.git
The following commit(s) were added to refs/heads/10.1.x by this push:
new 639ee683b5 Remove override javadoc
639ee683b5 is described below
commit 639ee683b57acfc95b7547e871b3b176edc4f3ca
Author: remm <r...@apache.org>
AuthorDate: Fri Mar 29 11:05:39 2024 +0100
Remove override javadoc
Remove very outdated boilerplate override javadoc from the Servlet API.
---
java/org/apache/catalina/connector/Request.java | 197 -----------------------
java/org/apache/catalina/connector/Response.java | 152 -----------------
2 files changed, 349 deletions(-)
diff --git a/java/org/apache/catalina/connector/Request.java
b/java/org/apache/catalina/connector/Request.java
index a013f88bca..b5240f6602 100644
--- a/java/org/apache/catalina/connector/Request.java
+++ b/java/org/apache/catalina/connector/Request.java
@@ -830,11 +830,6 @@ public class Request implements HttpServletRequest {
// ------------------------------------------------- ServletRequest Methods
- /**
- * @return the specified request attribute if it exists; otherwise, return
<code>null</code>.
- *
- * @param name Name of the request attribute to return
- */
@Override
public Object getAttribute(String name) {
// Special attributes
@@ -938,9 +933,6 @@ public class Request implements HttpServletRequest {
}
- /**
- * @return the character encoding for this Request.
- */
@Override
public String getCharacterEncoding() {
String characterEncoding = coyoteRequest.getCharacterEncoding();
@@ -984,18 +976,12 @@ public class Request implements HttpServletRequest {
}
- /**
- * @return the content length for this Request.
- */
@Override
public int getContentLength() {
return coyoteRequest.getContentLength();
}
- /**
- * @return the content type for this Request.
- */
@Override
public String getContentType() {
return coyoteRequest.getContentType();
@@ -1012,13 +998,6 @@ public class Request implements HttpServletRequest {
}
- /**
- * @return the servlet input stream for this Request. The default
implementation returns a servlet input stream
- * created by <code>createInputStream()</code>.
- *
- * @exception IllegalStateException if <code>getReader()</code> has
already been called for this request
- * @exception IOException if an input/output error occurs
- */
@Override
public ServletInputStream getInputStream() throws IOException {
@@ -1035,11 +1014,6 @@ public class Request implements HttpServletRequest {
}
- /**
- * @return the preferred Locale that the client will accept content in,
based on the value for the first
- * <code>Accept-Language</code> header that was encountered.
If the request did not specify a preferred
- * language, the server's default Locale is returned.
- */
@Override
public Locale getLocale() {
@@ -1055,11 +1029,6 @@ public class Request implements HttpServletRequest {
}
- /**
- * @return the set of preferred Locales that the client will accept
content in, based on the values for any
- * <code>Accept-Language</code> headers that were encountered.
If the request did not specify a
- * preferred language, the server's default Locale is returned.
- */
@Override
public Enumeration<Locale> getLocales() {
@@ -1154,24 +1123,12 @@ public class Request implements HttpServletRequest {
}
- /**
- * @return the protocol and version used to make this Request.
- */
@Override
public String getProtocol() {
return coyoteRequest.protocol().toStringType();
}
- /**
- * Read the Reader wrapping the input stream for this Request. The default
implementation wraps a
- * <code>BufferedReader</code> around the servlet input stream returned by
<code>createInputStream()</code>.
- *
- * @return a buffered reader for the request
- *
- * @exception IllegalStateException if <code>getInputStream()</code> has
already been called for this request
- * @exception IOException if an input/output error occurs
- */
@Override
public BufferedReader getReader() throws IOException {
@@ -1207,9 +1164,6 @@ public class Request implements HttpServletRequest {
}
- /**
- * @return the remote IP address making this Request.
- */
@Override
public String getRemoteAddr() {
if (remoteAddr == null) {
@@ -1232,9 +1186,6 @@ public class Request implements HttpServletRequest {
}
- /**
- * @return the remote host name making this Request.
- */
@Override
public String getRemoteHost() {
if (remoteHost == null) {
@@ -1248,9 +1199,6 @@ public class Request implements HttpServletRequest {
return remoteHost;
}
- /**
- * @return the Internet Protocol (IP) source port of the client or last
proxy that sent the request.
- */
@Override
public int getRemotePort() {
if (remotePort == -1) {
@@ -1260,9 +1208,6 @@ public class Request implements HttpServletRequest {
return remotePort;
}
- /**
- * @return the host name of the Internet Protocol (IP) interface on which
the request was received.
- */
@Override
public String getLocalName() {
if (localName == null) {
@@ -1272,9 +1217,6 @@ public class Request implements HttpServletRequest {
return localName;
}
- /**
- * @return the Internet Protocol (IP) address of the interface on which
the request was received.
- */
@Override
public String getLocalAddr() {
if (localAddr == null) {
@@ -1285,9 +1227,6 @@ public class Request implements HttpServletRequest {
}
- /**
- * @return the Internet Protocol (IP) port number of the interface on
which the request was received.
- */
@Override
public int getLocalPort() {
if (localPort == -1) {
@@ -1297,12 +1236,6 @@ public class Request implements HttpServletRequest {
return localPort;
}
- /**
- * @return a RequestDispatcher that wraps the resource at the specified
path, which may be interpreted as relative
- * to the current request path.
- *
- * @param path Path of the resource to be wrapped
- */
@Override
public RequestDispatcher getRequestDispatcher(String path) {
@@ -1376,47 +1309,30 @@ public class Request implements HttpServletRequest {
}
- /**
- * @return the scheme used to make this Request.
- */
@Override
public String getScheme() {
return coyoteRequest.scheme().toStringType();
}
- /**
- * @return the server name responding to this Request.
- */
@Override
public String getServerName() {
return coyoteRequest.serverName().toString();
}
- /**
- * @return the server port responding to this Request.
- */
@Override
public int getServerPort() {
return coyoteRequest.getServerPort();
}
- /**
- * @return <code>true</code> if this request was received on a secure
connection.
- */
@Override
public boolean isSecure() {
return secure;
}
- /**
- * Remove the specified request attribute if it exists.
- *
- * @param name Name of the request attribute to remove
- */
@Override
public void removeAttribute(String name) {
// Remove the specified attribute
@@ -1436,12 +1352,6 @@ public class Request implements HttpServletRequest {
}
- /**
- * Set the specified request attribute to the specified value.
- *
- * @param name Name of the request attribute to set
- * @param value The associated value
- */
@Override
public void setAttribute(String name, Object value) {
@@ -1570,16 +1480,6 @@ public class Request implements HttpServletRequest {
}
- /**
- * Overrides the name of the character encoding used in the body of this
request. This method must be called prior
- * to reading request parameters or reading input using
<code>getReader()</code>.
- *
- * @param enc The character encoding to be used
- *
- * @exception UnsupportedEncodingException if the specified encoding is
not supported
- *
- * @since Servlet 2.3
- */
@Override
public void setCharacterEncoding(String enc) throws
UnsupportedEncodingException {
@@ -2015,19 +1915,12 @@ public class Request implements HttpServletRequest {
}
- /**
- * Return the authentication type used for this Request.
- */
@Override
public String getAuthType() {
return authType;
}
- /**
- * Return the portion of the request URI used to select the Context of the
Request. The value returned is not
- * decoded which also implies it is not normalised.
- */
@Override
public String getContextPath() {
int lastSlash = mappingData.contextSlashCount;
@@ -2143,12 +2036,6 @@ public class Request implements HttpServletRequest {
}
- /**
- * Return the set of Cookies received with this Request. Triggers parsing
of the Cookie HTTP headers followed by
- * conversion to Cookie objects if this has not already been performed.
- *
- * @return the array of cookies
- */
@Override
public Cookie[] getCookies() {
if (!cookiesConverted) {
@@ -2170,15 +2057,6 @@ public class Request implements HttpServletRequest {
}
- /**
- * Return the value of the specified date header, if any; otherwise return
-1.
- *
- * @param name Name of the requested date header
- *
- * @return the date as a long
- *
- * @exception IllegalArgumentException if the specified header value
cannot be converted to a date
- */
@Override
public long getDateHeader(String name) {
@@ -2197,50 +2075,24 @@ public class Request implements HttpServletRequest {
}
- /**
- * Return the first value of the specified header, if any; otherwise,
return <code>null</code>
- *
- * @param name Name of the requested header
- *
- * @return the header value
- */
@Override
public String getHeader(String name) {
return coyoteRequest.getHeader(name);
}
- /**
- * Return all of the values of the specified header, if any; otherwise,
return an empty enumeration.
- *
- * @param name Name of the requested header
- *
- * @return the enumeration with the header values
- */
@Override
public Enumeration<String> getHeaders(String name) {
return coyoteRequest.getMimeHeaders().values(name);
}
- /**
- * @return the names of all headers received with this request.
- */
@Override
public Enumeration<String> getHeaderNames() {
return coyoteRequest.getMimeHeaders().names();
}
- /**
- * Return the value of the specified header as an integer, or -1 if there
is no such header for this request.
- *
- * @param name Name of the requested header
- *
- * @return the header value as an int
- *
- * @exception IllegalArgumentException if the specified header value
cannot be converted to an integer
- */
@Override
public int getIntHeader(String name) {
@@ -2259,27 +2111,18 @@ public class Request implements HttpServletRequest {
}
- /**
- * @return the HTTP request method used in this Request.
- */
@Override
public String getMethod() {
return coyoteRequest.method().toStringType();
}
- /**
- * @return the path information associated with this Request.
- */
@Override
public String getPathInfo() {
return mappingData.pathInfo.toStringType();
}
- /**
- * @return the extra path information for this request, translated to a
real path.
- */
@Override
public String getPathTranslated() {
@@ -2296,18 +2139,12 @@ public class Request implements HttpServletRequest {
}
- /**
- * @return the query string associated with this request.
- */
@Override
public String getQueryString() {
return coyoteRequest.queryString().toString();
}
- /**
- * @return the name of the remote user that has been authenticated for
this Request.
- */
@Override
public String getRemoteUser() {
@@ -2329,18 +2166,12 @@ public class Request implements HttpServletRequest {
}
- /**
- * @return the session identifier included in this request, if any.
- */
@Override
public String getRequestedSessionId() {
return requestedSessionId;
}
- /**
- * @return the request URI for this request.
- */
@Override
public String getRequestURI() {
return coyoteRequest.requestURI().toStringType();
@@ -2353,29 +2184,18 @@ public class Request implements HttpServletRequest {
}
- /**
- * @return the portion of the request URI used to select the servlet that
will process this request.
- */
@Override
public String getServletPath() {
return mappingData.wrapperPath.toStringType();
}
- /**
- * @return the session associated with this Request, creating one if
necessary.
- */
@Override
public HttpSession getSession() {
return getSession(true);
}
- /**
- * @return the session associated with this Request, creating one if
necessary and requested.
- *
- * @param create Create a new session if one does not exist
- */
@Override
public HttpSession getSession(boolean create) {
Session session = doGetSession(create);
@@ -2387,9 +2207,6 @@ public class Request implements HttpServletRequest {
}
- /**
- * @return <code>true</code> if the session identifier included in this
request came from a cookie.
- */
@Override
public boolean isRequestedSessionIdFromCookie() {
@@ -2401,9 +2218,6 @@ public class Request implements HttpServletRequest {
}
- /**
- * @return <code>true</code> if the session identifier included in this
request came from the request URI.
- */
@Override
public boolean isRequestedSessionIdFromURL() {
@@ -2415,9 +2229,6 @@ public class Request implements HttpServletRequest {
}
- /**
- * @return <code>true</code> if the session identifier included in this
request identifies a valid session.
- */
@Override
public boolean isRequestedSessionIdValid() {
@@ -2474,11 +2285,6 @@ public class Request implements HttpServletRequest {
}
- /**
- * @return <code>true</code> if the authenticated user principal possesses
the specified role name.
- *
- * @param role Role name to be validated
- */
@Override
public boolean isUserInRole(String role) {
@@ -2523,9 +2329,6 @@ public class Request implements HttpServletRequest {
}
- /**
- * @return the principal that has been authenticated for this Request.
- */
@Override
public Principal getUserPrincipal() {
if (userPrincipal instanceof TomcatPrincipal) {
diff --git a/java/org/apache/catalina/connector/Response.java
b/java/org/apache/catalina/connector/Response.java
index e4a2e0c5ce..f1e496e681 100644
--- a/java/org/apache/catalina/connector/Response.java
+++ b/java/org/apache/catalina/connector/Response.java
@@ -425,10 +425,6 @@ public class Response implements HttpServletResponse {
}
- /**
- * @return the content type that was set or calculated for this response,
or <code>null</code> if no content type
- * was set.
- */
@Override
public String getContentType() {
return getCoyoteResponse().getContentType();
@@ -461,29 +457,18 @@ public class Response implements HttpServletResponse {
// ------------------------------------------------ ServletResponse Methods
- /**
- * Flush the buffer and commit this response.
- *
- * @exception IOException if an input/output error occurs
- */
@Override
public void flushBuffer() throws IOException {
outputBuffer.flush();
}
- /**
- * @return the actual buffer size used for this Response.
- */
@Override
public int getBufferSize() {
return outputBuffer.getBufferSize();
}
- /**
- * @return the character encoding used for this Response.
- */
@Override
public String getCharacterEncoding() {
String charset = getCoyoteResponse().getCharacterEncoding();
@@ -505,12 +490,6 @@ public class Response implements HttpServletResponse {
}
- /**
- * @return the servlet output stream associated with this Response.
- *
- * @exception IllegalStateException if <code>getWriter</code> has already
been called for this response
- * @exception IOException if an input/output error occurs
- */
@Override
public ServletOutputStream getOutputStream() throws IOException {
@@ -527,21 +506,12 @@ public class Response implements HttpServletResponse {
}
- /**
- * @return the Locale assigned to this response.
- */
@Override
public Locale getLocale() {
return getCoyoteResponse().getLocale();
}
- /**
- * @return the writer associated with this Response.
- *
- * @exception IllegalStateException if <code>getOutputStream</code> has
already been called for this response
- * @exception IOException if an input/output error occurs
- */
@Override
public PrintWriter getWriter() throws IOException {
@@ -570,22 +540,12 @@ public class Response implements HttpServletResponse {
}
- /**
- * Has the output of this response already been committed?
- *
- * @return <code>true</code> if the response has been committed
- */
@Override
public boolean isCommitted() {
return getCoyoteResponse().isCommitted();
}
- /**
- * Clear any content written to the buffer.
- *
- * @exception IllegalStateException if this response has already been
committed
- */
@Override
public void reset() {
// Ignore any call from an included servlet
@@ -601,11 +561,6 @@ public class Response implements HttpServletResponse {
}
- /**
- * Reset the data buffer but not any status or header information.
- *
- * @exception IllegalStateException if the response has already been
committed
- */
@Override
public void resetBuffer() {
resetBuffer(false);
@@ -638,13 +593,6 @@ public class Response implements HttpServletResponse {
}
- /**
- * Set the buffer size to be used for this Response.
- *
- * @param size The new buffer size
- *
- * @exception IllegalStateException if this method is called after output
has been committed for this response
- */
@Override
public void setBufferSize(int size) {
@@ -657,11 +605,6 @@ public class Response implements HttpServletResponse {
}
- /**
- * Set the content length (in bytes) for this Response.
- *
- * @param length The new content length
- */
@Override
public void setContentLength(int length) {
@@ -684,11 +627,6 @@ public class Response implements HttpServletResponse {
}
- /**
- * Set the content type for this Response.
- *
- * @param type The new content type
- */
@Override
public void setContentType(String type) {
@@ -745,12 +683,6 @@ public class Response implements HttpServletResponse {
}
- /**
- * Overrides the name of the character encoding used in the body of the
request. This method must be called prior to
- * reading request parameters or reading input using getReader().
- *
- * @param encoding String containing the name of the character encoding.
- */
@Override
public void setCharacterEncoding(String encoding) {
@@ -783,11 +715,6 @@ public class Response implements HttpServletResponse {
}
- /**
- * Set the Locale that is appropriate for this response, including setting
the appropriate character encoding.
- *
- * @param locale The new locale
- */
@Override
public void setLocale(Locale locale) {
@@ -949,12 +876,6 @@ public class Response implements HttpServletResponse {
}
- /**
- * Add the specified date header to the specified value.
- *
- * @param name Name of the header to set
- * @param value Date value to be set
- */
@Override
public void addDateHeader(String name, long value) {
@@ -975,12 +896,6 @@ public class Response implements HttpServletResponse {
}
- /**
- * Add the specified header to the specified value.
- *
- * @param name Name of the header to set
- * @param value Value to be set
- */
@Override
public void addHeader(String name, String value) {
addHeader(name, value, null);
@@ -1029,12 +944,6 @@ public class Response implements HttpServletResponse {
}
- /**
- * Add the specified integer header to the specified value.
- *
- * @param name Name of the header to set
- * @param value Integer value to be set
- */
@Override
public void addIntHeader(String name, int value) {
@@ -1056,13 +965,6 @@ public class Response implements HttpServletResponse {
}
- /**
- * Has the specified header been set already in this response?
- *
- * @param name Name of the header to check
- *
- * @return <code>true</code> if the header has been set
- */
@Override
public boolean containsHeader(String name) {
// Need special handling for Content-Type and Content-Length due to
@@ -1095,13 +997,6 @@ public class Response implements HttpServletResponse {
}
- /**
- * Encode the session identifier associated with this response into the
specified redirect URL, if necessary.
- *
- * @param url URL to be encoded
- *
- * @return <code>true</code> if the URL was encoded
- */
@Override
public String encodeRedirectURL(String url) {
if (isEncodeable(toAbsolute(url))) {
@@ -1112,13 +1007,6 @@ public class Response implements HttpServletResponse {
}
- /**
- * Encode the session identifier associated with this response into the
specified URL, if necessary.
- *
- * @param url URL to be encoded
- *
- * @return <code>true</code> if the URL was encoded
- */
@Override
public String encodeURL(String url) {
@@ -1168,29 +1056,12 @@ public class Response implements HttpServletResponse {
}
- /**
- * Send an error response with the specified status and a default message.
- *
- * @param status HTTP status code to send
- *
- * @exception IllegalStateException if this response has already been
committed
- * @exception IOException if an input/output error occurs
- */
@Override
public void sendError(int status) throws IOException {
sendError(status, null);
}
- /**
- * Send an error response with the specified status and message.
- *
- * @param status HTTP status code to send
- * @param message Corresponding message to send
- *
- * @exception IllegalStateException if this response has already been
committed
- * @exception IOException if an input/output error occurs
- */
@Override
public void sendError(int status, String message) throws IOException {
@@ -1275,12 +1146,6 @@ public class Response implements HttpServletResponse {
}
- /**
- * Set the specified date header to the specified value.
- *
- * @param name Name of the header to set
- * @param value Date value to be set
- */
@Override
public void setDateHeader(String name, long value) {
@@ -1301,12 +1166,6 @@ public class Response implements HttpServletResponse {
}
- /**
- * Set the specified header to the specified value.
- *
- * @param name Name of the header to set
- * @param value Value to be set
- */
@Override
public void setHeader(String name, String value) {
@@ -1334,12 +1193,6 @@ public class Response implements HttpServletResponse {
}
- /**
- * Set the specified integer header to the specified value.
- *
- * @param name Name of the header to set
- * @param value Integer value to be set
- */
@Override
public void setIntHeader(String name, int value) {
@@ -1361,11 +1214,6 @@ public class Response implements HttpServletResponse {
}
- /**
- * Set the HTTP status to be returned with this response.
- *
- * @param status The new HTTP status
- */
@Override
public void setStatus(int status) {
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org
