InboundApiHandler.java

/*
*  Copyright (c) 2021, WSO2 Inc. (http://www.wso2.org) All Rights Reserved.
*
*  WSO2 Inc. 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.api.inbound;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.apache.synapse.MessageContext;
import org.apache.synapse.api.API;
import org.apache.synapse.api.AbstractApiHandler;
import org.apache.synapse.api.ApiConstants;
import org.apache.synapse.core.axis2.Axis2MessageContext;

import java.util.Arrays;
import java.util.Collection;

/**
 * This class is responsible for receiving requests from inbound endpoints and dispatching
 * them to a suitable inbound API for further processing.
 */
public class InboundApiHandler extends AbstractApiHandler {

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

    /**
     * Attempt to process the given message through one of the available inbound APIs. This method
     * will first try to locate a suitable API for the given message by running it through
     * the API validation routines available. If a matching API is found it will dispatch
     * the message to the located API. If a matching API cannot be found, message will be
     * left intact so any other handlers (eg: main sequence) can pick it up later.
     *
     * @param synCtx MessageContext of the request to be processed
     * @return true if the message was dispatched to an API and false otherwise
     */
    public boolean process(MessageContext synCtx) {
        if (synCtx.isResponse()) {
            return dispatchToAPI(synCtx);
        }
        org.apache.axis2.context.MessageContext msgCtx = ((Axis2MessageContext) synCtx).
                getAxis2MessageContext();
        String protocol = msgCtx.getIncomingTransportName();
        if (!Arrays.asList(ApiConstants.WS_PROTOCOL, ApiConstants.WSS_PROTOCOL,
                ApiConstants.HTTP_PROTOCOL, ApiConstants.HTTPS_PROTOCOL).contains(protocol)) {
            if (log.isDebugEnabled()) {
                log.debug("Invalid protocol for Inbound API mediation: " + protocol);
            }
            return false;
        }
        return dispatchToAPI(synCtx);
    }

    @Override
    protected boolean dispatchToAPI(MessageContext synCtx) {
        Object apiCaller = synCtx.getProperty(ApiConstants.API_CALLER);
        if (apiCaller != null) {
            Collection<API> apis = synCtx.getEnvironment().getSynapseConfiguration().getAPIs(apiCaller.toString());
            if (!apis.isEmpty()) {
                return dispatchToAPI(apis, synCtx);
            }
        }
        return false;
    }
}