org.jacorb.orb.iiop
Class IIOPListener

java.lang.Object
  extended byorg.omg.CORBA.LocalObject
      extended byorg.omg.ETF._ListenerLocalBase
          extended byorg.jacorb.orb.etf.ListenerBase
              extended byorg.jacorb.orb.iiop.IIOPListener
All Implemented Interfaces:
org.apache.avalon.framework.configuration.Configurable, IDLEntity, Listener, ListenerOperations, LocalInterface, Object, java.io.Serializable

public class IIOPListener
extends ListenerBase

Version:
$Id: IIOPListener.java,v 1.25 2005/10/10 21:35:24 phil.mesnier Exp $
Author:
Andre Spiegel
See Also:
Serialized Form

Nested Class Summary
protected  class IIOPListener.Acceptor
           
 
Field Summary
 
Fields inherited from class org.jacorb.orb.etf.ListenerBase
acceptor, configuration, incoming_connections, logger, orb, profile, terminated, up
 
Constructor Summary
IIOPListener()
           
IIOPListener(ORB orb)
          Deprecated. Use no-args version and then configure().
 
Method Summary
 void configure(org.apache.avalon.framework.configuration.Configuration configuration)
           
protected  Connection createServerConnection(java.net.Socket socket, boolean is_ssl)
          Template method to create a server-side ETF Connection.
 void destroy()
          The Listener is instructed to close its address.
 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 address in this plugin.
 
Methods inherited from class org.jacorb.orb.etf.ListenerBase
accept, completed_data, deliverConnection, endpoint, set_handle
 
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_def, _get_interface, _get_policy, _hash, _invoke, _is_a, _is_equivalent, _is_local, _non_existent, _orb, _release, _releaseReply, _request, _request, _servant_postinvoke, _servant_preinvoke, _set_policy_override, validate_connection
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface org.omg.CORBA.Object
_create_request, _create_request, _duplicate, _get_domain_managers, _get_interface_def, _get_interface, _get_policy, _hash, _is_a, _is_equivalent, _non_existent, _release, _request, _set_policy_override
 

Constructor Detail

IIOPListener

public IIOPListener()

IIOPListener

public IIOPListener(ORB orb)
Deprecated. Use no-args version and then configure().

Method Detail

configure

public void configure(org.apache.avalon.framework.configuration.Configuration configuration)
               throws org.apache.avalon.framework.configuration.ConfigurationException
Specified by:
configure in interface org.apache.avalon.framework.configuration.Configurable
Overrides:
configure in class ListenerBase
Throws:
org.apache.avalon.framework.configuration.ConfigurationException

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 address 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
Overrides:
listen in class ListenerBase

destroy

public void destroy()
The Listener is instructed to close its address. It shall no longer accept any connection requests and shall close all connections opened by it.

Specified by:
destroy in interface ListenerOperations
Overrides:
destroy in class ListenerBase

createServerConnection

protected Connection createServerConnection(java.net.Socket socket,
                                            boolean is_ssl)
                                     throws java.io.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.

Throws:
java.io.IOException