org.omg.CosNotifyComm
Interface SequencePullSupplierOperations

All Superinterfaces:

NotifySubscribeOperations

All Known Subinterfaces:

SequenceProxyPullSupplier, SequenceProxyPullSupplierOperations, SequencePullSupplier

public interface SequencePullSupplierOperations
extends NotifySubscribeOperations

SequencePullSupplier is an interface every sequence pull supplier must implement. Instance of this interface is actually a callback object that is connected to a proxy pull consumer of a channel.

See Also:

SequenceProxyPullConsumerOperations

Method Summary

void	disconnect_sequence_pull_supplier() This method does the application specific cleanup before disconnection.
StructuredEvent[]	pull_structured_events(int max_number) This method does the application specific way of producing and making up the events.
StructuredEvent[]	try_pull_structured_events(int max_number, BooleanHolder has_event) This method does the application specific way of producing and making up the events (if any).

Methods inherited from interface org.omg.CosNotifyComm.NotifySubscribeOperations

subscription_change

Method Detail

disconnect_sequence_pull_supplier

void disconnect_sequence_pull_supplier()

This method does the application specific cleanup before disconnection. Notification service will call this method just before this supplier is disconnected.

try_pull_structured_events

StructuredEvent[] try_pull_structured_events(int max_number,
                                             BooleanHolder has_event)
                                             throws Disconnected

This method does the application specific way of producing and making up the events (if any). Notification service actively calls this method to pull events from this supplier.

Parameters:

max_number - The maximum number of events the caller expects.

has_event - The indicator denoting whether the result contains at least an event.

Returns:

The events, packed in an event batch.

Throws:

Disconnected - if this supplier is not connected to any proxy consumer.

pull_structured_events

StructuredEvent[] pull_structured_events(int max_number)
                                         throws Disconnected

This method does the application specific way of producing and making up the events. Notification service actively calls this method to pull events from this supplier.

Parameters:

max_number - The maximum number of events the caller expects.

Returns:

The events

Throws:

Disconnected - if this supplier is not connected to any proxy consumer.