01: /**
02: * Licensed to the Apache Software Foundation (ASF) under one
03: * or more contributor license agreements. See the NOTICE file
04: * distributed with this work for additional information
05: * regarding copyright ownership. The ASF licenses this file
06: * to you under the Apache License, Version 2.0 (the
07: * "License"); you may not use this file except in compliance
08: * with the License. You may obtain a copy of the License at
09: *
10: * http://www.apache.org/licenses/LICENSE-2.0
11: *
12: * Unless required by applicable law or agreed to in writing,
13: * software distributed under the License is distributed on an
14: * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15: * KIND, either express or implied. See the License for the
16: * specific language governing permissions and limitations
17: * under the License.
18: */package org.apache.cxf.transport;
19:
20: import org.apache.cxf.BusException;
21:
22: /**
23: * The ConduitInitiatorManager provides an interface to register and retrieve
24: * transport factories.
25: */
26: public interface ConduitInitiatorManager {
27:
28: /**
29: * Associates a name, often a URI, with a <code>ConduitInitiator</code>
30: * when registering with the <code>Bus</code>'s <code>TransportRegistry</code>.
31: * @param name A string containing the name used to identify the
32: * <code>ConduitInitiator</code>
33: * @param factory The <code>ConduitInitiator</code> to be registered.
34: */
35: void registerConduitInitiator(String name, ConduitInitiator factory);
36:
37: /**
38: * Unregister a <code>ConduitInitiator</code>.
39: * @param name A string containing the name of the
40: * <code>ConduitInitiator</code>.
41: */
42: void deregisterConduitInitiator(String name);
43:
44: /**
45: * Returns the <code>ConduitInitiator</code> registered with the specified name,
46: * loading the appropriate plugin if necessary.
47: *
48: * @param name
49: * @return the registered <code>ConduitInitiator</code>
50: * @throws BusException
51: */
52: ConduitInitiator getConduitInitiator(String name)
53: throws BusException;
54:
55: ConduitInitiator getConduitInitiatorForUri(String uri);
56: }
|