org.jboss.ejb.client.EJBReceiverInvocationContext Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of jboss-ejb-client Show documentation
Client library for EJB applications working against Wildfly - Jakarta EE Variant
There is a newer version: 5.0.8.Final
/*
 * JBoss, Home of Professional Open Source.
 * Copyright 2017 Red Hat, Inc., and individual contributors
 * as indicated by the @author tags.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package org.jboss.ejb.client;

import java.util.Arrays;
import java.util.concurrent.Executor;
import java.util.function.Supplier;

import org.wildfly.common.Assert;
import org.wildfly.discovery.Discovery;
import org.wildfly.security.auth.client.AuthenticationContext;

/**
 * The context used for an EJB receiver to return the result of an invocation.
 *
 * @author David M. Lloyd
 */
public final class EJBReceiverInvocationContext extends AbstractReceiverInvocationContext {

    private final EJBClientInvocationContext clientInvocationContext;

    EJBReceiverInvocationContext(final EJBClientInvocationContext clientInvocationContext) {
        this.clientInvocationContext = clientInvocationContext;
    }

    /**
     * Indicate that the invocation should proceed asynchronously, if it isn't already.
     */
    public void proceedAsynchronously() {
        clientInvocationContext.proceedAsynchronously();
    }

    /**
     * Indicate that the invocation result is ready.  The given producer should either return the final
     * invocation result or throw an appropriate exception.  Any unmarshalling is expected to be deferred until
     * the result producer is called, in order to offload the work on the invoking thread even in the presence of
     * asynchronous invocation.
     *
     * @param resultProducer the result producer
     */
    public void resultReady(ResultProducer resultProducer) {
        clientInvocationContext.resultReady(resultProducer);
    }

    /**
     * Indicate that the request was successfully cancelled and that no result is forthcoming.
     */
    public void requestCancelled() {
        clientInvocationContext.cancelled();
    }

    /**
     * Indicate that a request failed locally with the given exception cause.  Retries are called in the
     * current thread before this method returns.
     *
     * @param cause the failure cause (must not be {@code null})
     */
    public void requestFailed(Exception cause) {
        requestFailed(cause, Runnable::run);
    }

    /**
     * Indicate that a request failed locally with the given exception cause.
     *
     * @param cause the failure cause (must not be {@code null})
     * @param retryExecutor the executor to use for retry attempts (must not be {@code null})
     */
    public void requestFailed(Exception cause, Executor retryExecutor) {
        Assert.checkNotNullParam("cause", cause);
        Assert.checkNotNullParam("retryExecutor", retryExecutor);
        clientInvocationContext.failed(cause, retryExecutor);
    }

    /*
     * Provide access to key invocation context information
     */
    public EJBClientInvocationContext getClientInvocationContext() {
        return clientInvocationContext;
    }

    public EJBClientContext getClientContext() {
        return clientInvocationContext.getClientContext();
    }

    public Discovery getDiscovery() {
        return clientInvocationContext.getDiscovery();
    }

    public AuthenticationContext getAuthenticationContext() {
        return clientInvocationContext.getAuthenticationContext();
    }
    
    @Override
    public String toString() {
        StringBuffer toString = new StringBuffer(EJBReceiverInvocationContext.class.getName() + "@" + System.identityHashCode(this));
        if(this.getClientInvocationContext() != null) {
            toString.append(" - ").append(this.getClientInvocationContext().getLocator().toString())
                .append(", method: ").append(this.getClientInvocationContext().getInvokedMethod().getName());
        }
        return toString.toString();
    }

    /**
     * A result producer for invocation.
     */
    public interface ResultProducer {

        /**
         * A result producer which produces a {@code null} return.
         */
        ResultProducer NULL = new Immediate(null);

        /**
         * Get the result.
         *
         * @return the result
         * @throws Exception if the result could not be acquired or the operation failed
         */
        Object getResult() throws Exception;

        /**
         * Discard the result, indicating that it will not be used.
         */
        void discardResult();

        /**
         * A result producer for failure cases.
         */
        class Failed implements ResultProducer {
            private final Supplier cause;

            /**
             * Construct a new instance.
             *
             * @param cause the failure cause
             */
            public Failed(final Exception cause) {
                this(() -> {
                    final StackTraceElement[] stackTrace = new Throwable().getStackTrace();
                    cause.setStackTrace(Arrays.copyOfRange(stackTrace, 2, stackTrace.length));
                    return cause;
                });
                Assert.checkNotNullParam("cause", cause);
            }

            /**
             * Construct a new instance.
             *
             * @param cause a supplier which yields the failure cause
             */
            public Failed(final Supplier cause) {
                Assert.checkNotNullParam("cause", cause);
                this.cause = cause;
            }

            public Object getResult() throws Exception {
                throw cause.get();
            }

            /**
             * Get the exception supplier.
             *
             * @return the exception supplier (not {@code null})
             */
            public Supplier getExceptionSupplier() {
                return cause;
            }

            public void discardResult() {
            }
        }

        class Immediate implements ResultProducer {
            private final Object result;

            public Immediate(final Object result) {
                this.result = result;
            }

            public Object getResult() throws Exception {
                return result;
            }

            public void discardResult() {
            }
        }
    }

}