Service Protocol: PushConsumer

A service implementing this protocol (usually by implementing one of the BasicService_PushConsumer or SessionService_PushConsumer, etc. interfaces from Service.idl) will receive Events from another service.

The IDL file defines three functions for this interface, but only one of them is really important:

• void push_structured_event( const StructuredEvent& event );
  This gets called each time a new StructuredEvent arrives.

The other two function callbacks disconnect_structured_push_consumer and offer_change have no special meaning in our context and are usually not called. Most implementations choose to ignore these function calls (or write a short log message).

Q: There are rumors that in recent versions of the service manager these functions actually get called sometimes... -- MartinBauer - 17 Jul 2003

More Information

• A nice and clean Example how to implement a SvcProtPushConsumer is the PoseDataLogger.
  Note how this implementation completely ignores the other two function callbacks disconnect_structured_push_consumer and offer_change.

• SvcProtPushConsumer.graffle: Above sequence diagram.