This is an automated email from the ASF dual-hosted git repository.
leerho pushed a commit to branch frank_grimes_java-21-ffm
in repository https://gitbox.apache.org/repos/asf/datasketches-memory.git
The following commit(s) were added to refs/heads/frank_grimes_java-21-ffm by
this push:
new df3e05c remove references to Java 17
df3e05c is described below
commit df3e05c98d64f4199cda1df622c04b55a63bc7ee
Author: Lee Rhodes <[email protected]>
AuthorDate: Thu Dec 5 12:10:44 2024 -0800
remove references to Java 17
---
.../apache/datasketches/memory/MurmurHash3.java | 4 +--
.../org/apache/datasketches/memory/Resource.java | 31 ++++++++++++----------
.../memory/internal/MurmurHash3v4.java | 4 +--
.../apache/datasketches/memory/package-info.java | 3 +--
.../internal/ExampleMemoryRequestServerTest.java | 2 +-
5 files changed, 23 insertions(+), 21 deletions(-)
diff --git a/src/main/java/org/apache/datasketches/memory/MurmurHash3.java
b/src/main/java/org/apache/datasketches/memory/MurmurHash3.java
index 161bf58..bd821c7 100644
--- a/src/main/java/org/apache/datasketches/memory/MurmurHash3.java
+++ b/src/main/java/org/apache/datasketches/memory/MurmurHash3.java
@@ -24,8 +24,8 @@ import java.lang.foreign.MemorySegment;
import org.apache.datasketches.memory.internal.MurmurHash3v4;
/**
- * <p>The MurmurHash3 is a fast, non-cryptographic, 128-bit hash function that
has
- * excellent avalanche and 2-way bit independence properties.</p>
+ * The MurmurHash3 is a fast, non-cryptographic, 128-bit hash function that has
+ * excellent avalanche and 2-way bit independence properties.
*
* <p>Austin Appleby's C++
* <a
href="https://github.com/aappleby/smhasher/blob/master/src/MurmurHash3.cpp";>
diff --git a/src/main/java/org/apache/datasketches/memory/Resource.java
b/src/main/java/org/apache/datasketches/memory/Resource.java
index 34baf70..c8a13f0 100644
--- a/src/main/java/org/apache/datasketches/memory/Resource.java
+++ b/src/main/java/org/apache/datasketches/memory/Resource.java
@@ -155,7 +155,7 @@ public interface Resource extends AutoCloseable {
/**
* Forces any changes made to the contents of this mapped segment to be
written to the storage device described
* by the mapped segment's file descriptor.
- * @see <a
href="https://docs.oracle.com/en/java/javase/17/docs/api/jdk.incubator.foreign/jdk/incubator/foreign/MemorySegment.html#force()">force()</a>
+ * @see <a
href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/MemorySegment.html#force()">force()</a>
*/
void force();
@@ -231,9 +231,10 @@ public interface Resource extends AutoCloseable {
boolean isHeap();
/**
- * Tells whether or not the contents of this mapped segment is resident in
physical memory. Please refer to
- * <a
href="https://docs.oracle.com/en/java/javase/17/docs/api/jdk.incubator.foreign/jdk/incubator/foreign/MemorySegment.html#isLoaded()">isLoaded()</a>.
+ * Returns true if it is likely that the contents of this segment is
resident in physical memory.
* @return true if it is likely that the contents of this segment is
resident in physical memory.
+ * @see
+<a
href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/MemorySegment.html#isLoaded()">isLoaded()</a>
*/
boolean isLoaded();
@@ -269,9 +270,8 @@ public interface Resource extends AutoCloseable {
boolean isSameResource(Resource that);
/**
- * Loads the contents of this mapped segment into physical memory. Please
refer to
- * <a
href="https://docs.oracle.com/en/java/javase/17/docs/api/jdk.incubator.foreign/jdk/incubator/foreign/MemorySegment.html
-#load()">load()</a>
+ * Loads the contents of this mapped segment into physical memory.
+ * @see <a
href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/MemorySegment.html#load()">load()</a>
*/
void load();
@@ -287,18 +287,18 @@ public interface Resource extends AutoCloseable {
long nativeOverlap(Resource that);
/**
- * See <a
href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/MemorySegment.html
-#mismatch(java.lang.foreign.MemorySegment)">mismatch(MemorySegment)</a>
+ * Finds the first byte mismatch with <i>that</i>.
* @param that the other Resource
* @return the relative offset, in bytes, of the first mismatch between this
and the given other Resource object,
- * otherwise -1 if no mismatch
+ * otherwise -1 if no mismatch.
+ * @see
+<a
href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/MemorySegment.html#mismatch(java.lang.foreign.MemorySegment)">
+mismatch(MemorySegment)</a>
*/
long mismatch(Resource that);
/**
- * See <a
href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/MemorySegment.html
-#mismatch(java.lang.foreign.MemorySegment,long,long,java.lang.foreign.MemorySegment,long,long)">
-mismatch(MemorySegment, long, long, MemorySegment, long, long)</a>
+ * Finds the first byte mismatch based on the given offsets
* @param src the given source Resource
* @param srcFromOffset the given start offset of the source region,
inclusive.
* @param srcToOffset the given end offset of the source region, exclusive.
@@ -306,6 +306,9 @@ mismatch(MemorySegment, long, long, MemorySegment, long,
long)</a>
* @param dstFromOffset the given start of the destination destination
region, inclusive.
* @param dstToOffset the given end offset of the destination destination
region, exclusive.
* @return the byte offset of the first mismatch relative to the start of
each of the above two regions.
+ * @see
+<a
href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/MemorySegment.html#mismatch(java.lang.foreign.MemorySegment,long,long,java.lang.foreign.MemorySegment,long,long)">
+mismatch(MemorySegment, long, long, MemorySegment, long, long)</a>
*/
long mismatch(Resource src, long srcFromOffset, long srcToOffset, Resource
dst, long dstFromOffset, long dstToOffset);
@@ -353,8 +356,8 @@ mismatch(MemorySegment, long, long, MemorySegment, long,
long)</a>
MemorySegment toMemorySegment();
/**
- * Unloads the contents of this mapped segment from physical memory. Please
refer to
- * <a
href="https://docs.oracle.com/en/java/javase/17/docs/api/jdk.incubator.foreign/jdk/incubator/foreign/MemorySegment.html#unload()">unload()</a>
+ * Unloads the contents of this mapped segment from physical memory.
+ * @see <a
href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/MemorySegment.html#unload()">unload()</a>
*/
void unload();
diff --git
a/src/main/java/org/apache/datasketches/memory/internal/MurmurHash3v4.java
b/src/main/java/org/apache/datasketches/memory/internal/MurmurHash3v4.java
index cd23c7a..3c64961 100644
--- a/src/main/java/org/apache/datasketches/memory/internal/MurmurHash3v4.java
+++ b/src/main/java/org/apache/datasketches/memory/internal/MurmurHash3v4.java
@@ -28,8 +28,8 @@ import java.util.Objects;
import org.apache.datasketches.memory.Memory;
/**
- * <p>The MurmurHash3 is a fast, non-cryptographic, 128-bit hash function that
has
- * excellent avalanche and 2-way bit independence properties.</p>
+ * The MurmurHash3 is a fast, non-cryptographic, 128-bit hash function that has
+ * excellent avalanche and 2-way bit independence properties.
*
* <p>Austin Appleby's C++
* <a
href="https://github.com/aappleby/smhasher/blob/master/src/MurmurHash3.cpp";>
diff --git a/src/main/java/org/apache/datasketches/memory/package-info.java
b/src/main/java/org/apache/datasketches/memory/package-info.java
index 5c6400b..61a3048 100644
--- a/src/main/java/org/apache/datasketches/memory/package-info.java
+++ b/src/main/java/org/apache/datasketches/memory/package-info.java
@@ -18,11 +18,10 @@
*/
/**
- * <p>This package provides high performance primitive and primitive array
access to direct (native),
+ * This package provides high performance primitive and primitive array access
to direct (native),
* off-heap memory and memory-mapped file resources, and consistent views into
* {@link java.nio.ByteBuffer}, and on-heap primitive arrays. It can be used
as a more
* comprehensive and flexible replacement for {@link java.nio.ByteBuffer}.
- * </p>
*
* <p>In addition, this package provides:</p>
*
diff --git
a/src/test/java/org/apache/datasketches/memory/internal/ExampleMemoryRequestServerTest.java
b/src/test/java/org/apache/datasketches/memory/internal/ExampleMemoryRequestServerTest.java
index 08a7e76..a90a3b1 100644
---
a/src/test/java/org/apache/datasketches/memory/internal/ExampleMemoryRequestServerTest.java
+++
b/src/test/java/org/apache/datasketches/memory/internal/ExampleMemoryRequestServerTest.java
@@ -30,7 +30,7 @@ import org.testng.annotations.Test;
/**
* Example of how to use the MemoryRequestServer with a memory hungry client.
*
- * <p>Note: this example only works with Java 17.</p>
+ * <p>Note: this example only works with Java 21 and above.</p>
*
* @author Lee Rhodes
*/
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
