com.feilong.lib.net.DefaultSocketFactory Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of feilong Show documentation
Show all versions of feilong Show documentation
feilong is a suite of core and expanded libraries that include utility classes, http, excel,cvs, io classes, and much much more.
/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You 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.
*/
package com.feilong.lib.net;
import java.io.IOException;
import java.net.InetAddress;
import java.net.InetSocketAddress;
import java.net.Proxy;
import java.net.ServerSocket;
import java.net.Socket;
import java.net.UnknownHostException;
import javax.net.SocketFactory;
/***
* DefaultSocketFactory implements the SocketFactory interface by
* simply wrapping the java.net.Socket and java.net.ServerSocket
* constructors. It is the default SocketFactory used by
* {@link com.feilong.lib.net.SocketClient}
* implementations.
*
*
* @see SocketFactory
* @see SocketClient
* @see SocketClient#setSocketFactory
***/
public class DefaultSocketFactory extends SocketFactory{
/** The proxy to use when creating new sockets. */
private final Proxy connProxy;
/**
* A constructor for sockets with proxy support.
*
* @param proxy
* The Proxy to use when creating new Sockets.
* @since 3.2
*/
public DefaultSocketFactory(Proxy proxy){
connProxy = proxy;
}
/**
* Creates an unconnected Socket.
*
* @return A new unconnected Socket.
* @throws IOException
* If an I/O error occurs while creating the Socket.
* @since 3.2
*/
@Override
public Socket createSocket() throws IOException{
if (connProxy != null){
return new Socket(connProxy);
}
return new Socket();
}
/***
* Creates a Socket connected to the given host and port.
*
* @param host
* The hostname to connect to.
* @param port
* The port to connect to.
* @return A Socket connected to the given host and port.
* @throws UnknownHostException
* If the hostname cannot be resolved.
* @throws IOException
* If an I/O error occurs while creating the Socket.
***/
@Override
public Socket createSocket(String host,int port) throws UnknownHostException,IOException{
if (connProxy != null){
Socket s = new Socket(connProxy);
s.connect(new InetSocketAddress(host, port));
return s;
}
return new Socket(host, port);
}
/***
* Creates a Socket connected to the given host and port.
*
* @param address
* The address of the host to connect to.
* @param port
* The port to connect to.
* @return A Socket connected to the given host and port.
* @throws IOException
* If an I/O error occurs while creating the Socket.
***/
@Override
public Socket createSocket(InetAddress address,int port) throws IOException{
if (connProxy != null){
Socket s = new Socket(connProxy);
s.connect(new InetSocketAddress(address, port));
return s;
}
return new Socket(address, port);
}
/***
* Creates a Socket connected to the given host and port and
* originating from the specified local address and port.
*
* @param host
* The hostname to connect to.
* @param port
* The port to connect to.
* @param localAddr
* The local address to use.
* @param localPort
* The local port to use.
* @return A Socket connected to the given host and port.
* @throws UnknownHostException
* If the hostname cannot be resolved.
* @throws IOException
* If an I/O error occurs while creating the Socket.
***/
@Override
public Socket createSocket(String host,int port,InetAddress localAddr,int localPort) throws UnknownHostException,IOException{
if (connProxy != null){
Socket s = new Socket(connProxy);
s.bind(new InetSocketAddress(localAddr, localPort));
s.connect(new InetSocketAddress(host, port));
return s;
}
return new Socket(host, port, localAddr, localPort);
}
/***
* Creates a Socket connected to the given host and port and
* originating from the specified local address and port.
*
* @param address
* The address of the host to connect to.
* @param port
* The port to connect to.
* @param localAddr
* The local address to use.
* @param localPort
* The local port to use.
* @return A Socket connected to the given host and port.
* @throws IOException
* If an I/O error occurs while creating the Socket.
***/
@Override
public Socket createSocket(InetAddress address,int port,InetAddress localAddr,int localPort) throws IOException{
if (connProxy != null){
Socket s = new Socket(connProxy);
s.bind(new InetSocketAddress(localAddr, localPort));
s.connect(new InetSocketAddress(address, port));
return s;
}
return new Socket(address, port, localAddr, localPort);
}
/***
* Creates a ServerSocket bound to a specified port. A port
* of 0 will create the ServerSocket on a system-determined free port.
*
* @param port
* The port on which to listen, or 0 to use any free port.
* @return A ServerSocket that will listen on a specified port.
* @throws IOException
* If an I/O error occurs while creating
* the ServerSocket.
***/
public ServerSocket createServerSocket(int port) throws IOException{
return new ServerSocket(port);
}
/***
* Creates a ServerSocket bound to a specified port with a given
* maximum queue length for incoming connections. A port of 0 will
* create the ServerSocket on a system-determined free port.
*
* @param port
* The port on which to listen, or 0 to use any free port.
* @param backlog
* The maximum length of the queue for incoming connections.
* @return A ServerSocket that will listen on a specified port.
* @throws IOException
* If an I/O error occurs while creating
* the ServerSocket.
***/
public ServerSocket createServerSocket(int port,int backlog) throws IOException{
return new ServerSocket(port, backlog);
}
/***
* Creates a ServerSocket bound to a specified port on a given local
* address with a given maximum queue length for incoming connections.
* A port of 0 will
* create the ServerSocket on a system-determined free port.
*
* @param port
* The port on which to listen, or 0 to use any free port.
* @param backlog
* The maximum length of the queue for incoming connections.
* @param bindAddr
* The local address to which the ServerSocket should bind.
* @return A ServerSocket that will listen on a specified port.
* @throws IOException
* If an I/O error occurs while creating
* the ServerSocket.
***/
public ServerSocket createServerSocket(int port,int backlog,InetAddress bindAddr) throws IOException{
return new ServerSocket(port, backlog, bindAddr);
}
}