com.tangosol.coherence.jcache.common.CoherenceEntryProcessorResult Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of coherence-jcache Show documentation
Oracle Coherence Community Edition
There is a newer version: 24.09.2
/*
 * Copyright (c) 2000, 2021, Oracle and/or its affiliates.
 *
 * Licensed under the Universal Permissive License v 1.0 as shown at
 * http://oss.oracle.com/licenses/upl.
 */
package com.tangosol.coherence.jcache.common;

import com.tangosol.coherence.jcache.serialization.SerializationHelper;

import com.tangosol.io.ExternalizableLite;
import com.tangosol.io.pof.PofReader;
import com.tangosol.io.pof.PofWriter;
import com.tangosol.io.pof.PortableObject;

import com.tangosol.util.Binary;
import com.tangosol.util.ExternalizableHelper;

import java.io.DataInput;
import java.io.DataOutput;
import java.io.IOException;

import javax.cache.CacheException;

import javax.cache.processor.EntryProcessorException;
import javax.cache.processor.EntryProcessorResult;

import static com.tangosol.util.ExternalizableHelper.FMT_NULL;


/**
 * A Coherence-based {@link javax.cache.processor.EntryProcessorResult}.
 *
 * @param   the type of the returned m_oResult
 *
 * @author bo  2013.11.11
 * @since Coherence 12.1.3
 */
public class CoherenceEntryProcessorResult
        implements EntryProcessorResult, ExternalizableLite, PortableObject
    {
    // ----- constructors -----------------------------------------------------

    /**
     * Constructs a {@link CoherenceEntryProcessorResult}
     * (for serialization).
     */
    public CoherenceEntryProcessorResult()
        {
        // required for serialization
        }

    /**
     * Constructs a {@link CoherenceEntryProcessorResult} for an
     * {@link Exception}.
     *
     * @param exception  the {@link Exception}
     */
    public CoherenceEntryProcessorResult(Exception exception)
        {
        m_oResult   = null;
        m_exception = exception;
        }

    /**
     * Constructs an {@link CoherenceEntryProcessorResult} for a
     * specific value.
     *
     * @param oResult  the result
     */
    public CoherenceEntryProcessorResult(T oResult)
        {
        m_oResult   = oResult;
        m_exception = null;
        }

    // ----- EntryProcessorResult interface ---------------------------------

    @Override
    public T get()
            throws EntryProcessorException
        {
        if (m_exception == null)
            {
            return m_oResult;
            }
        else
            {
            Throwable throwable = Helper.unwrap(m_exception);

            if (throwable instanceof CacheException)
                {
                throw(CacheException) throwable;
                }
            else
                {
                throw new EntryProcessorException(throwable);
                }
            }
        }

    // ----- helpers -----------------------------------------------------------

    /**
     * Return true if inspection of {@link Binary} content identifies null.
     *
     * @param bin  binary object
     *
     * @return iff binary object resolves to null
     */
    private static boolean isNull(Binary bin)
        {
        return bin != null && bin.length() == 1 && bin.byteAt(0) == FMT_NULL;
        }

    // ----- ExternalizableLite interface -----------------------------------

    @Override
    public void readExternal(DataInput in)
            throws IOException
        {
        m_oResult = (T) ExternalizableHelper.readObject(in);

        Binary binEx = new Binary(in);

        // start version 2 format processing
        try
            {
            // when 2nd field is non-null, deserialize 3rd field as an object
            m_exception = isNull(binEx) ? null : ExternalizableHelper.readObject(in);
            }
        catch (IOException e)
            {
            // backwards compatibility mode with version 1 format of writeExternal(DataOutput)
            // generate a replacement exception when 3rd field is missing
            m_exception = new RuntimeException("EntryProcessor terminated abnormally");
            }
        }

    @Override
    public void writeExternal(DataOutput out)
            throws IOException
        {
        ExternalizableHelper.writeObject(out, m_oResult);
        ExternalizableHelper.toBinary(m_exception).writeExternal(out);

        // version 2 format: write optional 3rd field as an object
        if (m_exception != null)
            {
            ExternalizableHelper.writeObject(out, m_exception);
            }
        }

    // ----- PortableObject interface ---------------------------------------

    @Override
    public void readExternal(PofReader reader)
            throws IOException
        {
        m_oResult = (T) reader.readObject(0);

        boolean fUseJavaSerialization = reader.readBoolean(1);

        if (fUseJavaSerialization)
            {
            m_exception = SerializationHelper.fromByteArray(reader.readByteArray(2), Exception.class);
            }
        else
            {
            m_exception = (Exception) reader.readObject(2);
            }
        }

    @Override
    public void writeExternal(PofWriter writer)
            throws IOException
        {
        writer.writeObject(0, m_oResult);

        boolean fUseJavaSerialization = !(m_exception instanceof PortableObject
                                          || m_exception instanceof ExternalizableLite);

        writer.writeBoolean(1, fUseJavaSerialization);

        if (fUseJavaSerialization)
            {
            writer.writeByteArray(2, SerializationHelper.toByteArray(m_exception));
            }
        else
            {
            writer.writeObject(2, m_exception);
            }
        }

    // ------ data members --------------------------------------------------

    /**
     * The result of processing the entry.  This may be null.
     */
    private T m_oResult;

    /**
     * The {@link Exception} that occurred executing an {@link javax.cache.processor.EntryProcessor}.
     * When null no exception has occurred.
     */
    private Exception m_exception;
    }