From 8165cabea237f579a8704d335bca5ed5644880f5 Mon Sep 17 00:00:00 2001 From: "Brian S. O'Neill" Date: Wed, 5 Feb 2025 19:20:43 -0800 Subject: [PATCH] Update some comments. --- src/main/java/org/cojen/dirmi/core/Stub.java | 5 +++-- .../org/cojen/dirmi/core/StubInvoker.java | 20 +++++++++---------- .../org/cojen/dirmi/core/StubWrapper.java | 4 ++-- 3 files changed, 15 insertions(+), 14 deletions(-) diff --git a/src/main/java/org/cojen/dirmi/core/Stub.java b/src/main/java/org/cojen/dirmi/core/Stub.java index 70ff283f..6e1f2ebd 100644 --- a/src/main/java/org/cojen/dirmi/core/Stub.java +++ b/src/main/java/org/cojen/dirmi/core/Stub.java @@ -19,8 +19,9 @@ import org.cojen.dirmi.Remote; /** - * Base class for remote stubs. It must not declare any new public instance methods because - * they can conflict with user-specified remote methods which have the same signature. + * Base class for remote stubs. It must not declare any new public or protected instance + * methods because they can conflict with user-specified remote methods which have the same + * signature. * * @author Brian S O'Neill */ diff --git a/src/main/java/org/cojen/dirmi/core/StubInvoker.java b/src/main/java/org/cojen/dirmi/core/StubInvoker.java index 5c3d4d73..949bd85a 100644 --- a/src/main/java/org/cojen/dirmi/core/StubInvoker.java +++ b/src/main/java/org/cojen/dirmi/core/StubInvoker.java @@ -22,8 +22,8 @@ /** * Base class for remote stubs which actually invoke the remote methods over the pipe. This - * class must not declare any new public instance methods because they can conflict with - * user-specified remote methods which have the same signature. + * class must not declare any new public or protected instance methods because they can + * conflict with user-specified remote methods which have the same signature. * * @author Brian S. O'Neill */ @@ -142,8 +142,8 @@ long resetTransportCount() { /** * Base class for invokers which support automatic disposal. This class must not declare - * any new public instance methods because they can conflict with user-specified remote - * methods which have the same signature. + * any new public or protected instance methods because they can conflict with + * user-specified remote methods which have the same signature. */ private static abstract class WithRef extends StubInvoker { private StubWrapper.Factory wrapperFactory; @@ -188,9 +188,9 @@ long resetTransportCount() { /** * Base class for invokers which support automatic disposal and don't have any methods for - * which "isUnacknowledged" is true. This class must not declare any new public instance - * methods because they can conflict with user-specified remote methods which have the same - * signature. + * which "isUnacknowledged" is true. This class must not declare any new public or + * protected instance methods because they can conflict with user-specified remote methods + * which have the same signature. */ public static abstract class WithBasicRef extends WithRef { private AutoDisposer.BasicRef ref; @@ -218,9 +218,9 @@ final Stub select() { /** * Base class for invokers which support automatic disposal and have at least one method - * for which "isUnacknowledged" is true. This class must not declare any new public - * instance methods because they can conflict with user-specified remote methods which have - * the same signature. + * for which "isUnacknowledged" is true. This class must not declare any new public or + * protected instance methods because they can conflict with user-specified remote methods + * which have the same signature. */ public static abstract class WithCountedRef extends WithRef { protected AutoDisposer.CountedRef ref; diff --git a/src/main/java/org/cojen/dirmi/core/StubWrapper.java b/src/main/java/org/cojen/dirmi/core/StubWrapper.java index a8d0d929..e3dd38ba 100644 --- a/src/main/java/org/cojen/dirmi/core/StubWrapper.java +++ b/src/main/java/org/cojen/dirmi/core/StubWrapper.java @@ -20,8 +20,8 @@ /** * Base class for remote stubs which delegate to an invoker for supporting AutoDispose. This - * class must not declare any new public instance methods because they can conflict with - * user-specified remote methods which have the same signature. + * class must not declare any new public or protected instance methods because they can + * conflict with user-specified remote methods which have the same signature. * * @author Brian S. O'Neill */