Examples of net.jini.jeri.kerberos.KerberosServerEndpoint.enumerateListenEndpoints()

• net.jini.jeri.kerberos.KerberosServerEndpoint.enumerateListenEndpoints()
  Passes the {@link net.jini.jeri.ServerEndpoint.ListenEndpoint ListenEndpoint} for this KerberosServerEndpoint tolistenContext, which will ensure an active listen operation on the endpoint, and returns a KerberosEndpoint instance corresponding to the listen operation chosen by listenContext.

  If this server endpoint's server host is null, then the endpoint returned will contain the default server host. This method computes the default by invoking {@link InetAddress#getLocalHost InetAddress.getLocalHost} to obtain anInetAddress for the local host. If InetAddress.getLocalHost throws an UnknownHostException, this method throws an UnknownHostException. The default host name will be the string returned by invoking {@link InetAddress#getHostAddress getHostAddress} on the obtainedInetAddress. If there is a security manager, its {@link SecurityManager#checkConnect(String,int) checkConnect} methodwill be invoked with the string returned by invoking {@link InetAddress#getHostName getHostName} on that sameInetAddress as the host argument and -1 as the port argument; this could result in a SecurityException.

  This method invokes addListenEndpoint on listenContext once, passing a ListenEndpoint as described below. If addListenEndpoint throws an exception, then this method throws that exception. Otherwise, this method returns a KerberosEndpoint instance with the host name described above, the TCP port number bound by the listen operation represented by the {@link net.jini.jeri.ServerEndpoint.ListenHandle ListenHandle} returned by addListenEndpoint, and the sameserver principal and SocketFactory as this KerberosServerEndpoint.

  The ListenEndpoint passed to addListenEndpoint represents the server subject, server principal, TCP port number, and ServerSocketFactory of this KerberosServerEndpoint. Its methods behave as follows:

  {@link net.jini.jeri.ServerEndpoint.ListenEndpoint#listen ListenHandlelisten(RequestDispatcher)}:

  Listens for requests received on this endpoint's TCP port, dispatching them to the supplied RequestDispatcher in the form of {@link net.jini.jeri.InboundRequest} instances.

  When the implementation of this method needs to create a new ServerSocket, it will do so by invoking one of the createServerSocket methods that returns a bound server socket on the contained ServerSocketFactory if non-null, or it will create a ServerSocket directly otherwise.

  If there is a security manager, its {@link SecurityManager#checkListen checkListen} method will be invoked with this endpoint's TCP port; thiscould result in a SecurityException. In addition, the security manager's {@link SecurityManager#checkPermission checkPermission} method will be invoked with an {@link net.jini.security.AuthenticationPermission} containing the serverprincipal of this endpoint and the listen action; this could also result in a SecurityException. Furthermore, before a given InboundRequest gets dispatched to the supplied request dispatcher, the security manager's {@link SecurityManager#checkAccept checkAccept} method must have beensuccessfully invoked in the security context of this listen invocation with the remote IP address and port of the Socket used to receive the request, and the security manager's checkPermission method must have been successfully invoked in the same context with an AuthenticationPermission containing the server principal of this endpoint as local principal, the client's authenticated principal as peer principal, and the accept action. The checkPermissions method of the dispatched InboundRequest also performs these latter security checks. (Note that in some cases, the implementation may carry out some of these security checks indirectly, such as through invocations of ServerSocket's constructors or accept method.)

  Once a ListenEndpoint of this provider starts to listen, each time a new inbound request comes in, it verifies that the serverSubject of the corresponding server endpoint still holds a valid KerberosKey corresponding to its serverPrincipal. It rejects the request if the verification fails. This guarantees that as soon as the KerberosKey for the principal in the Subject is destroyed (logout) or expired, no more new requests will be accepted.

  Requests will be dispatched in a {@link PrivilegedAction} wrapped by a{@link SecurityContext} obtained when this method was invoked, with the{@link AccessControlContext} of that SecurityContext ineffect.

  Dispatched requests will implement {@link net.jini.jeri.InboundRequest#populateContext populateContext} topopulate the given collection with an element that implements the {@link net.jini.io.context.ClientHost} interface, and an element thatimplements the {@link net.jini.io.context.ClientSubject} interface. TheClientHost element implements {@link net.jini.io.context.ClientHost#getClientHost getClientHost} to returnthe IP address of the Socket that the request was received over (see {@link Socket#getInetAddress}).

  Throws {@link IOException} if an I/O exception occurs while performingthis operation, such as if the TCP port is already in use.

  Throws {@link SecurityException} if there is a security manager and aninvocation of its checkListen or checkPermission method fails.

  Throws {@link NullPointerException} if requestDispatcheris null

  {@link net.jini.jeri.ServerEndpoint.ListenEndpoint#checkPermissions void checkPermissions()}:

  Verifies that the current security context has all of the security permissions necessary to listen for requests on this endpoint.

  If there is a security manager, its checkListen method will be invoked with this endpoint's TCP port; this could result in a SecurityException. In addition, the security manager's {@link SecurityManager#checkPermission checkPermission} method will beinvoked with an {@link net.jini.security.AuthenticationPermission}containing the server principal of this endpoint and the listen action; this could also result in a SecurityException.

  Throws {@link SecurityException} if there is a security manager and aninvocation of its checkListen or checkPermission method fails.

  {@link Object#equals boolean equals(Object)}:

  Compares the specified object with this ListenEndpoint for equality.

  This method returns true if and only if the specified object is also a ListenEndpoint produced by a KerberosServerEndpoint, and the two listen endpoints both have server subjects that compare equal using ==; have the same server principal; have the same values for TCP port; and have server socket factories that are either both null, or have the same actual class and are equal.

  @throws SecurityException if there is a security manager, andeither its {@link SecurityManager#checkListen checkListen} method fails, or serverHostis null and the security manager's {@link SecurityManager#checkConnect checkConnect} methodfails; or if the calling thread does not have permission to authenticate as the endpoint's server principal when listening for connections @throws IllegalArgumentException {@inheritDoc} @throws NullPointerException {@inheritDoc} @throws UnknownHostException if this instance's server hostis null and InetAddress.getLocalHost throws an UnknownHostException @throws UnsupportedConstraintException if the server subject ismissing any of the endpoint's server principals or the associated credentials