This is an automated email from the ASF dual-hosted git repository. remm pushed a commit to branch 9.0.x in repository https://gitbox.apache.org/repos/asf/tomcat.git
The following commit(s) were added to refs/heads/9.0.x by this push: new 1ad7d0e371 Remove override javadoc 1ad7d0e371 is described below commit 1ad7d0e3711c001928fed65a7bc2ec90f8d4c810 Author: remm <r...@apache.org> AuthorDate: Fri Mar 29 11:52:04 2024 +0100 Remove override javadoc Remove very outdated boilerplate override javadoc from the Servlet/Catalina API. --- .../apache/catalina/ha/session/DeltaSession.java | 148 ------------ .../apache/catalina/session/StandardSession.java | 259 --------------------- 2 files changed, 407 deletions(-) diff --git a/java/org/apache/catalina/ha/session/DeltaSession.java b/java/org/apache/catalina/ha/session/DeltaSession.java index 7e6b7e7b6e..b8a355ceef 100644 --- a/java/org/apache/catalina/ha/session/DeltaSession.java +++ b/java/org/apache/catalina/ha/session/DeltaSession.java @@ -116,34 +116,16 @@ public class DeltaSession extends StandardSession implements Externalizable, Clu // ----------------------------------------------------- ReplicatedMapEntry - /** - * Has the object changed since last replication and is not in a locked state - * - * @return boolean - */ @Override public boolean isDirty() { return deltaRequest.getSize() > 0; } - /** - * If this returns true, the map will extract the diff using getDiff() Otherwise it will serialize the entire - * object. - * - * @return boolean - */ @Override public boolean isDiffable() { return true; } - /** - * Returns a diff and sets the dirty map to false - * - * @return a serialized view of the difference - * - * @throws IOException IO error serializing - */ @Override public byte[] getDiff() throws IOException { SynchronizedStack<DeltaRequest> deltaRequestPool = null; @@ -183,15 +165,6 @@ public class DeltaSession extends StandardSession implements Externalizable, Clu return null; } - /** - * Applies a diff to an existing object. - * - * @param diff Serialized diff data - * @param offset Array offset - * @param length Array length - * - * @throws IOException IO error deserializing - */ @Override public void applyDiff(byte[] diff, int offset, int length) throws IOException, ClassNotFoundException { Thread currentThread = Thread.currentThread(); @@ -267,11 +240,6 @@ public class DeltaSession extends StandardSession implements Externalizable, Clu } } - /** - * If this returns true, to replicate that an object has been accessed - * - * @return boolean - */ @Override public boolean isAccessReplicate() { long replDelta = System.currentTimeMillis() - getLastTimeReplicated(); @@ -281,9 +249,6 @@ public class DeltaSession extends StandardSession implements Externalizable, Clu return false; } - /** - * Access to an existing object. - */ @Override public void accessEntry() { this.access(); @@ -293,19 +258,11 @@ public class DeltaSession extends StandardSession implements Externalizable, Clu // ----------------------------------------------------- Session Properties - /** - * returns true if this session is the primary session, if that is the case, the manager can expire it upon timeout. - */ @Override public boolean isPrimarySession() { return isPrimarySession; } - /** - * Sets whether this is the primary session or not. - * - * @param primarySession Flag value - */ @Override public void setPrimarySession(boolean primarySession) { this.isPrimarySession = primarySession; @@ -324,11 +281,6 @@ public class DeltaSession extends StandardSession implements Externalizable, Clu } - /** - * Set the session identifier for this session. - * - * @param id The new session identifier - */ @Override public void setId(String id) { setId(id, true); @@ -353,11 +305,6 @@ public class DeltaSession extends StandardSession implements Externalizable, Clu } } - /** - * Set the <code>isNew</code> flag for this session. - * - * @param isNew The new value for the <code>isNew</code> flag - */ @Override public void setNew(boolean isNew) { setNew(isNew, true); @@ -375,13 +322,6 @@ public class DeltaSession extends StandardSession implements Externalizable, Clu } } - /** - * Set the authenticated Principal that is associated with this Session. This provides an <code>Authenticator</code> - * with a means to cache a previously authenticated Principal, and avoid potentially expensive - * <code>Realm.authenticate()</code> calls on every request. - * - * @param principal The new Principal, or <code>null</code> if none - */ @Override public void setPrincipal(Principal principal) { setPrincipal(principal, true); @@ -399,11 +339,6 @@ public class DeltaSession extends StandardSession implements Externalizable, Clu } } - /** - * Set the authentication type used to authenticate our cached Principal, if any. - * - * @param authType The new cached authentication type - */ @Override public void setAuthType(String authType) { setAuthType(authType, true); @@ -421,9 +356,6 @@ public class DeltaSession extends StandardSession implements Externalizable, Clu } } - /** - * Return the <code>isValid</code> flag for this session. - */ @Override public boolean isValid() { if (!this.isValid) { @@ -455,9 +387,6 @@ public class DeltaSession extends StandardSession implements Externalizable, Clu return this.isValid; } - /** - * End the access and register to ReplicationValve (crossContext support) - */ @Override public void endAccess() { super.endAccess(); @@ -468,12 +397,6 @@ public class DeltaSession extends StandardSession implements Externalizable, Clu // ------------------------------------------------- Session Public Methods - /** - * Perform the internal processing required to invalidate this session, without triggering an exception if the - * session has already expired. - * - * @param notify Should we notify listeners about the demise of this session? - */ @Override public void expire(boolean notify) { expire(notify, true); @@ -524,9 +447,6 @@ public class DeltaSession extends StandardSession implements Externalizable, Clu } } - /** - * Release all object references, and initialize instance variables, in preparation for reuse of this object. - */ @Override public void recycle() { lockInternal(); @@ -599,15 +519,6 @@ public class DeltaSession extends StandardSession implements Externalizable, Clu } - /** - * Read a serialized version of the contents of this session object from the specified object input stream, without - * requiring that the StandardSession itself have been serialized. - * - * @param stream The object input stream to read from - * - * @exception ClassNotFoundException if an unknown class is specified - * @exception IOException if an input/output error occurs - */ @Override public void readObjectData(ObjectInputStream stream) throws ClassNotFoundException, IOException { doReadObject((ObjectInput) stream); @@ -617,14 +528,6 @@ public class DeltaSession extends StandardSession implements Externalizable, Clu doReadObject(stream); } - /** - * Write a serialized version of the contents of this session object to the specified object output stream, without - * requiring that the StandardSession itself have been serialized. - * - * @param stream The object output stream to write to - * - * @exception IOException if an input/output error occurs - */ @Override public void writeObjectData(ObjectOutputStream stream) throws IOException { writeObjectData((ObjectOutput) stream); @@ -707,18 +610,6 @@ public class DeltaSession extends StandardSession implements Externalizable, Clu // ----------------------------------------------HttpSession Public Methods - /** - * Remove the object bound with the specified name from this session. If the session does not have an object bound - * with this name, this method does nothing. - * <p> - * After this method executes, and if the object implements <code>HttpSessionBindingListener</code>, the container - * calls <code>valueUnbound()</code> on the object. - * - * @param name Name of the object to remove from this session. - * @param notify Should we notify interested listeners that this attribute is being removed? - * - * @exception IllegalStateException if this method is called on an invalidated session - */ @Override public void removeAttribute(String name, boolean notify) { removeAttribute(name, notify, true); @@ -732,20 +623,6 @@ public class DeltaSession extends StandardSession implements Externalizable, Clu removeAttributeInternal(name, notify, addDeltaRequest); } - /** - * Bind an object to this session, using the specified name. If an object of the same name is already bound to this - * session, the object is replaced. - * <p> - * After this method executes, and if the object implements <code>HttpSessionBindingListener</code>, the container - * calls <code>valueBound()</code> on the object. - * - * @param name Name to which the object is bound, cannot be null - * @param value Object to be bound, cannot be null - * - * @exception IllegalArgumentException if an attempt is made to add a non-serializable object in an environment - * marked distributable. - * @exception IllegalStateException if this method is called on an invalidated session - */ @Override public void setAttribute(String name, Object value) { setAttribute(name, value, true, true); @@ -824,17 +701,6 @@ public class DeltaSession extends StandardSession implements Externalizable, Clu // -------------------------------------------- HttpSession Private Methods - /** - * Read a serialized version of this session object from the specified object input stream. - * <p> - * <b>IMPLEMENTATION NOTE </b>: The reference to the owning Manager is not restored by this method, and must be set - * explicitly. - * - * @param stream The input stream to read from - * - * @exception ClassNotFoundException if an unknown class is specified - * @exception IOException if an input/output error occurs - */ @Override protected void doReadObject(ObjectInputStream stream) throws ClassNotFoundException, IOException { doReadObject((ObjectInput) stream); @@ -939,20 +805,6 @@ public class DeltaSession extends StandardSession implements Externalizable, Clu } - /** - * Write a serialized version of this session object to the specified object output stream. - * <p> - * <b>IMPLEMENTATION NOTE </b>: The owning Manager will not be stored in the serialized representation of this - * Session. After calling <code>readObject()</code>, you must set the associated Manager explicitly. - * <p> - * <b>IMPLEMENTATION NOTE </b>: Any attribute that is not Serializable will be unbound from the session, with - * appropriate actions if it implements HttpSessionBindingListener. If you do not want any such attributes, be sure - * the <code>distributable</code> property of the associated Manager is set to <code>true</code>. - * - * @param stream The output stream to write to - * - * @exception IOException if an input/output error occurs - */ @Override protected void doWriteObject(ObjectOutputStream stream) throws IOException { doWriteObject((ObjectOutput) stream); diff --git a/java/org/apache/catalina/session/StandardSession.java b/java/org/apache/catalina/session/StandardSession.java index feff609be5..0c21d2f402 100644 --- a/java/org/apache/catalina/session/StandardSession.java +++ b/java/org/apache/catalina/session/StandardSession.java @@ -262,20 +262,12 @@ public class StandardSession implements HttpSession, Session, Serializable { // ----------------------------------------------------- Session Properties - /** - * Return the authentication type used to authenticate our cached Principal, if any. - */ @Override public String getAuthType() { return this.authType; } - /** - * Set the authentication type used to authenticate our cached Principal, if any. - * - * @param authType The new cached authentication type - */ @Override public void setAuthType(String authType) { String oldAuthType = this.authType; @@ -284,12 +276,6 @@ public class StandardSession implements HttpSession, Session, Serializable { } - /** - * Set the creation time for this session. This method is called by the Manager when an existing Session instance is - * reused. - * - * @param time The new creation time - */ @Override public void setCreationTime(long time) { @@ -300,29 +286,18 @@ public class StandardSession implements HttpSession, Session, Serializable { } - /** - * Return the session identifier for this session. - */ @Override public String getId() { return this.id; } - /** - * Return the session identifier for this session. - */ @Override public String getIdInternal() { return this.id; } - /** - * Set the session identifier for this session. - * - * @param id The new session identifier - */ @Override public void setId(String id) { setId(id, true); @@ -384,16 +359,6 @@ public class StandardSession implements HttpSession, Session, Serializable { } - /** - * Inform the listeners about the change session ID. - * - * @param newId new session ID - * @param oldId old session ID - * @param notifySessionListeners Should any associated sessionListeners be notified that session ID has been - * changed? - * @param notifyContainerListeners Should any associated ContainerListeners be notified that session ID has been - * changed? - */ @Override public void tellChangedSessionId(String newId, String oldId, boolean notifySessionListeners, boolean notifyContainerListeners) { @@ -426,11 +391,6 @@ public class StandardSession implements HttpSession, Session, Serializable { } - /** - * Return the last time the client sent a request associated with this session, as the number of milliseconds since - * midnight, January 1, 1970 GMT. Actions that your application takes, such as getting or setting a value associated - * with the session, do not affect the access time. This one gets updated whenever a request starts. - */ @Override public long getThisAccessedTime() { @@ -441,21 +401,11 @@ public class StandardSession implements HttpSession, Session, Serializable { return this.thisAccessedTime; } - /** - * Return the last client access time without invalidation check - * - * @see #getThisAccessedTime() - */ @Override public long getThisAccessedTimeInternal() { return this.thisAccessedTime; } - /** - * Return the last time the client sent a request associated with this session, as the number of milliseconds since - * midnight, January 1, 1970 GMT. Actions that your application takes, such as getting or setting a value associated - * with the session, do not affect the access time. This one gets updated whenever a request finishes. - */ @Override public long getLastAccessedTime() { @@ -466,19 +416,11 @@ public class StandardSession implements HttpSession, Session, Serializable { return this.lastAccessedTime; } - /** - * Return the last client access time without invalidation check - * - * @see #getLastAccessedTime() - */ @Override public long getLastAccessedTimeInternal() { return this.lastAccessedTime; } - /** - * Return the idle time (in milliseconds) from last client access time. - */ @Override public long getIdleTime() { @@ -489,11 +431,6 @@ public class StandardSession implements HttpSession, Session, Serializable { return getIdleTimeInternal(); } - /** - * Return the idle time from last client access time without invalidation check - * - * @see #getIdleTime() - */ @Override public long getIdleTimeInternal() { long timeNow = System.currentTimeMillis(); @@ -506,78 +443,42 @@ public class StandardSession implements HttpSession, Session, Serializable { return timeIdle; } - /** - * Return the Manager within which this Session is valid. - */ @Override public Manager getManager() { return this.manager; } - /** - * Set the Manager within which this Session is valid. - * - * @param manager The new Manager - */ @Override public void setManager(Manager manager) { this.manager = manager; } - /** - * Return the maximum time interval, in seconds, between client requests before the servlet container will - * invalidate the session. A negative time indicates that the session should never time out. - */ @Override public int getMaxInactiveInterval() { return this.maxInactiveInterval; } - /** - * Set the maximum time interval, in seconds, between client requests before the servlet container will invalidate - * the session. A zero or negative time indicates that the session should never time out. - * - * @param interval The new maximum interval - */ @Override public void setMaxInactiveInterval(int interval) { this.maxInactiveInterval = interval; } - /** - * Set the <code>isNew</code> flag for this session. - * - * @param isNew The new value for the <code>isNew</code> flag - */ @Override public void setNew(boolean isNew) { this.isNew = isNew; } - /** - * Return the authenticated Principal that is associated with this Session. This provides an - * <code>Authenticator</code> with a means to cache a previously authenticated Principal, and avoid potentially - * expensive <code>Realm.authenticate()</code> calls on every request. If there is no current associated Principal, - * return <code>null</code>. - */ @Override public Principal getPrincipal() { return this.principal; } - /** - * Set the authenticated Principal that is associated with this Session. This provides an <code>Authenticator</code> - * with a means to cache a previously authenticated Principal, and avoid potentially expensive - * <code>Realm.authenticate()</code> calls on every request. - * - * @param principal The new Principal, or <code>null</code> if none - */ @Override public void setPrincipal(Principal principal) { @@ -588,9 +489,6 @@ public class StandardSession implements HttpSession, Session, Serializable { } - /** - * Return the <code>HttpSession</code> for which this object is the facade. - */ @Override public HttpSession getSession() { if (facade == null) { @@ -604,9 +502,6 @@ public class StandardSession implements HttpSession, Session, Serializable { } - /** - * Return the <code>isValid</code> flag for this session. - */ @Override public boolean isValid() { @@ -633,11 +528,6 @@ public class StandardSession implements HttpSession, Session, Serializable { } - /** - * Set the <code>isValid</code> flag for this session. - * - * @param isValid The new value for the <code>isValid</code> flag - */ @Override public void setValid(boolean isValid) { this.isValid = isValid; @@ -647,10 +537,6 @@ public class StandardSession implements HttpSession, Session, Serializable { // ------------------------------------------------- Session Public Methods - /** - * Update the accessed time information for this session. This method should be called by the context when a request - * comes in for a particular session, even if the application does not reference it. - */ @Override public void access() { @@ -663,9 +549,6 @@ public class StandardSession implements HttpSession, Session, Serializable { } - /** - * End the access. - */ @Override public void endAccess() { @@ -689,9 +572,6 @@ public class StandardSession implements HttpSession, Session, Serializable { } - /** - * Add a session event listener to this component. - */ @Override public void addSessionListener(SessionListener listener) { @@ -700,10 +580,6 @@ public class StandardSession implements HttpSession, Session, Serializable { } - /** - * Perform the internal processing required to invalidate this session, without triggering an exception if the - * session has already expired. - */ @Override public void expire() { @@ -887,30 +763,18 @@ public class StandardSession implements HttpSession, Session, Serializable { } - /** - * Return the object bound with the specified name to the internal notes for this session, or <code>null</code> if - * no such binding exists. - * - * @param name Name of the note to be returned - */ @Override public Object getNote(String name) { return notes.get(name); } - /** - * Return an Iterator containing the String names of all notes bindings that exist for this session. - */ @Override public Iterator<String> getNoteNames() { return notes.keySet().iterator(); } - /** - * Release all object references, and initialize instance variables, in preparation for reuse of this object. - */ @Override public void recycle() { @@ -931,11 +795,6 @@ public class StandardSession implements HttpSession, Session, Serializable { } - /** - * Remove any object bound to the specified name in the internal notes for this session. - * - * @param name Name of the note to be removed - */ @Override public void removeNote(String name) { @@ -944,9 +803,6 @@ public class StandardSession implements HttpSession, Session, Serializable { } - /** - * Remove a session event listener from this component. - */ @Override public void removeSessionListener(SessionListener listener) { @@ -955,13 +811,6 @@ public class StandardSession implements HttpSession, Session, Serializable { } - /** - * Bind an object to a specified name in the internal notes associated with this session, replacing any existing - * binding for this name. - * - * @param name Name to which the object should be bound - * @param value Object to be bound to the specified name - */ @Override public void setNote(String name, Object value) { @@ -1020,11 +869,6 @@ public class StandardSession implements HttpSession, Session, Serializable { // ------------------------------------------------- HttpSession Properties - /** - * Return the time when this session was created, in milliseconds since midnight, January 1, 1970 GMT. - * - * @exception IllegalStateException if this method is called on an invalidated session - */ @Override public long getCreationTime() { if (!isValidInternal()) { @@ -1035,19 +879,12 @@ public class StandardSession implements HttpSession, Session, Serializable { } - /** - * Return the time when this session was created, in milliseconds since midnight, January 1, 1970 GMT, bypassing the - * session validation checks. - */ @Override public long getCreationTimeInternal() { return this.creationTime; } - /** - * Return the ServletContext to which this session belongs. - */ @Override public ServletContext getServletContext() { if (manager == null) { @@ -1076,14 +913,6 @@ public class StandardSession implements HttpSession, Session, Serializable { // ----------------------------------------------HttpSession Public Methods - /** - * Return the object bound with the specified name in this session, or <code>null</code> if no object is bound with - * that name. - * - * @param name Name of the attribute to be returned - * - * @exception IllegalStateException if this method is called on an invalidated session - */ @Override public Object getAttribute(String name) { if (!isValidInternal()) { @@ -1098,12 +927,6 @@ public class StandardSession implements HttpSession, Session, Serializable { } - /** - * Return an <code>Enumeration</code> of <code>String</code> objects containing the names of the objects bound to - * this session. - * - * @exception IllegalStateException if this method is called on an invalidated session - */ @Override public Enumeration<String> getAttributeNames() { @@ -1116,16 +939,6 @@ public class StandardSession implements HttpSession, Session, Serializable { } - /** - * Return the object bound with the specified name in this session, or <code>null</code> if no object is bound with - * that name. - * - * @param name Name of the value to be returned - * - * @exception IllegalStateException if this method is called on an invalidated session - * - * @deprecated As of Version 2.2, this method is replaced by <code>getAttribute()</code> - */ @Override @Deprecated public Object getValue(String name) { @@ -1135,14 +948,6 @@ public class StandardSession implements HttpSession, Session, Serializable { } - /** - * Return the set of names of objects bound to this session. If there are no such objects, a zero-length array is - * returned. - * - * @exception IllegalStateException if this method is called on an invalidated session - * - * @deprecated As of Version 2.2, this method is replaced by <code>getAttributeNames()</code> - */ @Override @Deprecated public String[] getValueNames() { @@ -1154,11 +959,6 @@ public class StandardSession implements HttpSession, Session, Serializable { } - /** - * Invalidates this session and unbinds any objects bound to it. - * - * @exception IllegalStateException if this method is called on an invalidated session - */ @Override public void invalidate() { @@ -1172,13 +972,6 @@ public class StandardSession implements HttpSession, Session, Serializable { } - /** - * Return <code>true</code> if the client does not yet know about the session, or if the client chooses not to join - * the session. For example, if the server used only cookie-based sessions, and the client has disabled the use of - * cookies, then a session would be new on each request. - * - * @exception IllegalStateException if this method is called on an invalidated session - */ @Override public boolean isNew() { if (!isValidInternal()) { @@ -1189,20 +982,6 @@ public class StandardSession implements HttpSession, Session, Serializable { } - /** - * Bind an object to this session, using the specified name. If an object of the same name is already bound to this - * session, the object is replaced. - * <p> - * After this method executes, and if the object implements <code>HttpSessionBindingListener</code>, the container - * calls <code>valueBound()</code> on the object. - * - * @param name Name to which the object is bound, cannot be null - * @param value Object to be bound, cannot be null - * - * @exception IllegalStateException if this method is called on an invalidated session - * - * @deprecated As of Version 2.2, this method is replaced by <code>setAttribute()</code> - */ @Override @Deprecated public void putValue(String name, Object value) { @@ -1212,17 +991,6 @@ public class StandardSession implements HttpSession, Session, Serializable { } - /** - * Remove the object bound with the specified name from this session. If the session does not have an object bound - * with this name, this method does nothing. - * <p> - * After this method executes, and if the object implements <code>HttpSessionBindingListener</code>, the container - * calls <code>valueUnbound()</code> on the object. - * - * @param name Name of the object to remove from this session. - * - * @exception IllegalStateException if this method is called on an invalidated session - */ @Override public void removeAttribute(String name) { @@ -1255,19 +1023,6 @@ public class StandardSession implements HttpSession, Session, Serializable { } - /** - * Remove the object bound with the specified name from this session. If the session does not have an object bound - * with this name, this method does nothing. - * <p> - * After this method executes, and if the object implements <code>HttpSessionBindingListener</code>, the container - * calls <code>valueUnbound()</code> on the object. - * - * @param name Name of the object to remove from this session. - * - * @exception IllegalStateException if this method is called on an invalidated session - * - * @deprecated As of Version 2.2, this method is replaced by <code>removeAttribute()</code> - */ @Override @Deprecated public void removeValue(String name) { @@ -1277,20 +1032,6 @@ public class StandardSession implements HttpSession, Session, Serializable { } - /** - * Bind an object to this session, using the specified name. If an object of the same name is already bound to this - * session, the object is replaced. - * <p> - * After this method executes, and if the object implements <code>HttpSessionBindingListener</code>, the container - * calls <code>valueBound()</code> on the object. - * - * @param name Name to which the object is bound, cannot be null - * @param value Object to be bound, cannot be null - * - * @exception IllegalArgumentException if an attempt is made to add a non-serializable object in an environment - * marked distributable. - * @exception IllegalStateException if this method is called on an invalidated session - */ @Override public void setAttribute(String name, Object value) { setAttribute(name, value, true); --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org For additional commands, e-mail: dev-h...@tomcat.apache.org