|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
public interface SocketFactory
A factory for creating and connecting sockets.
The factory encapsulates the logic for establishing a socket connection.
Both Object.equals()
and Object.hashCode()
must be overridden for the correct operation of some connection managers.
| Method Summary | |
|---|---|
java.net.Socket |
connectSocket(java.net.Socket sock,
java.lang.String host,
int port,
java.net.InetAddress localAddress,
int localPort,
org.apache.http.params.HttpParams params)
Connects a socket to the given host. |
java.net.Socket |
createSocket()
Creates a new, unconnected socket. |
boolean |
isSecure(java.net.Socket sock)
Checks whether a socket provides a secure connection. |
| Method Detail |
|---|
java.net.Socket createSocket()
throws java.io.IOException
connectSocket.
java.io.IOException - if an I/O error occurs while creating the socket
java.net.Socket connectSocket(java.net.Socket sock,
java.lang.String host,
int port,
java.net.InetAddress localAddress,
int localPort,
org.apache.http.params.HttpParams params)
throws java.io.IOException,
java.net.UnknownHostException,
ConnectTimeoutException
sock - the socket to connect, as obtained from
createSocket.
null indicates that a new socket
should be created and connected.host - the host to connect toport - the port to connect to on the hostlocalAddress - the local address to bind the socket to, or
null for anylocalPort - the port on the local machine,
0 or a negative number for anyparams - additional parameters for connecting
sock argument if this factory supports
a layered protocol.
java.io.IOException - if an I/O error occurs
java.net.UnknownHostException - if the IP address of the target host
can not be determined
ConnectTimeoutException - if the socket cannot be connected
within the time limit defined in the params
boolean isSecure(java.net.Socket sock)
throws java.lang.IllegalArgumentException
connected
by this factory.
The factory will not perform I/O operations
in this method.
sock - the connected socket to check
true if the connection of the socket
should be considered secure, or
false if it should not
java.lang.IllegalArgumentException - if the argument is invalid, for example because it is
not a connected socket or was created by a different
socket factory.
Note that socket factories are not required to
check these conditions, they may simply return a default
value when called with an invalid socket argument.
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||