Docjar: A Java Source and Docuemnt Enginecom.*    java.*    javax.*    org.*    all    new    plug-in

Quick Search    Search Deep

cryptix.sasl.rmi
Class SaslServerSocket  view SaslServerSocket download SaslServerSocket.java

java.lang.Object
  extended byjava.net.ServerSocket
      extended bycryptix.sasl.rmi.SaslServerSocket

public class SaslServerSocket
extends java.net.ServerSocket

This class implements server sockets. A server socket waits for requests to come in over the network. It performs some operation based on that request, and then possibly returns a result to the requester.

Version:
1.1

Field Summary
private static org.apache.log4j.Category cat
           
 
Fields inherited from class java.net.ServerSocket
 
Constructor Summary
SaslServerSocket(int port)
          Creates a server socket on a specified port.
 
Method Summary
 java.net.Socket accept()
          Listens for a connection to be made to this socket and accepts it.
 
Methods inherited from class java.net.ServerSocket
bind, bind, close, getChannel, getInetAddress, getLocalPort, getLocalSocketAddress, getReceiveBufferSize, getReuseAddress, getSoTimeout, implAccept, isBound, isClosed, setReceiveBufferSize, setReuseAddress, setSocketFactory, setSoTimeout, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

cat

private static org.apache.log4j.Category cat
Constructor Detail

SaslServerSocket

public SaslServerSocket(int port)
                 throws java.io.IOException
Creates a server socket on a specified port. A port of 0 creates a socket on any free port.

The maximum queue length for incoming connection indications (a request to connect) is set to 50. If a connection indication arrives when the queue is full, the connection is refused.

If there is a security manager, its checkListen() method is called with the port argument as its argument to ensure the operation is allowed. This could result in a SecurityException.

Method Detail

accept

public java.net.Socket accept()
                       throws java.io.IOException
Listens for a connection to be made to this socket and accepts it. The method blocks until a connection is made.

A new Socket s is created and, if there is a security manager, the security manager's checkAccept() method is called with s.getInetAddress().getHostAddress() and s.getPort() as its arguments to ensure the operation is allowed. This could result in a SecurityException.

NOTE:This implementation now _always_ starts by reading on this (server) side, which implies that the peer (client) has to start the dialogue. This is no problem for mechanisms whose client has an initial response to send to the server. However, for those mechanisms whose client does not have an initial response, we achieve this in SaslClientSocketFactory by adding a write of a 0-byte message that we (SHOULD) discard in the mechanism's server implementation.

Since:
1.1