com.sun.jaw.impl.adaptor.https
Class AdaptorSocket

java.lang.Object
  |
  +--com.sun.jaw.impl.adaptor.comm.AdaptorSocket
        |
        +--com.sun.jaw.impl.adaptor.https.AdaptorSocket

public class AdaptorSocket
extends AdaptorSocket

The AdaptorSocket class provides a wrap-up of the socket to be used for an HTTP-based adaptor using SSL.

The list of SSL cipher suites can be specified through the use of system properties in the format:

jaw.ssl.cipher.suite.<n>=<cipher suite name>

If no cipher suites are specified by the user then the cipher suites enabled by default by the SSL implementation will be used instead.


Fields inherited from class com.sun.jaw.impl.adaptor.comm.AdaptorSocket
port
 
Constructor Summary
AdaptorSocket()
          Constructs an HTTP/SSL adaptor socket.
AdaptorSocket(int port)
           
 
Method Summary
 AdaptorSocket createClientSocket()
          Create a socket to be used on the client side.
 AdaptorSocket createServerSocket(int port)
          Create a socket to be used on the server side with the given port
 void doBind()
          Bind to receive requests (usually used on server side)
 void doConnect(java.lang.String serverName, int serverPort)
          Connect to send a request (usually used on client side)
 void doDisconnect()
          Can be used on both server and client sides.
 java.io.InputStream doGetInputStream()
          Return an inputstream for this socket.
 java.io.InputStream doReceive()
          Wait for an incoming message.
 void doSend(java.lang.String header, byte[] content)
          Send the given header and content to the peer On the client side, it's usually the initiated request, and on the server side, it's the reply to the client's request.
 void doUnbind()
          Unbind (usually used on server side)
 java.net.InetAddress getLocalAddress()
          Return the local IP address.
 int getLocalPort()
          Return the local port number.
 java.lang.String getProtocol()
          Return the name of the "protocol" used
 java.net.InetAddress getRemoteAddress()
          Return the remote IP address.
 int getRemotePort()
          Return the remote port number.
 java.lang.String toString()
           
 
Methods inherited from class com.sun.jaw.impl.adaptor.comm.AdaptorSocket
clone, getTimeout, setTimeout
 
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

AdaptorSocket

public AdaptorSocket()
Constructs an HTTP/SSL adaptor socket.

AdaptorSocket

public AdaptorSocket(int port)
Method Detail

createServerSocket

public AdaptorSocket createServerSocket(int port)
Create a socket to be used on the server side with the given port
Overrides:
createServerSocket in class AdaptorSocket

createClientSocket

public AdaptorSocket createClientSocket()
Create a socket to be used on the client side. No port is provided as the client does not "bind".
Overrides:
createClientSocket in class AdaptorSocket

getProtocol

public java.lang.String getProtocol()
Return the name of the "protocol" used
Overrides:
getProtocol in class AdaptorSocket

doBind

public void doBind()
            throws java.io.IOException
Bind to receive requests (usually used on server side)
Throws:
java.io.IOException - Signals that an I/O exception of some sort has occurred.
Overrides:
doBind in class AdaptorSocket

doUnbind

public void doUnbind()
              throws java.io.IOException
Unbind (usually used on server side)
Throws:
java.io.IOException - Signals that an I/O exception of some sort has occurred.
Overrides:
doUnbind in class AdaptorSocket

doConnect

public void doConnect(java.lang.String serverName,
                      int serverPort)
               throws java.net.UnknownHostException,
                      java.io.IOException,
                      CommunicationException
Connect to send a request (usually used on client side)
Throws:
java.net.UnknownHostException - The IP address of the specified host could not be determined.
java.io.IOException - Signals that an I/O exception of some sort has occurred.
CommunicationException - A communications problem occurred.
Overrides:
doConnect in class AdaptorSocket

doDisconnect

public void doDisconnect()
                  throws java.io.IOException,
                         CommunicationException
Can be used on both server and client sides. On the client side, disconnects the socket used when connecting. On the server side, disconnects the socket involved in the communication with the client; it's not usually the socket used for binding.
Throws:
java.io.IOException - Signals that an I/O exception of some sort has occurred.
CommunicationException - A communications problem occurred.
Overrides:
doDisconnect in class AdaptorSocket

doSend

public void doSend(java.lang.String header,
                   byte[] content)
            throws java.io.IOException
Send the given header and content to the peer On the client side, it's usually the initiated request, and on the server side, it's the reply to the client's request.
Throws:
java.io.IOException - Signals that an I/O exception of some sort has occurred.
Overrides:
doSend in class AdaptorSocket

doReceive

public java.io.InputStream doReceive()
                              throws java.io.IOException
Wait for an incoming message. On the server side, wait for a request from the client, and on the client side, wait for the reply to the client's request.
Throws:
java.io.IOException - Signals that an I/O exception of some sort has occurred.
Overrides:
doReceive in class AdaptorSocket

doGetInputStream

public java.io.InputStream doGetInputStream()
                                     throws java.io.IOException
Return an inputstream for this socket.
Throws:
java.io.IOException - Signals that an I/O exception of some sort has occurred.
Overrides:
doGetInputStream in class AdaptorSocket

getLocalAddress

public java.net.InetAddress getLocalAddress()
Return the local IP address.
Overrides:
getLocalAddress in class AdaptorSocket

getLocalPort

public int getLocalPort()
Return the local port number.
Overrides:
getLocalPort in class AdaptorSocket

getRemoteAddress

public java.net.InetAddress getRemoteAddress()
Return the remote IP address.
Overrides:
getRemoteAddress in class AdaptorSocket

getRemotePort

public int getRemotePort()
Return the remote port number.
Overrides:
getRemotePort in class AdaptorSocket

toString

public java.lang.String toString()
Overrides:
toString in class java.lang.Object