List of enumerateListenEndpoints() Examples

Examples of enumerateListenEndpoints()

net.jini.jeri.ServerEndpoint.enumerateListenEndpoints()
Enumerates the communication endpoints represented by this ServerEndpoint by passing the ListenEndpoint for each of them to listenContext, which will ensure an active listen operation on each endpoint, and returns an Endpoint instance corresponding to the listen operations chosen by listenContext.
This method uses listenContext to cooperate with the caller to ensure the appropriate listen operations. In this cooperation,
- the ServerEndpoint is responsible for declaring to the caller the discrete communication endpoints represented by this ServerEndpoint as ListenEndpoint instances passed to listenContext's {@link ListenContext#addListenEndpoint addListenEndpoint} method, and
- the caller is responsible for declaring the active listen operations to be used for this ServerEndpoint.enumerateListenEndpoints invocation corresponding to each discrete communication endpoint as {@link ListenCookie ListenCookie} instances returned fromlistenContext's addListenEndpoint method.
For each ListenEndpoint, the caller (through listenContext) may choose to start a new listen operation, or it may choose to reuse a previously started listen operation that it has a ListenCookie for.
This method sequentially invokes addListenEndpoint on listenContext once for each discrete communication endpoint represented by this ServerEndpoint, passing the ListenEndpoint representing that communication endpoint. If any of the invocations of ListenContext.addListenEndpoint throws an exception, this method throws that exception. Otherwise, this method returns an Endpoint instance that sends requests to be received by the listen operations chosen by listenContext. @param listenContext the ListenContext to passthis ServerEndpoint's ListenEndpoint instances to @return the Endpoint instance for sending requeststo this ServerEndpoint's communication endpoints being listened on @throws IOException if an I/O exception occurs while attemptingto listen for requests on the communication endpoints represented by this ServerEndpoint. This could occur, for example, if an I/O resource associated with one of the communication endpoints is already in exclusive use, or if there are insufficient I/O resources for the operation. @throws SecurityException if the current security context doesnot have the permissions necessary to listen for requests on one of the communication endpoints represented by this ServerEndpoint @throws IllegalArgumentException if an invocation of theaddListenEndpoint method on the supplied ListenContext returns a ListenCookie that does not correspond to the ListenEndpoint that was passed to it @throws NullPointerException if listenContext isnull
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

Examples of net.jini.jeri.ServerEndpoint.enumerateListenEndpoints()

        //obtain a ServerEndpoint and verify that the addListenEndpoint
        //is called on the ListenContext specified and the expected number
        //of ListenEndpoints are passed in to the context.
        SETContext lc = new SETContext();
        ServerEndpoint se = getServerEndpoint();
        Endpoint e = se.enumerateListenEndpoints(lc);
        boolean exceptionThrown = false;
        log.finest("Call to enumerateListeEndpoints returns " + e);
        Integer expected = (Integer) getConfigObject(Integer.class,
            "expectedListenEndpoints");
        ArrayList endpoints = lc.getEndpoints();

View Full Code Here

Examples of net.jini.jeri.ServerEndpoint.enumerateListenEndpoints()


    public void run() throws Exception {
        Endpoint endpoint = null;
        //Obtain endpoint
        ServerEndpoint serverEndpoint = getServerEndpoint();
        endpoint = serverEndpoint
            .enumerateListenEndpoints(new SETContext());
        //Obtain constraints
        InvocationConstraints conflictingConstraints =
            (InvocationConstraints) getConfigObject(
                InvocationConstraints.class, "conflictingConstraints");

View Full Code Here

Examples of net.jini.jeri.ServerEndpoint.enumerateListenEndpoints()

    public void run() throws Exception {
        //Obtain a server endpoint instance
        ServerEndpoint endpoint = getServerEndpoint();
        try {
            //Verify that an arbitrary exception is propagated
            endpoint.enumerateListenEndpoints(
                new ExceptionListenContext(new ArbitraryException()));
        } catch (ArbitraryException a) {
            try {
                //Verify that an IOException is propagated
                endpoint.enumerateListenEndpoints(

View Full Code Here

Examples of net.jini.jeri.ServerEndpoint.enumerateListenEndpoints()

            endpoint.enumerateListenEndpoints(
                new ExceptionListenContext(new ArbitraryException()));
        } catch (ArbitraryException a) {
            try {
                //Verify that an IOException is propagated
                endpoint.enumerateListenEndpoints(
                    new ExceptionListenContext(new IOException()));
            } catch (IOException e) {
                return;
            }
        }

View Full Code Here

Examples of net.jini.jeri.ServerEndpoint.enumerateListenEndpoints()

            ((EndpointHolder)it.next()).getListenHandle().close();
        }
        // wait to make sure resources released before attempting
        // to reuse socket
        Thread.currentThread().sleep(1000 * 30); 
        se2.enumerateListenEndpoints(lc2);
        ArrayList endpoints2 = lc2.getEndpoints();
        for (int i=0; i<endpoints.size(); i++){
            EndpointHolder eph = (EndpointHolder) endpoints.get(i);
            EndpointHolder eph2 = (EndpointHolder) endpoints2.get(i);
            ServerEndpoint.ListenEndpoint le = eph.getListenEndpoint();

View Full Code Here

Examples of net.jini.jeri.ServerEndpoint.enumerateListenEndpoints()

                + " endpoints are considered equal");
        }
        //Verify that ListenEndpoint on functionally equivalent
        //ServerEndpoint instances are considered equal.
        lc2 = new EqualityContext();
        se2.enumerateListenEndpoints(lc2);
        endpoints2 = lc2.getEndpoints();
        for (int i=0; i<endpoints.size(); i++){
            EndpointHolder eph = (EndpointHolder) endpoints.get(i);
            EndpointHolder eph2 = (EndpointHolder) endpoints2.get(i);
            ServerEndpoint.ListenEndpoint le = eph.getListenEndpoint();

View Full Code Here

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

  private Object createSep() throws Exception {
      try {
          KerberosServerEndpoint sep = 
        KerberosServerEndpoint.getInstance(
      subject, serverPrincipal, serverHost, port, csf, ssf);
    sep.enumerateListenEndpoints(new ListenContext() {
      public ListenCookie addListenEndpoint(
          ListenEndpoint listenEndpoint) throws IOException
      {
          ListenHandle handle = listenEndpoint.listen(
        new RequestDispatcher() {

View Full Code Here

0 1 2

TOP

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.