AsyncCallback.java

/*
 *  Licensed to the Apache Software Foundation (ASF) under one
 *  or more contributor license agreements.  See the NOTICE file
 *  distributed with this work for additional information
 *  regarding copyright ownership.  The ASF licenses this file
 *  to you 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.apache.synapse.core.axis2;

import org.apache.axis2.client.async.AxisCallback;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.apache.synapse.FaultHandler;
import org.apache.synapse.MessageContext;
import org.apache.synapse.SynapseConstants;
import org.apache.synapse.SynapseException;

/**
 * This class only "holds" the Synapse out message context for the Synapse callback message
 * receiver when a response is received or error is encountered
 */
public class AsyncCallback implements AxisCallback {

    private static final Log log = LogFactory.getLog(AsyncCallback.class);

    /** The corresponding Synapse outgoing message context this instance is holding onto */
    private final MessageContext synapseOutMsgCtx;

    /** The corresponding Axis2 outgoing message context this instance is holding onto */
    private org.apache.axis2.context.MessageContext axis2OutMsgCtx;

    /** Time to timeout this callback */
    private long timeOutOn;
    /** Action to perform when timeout occurs */
    private int timeOutAction = SynapseConstants.NONE;

    private long timeoutDuration;

    /** Whether callback is marked for removal from the store */
    private boolean markedForRemoval = false;

    private SynapseConstants.ENDPOINT_TIMEOUT_TYPE timeoutType;

    public AsyncCallback( org.apache.axis2.context.MessageContext messageContext,MessageContext synapseOutMsgCtx) {
        this.synapseOutMsgCtx = synapseOutMsgCtx;
        this.axis2OutMsgCtx = messageContext;
    }

    public void onMessage(org.apache.axis2.context.MessageContext messageContext) {}

    public void onFault(org.apache.axis2.context.MessageContext messageContext) {}

    public void onError(Exception e) {
        axis2OutMsgCtx.setFailureReason(e);
        log.error(e.getMessage(), e);

        if (!synapseOutMsgCtx.getFaultStack().isEmpty()) {
            if (log.isWarnEnabled()) {
                log.warn("Executing fault handler due to exception encountered");
            }

            ((FaultHandler) synapseOutMsgCtx.getFaultStack().pop()).handleFault(synapseOutMsgCtx, new SynapseException(e.getMessage(), e));

        } else {
            if (log.isWarnEnabled()) {
                log.warn("Exception encountered but no fault handler found - " +
                        "message dropped");
            }
        }
    }

    public void onComplete() {}

    public org.apache.synapse.MessageContext getSynapseOutMsgCtx() {
        return synapseOutMsgCtx;
    }

    public org.apache.axis2.context.MessageContext getAxis2OutMsgCtx() {
        return axis2OutMsgCtx;
    }

    public long getTimeOutOn() {
        return timeOutOn;
    }

    public long getTimeoutDuration() {
        return timeoutDuration;
    }

    public void setTimeout(long timeoutDuration) {
        this.timeoutDuration = timeoutDuration;
        this.timeOutOn = System.currentTimeMillis() + timeoutDuration;
    }

    public int getTimeOutAction() {
        return timeOutAction;
    }

    public void setTimeOutAction(int timeOutAction) {
        this.timeOutAction = timeOutAction;
    }

    public SynapseConstants.ENDPOINT_TIMEOUT_TYPE getTimeoutType() {
        return timeoutType;
    }

    public void setTimeoutType(SynapseConstants.ENDPOINT_TIMEOUT_TYPE timeoutType) {
        this.timeoutType = timeoutType;
    }

    /**
     * Check whether callback is marked for removal from the callback store
     *
     * @return whether callback is marked for removal from the callback store
     */
    public boolean isMarkedForRemoval() {
        return markedForRemoval;
    }

    /**
     * Mark callback to be removed from the callback store
     */
    public void setMarkedForRemoval() {
        this.markedForRemoval = true;
    }
}