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