org.jacorb.orb.iiop

Class IIOPListener

Implemented Interfaces:
Configurable, IDLEntity, Listener, ListenerOperations, LocalInterface, Object, java.io.Serializable

public class IIOPListener
extends _ListenerLocalBase
implements Configurable

Version:
$Id: IIOPListener.java,v 1.17 2004/05/06 09:41:04 nicolas Exp $

Author:
Andre Spiegel

Constructor Summary

IIOPListener(ORB orb)

Method Summary

Connection
accept()
This call is an alternative to using set_handle() to initiate the callback-style of accepting new connections.
void
completed_data(Connection conn)
The connection instance is returned to the Listener.
void
configure(Configuration configuration)
protected Connection
createServerConnection(Socket socket, boolean is_ssl)
Template method to create a server-side ETF Connection.
void
destroy()
The Listener is instructed to close its endpoint.
Profile
endpoint()
Returns a copy of the profile describing the endpoint of this instance.
void
listen()
It is possible that connection requests arrive after the initial creation of the Listener instance but before the conclusion of the configuration of the specific endpoint in this plugin.
void
set_handle(Handle up)
This call establishes the link between the ORB (i.e. the Handle instance) and a server endpoint of the plugged-in transport.

Methods inherited from class org.omg.ETF._ListenerLocalBase

_ids

Methods inherited from class org.omg.CORBA.LocalObject

_create_request, _create_request, _duplicate, _get_domain_managers, _get_interface, _get_interface_def, _get_policy, _hash, _ids, _invoke, _is_a, _is_equivalent, _is_local, _non_existent, _orb, _release, _releaseReply, _request, _request, _servant_postinvoke, _servant_preinvoke, _set_policy_override, validate_connection

Constructor Details

IIOPListener

public IIOPListener(ORB orb)

Method Details

accept

public Connection accept()
This call is an alternative to using set_handle() to initiate the callback-style of accepting new connections. This call blocks until a client connects to the server. Then a new Connection instance is returned. The transport plug-in must ensure that a thread blocked in accept() returns when destroy() is called with a null object reference. The transport plug-in must raise the CORBA::BAD_INV_ORDER with minor code {TBD} if the ORB calls this operation and set_handle() has ever been called previously on the same listener instance.
Specified by:
accept in interface ListenerOperations


completed_data

public void completed_data(Connection conn)
The connection instance is returned to the Listener. It now shall signal any incoming data to the Handle.
Specified by:
completed_data in interface ListenerOperations


configure

public void configure(Configuration configuration)
            throws ConfigurationException


createServerConnection

protected Connection createServerConnection(Socket socket,
                                            boolean is_ssl)
            throws IOException
Template method to create a server-side ETF Connection. This can be overridden by subclasses to pass a different kind of Connection up to the ORB.


destroy

public void destroy()
The Listener is instructed to close its endpoint. It shall no longer accept any connection requests and shall close all connections opened by it.
Specified by:
destroy in interface ListenerOperations


endpoint

public Profile endpoint()
Returns a copy of the profile describing the endpoint of this instance.
Specified by:
endpoint in interface ListenerOperations


listen

public void listen()
It is possible that connection requests arrive after the initial creation of the Listener instance but before the conclusion of the configuration of the specific endpoint in this plugin. In order to provide a clear end of this configuration state, we added the listen() method. It is called by the ORB when it ready for incoming connection and thus signals the Listener instance to start processing the incoming connection requests. Therefore, a Listener instance shall not deliver incoming connections to the ORB before this method was called.
Specified by:
listen in interface ListenerOperations


set_handle

public void set_handle(Handle up)
This call establishes the link between the ORB (i.e. the Handle instance) and a server endpoint of the plugged-in transport. All calls upwards into the ORB shall use the given instance.
Specified by:
set_handle in interface ListenerOperations