You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by tv...@apache.org on 2023/01/08 19:49:48 UTC
[commons-jcs] branch release-3.2 created (now 817aa692)
This is an automated email from the ASF dual-hosted git repository.
tv pushed a change to branch release-3.2
in repository https://gitbox.apache.org/repos/asf/commons-jcs.git
at 817aa692 Update generated files
This branch includes the following new commits:
new 353c9508 Typos
new 913ed1af Prepare release
new 01a01556 Re-introduce deprecated constructor to make japicmp happy
new dc4adae5 Add missing hashCode()/equals() methods
new ada8e235 japicmp wants a 3.2 release
new 9755c18a Updated download page in preparation for 3.2 release.
new 89fd906d Update release notes for 3.2 release
new 817aa692 Update generated files
The 8 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
[commons-jcs] 02/08: Prepare release
Posted by tv...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
tv pushed a commit to branch release-3.2
in repository https://gitbox.apache.org/repos/asf/commons-jcs.git
commit 913ed1af1c0ae1692cad3499fb080b0c371a9bbe
Author: Thomas Vandahl <tv...@apache.org>
AuthorDate: Sun Jan 8 19:59:30 2023 +0100
Prepare release
---
pom.xml | 4 ++--
src/changes/changes.xml | 2 +-
2 files changed, 3 insertions(+), 3 deletions(-)
diff --git a/pom.xml b/pom.xml
index 7614e498..7f23c929 100644
--- a/pom.xml
+++ b/pom.xml
@@ -531,8 +531,8 @@
<commons.componentid>jcs</commons.componentid>
<commons.osgi.symbolicName>org.apache.commons.${project.artifactId}</commons.osgi.symbolicName>
<commons.module.name>org.apache.commons.jcs3</commons.module.name>
- <commons.release.version>3.2</commons.release.version>
- <commons.release.name>commons-jcs3-dist-3.2</commons.release.name>
+ <commons.release.version>3.1.1</commons.release.version>
+ <commons.release.name>commons-jcs3-dist-3.1.1</commons.release.name>
<commons.release.desc>(Java 8+)</commons.release.desc>
<commons.releaseManagerName>tv</commons.releaseManagerName>
<commons.releaseManagerKey>88817402</commons.releaseManagerKey>
diff --git a/src/changes/changes.xml b/src/changes/changes.xml
index d7c247cb..54cada01 100644
--- a/src/changes/changes.xml
+++ b/src/changes/changes.xml
@@ -19,7 +19,7 @@
<author email="dev@commons.apache.org">Apache Commons Developers</author>
</properties>
<body>
- <release version="3.1.1" date="TBD">Jeremy Long
+ <release version="3.1.1" date="2023-01-08">
<action dev="tv" type="fix" issue="JCS-232" due-to="Jeremy Long">
Handle ServiceConfigurationError when using a different logging framework
</action>
[commons-jcs] 06/08: Updated download page in preparation for 3.2 release.
Posted by tv...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
tv pushed a commit to branch release-3.2
in repository https://gitbox.apache.org/repos/asf/commons-jcs.git
commit 9755c18a67cfc92cd62aa0ae7dfd4d0734ea92f5
Author: Thomas Vandahl <tv...@apache.org>
AuthorDate: Sun Jan 8 20:29:41 2023 +0100
Updated download page in preparation for 3.2 release.
---
xdocs/download_jcs.xml | 26 +++++++++++++-------------
1 file changed, 13 insertions(+), 13 deletions(-)
diff --git a/xdocs/download_jcs.xml b/xdocs/download_jcs.xml
index 35d13232..1a9d616e 100644
--- a/xdocs/download_jcs.xml
+++ b/xdocs/download_jcs.xml
@@ -113,32 +113,32 @@ limitations under the License.
</p>
</subsection>
</section>
- <section name="Apache Commons JCS 3.1 (Java 8+)">
+ <section name="Apache Commons JCS 3.2 (Java 8+)">
<subsection name="Binaries">
<table>
<tr>
- <td><a href="[preferred]/commons/jcs/binaries/commons-jcs3-dist-3.1-bin.tar.gz">commons-jcs3-dist-3.1-bin.tar.gz</a></td>
- <td><a href="https://www.apache.org/dist/commons/jcs/binaries/commons-jcs3-dist-3.1-bin.tar.gz.sha512">sha512</a></td>
- <td><a href="https://www.apache.org/dist/commons/jcs/binaries/commons-jcs3-dist-3.1-bin.tar.gz.asc">pgp</a></td>
+ <td><a href="[preferred]/commons/jcs/binaries/commons-jcs3-dist-3.2-bin.tar.gz">commons-jcs3-dist-3.2-bin.tar.gz</a></td>
+ <td><a href="https://www.apache.org/dist/commons/jcs/binaries/commons-jcs3-dist-3.2-bin.tar.gz.sha512">sha512</a></td>
+ <td><a href="https://www.apache.org/dist/commons/jcs/binaries/commons-jcs3-dist-3.2-bin.tar.gz.asc">pgp</a></td>
</tr>
<tr>
- <td><a href="[preferred]/commons/jcs/binaries/commons-jcs3-dist-3.1-bin.zip">commons-jcs3-dist-3.1-bin.zip</a></td>
- <td><a href="https://www.apache.org/dist/commons/jcs/binaries/commons-jcs3-dist-3.1-bin.zip.sha512">sha512</a></td>
- <td><a href="https://www.apache.org/dist/commons/jcs/binaries/commons-jcs3-dist-3.1-bin.zip.asc">pgp</a></td>
+ <td><a href="[preferred]/commons/jcs/binaries/commons-jcs3-dist-3.2-bin.zip">commons-jcs3-dist-3.2-bin.zip</a></td>
+ <td><a href="https://www.apache.org/dist/commons/jcs/binaries/commons-jcs3-dist-3.2-bin.zip.sha512">sha512</a></td>
+ <td><a href="https://www.apache.org/dist/commons/jcs/binaries/commons-jcs3-dist-3.2-bin.zip.asc">pgp</a></td>
</tr>
</table>
</subsection>
<subsection name="Source">
<table>
<tr>
- <td><a href="[preferred]/commons/jcs/source/commons-jcs3-dist-3.1-src.tar.gz">commons-jcs3-dist-3.1-src.tar.gz</a></td>
- <td><a href="https://www.apache.org/dist/commons/jcs/source/commons-jcs3-dist-3.1-src.tar.gz.sha512">sha512</a></td>
- <td><a href="https://www.apache.org/dist/commons/jcs/source/commons-jcs3-dist-3.1-src.tar.gz.asc">pgp</a></td>
+ <td><a href="[preferred]/commons/jcs/source/commons-jcs3-dist-3.2-src.tar.gz">commons-jcs3-dist-3.2-src.tar.gz</a></td>
+ <td><a href="https://www.apache.org/dist/commons/jcs/source/commons-jcs3-dist-3.2-src.tar.gz.sha512">sha512</a></td>
+ <td><a href="https://www.apache.org/dist/commons/jcs/source/commons-jcs3-dist-3.2-src.tar.gz.asc">pgp</a></td>
</tr>
<tr>
- <td><a href="[preferred]/commons/jcs/source/commons-jcs3-dist-3.1-src.zip">commons-jcs3-dist-3.1-src.zip</a></td>
- <td><a href="https://www.apache.org/dist/commons/jcs/source/commons-jcs3-dist-3.1-src.zip.sha512">sha512</a></td>
- <td><a href="https://www.apache.org/dist/commons/jcs/source/commons-jcs3-dist-3.1-src.zip.asc">pgp</a></td>
+ <td><a href="[preferred]/commons/jcs/source/commons-jcs3-dist-3.2-src.zip">commons-jcs3-dist-3.2-src.zip</a></td>
+ <td><a href="https://www.apache.org/dist/commons/jcs/source/commons-jcs3-dist-3.2-src.zip.sha512">sha512</a></td>
+ <td><a href="https://www.apache.org/dist/commons/jcs/source/commons-jcs3-dist-3.2-src.zip.asc">pgp</a></td>
</tr>
</table>
</subsection>
[commons-jcs] 03/08: Re-introduce deprecated constructor to make japicmp happy
Posted by tv...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
tv pushed a commit to branch release-3.2
in repository https://gitbox.apache.org/repos/asf/commons-jcs.git
commit 01a01556dae54746255a27d8470ac44249fcb967
Author: Thomas Vandahl <tv...@apache.org>
AuthorDate: Sun Jan 8 20:00:12 2023 +0100
Re-introduce deprecated constructor to make japicmp happy
---
.../auxiliary/lateral/socket/tcp/LateralTCPListener.java | 16 ++++++++++++++--
1 file changed, 14 insertions(+), 2 deletions(-)
diff --git a/commons-jcs-core/src/main/java/org/apache/commons/jcs3/auxiliary/lateral/socket/tcp/LateralTCPListener.java b/commons-jcs-core/src/main/java/org/apache/commons/jcs3/auxiliary/lateral/socket/tcp/LateralTCPListener.java
index 8ac7de9e..f7858dfe 100644
--- a/commons-jcs-core/src/main/java/org/apache/commons/jcs3/auxiliary/lateral/socket/tcp/LateralTCPListener.java
+++ b/commons-jcs-core/src/main/java/org/apache/commons/jcs3/auxiliary/lateral/socket/tcp/LateralTCPListener.java
@@ -128,7 +128,7 @@ public class LateralTCPListener<K, V>
return newIns;
});
}
-
+
/**
* Gets the instance attribute of the LateralCacheTCPListener class.
* <p>
@@ -158,7 +158,19 @@ public class LateralTCPListener<K, V>
/**
* Only need one since it does work for all regions, just reference by multiple region names.
* <p>
- * @param ilca
+ * @param ilca ITCPLateralCacheAttributes
+ * @deprecated Specify serializer
+ */
+ @Deprecated
+ protected LateralTCPListener( final ITCPLateralCacheAttributes ilca )
+ {
+ this(ilca, new StandardSerializer());
+ }
+
+ /**
+ * Only need one since it does work for all regions, just reference by multiple region names.
+ * <p>
+ * @param ilca ITCPLateralCacheAttributes
* @param serializer the serializer to use when receiving
*/
protected LateralTCPListener( final ITCPLateralCacheAttributes ilca, final IElementSerializer serializer )
[commons-jcs] 07/08: Update release notes for 3.2 release
Posted by tv...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
tv pushed a commit to branch release-3.2
in repository https://gitbox.apache.org/repos/asf/commons-jcs.git
commit 89fd906d932ec449b8530e99689ac4ef102cbeb2
Author: Thomas Vandahl <tv...@apache.org>
AuthorDate: Sun Jan 8 20:38:59 2023 +0100
Update release notes for 3.2 release
---
RELEASE-NOTES.txt | 75 ++++++++++++++++++-------------------------------------
1 file changed, 24 insertions(+), 51 deletions(-)
diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt
index dada678b..5aa68acc 100644
--- a/RELEASE-NOTES.txt
+++ b/RELEASE-NOTES.txt
@@ -16,18 +16,20 @@ limitations under the License.
Apache Commons JCS
- Version 3.1
+ Version 3.2
Release Notes
INTRODUCTION:
-This document contains the release notes for the 3.1 version of Apache Commons JCS.
-Commons JCS is a distributed caching system written in Java. It is intend to speed up
-applications by providing a means to manage cached data of various dynamic natures.
+This document contains the release notes for the 3.2 version of Apache Commons
+JCS.
+Commons JCS is a distributed caching system written in Java. It is intend to
+speed up applications by providing a means to manage cached data of various
+dynamic natures.
-JCS 3.0 and onwards now targets Java 8.0, making use of features that arrived with Java 8.0
-such as lambdas.
+JCS 3.0 and onwards now targets Java 8.0, making use of features that arrived
+with Java 8.0 such as lambdas.
For the advice on upgrading from 2.x to 3.x, see the following page:
@@ -35,55 +37,26 @@ For the advice on upgrading from 2.x to 3.x, see the following page:
Changes in this version include:
-New features:
-o Add EncryptingSerializer and some documentation
-o Add BlockDiskKeyStore.isEmpty(). Thanks to Gary Gregory.
-o Add IndexedDisk.isEmpty(). Thanks to Gary Gregory.
-
Fixed Bugs:
-o Use new SecureRandom() instead of SecureRandom.getStrongInstance() to
- avoid potential performance problems on Linux Thanks to Bruno Kinoshita.
-o JCS-228: Attempt to fix osgi import packages Thanks to Patrick Ziegler.
-o JCS-191: Fix for Server Failover mechanism not working, add test Thanks to Prajakta Uplaikar.
-o JCS-186: Use configured listener address for UDP service broadcast Thanks to Alex L.
-o JCS-186: Fix UDP service discovery with LateralCache Thanks to Alex L.
-o Fix shutdown race conditions
+o JCS-232: Handle ServiceConfigurationError when using a different logging framework Thanks to Jeremy Long.
+o JCS-231: Fix Lateral TCP cache recovery loop for empty TCP servers Thanks to Andrea Vettori.
+o JCS-230: UDPDiscoveryReceiver with EncryptingSerializer fails #88. Thanks to Dorota Oeknigk-Urbanska.
+o JCS-229: LateralTCPListener class uses always StandardSerializer #89. Thanks to Dorota Oeknigk-Urbanska.
Changes:
-o Update from Apache Log4j 2.14.1 to 2.17.1 Thanks to Gary Gregory.
-o Autodetect lateral service address on the interface used for multicast -
- depending on the multicast protocol:
- IPv6 link-local address for IPv6 multicast,
- IPv4 site-local address for IPv4 multicast
-o Use NIO for UDP service discovery, works with IPv6 now
-o Use NIO for LateralTCPListener
-o IMPORTANT CHANGE
- Use IElementSerializer for LateralTCPSender and listener
-o IMPORTANT CHANGE
- Use IElementSerializer for RemoteHttpCacheServlet
-o IMPORTANT CHANGE
- Use IElementSerializer for Block disk key storage
-o IMPORTANT CHANGE
- Use IElementSerializer for UDP service discovery
-o Replace several Runnable classes with Lambdas
- Deprecate original classes
-o Update from Apache Commons Lang 3.10 to 3.12.0. Thanks to Gary Gregory.
-o Bump build actions/setup-java from v1.4.3 to v2. Thanks to Gary Gregory.
-o Update from Apache Commons IO 2.8.0 to 2.10.0, #72. Thanks to Gary Gregory, Dependabot.
-o Bump actions/cache from 2.1.5 to 2.1.6 #70. Thanks to Dependabot.
-o Bump log4j-api from 2.13.2 to 2.17.1 #79, #81. Thanks to Dependabot.
-
-Removed:
-o Remove support for long deprecated and inconsistent
- RemoteCacheServer configuration keys
- - remote.cache.service.port is now jcs.remotecache.serverattributes.servicePort
- - remote.cache.rmiSocketFactoryTimeoutMillis is now jcs.remotecache.serverattributes.rmiSocketFactoryTimeoutMillis
- - remote.cluster.LocalClusterConsistency is now jcs.remotecache.serverattributes.LocalClusterConsistency
- - remote.cluster.AllowClusterGet is now jcs.remotecache.serverattributes.AllowClusterGet
+o Bump actions/cache from 2.1.7 to 3.0.9 #86, #111. Thanks to Dependabot, Gary Gregory.
+o Bump actions/checkout from 2 to 3.0.2 #93. Thanks to Dependabot, Gary Gregory.
+o Bump actions/setup-java from 2 to 3.5.1. Thanks to Gary Gregory.
+o Bump commons-parent from 52 to 56 #90, #130. Thanks to Dependabot.
+o Bump log4j-api from 2.17.1 to 2.19.0 #85, #100, #107. Thanks to Dependabot.
+o Bump log4j-core from 2.17.1 to 2.19.0 #87, #99, #108. Thanks to Dependabot.
+o Bump commons-text from 1.9 to 1.10.0 #110. Thanks to Dependabot.
+
Historical list of changes: http://commons.apache.org/proper/commons-jcs/changes-report.html
-For complete information on Apache Commons JCS, including instructions on how to submit bug reports,
-patches, or suggestions for improvement, see the Apache Commons JCS website:
+For complete information on Apache Commons JCS, including instructions on how
+to submit bug reports, patches, or suggestions for improvement, see the Apache
+Commons JCS website:
-http://commons.apache.org/proper/commons-jcs/
\ No newline at end of file
+http://commons.apache.org/proper/commons-jcs/
[commons-jcs] 04/08: Add missing hashCode()/equals() methods
Posted by tv...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
tv pushed a commit to branch release-3.2
in repository https://gitbox.apache.org/repos/asf/commons-jcs.git
commit dc4adae5fe1c9d4eaa78a98d3b59238105e0a51c
Author: Thomas Vandahl <tv...@apache.org>
AuthorDate: Sun Jan 8 20:01:23 2023 +0100
Add missing hashCode()/equals() methods
---
.../jcs3/auxiliary/disk/PurgatoryElement.java | 30 ++++++++++++++++++++++
.../jcs3/engine/CacheElementSerialized.java | 20 +++++++++++++++
2 files changed, 50 insertions(+)
diff --git a/commons-jcs-core/src/main/java/org/apache/commons/jcs3/auxiliary/disk/PurgatoryElement.java b/commons-jcs-core/src/main/java/org/apache/commons/jcs3/auxiliary/disk/PurgatoryElement.java
index 593356eb..90142002 100644
--- a/commons-jcs-core/src/main/java/org/apache/commons/jcs3/auxiliary/disk/PurgatoryElement.java
+++ b/commons-jcs-core/src/main/java/org/apache/commons/jcs3/auxiliary/disk/PurgatoryElement.java
@@ -19,6 +19,8 @@ package org.apache.commons.jcs3.auxiliary.disk;
* under the License.
*/
+import java.util.Objects;
+
import org.apache.commons.jcs3.engine.CacheElement;
import org.apache.commons.jcs3.engine.behavior.ICacheElement;
import org.apache.commons.jcs3.engine.behavior.IElementAttributes;
@@ -135,6 +137,34 @@ public class PurgatoryElement<K, V>
cacheElement.setElementAttributes( attr );
}
+ /**
+ * @param obj other object
+ * @return true if this object key equals the key of obj
+ */
+ @Override
+ public boolean equals(final Object obj)
+ {
+ if (this == obj)
+ {
+ return true;
+ }
+ if (!(obj instanceof PurgatoryElement))
+ {
+ return false;
+ }
+ final PurgatoryElement<?,?> other = (PurgatoryElement<?,?>) obj;
+ return Objects.equals(getKey(), other.getKey());
+ }
+
+ /**
+ * @return a hash of the key only
+ */
+ @Override
+ public int hashCode()
+ {
+ return getKey().hashCode();
+ }
+
/**
* @return debug string
*/
diff --git a/commons-jcs-core/src/main/java/org/apache/commons/jcs3/engine/CacheElementSerialized.java b/commons-jcs-core/src/main/java/org/apache/commons/jcs3/engine/CacheElementSerialized.java
index 17788ba1..1964154e 100644
--- a/commons-jcs-core/src/main/java/org/apache/commons/jcs3/engine/CacheElementSerialized.java
+++ b/commons-jcs-core/src/main/java/org/apache/commons/jcs3/engine/CacheElementSerialized.java
@@ -20,6 +20,7 @@ package org.apache.commons.jcs3.engine;
*/
import java.util.Arrays;
+import java.util.Objects;
import org.apache.commons.jcs3.engine.behavior.ICacheElementSerialized;
import org.apache.commons.jcs3.engine.behavior.IElementAttributes;
@@ -57,6 +58,25 @@ public class CacheElementSerialized<K, V>
return this.serializedValue;
}
+ /**
+ * @param obj other object
+ * @return true if this object key equals the key of obj
+ */
+ @Override
+ public boolean equals(final Object obj)
+ {
+ if (this == obj)
+ {
+ return true;
+ }
+ if (!(obj instanceof CacheElementSerialized))
+ {
+ return false;
+ }
+ final CacheElementSerialized<?,?> other = (CacheElementSerialized<?,?>) obj;
+ return Objects.equals(getKey(), other.getKey());
+ }
+
/**
* For debugging only.
* <p>
[commons-jcs] 05/08: japicmp wants a 3.2 release
Posted by tv...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
tv pushed a commit to branch release-3.2
in repository https://gitbox.apache.org/repos/asf/commons-jcs.git
commit ada8e235e8ca54e9574fd81cdeddd807c737d947
Author: Thomas Vandahl <tv...@apache.org>
AuthorDate: Sun Jan 8 20:29:18 2023 +0100
japicmp wants a 3.2 release
---
pom.xml | 4 ++--
src/changes/changes.xml | 2 +-
2 files changed, 3 insertions(+), 3 deletions(-)
diff --git a/pom.xml b/pom.xml
index 7f23c929..7614e498 100644
--- a/pom.xml
+++ b/pom.xml
@@ -531,8 +531,8 @@
<commons.componentid>jcs</commons.componentid>
<commons.osgi.symbolicName>org.apache.commons.${project.artifactId}</commons.osgi.symbolicName>
<commons.module.name>org.apache.commons.jcs3</commons.module.name>
- <commons.release.version>3.1.1</commons.release.version>
- <commons.release.name>commons-jcs3-dist-3.1.1</commons.release.name>
+ <commons.release.version>3.2</commons.release.version>
+ <commons.release.name>commons-jcs3-dist-3.2</commons.release.name>
<commons.release.desc>(Java 8+)</commons.release.desc>
<commons.releaseManagerName>tv</commons.releaseManagerName>
<commons.releaseManagerKey>88817402</commons.releaseManagerKey>
diff --git a/src/changes/changes.xml b/src/changes/changes.xml
index 54cada01..23a2164d 100644
--- a/src/changes/changes.xml
+++ b/src/changes/changes.xml
@@ -19,7 +19,7 @@
<author email="dev@commons.apache.org">Apache Commons Developers</author>
</properties>
<body>
- <release version="3.1.1" date="2023-01-08">
+ <release version="3.2" date="2023-01-08">
<action dev="tv" type="fix" issue="JCS-232" due-to="Jeremy Long">
Handle ServiceConfigurationError when using a different logging framework
</action>
[commons-jcs] 08/08: Update generated files
Posted by tv...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
tv pushed a commit to branch release-3.2
in repository https://gitbox.apache.org/repos/asf/commons-jcs.git
commit 817aa692c9851417737947ab5c6f7ccea263078f
Author: Thomas Vandahl <tv...@apache.org>
AuthorDate: Sun Jan 8 20:46:00 2023 +0100
Update generated files
---
CONTRIBUTING.md | 230 +++++++++++++++++++++++++--------------------------
README.md | 211 +++++++++++++++++++++++-----------------------
xdocs/mail-lists.xml | 20 +++--
3 files changed, 236 insertions(+), 225 deletions(-)
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 7e75de18..019a5169 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -1,115 +1,115 @@
-<!---
- Licensed to the Apache Software Foundation (ASF) under one or more
- contributor license agreements. See the NOTICE file distributed with
- this work for additional information regarding copyright ownership.
- The ASF licenses this file to You under the Apache License, Version 2.0
- (the "License"); you may not use this file except in compliance with
- the License. You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License.
--->
-<!---
- +======================================================================+
- |**** ****|
- |**** THIS FILE IS GENERATED BY THE COMMONS BUILD PLUGIN ****|
- |**** DO NOT EDIT DIRECTLY ****|
- |**** ****|
- +======================================================================+
- | TEMPLATE FILE: contributing-md-template.md |
- | commons-build-plugin/trunk/src/main/resources/commons-xdoc-templates |
- +======================================================================+
- | |
- | 1) Re-generate using: mvn commons-build:contributing-md |
- | |
- | 2) Set the following properties in the component's pom: |
- | - commons.jira.id (required, alphabetic, upper case) |
- | |
- | 3) Example Properties |
- | |
- | <properties> |
- | <commons.jira.id>MATH</commons.jira.id> |
- | </properties> |
- | |
- +======================================================================+
---->
-Contributing to Apache Commons JCS
-======================
-
-You have found a bug or you have an idea for a cool new feature? Contributing code is a great way to give something back to
-the open source community. Before you dig right into the code there are a few guidelines that we need contributors to
-follow so that we can have a chance of keeping on top of things.
-
-Getting Started
----------------
-
-+ Make sure you have a [JIRA account](https://issues.apache.org/jira/).
-+ Make sure you have a [GitHub account](https://github.com/signup/free).
-+ If you're planning to implement a new feature it makes sense to discuss your changes on the [dev list](https://commons.apache.org/mail-lists.html) first. This way you can make sure you're not wasting your time on something that isn't considered to be in Apache Commons JCS's scope.
-+ Submit a [Jira Ticket][jira] for your issue, assuming one does not already exist.
- + Clearly describe the issue including steps to reproduce when it is a bug.
- + Make sure you fill in the earliest version that you know has the issue.
-+ Find the corresponding [repository on GitHub](https://github.com/apache/?query=commons-),
-[fork](https://help.github.com/articles/fork-a-repo/) and check out your forked repository.
-
-Making Changes
---------------
-
-+ Create a _topic branch_ for your isolated work.
- * Usually you should base your branch on the `master` branch.
- * A good topic branch name can be the JIRA bug id plus a keyword, e.g. `JCS-123-InputStream`.
- * If you have submitted multiple JIRA issues, try to maintain separate branches and pull requests.
-+ Make commits of logical units.
- * Make sure your commit messages are meaningful and in the proper format. Your commit message should contain the key of the JIRA issue.
- * e.g. `JCS-123: Close input stream earlier`
-+ Respect the original code style:
- + Only use spaces for indentation.
- + Create minimal diffs - disable _On Save_ actions like _Reformat Source Code_ or _Organize Imports_. If you feel the source code should be reformatted create a separate PR for this change first.
- + Check for unnecessary whitespace with `git diff` -- check before committing.
-+ Make sure you have added the necessary tests for your changes, typically in `src/test/java`.
-+ Run all the tests with `mvn clean verify` to assure nothing else was accidentally broken.
-
-Making Trivial Changes
-----------------------
-
-The JIRA tickets are used to generate the changelog for the next release.
-
-For changes of a trivial nature to comments and documentation, it is not always necessary to create a new ticket in JIRA.
-In this case, it is appropriate to start the first line of a commit with '(doc)' instead of a ticket number.
-
-
-Submitting Changes
-------------------
-
-+ Sign and submit the Apache [Contributor License Agreement][cla] if you haven't already.
- * Note that small patches & typical bug fixes do not require a CLA as
- clause 5 of the [Apache License](https://www.apache.org/licenses/LICENSE-2.0.html#contributions)
- covers them.
-+ Push your changes to a topic branch in your fork of the repository.
-+ Submit a _Pull Request_ to the corresponding repository in the `apache` organization.
- * Verify _Files Changed_ shows only your intended changes and does not
- include additional files like `target/*.class`
-+ Update your JIRA ticket and include a link to the pull request in the ticket.
-
-If you prefer to not use GitHub, then you can instead use
-`git format-patch` (or `svn diff`) and attach the patch file to the JIRA issue.
-
-
-Additional Resources
---------------------
-
-+ [Contributing patches](https://commons.apache.org/patches.html)
-+ [Apache Commons JCS JIRA project page][jira]
-+ [Contributor License Agreement][cla]
-+ [General GitHub documentation](https://help.github.com/)
-+ [GitHub pull request documentation](https://help.github.com/articles/creating-a-pull-request/)
-+ [Apache Commons Twitter Account](https://twitter.com/ApacheCommons)
-+ `#apache-commons` IRC channel on `irc.freenode.net`
-
-[cla]:https://www.apache.org/licenses/#clas
-[jira]:https://issues.apache.org/jira/browse/JCS
+<!---
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<!---
+ +======================================================================+
+ |**** ****|
+ |**** THIS FILE IS GENERATED BY THE COMMONS BUILD PLUGIN ****|
+ |**** DO NOT EDIT DIRECTLY ****|
+ |**** ****|
+ +======================================================================+
+ | TEMPLATE FILE: contributing-md-template.md |
+ | commons-build-plugin/trunk/src/main/resources/commons-xdoc-templates |
+ +======================================================================+
+ | |
+ | 1) Re-generate using: mvn commons-build:contributing-md |
+ | |
+ | 2) Set the following properties in the component's pom: |
+ | - commons.jira.id (required, alphabetic, upper case) |
+ | |
+ | 3) Example Properties |
+ | |
+ | <properties> |
+ | <commons.jira.id>MATH</commons.jira.id> |
+ | </properties> |
+ | |
+ +======================================================================+
+--->
+Contributing to Apache Commons JCS
+======================
+
+You have found a bug or you have an idea for a cool new feature? Contributing code is a great way to give something back to
+the open source community. Before you dig right into the code there are a few guidelines that we need contributors to
+follow so that we can have a chance of keeping on top of things.
+
+Getting Started
+---------------
+
++ Make sure you have a [JIRA account](https://issues.apache.org/jira/).
++ Make sure you have a [GitHub account](https://github.com/signup/free).
++ If you're planning to implement a new feature it makes sense to discuss your changes on the [dev list](https://commons.apache.org/mail-lists.html) first. This way you can make sure you're not wasting your time on something that isn't considered to be in Apache Commons JCS's scope.
++ Submit a [Jira Ticket][jira] for your issue, assuming one does not already exist.
+ + Clearly describe the issue including steps to reproduce when it is a bug.
+ + Make sure you fill in the earliest version that you know has the issue.
++ Find the corresponding [repository on GitHub](https://github.com/apache/?query=commons-),
+[fork](https://help.github.com/articles/fork-a-repo/) and check out your forked repository.
+
+Making Changes
+--------------
+
++ Create a _topic branch_ for your isolated work.
+ * Usually you should base your branch on the `master` or `trunk` branch.
+ * A good topic branch name can be the JIRA bug id plus a keyword, e.g. `JCS-123-InputStream`.
+ * If you have submitted multiple JIRA issues, try to maintain separate branches and pull requests.
++ Make commits of logical units.
+ * Make sure your commit messages are meaningful and in the proper format. Your commit message should contain the key of the JIRA issue.
+ * e.g. `JCS-123: Close input stream earlier`
++ Respect the original code style:
+ + Only use spaces for indentation.
+ + Create minimal diffs - disable _On Save_ actions like _Reformat Source Code_ or _Organize Imports_. If you feel the source code should be reformatted create a separate PR for this change first.
+ + Check for unnecessary whitespace with `git diff` -- check before committing.
++ Make sure you have added the necessary tests for your changes, typically in `src/test/java`.
++ Run all the tests with `mvn clean verify` to assure nothing else was accidentally broken.
+
+Making Trivial Changes
+----------------------
+
+The JIRA tickets are used to generate the changelog for the next release.
+
+For changes of a trivial nature to comments and documentation, it is not always necessary to create a new ticket in JIRA.
+In this case, it is appropriate to start the first line of a commit with '(doc)' instead of a ticket number.
+
+
+Submitting Changes
+------------------
+
++ Sign and submit the Apache [Contributor License Agreement][cla] if you haven't already.
+ * Note that small patches & typical bug fixes do not require a CLA as
+ clause 5 of the [Apache License](https://www.apache.org/licenses/LICENSE-2.0.html#contributions)
+ covers them.
++ Push your changes to a topic branch in your fork of the repository.
++ Submit a _Pull Request_ to the corresponding repository in the `apache` organization.
+ * Verify _Files Changed_ shows only your intended changes and does not
+ include additional files like `target/*.class`
++ Update your JIRA ticket and include a link to the pull request in the ticket.
+
+If you prefer to not use GitHub, then you can instead use
+`git format-patch` (or `svn diff`) and attach the patch file to the JIRA issue.
+
+
+Additional Resources
+--------------------
+
++ [Contributing patches](https://commons.apache.org/patches.html)
++ [Apache Commons JCS JIRA project page][jira]
++ [Contributor License Agreement][cla]
++ [General GitHub documentation](https://help.github.com/)
++ [GitHub pull request documentation](https://help.github.com/articles/creating-a-pull-request/)
++ [Apache Commons Twitter Account](https://twitter.com/ApacheCommons)
++ `#apache-commons` IRC channel on `irc.freenode.net`
+
+[cla]:https://www.apache.org/licenses/#clas
+[jira]:https://issues.apache.org/jira/browse/JCS
diff --git a/README.md b/README.md
index 1bbaa904..056bcb46 100644
--- a/README.md
+++ b/README.md
@@ -1,105 +1,106 @@
-<!---
- Licensed to the Apache Software Foundation (ASF) under one or more
- contributor license agreements. See the NOTICE file distributed with
- this work for additional information regarding copyright ownership.
- The ASF licenses this file to You under the Apache License, Version 2.0
- (the "License"); you may not use this file except in compliance with
- the License. You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License.
--->
-<!---
- +======================================================================+
- |**** ****|
- |**** THIS FILE IS GENERATED BY THE COMMONS BUILD PLUGIN ****|
- |**** DO NOT EDIT DIRECTLY ****|
- |**** ****|
- +======================================================================+
- | TEMPLATE FILE: readme-md-template.md |
- | commons-build-plugin/trunk/src/main/resources/commons-xdoc-templates |
- +======================================================================+
- | |
- | 1) Re-generate using: mvn commons-build:readme-md |
- | |
- | 2) Set the following properties in the component's pom: |
- | - commons.componentid (required, alphabetic, lower case) |
- | - commons.release.version (required) |
- | |
- | 3) Example Properties |
- | |
- | <properties> |
- | <commons.componentid>math</commons.componentid> |
- | <commons.release.version>1.2</commons.release.version> |
- | </properties> |
- | |
- +======================================================================+
---->
-Apache Commons JCS
-===================
-
-[](https://github.com/apache/commons-jcs/actions)
-[](https://app.codecov.io/gh/apache/commons-jcs)
-[](https://maven-badges.herokuapp.com/maven-central/org.apache.commons/commons-jcs3/?gav=true)
-[](https://javadoc.io/doc/org.apache.commons/commons-jcs3/3.1)
-
-Apache Commons JCS is a distributed, versatile caching system.
-
-Documentation
--------------
-
-More information can be found on the [Apache Commons JCS homepage](https://commons.apache.org/proper/commons-jcs).
-The [Javadoc](https://commons.apache.org/proper/commons-jcs/apidocs) can be browsed.
-Questions related to the usage of Apache Commons JCS should be posted to the [user mailing list][ml].
-
-Where can I get the latest release?
------------------------------------
-You can download source and binaries from our [download page](https://commons.apache.org/proper/commons-jcs/download_jcs.cgi).
-
-Alternatively you can pull it from the central Maven repositories:
-
-```xml
-<dependency>
- <groupId>org.apache.commons</groupId>
- <artifactId>commons-jcs3</artifactId>
- <version>3.1</version>
-</dependency>
-```
-
-Contributing
-------------
-
-We accept Pull Requests via GitHub. The [developer mailing list][ml] is the main channel of communication for contributors.
-There are some guidelines which will make applying PRs easier for us:
-+ No tabs! Please use spaces for indentation.
-+ Respect the code style.
-+ Create minimal diffs - disable on save actions like reformat source code or organize imports. If you feel the source code should be reformatted create a separate PR for this change.
-+ Provide JUnit tests for your changes and make sure your changes don't break any existing tests by running ```mvn```.
-
-If you plan to contribute on a regular basis, please consider filing a [contributor license agreement](https://www.apache.org/licenses/#clas).
-You can learn more about contributing via GitHub in our [contribution guidelines](CONTRIBUTING.md).
-
-License
--------
-This code is under the [Apache Licence v2](https://www.apache.org/licenses/LICENSE-2.0).
-
-See the `NOTICE.txt` file for required notices and attributions.
-
-Donations
----------
-You like Apache Commons JCS? Then [donate back to the ASF](https://www.apache.org/foundation/contributing.html) to support the development.
-
-Additional Resources
---------------------
-
-+ [Apache Commons Homepage](https://commons.apache.org/)
-+ [Apache Issue Tracker (JIRA)](https://issues.apache.org/jira/browse/JCS)
-+ [Apache Commons Twitter Account](https://twitter.com/ApacheCommons)
-+ `#apache-commons` IRC channel on `irc.freenode.org`
-
-[ml]:https://commons.apache.org/mail-lists.html
+<!---
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<!---
+ +======================================================================+
+ |**** ****|
+ |**** THIS FILE IS GENERATED BY THE COMMONS BUILD PLUGIN ****|
+ |**** DO NOT EDIT DIRECTLY ****|
+ |**** ****|
+ +======================================================================+
+ | TEMPLATE FILE: readme-md-template.md |
+ | commons-build-plugin/trunk/src/main/resources/commons-xdoc-templates |
+ +======================================================================+
+ | |
+ | 1) Re-generate using: mvn commons-build:readme-md |
+ | |
+ | 2) Set the following properties in the component's pom: |
+ | - commons.componentid (required, alphabetic, lower case) |
+ | - commons.release.version (required) |
+ | |
+ | 3) Example Properties |
+ | |
+ | <properties> |
+ | <commons.componentid>math</commons.componentid> |
+ | <commons.release.version>1.2</commons.release.version> |
+ | </properties> |
+ | |
+ +======================================================================+
+--->
+Apache Commons JCS
+===================
+
+[](https://travis-ci.org/apache/commons-jcs)
+[](https://github.com/apache/commons-jcs/actions)
+[](https://coveralls.io/r/apache/commons-jcs)
+[](https://maven-badges.herokuapp.com/maven-central/org.apache.commons/commons-jcs3/)
+[](https://javadoc.io/doc/org.apache.commons/commons-jcs3/3.2)
+
+Apache Commons JCS is a distributed, versatile caching system.
+
+Documentation
+-------------
+
+More information can be found on the [Apache Commons JCS homepage](https://commons.apache.org/proper/commons-jcs).
+The [Javadoc](https://commons.apache.org/proper/commons-jcs/apidocs) can be browsed.
+Questions related to the usage of Apache Commons JCS should be posted to the [user mailing list][ml].
+
+Where can I get the latest release?
+-----------------------------------
+You can download source and binaries from our [download page](https://commons.apache.org/proper/commons-jcs/download_jcs.cgi).
+
+Alternatively you can pull it from the central Maven repositories:
+
+```xml
+<dependency>
+ <groupId>org.apache.commons</groupId>
+ <artifactId>commons-jcs3</artifactId>
+ <version>3.2</version>
+</dependency>
+```
+
+Contributing
+------------
+
+We accept Pull Requests via GitHub. The [developer mailing list][ml] is the main channel of communication for contributors.
+There are some guidelines which will make applying PRs easier for us:
++ No tabs! Please use spaces for indentation.
++ Respect the code style.
++ Create minimal diffs - disable on save actions like reformat source code or organize imports. If you feel the source code should be reformatted create a separate PR for this change.
++ Provide JUnit tests for your changes and make sure your changes don't break any existing tests by running ```mvn clean test```.
+
+If you plan to contribute on a regular basis, please consider filing a [contributor license agreement](https://www.apache.org/licenses/#clas).
+You can learn more about contributing via GitHub in our [contribution guidelines](CONTRIBUTING.md).
+
+License
+-------
+This code is under the [Apache Licence v2](https://www.apache.org/licenses/LICENSE-2.0).
+
+See the `NOTICE.txt` file for required notices and attributions.
+
+Donations
+---------
+You like Apache Commons JCS? Then [donate back to the ASF](https://www.apache.org/foundation/contributing.html) to support the development.
+
+Additional Resources
+--------------------
+
++ [Apache Commons Homepage](https://commons.apache.org/)
++ [Apache Issue Tracker (JIRA)](https://issues.apache.org/jira/browse/JCS)
++ [Apache Commons Twitter Account](https://twitter.com/ApacheCommons)
++ `#apache-commons` IRC channel on `irc.freenode.org`
+
+[ml]:https://commons.apache.org/mail-lists.html
diff --git a/xdocs/mail-lists.xml b/xdocs/mail-lists.xml
index f19151ad..b37bef0d 100644
--- a/xdocs/mail-lists.xml
+++ b/xdocs/mail-lists.xml
@@ -105,7 +105,9 @@ limitations under the License.
<td><a href="mailto:user-subscribe@commons.apache.org">Subscribe</a></td>
<td><a href="mailto:user-unsubscribe@commons.apache.org">Unsubscribe</a></td>
<td><a href="mailto:user@commons.apache.org?subject=[jcs]">Post</a></td>
- <td><a href="https://mail-archives.apache.org/mod_mbox/commons-user/">mail-archives.apache.org</a></td>
+ <td><a href="https://mail-archives.apache.org/mod_mbox/commons-user/">mail-archives.apache.org</a><br />
+ <a href="https://lists.apache.org/list.html?user@commons.apache.org">lists.apache.org</a>
+ </td>
<td><a href="https://markmail.org/list/org.apache.commons.users/">markmail.org</a><br />
<a href="https://www.mail-archive.com/user@commons.apache.org/">www.mail-archive.com</a><br />
<a href="https://news.gmane.org/gmane.comp.jakarta.commons.devel">news.gmane.org</a>
@@ -123,7 +125,9 @@ limitations under the License.
<td><a href="mailto:dev-subscribe@commons.apache.org">Subscribe</a></td>
<td><a href="mailto:dev-unsubscribe@commons.apache.org">Unsubscribe</a></td>
<td><a href="mailto:dev@commons.apache.org?subject=[jcs]">Post</a></td>
- <td><a href="https://mail-archives.apache.org/mod_mbox/commons-dev/">mail-archives.apache.org</a></td>
+ <td><a href="https://mail-archives.apache.org/mod_mbox/commons-dev/">mail-archives.apache.org</a><br />
+ <a href="https://lists.apache.org/list.html?dev@commons.apache.org">lists.apache.org</a>
+ </td>
<td><a href="https://markmail.org/list/org.apache.commons.dev/">markmail.org</a><br />
<a href="https://www.mail-archive.com/dev@commons.apache.org/">www.mail-archive.com</a><br />
<a href="https://news.gmane.org/gmane.comp.jakarta.commons.devel">news.gmane.org</a>
@@ -141,7 +145,9 @@ limitations under the License.
<td><a href="mailto:issues-subscribe@commons.apache.org">Subscribe</a></td>
<td><a href="mailto:issues-unsubscribe@commons.apache.org">Unsubscribe</a></td>
<td><i>read only</i></td>
- <td><a href="https://mail-archives.apache.org/mod_mbox/commons-issues/">mail-archives.apache.org</a></td>
+ <td><a href="https://mail-archives.apache.org/mod_mbox/commons-issues/">mail-archives.apache.org</a><br />
+ <a href="https://lists.apache.org/list.html?issues@commons.apache.org">lists.apache.org</a>
+ </td>
<td><a href="https://markmail.org/list/org.apache.commons.issues/">markmail.org</a><br />
<a href="https://www.mail-archive.com/issues@commons.apache.org/">www.mail-archive.com</a>
</td>
@@ -158,7 +164,9 @@ limitations under the License.
<td><a href="mailto:commits-subscribe@commons.apache.org">Subscribe</a></td>
<td><a href="mailto:commits-unsubscribe@commons.apache.org">Unsubscribe</a></td>
<td><i>read only</i></td>
- <td><a href="https://mail-archives.apache.org/mod_mbox/commons-commits/">mail-archives.apache.org</a></td>
+ <td><a href="https://mail-archives.apache.org/mod_mbox/commons-commits/">mail-archives.apache.org</a><br />
+ <a href="https://lists.apache.org/list.html?commits@commons.apache.org">lists.apache.org</a>
+ </td>
<td><a href="https://markmail.org/list/org.apache.commons.commits/">markmail.org</a><br />
<a href="https://www.mail-archive.com/commits@commons.apache.org/">www.mail-archive.com</a>
</td>
@@ -191,7 +199,9 @@ limitations under the License.
<td><a class="externalLink" href="mailto:announce-subscribe@apache.org">Subscribe</a></td>
<td><a class="externalLink" href="mailto:announce-unsubscribe@apache.org">Unsubscribe</a></td>
<td><i>read only</i></td>
- <td><a class="externalLink" href="https://mail-archives.apache.org/mod_mbox/www-announce/">mail-archives.apache.org</a></td>
+ <td><a class="externalLink" href="https://mail-archives.apache.org/mod_mbox/www-announce/">mail-archives.apache.org</a><br />
+ <a class="externalLink" href="https://lists.apache.org/list.html?announce@apache.org">lists.apache.org</a>
+ </td>
<td><a class="externalLink" href="https://markmail.org/list/org.apache.announce/">markmail.org</a><br />
<a class="externalLink" href="https://old.nabble.com/Apache-News-and-Announce-f109.html">old.nabble.com</a><br />
<a class="externalLink" href="https://www.mail-archive.com/announce@apache.org/">www.mail-archive.com</a><br />
[commons-jcs] 01/08: Typos
Posted by tv...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
tv pushed a commit to branch release-3.2
in repository https://gitbox.apache.org/repos/asf/commons-jcs.git
commit 353c9508a4a6689993b5105f43beae2c164590dd
Author: Thomas Vandahl <tv...@apache.org>
AuthorDate: Sun Jan 8 19:11:18 2023 +0100
Typos
---
.../org/apache/commons/jcs3/utils/discovery/UDPDiscoveryReceiver.java | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/commons-jcs-core/src/main/java/org/apache/commons/jcs3/utils/discovery/UDPDiscoveryReceiver.java b/commons-jcs-core/src/main/java/org/apache/commons/jcs3/utils/discovery/UDPDiscoveryReceiver.java
index 5b8238f4..573197e9 100644
--- a/commons-jcs-core/src/main/java/org/apache/commons/jcs3/utils/discovery/UDPDiscoveryReceiver.java
+++ b/commons-jcs-core/src/main/java/org/apache/commons/jcs3/utils/discovery/UDPDiscoveryReceiver.java
@@ -87,7 +87,7 @@ public class UDPDiscoveryReceiver
/**
* Constructor for the UDPDiscoveryReceiver object.
* <p>
- * We determine out own host using InetAddress
+ * We determine our own host using InetAddress
*<p>
* @param service
* @param multicastInterfaceString
@@ -335,7 +335,7 @@ public class UDPDiscoveryReceiver
/**
* Separate thread run when a command comes into the UDPDiscoveryReceiver.
- * @deprectaed No longer used
+ * @deprecated No longer used
*/
@Deprecated
public class MessageHandler