This is an automated email from the ASF dual-hosted git repository. ggregory pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/commons-jcs.git
The following commit(s) were added to refs/heads/master by this push: new e0834d9e Javadoc e0834d9e is described below commit e0834d9ec8bd60f73ff1a9cf52867a4ecca210ea Author: Gary Gregory <garydgreg...@gmail.com> AuthorDate: Sun Mar 23 10:40:11 2025 -0400 Javadoc --- .../socket/tcp/TCPLateralCacheAttributes.java | 38 +++++++-------- .../tcp/behavior/ITCPLateralCacheAttributes.java | 2 +- .../jcs3/engine/CompositeCacheAttributes.java | 54 +++++++++++----------- .../engine/behavior/ICompositeCacheAttributes.java | 6 +-- 4 files changed, 50 insertions(+), 50 deletions(-) diff --git a/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/auxiliary/lateral/socket/tcp/TCPLateralCacheAttributes.java b/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/auxiliary/lateral/socket/tcp/TCPLateralCacheAttributes.java index 6894ecde..b44d745d 100644 --- a/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/auxiliary/lateral/socket/tcp/TCPLateralCacheAttributes.java +++ b/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/auxiliary/lateral/socket/tcp/TCPLateralCacheAttributes.java @@ -122,7 +122,7 @@ public class TCPLateralCacheAttributes /** * Gets the tcpListenerHost attribute of the ILateralCacheAttributes object - * <p> + * * @return The tcpListenerHost value */ @Override @@ -133,7 +133,7 @@ public class TCPLateralCacheAttributes /** * Gets the tcpListenerPort attribute of the ILateralCacheAttributes object - * <p> + * * @return The tcpListenerPort value */ @Override @@ -144,7 +144,7 @@ public class TCPLateralCacheAttributes /** * Gets the tcpServer attribute of the ILateralCacheAttributes object - * <p> + * * @return The tcpServer value */ @Override @@ -155,7 +155,7 @@ public class TCPLateralCacheAttributes /** * Gets the tcpServers attribute of the ILateralCacheAttributes object - * <p> + * * @return The tcpServers value */ @Override @@ -166,7 +166,7 @@ public class TCPLateralCacheAttributes /** * The address to broadcast to if UDPDiscovery is enabled. - * <p> + * * @return the udpDiscoveryAddr. */ @Override @@ -177,7 +177,7 @@ public class TCPLateralCacheAttributes /** * The port to use if UDPDiscovery is enabled. - * <p> + * * @return the udpDiscoveryPort. */ @Override @@ -188,7 +188,7 @@ public class TCPLateralCacheAttributes /** * The time-to-live for the UDP multicast packets - * <p> + * * @return the udpTTL. * @since 3.1 */ @@ -200,7 +200,7 @@ public class TCPLateralCacheAttributes /** * Is the lateral allowed to try and get from other laterals. - * <p> + * * @return true if the lateral will try to get */ @Override @@ -211,7 +211,7 @@ public class TCPLateralCacheAttributes /** * Is the lateral allowed to put objects to other laterals. - * <p> + * * @return true if puts are allowed */ @Override @@ -226,7 +226,7 @@ public class TCPLateralCacheAttributes * then it will compare the hash code. if they are the same, it will not remove. This isn't * perfect since different objects can have the same hash code, but it is unlikely of objects of * the same type. - * <p> + * * @return boolean */ @Override @@ -239,7 +239,7 @@ public class TCPLateralCacheAttributes * Should the client send a remove command rather than a put when update is called. This is a * client option, not a receiver option. This allows you to prevent the lateral from serializing * objects. - * <p> + * * @return true if updates will result in a remove command being sent. */ @Override @@ -249,8 +249,8 @@ public class TCPLateralCacheAttributes } /** - * Whether or not TCP laterals can try to find each other by multicast communication. - * <p> + * Tests whether or not TCP laterals can try to find each other by multicast communication. + * * @return the udpDiscoveryEnabled. */ @Override @@ -274,7 +274,7 @@ public class TCPLateralCacheAttributes /** * Is the lateral allowed to put objects to other laterals. - * <p> + * * @param allowPut */ @Override @@ -289,7 +289,7 @@ public class TCPLateralCacheAttributes * then it will compare the hash code. if they are the same, it will not remove. This isn't * perfect since different objects can have the same hash code, but it is unlikely of objects of * the same type. - * <p> + * * @param filter */ @Override @@ -302,7 +302,7 @@ public class TCPLateralCacheAttributes * Should the client send a remove command rather than a put when update is called. This is a * client option, not a receiver option. This allows you to prevent the lateral from serializing * objects. - * <p> + * * @param issueRemoveOnPut */ @Override @@ -331,7 +331,7 @@ public class TCPLateralCacheAttributes /** * Sets the tcpListenerHost attribute of the ILateralCacheAttributes object - * <p> + * * @param val * The new tcpListenerHost value */ @@ -343,7 +343,7 @@ public class TCPLateralCacheAttributes /** * Sets the tcpListenerPort attribute of the ILateralCacheAttributes object - * <p> + * * @param val The new tcpListenerPort value */ @Override @@ -354,7 +354,7 @@ public class TCPLateralCacheAttributes /** * Sets the tcpServer attribute of the ILateralCacheAttributes object - * <p> + * * @param val The new tcpServer value */ @Override diff --git a/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/auxiliary/lateral/socket/tcp/behavior/ITCPLateralCacheAttributes.java b/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/auxiliary/lateral/socket/tcp/behavior/ITCPLateralCacheAttributes.java index b86e8fa5..841accbf 100644 --- a/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/auxiliary/lateral/socket/tcp/behavior/ITCPLateralCacheAttributes.java +++ b/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/auxiliary/lateral/socket/tcp/behavior/ITCPLateralCacheAttributes.java @@ -125,7 +125,7 @@ public interface ITCPLateralCacheAttributes boolean isIssueRemoveOnPut(); /** - * Whether or not TCP laterals can try to find each other by multicast + * Tests whether or not TCP laterals can try to find each other by multicast * communication. * <p> * @return the udpDiscoveryEnabled. diff --git a/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/engine/CompositeCacheAttributes.java b/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/engine/CompositeCacheAttributes.java index 120b0bda..5ec27550 100644 --- a/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/engine/CompositeCacheAttributes.java +++ b/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/engine/CompositeCacheAttributes.java @@ -127,7 +127,7 @@ public class CompositeCacheAttributes /** * Gets the cacheName attribute of the CompositeCacheAttributes object - * <p> + * * @return The cacheName value */ @Override @@ -147,7 +147,7 @@ public class CompositeCacheAttributes /** * If UseMemoryShrinker is true the memory cache should auto-expire elements to reclaim space. - * <p> + * * @return The MaxMemoryIdleTimeSeconds value */ @Override @@ -158,7 +158,7 @@ public class CompositeCacheAttributes /** * Gets the maxObjects attribute of the CompositeCacheAttributes object - * <p> + * * @return The maxObjects value */ @Override @@ -170,7 +170,7 @@ public class CompositeCacheAttributes /** * If UseMemoryShrinker is true the memory cache should auto-expire elements to reclaim space. * This gets the maximum number of items to spool per run. - * <p> + * * @return The maxSpoolPerRun value */ @Override @@ -181,7 +181,7 @@ public class CompositeCacheAttributes /** * Gets the memoryCacheName attribute of the CompositeCacheAttributes object - * <p> + * * @return The memoryCacheName value */ @Override @@ -193,7 +193,7 @@ public class CompositeCacheAttributes /** * If UseMemoryShrinker is true the memory cache should auto-expire elements to reclaim space. * This gets the shrinker interval. - * <p> + * * @return The ShrinkerIntervalSeconds value */ @Override @@ -204,7 +204,7 @@ public class CompositeCacheAttributes /** * Number to send to disk at the time when memory is full. - * <p> + * * @return int */ @Override @@ -215,7 +215,7 @@ public class CompositeCacheAttributes /** * Gets the useDisk attribute of the CompositeCacheAttributes object - * <p> + * * @return The useDisk value */ @Override @@ -226,7 +226,7 @@ public class CompositeCacheAttributes /** * Gets the useLateral attribute of the CompositeCacheAttributes object - * <p> + * * @return The useLateral value */ @Override @@ -236,8 +236,8 @@ public class CompositeCacheAttributes } /** - * Whether the memory cache should perform background memory shrinkage. - * <p> + * Tests whether the memory cache should perform background memory shrinkage. + * * @return The UseMemoryShrinker value */ @Override @@ -248,7 +248,7 @@ public class CompositeCacheAttributes /** * Gets the useRemote attribute of the CompositeCacheAttributes object - * <p> + * * @return The useRemote value */ @Override @@ -259,7 +259,7 @@ public class CompositeCacheAttributes /** * Sets the cacheName attribute of the CompositeCacheAttributes object - * <p> + * * @param s The new cacheName value */ @Override @@ -270,7 +270,7 @@ public class CompositeCacheAttributes /** * By default this is SWAP_ONLY. - * <p> + * * @param diskUsagePattern The diskUsagePattern to set. */ @Override @@ -283,7 +283,7 @@ public class CompositeCacheAttributes * Translates the name to the disk usage pattern short value. * <p> * The allowed values are SWAP and UPDATE. - * <p> + * * @param diskUsagePatternName The diskUsagePattern to set. */ @Override @@ -305,7 +305,7 @@ public class CompositeCacheAttributes /** * If UseMemoryShrinker is true the memory cache should auto-expire elements to reclaim space. - * <p> + * * @param seconds The new MaxMemoryIdleTimeSeconds value */ @Override @@ -316,7 +316,7 @@ public class CompositeCacheAttributes /** * Sets the maxObjects attribute of the CompositeCacheAttributes object - * <p> + * * @param maxObjs The new maxObjects value */ @Override @@ -330,7 +330,7 @@ public class CompositeCacheAttributes * This sets the maximum number of items to spool per run. * <p> * If the value is -1, then there is no limit to the number of items to be spooled. - * <p> + * * @param maxSpoolPerRun The new maxSpoolPerRun value */ @Override @@ -341,7 +341,7 @@ public class CompositeCacheAttributes /** * Sets the memoryCacheName attribute of the CompositeCacheAttributes object - * <p> + * * @param s The new memoryCacheName value */ @Override @@ -353,7 +353,7 @@ public class CompositeCacheAttributes /** * If UseMemoryShrinker is true the memory cache should auto-expire elements to reclaim space. * This sets the shrinker interval. - * <p> + * * @param seconds The new ShrinkerIntervalSeconds value */ @Override @@ -364,7 +364,7 @@ public class CompositeCacheAttributes /** * Number to send to disk at a time. - * <p> + * * @param spoolChunkSize */ @Override @@ -375,7 +375,7 @@ public class CompositeCacheAttributes /** * Sets the useDisk attribute of the CompositeCacheAttributes object - * <p> + * * @param useDisk The new useDisk value */ @Override @@ -386,7 +386,7 @@ public class CompositeCacheAttributes /** * Sets the useLateral attribute of the CompositeCacheAttributes object - * <p> + * * @param b The new useLateral value */ @Override @@ -396,8 +396,8 @@ public class CompositeCacheAttributes } /** - * Whether the memory cache should perform background memory shrinkage. - * <p> + * Sets whether the memory cache should perform background memory shrinkage. + * * @param useShrinker The new UseMemoryShrinker value */ @Override @@ -408,7 +408,7 @@ public class CompositeCacheAttributes /** * Sets the useRemote attribute of the CompositeCacheAttributes object - * <p> + * * @param useRemote The new useRemote value */ @Override @@ -419,7 +419,7 @@ public class CompositeCacheAttributes /** * Dumps the core attributes. - * <p> + * * @return For debugging. */ @Override diff --git a/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/engine/behavior/ICompositeCacheAttributes.java b/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/engine/behavior/ICompositeCacheAttributes.java index 33419719..48c02c69 100644 --- a/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/engine/behavior/ICompositeCacheAttributes.java +++ b/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/engine/behavior/ICompositeCacheAttributes.java @@ -117,7 +117,7 @@ public interface ICompositeCacheAttributes boolean isUseLateral(); /** - * Whether the memory cache should perform background memory shrinkage. + * Tests whether the memory cache should perform background memory shrinkage. * <p> * @return The UseMemoryShrinker value */ @@ -219,7 +219,7 @@ public interface ICompositeCacheAttributes void setUseDisk( boolean useDisk ); /** - * set whether the cache should use a lateral cache + * Sets whether the cache should use a lateral cache * <p> * @param d * The new useLateral value @@ -227,7 +227,7 @@ public interface ICompositeCacheAttributes void setUseLateral( boolean d ); /** - * Whether the memory cache should perform background memory shrinkage. + * Sets whether the memory cache should perform background memory shrinkage. * <p> * @param useShrinker * The new UseMemoryShrinker value