Queue changes for non-Java clients using JSON

(merge main -> ce/main 107674)

[git-p4: depot-paths = "//dev/coherence-ce/main/": change = 107675]

Author: thegridman

prj/coherence-core/src/main/java/com/tangosol/internal/net/queue/model/QueuePollResult.java

@@ -9,32 +9,41 @@
 
 import com.tangosol.io.AbstractEvolvable;
 import com.tangosol.io.ExternalizableLite;
-import com.tangosol.io.SerializationSupport;
 import com.tangosol.io.Serializer;
 import com.tangosol.io.SerializerAware;
 import com.tangosol.io.pof.EvolvablePortableObject;
 import com.tangosol.io.pof.PofReader;
 import com.tangosol.io.pof.PofWriter;
 import com.tangosol.util.Binary;
 import com.tangosol.util.ExternalizableHelper;
-import jakarta.json.bind.annotation.JsonbCreator;
-import jakarta.json.bind.annotation.JsonbNillable;
 import jakarta.json.bind.annotation.JsonbProperty;
 import jakarta.json.bind.annotation.JsonbTransient;
 
 import java.io.DataInput;
 import java.io.DataOutput;
 import java.io.IOException;
-import java.io.ObjectStreamException;
 
+/**
+ * The result of invoking a {@link com.tangosol.internal.net.queue.processor.QueuePoll}.
+ */
 public class QueuePollResult
         extends AbstractEvolvable
         implements ExternalizableLite, EvolvablePortableObject, SerializerAware
     {
+    /**
+     * Default constructor for serialization.
+     */
     public QueuePollResult()
         {
         }
 
+    /**
+     * Create a {@link QueuePollResult}.
+     *
+     * @param id          the id of the polled element
+     * @param binElement  the serialized {@link Binary} value polled from the queue
+     *                    or {@code null} if the queue was empty
+     */
     public QueuePollResult(long id, Binary binElement)
         {
         m_id         = id;
@@ -52,26 +61,40 @@ public long getId()
         }
 
     /**
-     * Return the serialized binary value of the polled element.
+     * Return the serialized binary value of the polled element,
+     * or {@code null} if the queue was empty.
      *
-     * @return the serialized binary value of the polled element
+     * @return the serialized binary value of the polled element,
+     *         or {@code null} if the queue was empty
      */
     public Binary getBinaryElement()
         {
         return m_binElement;
         }
 
     /**
-     * Return the deserialized object form of the polled element.
+     * Return the deserialized object form of the polled element,
+     * or {@code null} if the queue was empty.
      *
-     * @return the deserialized object form of the polled element
+     * @return the deserialized object form of the polled element,
+     *         or {@code null} if the queue was empty.
      */
     @SuppressWarnings("unchecked")
     public <E> E getElement()
         {
         return (E) m_oElement;
         }
 
+    /**
+     * Return {@code true} if this result has a deserialized value.
+     *
+     * @return {@code true} if this result has a deserialized value
+     */
+    public boolean isPresent()
+        {
+        return m_fPresent;
+        }
+
     // ----- EvolvablePortableObject methods --------------------------------
 
     @Override
@@ -99,7 +122,7 @@ public void writeExternal(PofWriter out) throws IOException
     @Override
     public void readExternal(DataInput in) throws IOException
         {
-        m_id = in.readLong();
+        m_id         = in.readLong();
         m_binElement = ExternalizableHelper.readObject(in);
         }
 
@@ -125,11 +148,15 @@ public void setContextSerializer(Serializer serializer)
         if (m_binElement != null)
             {
             m_oElement = ExternalizableHelper.fromBinary(m_binElement, m_serializer);
+            m_fPresent = true;
             }
         }
 
     // ----- constants ------------------------------------------------------
 
+    /**
+     * The {@link EvolvablePortableObject} version of this class.
+     */
     public static final int IMPL_VERSION = 1;
 
     // ----- data members ---------------------------------------------------
@@ -151,15 +178,15 @@ public void setContextSerializer(Serializer serializer)
      */
     private transient Serializer m_serializer;
 
-    /**
-     * A flag to indicate the {@link #m_oElement} field was deserialized from the binary value.
-     */
-    private transient boolean m_fHasObjectValue;
-
     /**
      * The Object version of the element;
      */
     @JsonbProperty("element")
-    @JsonbNillable
     private transient Object m_oElement;
+
+    /**
+     * Indicates if a deserialized value is present in the {@link #m_oElement} field.
+     */
+    @JsonbProperty("present")
+    private transient boolean m_fPresent;
     }