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.http;
19:
20: import java.io.IOException;
21: import java.net.HttpURLConnection;
22: import java.net.Proxy;
23: import java.net.URL;
24:
25: /**
26: * The primary purpose for this interface is to generate HttpURLConnections
27: * and retrieve information about the connections. This interface is also
28: * meant to be used as a lower denominator for HttpURLConnections and
29: * HttpsURLConnections.
30: */
31: public interface HttpURLConnectionFactory {
32:
33: /**
34: * Create an HttpURLConnection, proxified if neccessary.
35: *
36: * @param proxy The proxy. May be null if connection is not to be proxied.
37: * @param url The target URL
38: * @return An appropriate URLConnection
39: */
40: HttpURLConnection createConnection(Proxy proxy, URL url)
41: throws IOException;
42:
43: /**
44: * This method returns Connection Info objects for the particular
45: * connection. The connection must be connected.
46: * @param con The connection that is the subject of the information object.
47: * @return The HttpURLConnection Info for the given connection.
48: * @throws IOException
49: */
50: HttpURLConnectionInfo getConnectionInfo(
51: HttpURLConnection connnection) throws IOException;
52: }
|