This is an automated email from the ASF dual-hosted git repository.
github-actions[bot] pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/arrow-java.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 3a6f83434 Publish documentation
(3a1498b5c060dd359a5aa79e6d6c8d8997cfe013)
3a6f83434 is described below
commit 3a6f834346586835e486e9b3b969874fa9534e54
Author: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
AuthorDate: Thu Aug 27 14:00:23 2026 +0000
Publish documentation (3a1498b5c060dd359a5aa79e6d6c8d8997cfe013)
---
main/_sources/install.rst.txt | 20 ++++++++++++++------
main/install.html | 19 +++++++++++++------
.../org/apache/arrow/vector/ValueVector.html | 2 --
main/searchindex.js | 2 +-
4 files changed, 28 insertions(+), 15 deletions(-)
diff --git a/main/_sources/install.rst.txt b/main/_sources/install.rst.txt
index e0b34515e..904b00499 100644
--- a/main/_sources/install.rst.txt
+++ b/main/_sources/install.rst.txt
@@ -28,10 +28,13 @@ Java Compatibility
==================
Java modules are compatible with JDK 17 and above. Currently, JDK versions
-17, 21, and latest are tested in CI.
+17, 21, and 25 are tested in CI.
-Note that some JDK internals must be exposed by
-adding
``--add-opens=java.base/java.nio=org.apache.arrow.memory.core,ALL-UNNAMED`` to
the ``java`` command:
+Note that some JDK internals must be exposed by adding these flags to the
``java`` command:
+
+- ``--add-opens=java.base/java.nio=org.apache.arrow.memory.core,ALL-UNNAMED``
(always required)
+- ``--enable-native-access=io.netty.common`` (Java 25+, when using
``arrow-memory-netty``)
+- ``--sun-misc-unsafe-memory-access=allow`` (Java 25+; not stricly necessary,
but suppresses certain warnings)
.. code-block:: shell
@@ -40,14 +43,19 @@ adding
``--add-opens=java.base/java.nio=org.apache.arrow.memory.core,ALL-UNNAMED
# Indirectly via environment variables
$ env
JDK_JAVA_OPTIONS="--add-opens=java.base/java.nio=org.apache.arrow.memory.core,ALL-UNNAMED"
java -jar ...
-Otherwise, you may see errors like ``module java.base does not "opens
-java.nio" to unnamed module`` or ``module java.base does not "opens
-java.nio" to org.apache.arrow.memory.core``
+Otherwise, you may see errors and/or warnings like these:
+- ``module java.base does not "opens java.nio" to unnamed module``
+- ``module java.base does not "opens java.nio" to
org.apache.arrow.memory.core``
+- ``Native access (restricted methods) is not enabled for the io.netty.common
module.``
+- ``A terminally deprecated method in sun.misc.Unsafe has been called``
Note that the command has changed from Arrow 15 and earlier. If you are still
using the flags from that version
(``--add-opens=java.base/java.nio=org.apache.arrow.memory.core,ALL-UNNAMED``)
you will see the
``module java.base does not "opens java.nio" to org.apache.arrow.memory.core``
error.
+For more information on these flags, see the `Netty documentation
+<https://netty.io/wiki/java-24-and-sun.misc.unsafe.html>`_.
+
If you are using flight-core or dependent modules, you will need to mark that
flight-core can read unnamed modules.
Modifying the command above for Flight:
diff --git a/main/install.html b/main/install.html
index 642202b2c..5112560a7 100644
--- a/main/install.html
+++ b/main/install.html
@@ -271,21 +271,28 @@
<section id="java-compatibility">
<h2>Java Compatibility<a class="headerlink" href="#java-compatibility"
title="Link to this heading">ΒΆ</a></h2>
<p>Java modules are compatible with JDK 17 and above. Currently, JDK versions
-17, 21, and latest are tested in CI.</p>
-<p>Note that some JDK internals must be exposed by
-adding <code class="docutils literal notranslate"><span
class="pre">--add-opens=java.base/java.nio=org.apache.arrow.memory.core,ALL-UNNAMED</span></code>
to the <code class="docutils literal notranslate"><span
class="pre">java</span></code> command:</p>
+17, 21, and 25 are tested in CI.</p>
+<p>Note that some JDK internals must be exposed by adding these flags to the
<code class="docutils literal notranslate"><span class="pre">java</span></code>
command:</p>
+<ul class="simple">
+<li><p><code class="docutils literal notranslate"><span
class="pre">--add-opens=java.base/java.nio=org.apache.arrow.memory.core,ALL-UNNAMED</span></code>
(always required)</p></li>
+<li><p><code class="docutils literal notranslate"><span
class="pre">--enable-native-access=io.netty.common</span></code> (Java 25+,
when using <code class="docutils literal notranslate"><span
class="pre">arrow-memory-netty</span></code>)</p></li>
+<li><p><code class="docutils literal notranslate"><span
class="pre">--sun-misc-unsafe-memory-access=allow</span></code> (Java 25+; not
stricly necessary, but suppresses certain warnings)</p></li>
+</ul>
<div class="highlight-shell notranslate"><div
class="highlight"><pre><span></span><span class="c1"># Directly on the command
line</span>
$<span class="w"> </span>java<span class="w"> </span>--add-opens<span
class="o">=</span>java.base/java.nio<span
class="o">=</span>org.apache.arrow.memory.core,ALL-UNNAMED<span class="w">
</span>-jar<span class="w"> </span>...
<span class="c1"># Indirectly via environment variables</span>
$<span class="w"> </span>env<span class="w"> </span><span
class="nv">JDK_JAVA_OPTIONS</span><span class="o">=</span><span
class="s2">"--add-opens=java.base/java.nio=org.apache.arrow.memory.core,ALL-UNNAMED"</span><span
class="w"> </span>java<span class="w"> </span>-jar<span class="w"> </span>...
</pre></div>
</div>
-<p>Otherwise, you may see errors like <code class="docutils literal
notranslate"><span class="pre">module</span> <span class="pre">java.base</span>
<span class="pre">does</span> <span class="pre">not</span> <span
class="pre">"opens</span>
-<span class="pre">java.nio"</span> <span class="pre">to</span> <span
class="pre">unnamed</span> <span class="pre">module</span></code> or <code
class="docutils literal notranslate"><span class="pre">module</span> <span
class="pre">java.base</span> <span class="pre">does</span> <span
class="pre">not</span> <span class="pre">"opens</span>
-<span class="pre">java.nio"</span> <span class="pre">to</span> <span
class="pre">org.apache.arrow.memory.core</span></code></p>
+<p>Otherwise, you may see errors and/or warnings like these:
+- <code class="docutils literal notranslate"><span class="pre">module</span>
<span class="pre">java.base</span> <span class="pre">does</span> <span
class="pre">not</span> <span class="pre">"opens</span> <span
class="pre">java.nio"</span> <span class="pre">to</span> <span
class="pre">unnamed</span> <span class="pre">module</span></code>
+- <code class="docutils literal notranslate"><span class="pre">module</span>
<span class="pre">java.base</span> <span class="pre">does</span> <span
class="pre">not</span> <span class="pre">"opens</span> <span
class="pre">java.nio"</span> <span class="pre">to</span> <span
class="pre">org.apache.arrow.memory.core</span></code>
+- <code class="docutils literal notranslate"><span class="pre">Native</span>
<span class="pre">access</span> <span class="pre">(restricted</span> <span
class="pre">methods)</span> <span class="pre">is</span> <span
class="pre">not</span> <span class="pre">enabled</span> <span
class="pre">for</span> <span class="pre">the</span> <span
class="pre">io.netty.common</span> <span class="pre">module.</span></code>
+- <code class="docutils literal notranslate"><span class="pre">A</span> <span
class="pre">terminally</span> <span class="pre">deprecated</span> <span
class="pre">method</span> <span class="pre">in</span> <span
class="pre">sun.misc.Unsafe</span> <span class="pre">has</span> <span
class="pre">been</span> <span class="pre">called</span></code></p>
<p>Note that the command has changed from Arrow 15 and earlier. If you are
still using the flags from that version
(<code class="docutils literal notranslate"><span
class="pre">--add-opens=java.base/java.nio=org.apache.arrow.memory.core,ALL-UNNAMED</span></code>)
you will see the
<code class="docutils literal notranslate"><span class="pre">module</span>
<span class="pre">java.base</span> <span class="pre">does</span> <span
class="pre">not</span> <span class="pre">"opens</span> <span
class="pre">java.nio"</span> <span class="pre">to</span> <span
class="pre">org.apache.arrow.memory.core</span></code> error.</p>
+<p>For more information on these flags, see the <a class="reference external"
href="https://netty.io/wiki/java-24-and-sun.misc.unsafe.html";>Netty
documentation</a>.</p>
<p>If you are using flight-core or dependent modules, you will need to mark
that flight-core can read unnamed modules.
Modifying the command above for Flight:</p>
<div class="highlight-shell notranslate"><div
class="highlight"><pre><span></span><span class="c1"># Directly on the command
line</span>
diff --git
a/main/reference/org.apache.arrow.vector/org/apache/arrow/vector/ValueVector.html
b/main/reference/org.apache.arrow.vector/org/apache/arrow/vector/ValueVector.html
index 0da142f7a..dd7a54c8d 100644
---
a/main/reference/org.apache.arrow.vector/org/apache/arrow/vector/ValueVector.html
+++
b/main/reference/org.apache.arrow.vector/org/apache/arrow/vector/ValueVector.html
@@ -113,10 +113,8 @@ extends <a
href="https://docs.oracle.com/en/java/javase/17/docs/api/java.base/ja
<p>This interface "should" strive to guarantee this order of operation:
<blockquote>
-
allocate > mutate > setvaluecount > access > clear (or allocate
to start the process
over).
-
</blockquote></div>
</section>
<section class="summary">
diff --git a/main/searchindex.js b/main/searchindex.js
index d0d5db009..e81cc473c 100644
--- a/main/searchindex.js
+++ b/main/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"alltitles": {"Adding Services": [[6, "adding-services"]],
"Adding and removing vectors": [[18, "adding-and-removing-vectors"]],
"Allocation Details": [[13, "allocation-details"]], "Allocator Perspective":
[[13, "allocator-perspective"]], "Archery": [[3, "archery"], [3, "id4"]],
"Arrow Flight RPC": [[6, null]], "Arrow Flight SQL": [[7, null]], "Arrow Flight
SQL JDBC Driver": [[8, null]], "Arrow JDBC Adapter": [[12, null]], "Arrow Java
Modules": [[14, "id1"]], "Arrow Memo [...]
\ No newline at end of file
+Search.setIndex({"alltitles": {"Adding Services": [[6, "adding-services"]],
"Adding and removing vectors": [[18, "adding-and-removing-vectors"]],
"Allocation Details": [[13, "allocation-details"]], "Allocator Perspective":
[[13, "allocator-perspective"]], "Archery": [[3, "archery"], [3, "id4"]],
"Arrow Flight RPC": [[6, null]], "Arrow Flight SQL": [[7, null]], "Arrow Flight
SQL JDBC Driver": [[8, null]], "Arrow JDBC Adapter": [[12, null]], "Arrow Java
Modules": [[14, "id1"]], "Arrow Memo [...]
\ No newline at end of file
