ARROW-17865: [Java] Deprecate Java Plasma JNI bindings (#14262)

Deprecate Java Plasma JNI bindings based on https://lists.apache.org/thread/nw232k2lzmg9kcl8ts475m9ybl34j81p Authored-by: david dali susanibar arce <davi.sarces@gmail.com> Signed-off-by: David Li <li.davidm96@gmail.com>
apache · Sep 28, 2022 · b672e5c · b672e5c
1 parent 9af43f1
commit b672e5c
Show file tree

Hide file tree

Showing 9 changed files with 26 additions and 1 deletion.
diff --git a/java/plasma/README.md b/java/plasma/README.md
@@ -19,6 +19,8 @@
 
 # Java Plasma Client
 
+This is deprecated since 10.0.0. This will be removed from 12.0.0 or so.
+
 ## Setup Build Environment
 
 Install:

diff --git a/java/plasma/pom.xml b/java/plasma/pom.xml
@@ -18,7 +18,8 @@
     </parent>
     <artifactId>arrow-plasma</artifactId>
     <name>Arrow Plasma Client</name>
-    <description>(Experimental/Contrib) Java client for the Plasma object store.</description>
+    <description>(DEPRECATED) Java client for the Plasma object store.
+        This is deprecated since 10.0.0. This will be removed from 12.0.0 or so.</description>
     <build>
         <plugins>
             <plugin>

diff --git a/java/plasma/src/main/java/org/apache/arrow/plasma/ObjectStoreLink.java b/java/plasma/src/main/java/org/apache/arrow/plasma/ObjectStoreLink.java
@@ -24,7 +24,10 @@
 
 /**
  * Object store interface, which provides the capabilities to put and get raw byte array, and serves.
+ *
+ * @deprecated Plasma is deprecated since 10.0.0. Plasma will not be released from Apache Arrow 12.0.0 or so.
  */
+@Deprecated
 public interface ObjectStoreLink {
 
   /**

diff --git a/java/plasma/src/main/java/org/apache/arrow/plasma/PlasmaClient.java b/java/plasma/src/main/java/org/apache/arrow/plasma/PlasmaClient.java
@@ -30,7 +30,10 @@
  *
  * <p>The PlasmaClient can ask the PlasmaStore to allocate a new buffer, seal a buffer, and get a
  * buffer. Buffers are referred to by object IDs.
+ *
+ * @deprecated Plasma is deprecated since 10.0.0. Plasma will not be released from Apache Arrow 12.0.0 or so.
  */
+@Deprecated
 public class PlasmaClient implements ObjectStoreLink {
 
   private final long conn;

diff --git a/java/plasma/src/main/java/org/apache/arrow/plasma/PlasmaClientJNI.java b/java/plasma/src/main/java/org/apache/arrow/plasma/PlasmaClientJNI.java
@@ -24,7 +24,10 @@
 
 /**
  * JNI static methods for PlasmaClient.
+ *
+ * @deprecated Plasma is deprecated since 10.0.0. Plasma will not be released from Apache Arrow 12.0.0 or so.
  */
+@Deprecated
 public class PlasmaClientJNI {
 
   public static native long connect(String storeSocketName, String managerSocketName, int releaseDelay);

diff --git a/java/plasma/src/main/java/org/apache/arrow/plasma/exceptions/DuplicateObjectException.java b/java/plasma/src/main/java/org/apache/arrow/plasma/exceptions/DuplicateObjectException.java
@@ -19,7 +19,10 @@
 
 /**
  * Thrown when attempting to place an object into the store for an ID that already exists.
+ *
+ * @deprecated Plasma is deprecated since 10.0.0. Plasma will not be released from Apache Arrow 12.0.0 or so.
  */
+@Deprecated
 public class DuplicateObjectException extends RuntimeException {
 
   public DuplicateObjectException(String objectId) {

diff --git a/java/plasma/src/main/java/org/apache/arrow/plasma/exceptions/PlasmaClientException.java b/java/plasma/src/main/java/org/apache/arrow/plasma/exceptions/PlasmaClientException.java
@@ -19,7 +19,10 @@
 
 /**
  * Generic exception thrown by the plasma client (for example on failure to connect).
+ *
+ * @deprecated Plasma is deprecated since 10.0.0. Plasma will not be released from Apache Arrow 12.0.0 or so.
  */
+@Deprecated
 public class PlasmaClientException extends RuntimeException {
 
   public PlasmaClientException(String message) {

diff --git a/java/plasma/src/main/java/org/apache/arrow/plasma/exceptions/PlasmaOutOfMemoryException.java b/java/plasma/src/main/java/org/apache/arrow/plasma/exceptions/PlasmaOutOfMemoryException.java
@@ -19,7 +19,10 @@
 
 /**
  * Indicates no more memory is available in Plasma.
+ *
+ * @deprecated Plasma is deprecated since 10.0.0. Plasma will not be released from Apache Arrow 12.0.0 or so.
  */
+@Deprecated
 public class PlasmaOutOfMemoryException extends RuntimeException {
 
   public PlasmaOutOfMemoryException(String message) {

diff --git a/java/plasma/src/test/java/org/apache/arrow/plasma/PlasmaClientTest.java b/java/plasma/src/test/java/org/apache/arrow/plasma/PlasmaClientTest.java
@@ -29,6 +29,10 @@
 import org.apache.arrow.plasma.exceptions.PlasmaOutOfMemoryException;
 import org.junit.Assert;
 
+/*
+ * @Deprecated Plasma is deprecated since 10.0.0. Plasma will not be released from Apache Arrow 12.0.0 or so.
+ */
+@Deprecated
 public class PlasmaClientTest {
 
   private String storeSuffix = "/tmp/store";