This is an automated email from the ASF dual-hosted git repository.
markt 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 fe4070962f Add concurrency information to Javadoc
fe4070962f is described below
commit fe4070962f2d6a87bb22354ae49cdd01e3ad247a
Author: Mark Thomas <ma...@apache.org>
AuthorDate: Wed Aug 27 11:18:15 2025 +0100
Add concurrency information to Javadoc
---
java/org/apache/catalina/Store.java | 16 +++++++++-------
1 file changed, 9 insertions(+), 7 deletions(-)
diff --git a/java/org/apache/catalina/Store.java
b/java/org/apache/catalina/Store.java
index 89b3e01218..18a7bb96e3 100644
--- a/java/org/apache/catalina/Store.java
+++ b/java/org/apache/catalina/Store.java
@@ -30,8 +30,6 @@ import java.io.IOException;
*/
public interface Store {
- // ------------------------------------------------------------- Properties
-
/**
* @return the Manager instance associated with this Store.
*/
@@ -54,9 +52,6 @@ public interface Store {
int getSize() throws IOException;
- // --------------------------------------------------------- Public Methods
-
-
/**
* Add a property change listener to this component.
*
@@ -77,6 +72,9 @@ public interface Store {
/**
* Load and return the Session associated with the specified session
identifier from this Store, without removing
* it. If there is no such stored Session, return <code>null</code>.
+ * <p>
+ * Implementations should expect, and correctly handle, concurrent calls
to any method but in particular calls to
+ * {@code #load(String)}, {@code #save(Session)} and {@code
#remove(String)} for the same session.
*
* @param id Session identifier of the session to load
*
@@ -91,6 +89,9 @@ public interface Store {
/**
* Remove the Session with the specified session identifier from this
Store, if present. If no such Session is
* present, this method takes no action.
+ * <p>
+ * Implementations should expect, and correctly handle, concurrent calls
to any method but in particular calls to
+ * {@code #load(String)}, {@code #save(Session)} and {@code
#remove(String)} for the same session.
*
* @param id Session identifier of the Session to be removed
*
@@ -118,12 +119,13 @@ public interface Store {
/**
* Save the specified Session into this Store. Any previously saved
information for the associated session
* identifier is replaced.
+ * <p>
+ * Implementations should expect, and correctly handle, concurrent calls
to any method but in particular calls to
+ * {@code #load(String)}, {@code #save(Session)} and {@code
#remove(String)} for the same session.
*
* @param session Session to be saved
*
* @exception IOException if an input/output error occurs
*/
void save(Session session) throws IOException;
-
-
}
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org
