Main Page   Namespace List   Class Hierarchy   Alphabetical List   Compound List   File List   Compound Members   File Members  

CosEventComm::PullSupplier Interface Reference

Define the interface implemented by pull-style suppliers. More...

import "CosEventComm.idl";

Inheritance diagram for CosEventComm::PullSupplier:

Inheritance graph
[legend]
List of all members.

Public Methods

any pull () raises (Disconnected)
 Pull (blocking) one event from the supplier.

any try_pull (out boolean has_event) raises (Disconnected)
 Pull (non-blocking) one event from the supplier.

void disconnect_pull_supplier ()
 The peer has disconnected from the pull-style supplier.


Detailed Description

Define the interface implemented by pull-style suppliers.

A pull-style supplier passively generates events for the Event Service


Member Function Documentation

void CosEventComm::PullSupplier::disconnect_pull_supplier  
 

The peer has disconnected from the pull-style supplier.

The disconnect_pull_supplier operation indicates that the peer has disconnected, for example, because it has been destroyed. The application can safe release all resource attached to this supplier and destroy it, the peer should not make any attempts to pull more data after this request.

any CosEventComm::PullSupplier::pull   raises (Disconnected)
 

Pull (blocking) one event from the supplier.

The pull operation should block until the next event becomes available.

Returns:
The next event
Exceptions:
CosEventComm::Disconnected  if the object considers itself no longer connected to its peer.

any CosEventComm::PullSupplier::try_pull out boolean    has_event raises (Disconnected)
 

Pull (non-blocking) one event from the supplier.

The try_pull operation does not block: if the event data is available, it returns the event data and sets the has_event parameter to true; if the event is not available, it sets the has_event parameter to false and the event data is returned as long with an undefined value.

Parameters:
has_event  Set to TRUE if there was another event available, FALSE otherwise.
Returns:
The next event if one was available, an any containing a 'long' with an undefined value otherwise.
Exceptions:
CosEventComm::Disconnected  if the object considers itself no longer connected to its peer.


The documentation for this interface was generated from the following file:
Generated on Thu Jan 15 00:30:55 2004 for TAO_CosEvent by doxygen1.2.18