|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface SocketFactory
A factory for creating, initializing and connecting sockets. The factory encapsulates the logic for establishing a socket connection.
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 socketjava.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 |