An interface for an Acceptor object, which is used by CORBA servers to accept client connection requests. It also provides operations for the management of IOR profiles.
readonly attribute Handle handle;
The "handle" for this Acceptor. Like with the handle for
Transports, the handle may only be used with
operations like select()
. A handle value of -1
indicates that the protocol plug-in does not support
"selectable" Transports.
readonly attribute ProfileId tag;
The profile id tag.
Transport accept();
Used by CORBA servers to accept client connection requests. It returns a Transport object, which can be used for sending and receiving octet streams to and from the client.
void add_profile(in ObjectKey key, inout IOR ior);
Adds a new profile that matches this Acceptor to an IOR.
key
- The object key to use for the new profile.
ior
- The IOR.
void close();
Closes the Transport. accept
or
listen
must not be called after close
has been called.
AcceptorInfo get_info();
Returns the information object associated with the Acceptor.
ObjectKey is_local(in IOR ior);
Checks whether an IOR is for a local object, taking only profiles into account matching this Acceptor.
ior
- The IOR to check for.
void listen();
Sets the acceptor up to listen for incoming connections. Until this method is called on the acceptor, new connection requests should result in a connection request failure.
void shutdown();
Shuts down the Transport. After calling shutdown
,
calls to accept
or listen
result in
an appropriate CORBA::COMM_FAILURE
exception being
raised.
Generated by the ORBacus IDL-to-HTML translator (non-commercial)