001    /**
002     * Licensed to the Apache Software Foundation (ASF) under one or more
003     * contributor license agreements.  See the NOTICE file distributed with
004     * this work for additional information regarding copyright ownership.
005     * The ASF licenses this file to You under the Apache License, Version 2.0
006     * (the "License"); you may not use this file except in compliance with
007     * the License.  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    package org.apache.camel.component.ref;
018    
019    import java.util.Map;
020    
021    import org.apache.camel.Endpoint;
022    import org.apache.camel.impl.DefaultComponent;
023    import org.apache.camel.util.CamelContextHelper;
024    
025    /**
026     * Component for lookup of existing endpoints bound in the {@link org.apache.camel.spi.Registry}.
027     * <p/>
028     * This component uses the <tt>ref:</tt> notation instead of the mostly common <tt>uri:</tt> notation. 
029     */
030    public class RefComponent extends DefaultComponent {
031    
032        protected Endpoint createEndpoint(String uri, String remaining, Map<String, Object> parameters) throws Exception {
033            // first remove the scheme from the URI
034            int index = uri.indexOf(':');
035            String name = uri;
036            if (index >= 0) {
037                name = uri.substring(index + 1);
038            }
039            if (name.startsWith("//")) {
040                name = name.substring(2);
041            }
042            return lookupEndpoint(name, parameters);
043        }
044    
045        /**
046         * Looks up a mandatory endpoint for a given name.
047         * <p/>
048         * Derived classes could use this name as a logical name and look it up on some registry.
049         * <p/>
050         * The default implementation will do a mandatory look up the name in the {@link org.apache.camel.spi.Registry}.
051         *
052         * @throws org.apache.camel.NoSuchBeanException if not found in the {@link org.apache.camel.spi.Registry}
053         */
054        protected Endpoint lookupEndpoint(String name, Map<String, Object> parameters) {
055            return CamelContextHelper.mandatoryLookup(getCamelContext(), name, Endpoint.class);
056        }
057    }