org.jacorb.orb

Class BasicAdapter

public class BasicAdapter extends _HandleLocalBase implements Configurable

Class BasicAdapter, used by the POA.

Version: $Id: BasicAdapter.java,v 1.59 2006/07/13 08:57:36 nick.cross Exp $

Author: Gerald Brose

Method Summary
booleanadd_input(Connection conn)
Announces a new connection instance to the ORB.
voidclosed_by_peer(Connection conn)
In some cases, the client side can initiate the closing of a connection.
voidconfigure(Configuration myConfiguration)
configure the BasicAdapter
voiddeliverRequest(ServerRequest request, POA poa)
to be called from the POA, code duplicated for performance reasons to avoid synchronization in the private version of this method.
StringgetAddress()
ListgetEndpointProfiles()
Returns a List of endpoint profiles for all transports that listen for incoming connections.
ORBgetORB()
intgetPort()
RequestListenergetRequestListener()
intgetSSLPort()
booleanhasSSLListener()
voidrenewSSLServerSockets()
Tell all IIOPListeners to renew their SSL server sockets.
voidreturn_result(ServerRequest request)
to be called from the POA
voidsignal_data_available(Connection conn)
The plugged-in transport (e.g. the Listener instance) shall call this function when it owns a server-side Connection and data arrives on the local endpoint.
voidstopListeners()

Method Detail

add_input

public boolean add_input(Connection conn)
Announces a new connection instance to the ORB. The caller shall examine the boolean return value and destroy the connection, if the call returns false. A new connection initially belongs to the plug-in, and it shall signal the connection to the ORB when the first incoming request data was received, using this Handle upcall.

The Handle shall accept the connection (and cache information about it if needed), as long as it is allowed to do so by the ORB. In this case it shall return true. If a new connection is currently not allowed, it shall ignore the passed instance and return false.

closed_by_peer

public void closed_by_peer(Connection conn)
In some cases, the client side can initiate the closing of a connection. The plugin shall signal this event to the server side ORB via its Handle by calling this function.

configure

public void configure(Configuration myConfiguration)
configure the BasicAdapter

deliverRequest

public void deliverRequest(ServerRequest request, POA poa)
to be called from the POA, code duplicated for performance reasons to avoid synchronization in the private version of this method.

getAddress

public String getAddress()

Deprecated: This method cannot return a sensible result in the presence of alternate transports, use getEndpointProfiles instead.

getEndpointProfiles

public List getEndpointProfiles()
Returns a List of endpoint profiles for all transports that listen for incoming connections. Each individual profile is a copy and can safely be modified by the caller (e.g. add an object key, patch the address, stuff it into an IOR, etc.).

getORB

public ORB getORB()

getPort

public int getPort()

Deprecated: This method cannot return a sensible result in the presence of alternate transports, use getEndpointProfiles instead.

getRequestListener

public RequestListener getRequestListener()

getSSLPort

public int getSSLPort()

Deprecated: This method cannot return a sensible result in the presence of alternate transports, use getEndpointProfiles instead.

hasSSLListener

public boolean hasSSLListener()

Deprecated: This method cannot return a sensible result in the presence of alternate transports, use getEndpointProfiles instead.

renewSSLServerSockets

public void renewSSLServerSockets()
Tell all IIOPListeners to renew their SSL server sockets.

See Also: IIOPListener

return_result

public void return_result(ServerRequest request)
to be called from the POA

signal_data_available

public void signal_data_available(Connection conn)
The plugged-in transport (e.g. the Listener instance) shall call this function when it owns a server-side Connection and data arrives on the local endpoint. This will start a new request dispatching cycle in the ORB. Subsequently, it shall ignore any other incoming data from this Connection until the Listener's completed_data function is called by the ORB.

stopListeners

public void stopListeners()