[HTTPCORE-14] Consider decoupling HttpHost and Scheme and moving Scheme, SocketFactory and SecureSocketFactory to HttpConn

Changelog:
----------
* Moved Scheme, SocketFactory, SecureSocketFactory and related classes to HttpConn 


git-svn-id: https://svn.apache.org/repos/asf/jakarta/httpcomponents/httpclient/trunk@451410 13f79535-47bb-0310-9956-ffa450edef68

src/java/org/apache/http/conn/PlainSocketFactory.java

@@ -0,0 +1,126 @@
+/*
+ * $HeadURL$
+ * $Revision$
+ * $Date$
+ *
+ * ====================================================================
+ *
+ *  Copyright 2002-2004 The Apache Software Foundation
+ *
+ *  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.
+ * ====================================================================
+ *
+ * This software consists of voluntary contributions made by many
+ * individuals on behalf of the Apache Software Foundation.  For more
+ * information on the Apache Software Foundation, please see
+ * <http://www.apache.org/>.
+ *
+ */
+
+package org.apache.http.impl.io;
+
+import java.io.IOException;
+import java.net.InetAddress;
+import java.net.Socket;
+import java.net.UnknownHostException;
+
+import org.apache.http.io.SocketFactory;
+import org.apache.http.params.HttpConnectionParams;
+import org.apache.http.params.HttpParams;
+
+/**
+ * The default class for creating protocol sockets.  This class just uses the
+ * {@link java.net.Socket socket} constructors.
+ * 
+ * @author Michael Becke
+ * 
+ * @since 2.0
+ */
+public class PlainSocketFactory implements SocketFactory {
+
+    /**
+     * The factory singleton.
+     */
+    private static final PlainSocketFactory DEFAULT_FACTORY = new PlainSocketFactory();
+    
+    /**
+     * Gets an singleton instance of the DefaultProtocolSocketFactory.
+     * @return a DefaultProtocolSocketFactory
+     */
+    public static PlainSocketFactory getSocketFactory() {
+        return DEFAULT_FACTORY;
+    }
+    
+    /**
+     * Constructor for DefaultProtocolSocketFactory.
+     */
+    private PlainSocketFactory() {
+        super();
+    }
+
+    /**
+     * Attempts to get a new socket connection to using old (pre Java 1.4) IO mode.
+     * This socket factory does not support connect timeout as it requires Java 1.4
+     * functionality.
+     *  
+     * @param host the host name/IP
+     * @param port the port on the host
+     * @param localAddress the local host name/IP to bind the socket to
+     * @param localPort the port on the local machine
+     * @param params {@link HttpConnectionParams Http connection parameters}
+     * 
+     * @return Socket a new socket
+     * 
+     * @throws IOException if an I/O error occurs while creating the socket
+     * @throws UnknownHostException if the IP address of the host cannot be
+     * @throws IllegalStateException if connection timeout is set
+     * determined
+     * 
+     * @since 3.0
+     */
+    public Socket createSocket(
+        final String host,
+        final int port,
+        final InetAddress localAddress,
+        final int localPort,
+        final HttpParams params
+    ) throws IOException, UnknownHostException {
+        if (params == null) {
+            throw new IllegalArgumentException("Parameters may not be null");
+        }
+        int timeout = HttpConnectionParams.getConnectionTimeout(params);
+        if (timeout != 0) {
+            throw new IllegalStateException("Connection timeout is not supported in old IO mode");
+        }
+        if (localAddress != null) {
+            return new Socket(host, port, localAddress, localPort);
+        } else {
+            return new Socket(host, port);
+        }
+    }
+
+    /**
+     * All instances of DefaultProtocolSocketFactory are the same.
+     */
+    public boolean equals(Object obj) {
+        return ((obj != null) && obj.getClass().equals(PlainSocketFactory.class));
+    }
+
+    /**
+     * All instances of DefaultProtocolSocketFactory have the same hash code.
+     */
+    public int hashCode() {
+        return PlainSocketFactory.class.hashCode();
+    }
+
+}