001    /** 
002     * 
003     * Copyright 2004 Protique Ltd
004     * 
005     * Licensed under the Apache License, Version 2.0 (the "License"); 
006     * you may not use this file except in compliance with the License. 
007     * You may obtain a copy of the License at 
008     * 
009     * http://www.apache.org/licenses/LICENSE-2.0
010     * 
011     * Unless required by applicable law or agreed to in writing, software
012     * distributed under the License is distributed on an "AS IS" BASIS, 
013     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
014     * See the License for the specific language governing permissions and 
015     * limitations under the License. 
016     * 
017     **/
018    package org.activemq.transport;
019    
020    import org.activemq.io.WireFormat;
021    import org.activemq.util.FactoryFinder;
022    
023    import javax.jms.JMSException;
024    import java.io.IOException;
025    import java.net.URI;
026    
027    /**
028     * A TransportChannel is used for tranporting packets between nodes
029     *
030     * @version $Revision: 1.1.1.1 $
031     */
032    public class TransportChannelProvider {
033        private static FactoryFinder finder = new FactoryFinder("META-INF/services/org/activemq/transport/");
034    
035        /**
036         * Create a Channel to a remote Node - e.g. a Broker
037         *
038         * @param remoteLocation
039         * @return the TransportChannel bound to the remote node
040         * @throws JMSException
041         */
042        public static TransportChannel create(WireFormat wireFormat, URI remoteLocation) throws JMSException {
043            return getFactory(remoteLocation).create(wireFormat, remoteLocation);
044        }
045    
046        /**
047         * Create a Channel to a remote Node - e.g. a Broker
048         *
049         * @param remoteLocation
050         * @param localLocation  -
051         *                       e.g. local InetAddress and local port
052         * @return the TransportChannel bound to the remote node
053         * @throws JMSException
054         */
055        public static TransportChannel create(WireFormat wireFormat, URI remoteLocation, URI localLocation) throws JMSException {
056            return getFactory(remoteLocation).create(wireFormat, remoteLocation, localLocation);
057        }
058    
059        public static TransportChannelFactory getFactory(URI remoteLocation) throws JMSException {
060            String protocol = remoteLocation.getScheme();
061            try {
062                Object value = finder.newInstance(protocol);
063                if (value instanceof TransportChannelFactory) {
064                    return (TransportChannelFactory) value;
065                }
066                else {
067                    throw new JMSException("Factory does not implement TransportChannelFactory: " + value);
068                }
069            }
070            catch (IllegalAccessException e) {
071                throw createJMSexception(protocol, e);
072            }
073            catch (InstantiationException e) {
074                throw createJMSexception(protocol, e);
075            }
076            catch (IOException e) {
077                throw createJMSexception(protocol, e);
078            }
079            catch (ClassNotFoundException e) {
080                throw createJMSexception(protocol, e);
081            }
082    
083        }
084    
085        protected static JMSException createJMSexception(String protocol, Exception e) {
086            JMSException answer = new JMSException("Could not load protocol: " + protocol + ". Reason: " + e);
087            answer.setLinkedException(e);
088            return answer;
089        }
090    }