com.zz.cluster4spring.support.invocation.DefaultEndpointSelectionPolicy.java Source code

Introduction

Here is the source code for com.zz.cluster4spring.support.invocation.DefaultEndpointSelectionPolicy.java

Source

/******************************************************************************
 * Copyright(c) 2005-2007 SoftAMIS (http://www.soft-amis.com)                 *
 * All Rights Reserved.                                                       *
 *                                                                            *
 * 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 com.zz.cluster4spring.support.invocation;

import static java.text.MessageFormat.format;

import java.util.List;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.springframework.remoting.RemoteAccessException;
import org.springframework.remoting.RemoteLookupFailureException;

import com.zz.cluster4spring.support.Endpoint;
import com.zz.cluster4spring.support.EndpointSelectionPolicy;
import com.zz.cluster4spring.support.ServiceMoniker;

/**
 * Policy that performs selection of endpoint for invocation from the given list
 * of available endpoints. This implementation simply selects the first element
 * from the given list.
 *
 * @author Andrew Sazonov
 * @version 1.0
 * @param <SI>
 *            type of data used to invoke remote service (such as remote service
 *            URL)
 * @param <E>
 *            type of endpoints that could be created by this factory
 * 
 *            ?
 */

public class DefaultEndpointSelectionPolicy<E extends Endpoint<SI>, SI extends ServiceMoniker>
        implements EndpointSelectionPolicy<E, SI> {
    protected static final Log fLog = LogFactory.getLog(DefaultEndpointSelectionPolicy.class);

    public DefaultEndpointSelectionPolicy() {
    }

    /**
     * Selects endpoint for invocation from the given list of endpoints. Simply
     * selects the first element from the list.
     *
     * @param aEndpoints
     *            list of endpoints available for invocation of remote service
     * @return selected endpoints
     * @throws org.springframework.remoting.RemoteAccessException
     *             throw if some error occured during seleting endpoint for
     *             invocation
     */
    public E selectServiceEndpoint(List<E> aEndpoints) throws RemoteAccessException {
        if (aEndpoints == null) {
            String message = "Unable to obtain service endpoint - list of endpoints is null";
            if (fLog.isErrorEnabled()) {
                fLog.error(message);
            }
            throw new RemoteAccessException(message);
        }
        E result = null;
        try {
            // we simply always return first item from the list
            result = aEndpoints.iterator().next();
            if (fLog.isTraceEnabled()) {
                SI serviceInfo = result.getServiceInfo();
                String message = format("EndPoint selected. Service URL: [{0}]", serviceInfo);
                fLog.trace(message);
            }
        } catch (Exception e) {
            throw new RemoteLookupFailureException("Unable to obtain service endpoint", e);
        }
        return result;
    }
}