CosEventCh...shSupplier(3)

πŸ“¦
version 5.2.2 Β· 2 versions
, in fedora 43, fedora 44

✨ NAME ✨

CosEventChannelAdmin_ProxyPushSupplier β€” okay bestie, this module is the whole ProxyPushSupplier interface, and it's basically the middleman πŸ’… between a push consumer and the event channel. It literally exists to hold the vibes together.


🌸 DESCRIPTION 🌸

So the ProxyPushSupplier interface is the second step in the glow-up journey of connecting push consumers to the event channel. Think of a proxy supplier like a normal supplier but with extra β€” it's got one more method whose whole job is connecting a consumer to the proxy supplier. main character energy, honestly 🫢

To get access to all the definitions β€” like exceptions, bestie β€” you include the necessary hrl files like this:

-include_lib("cosEvent/include/*.hrl").

Any object that's out here holding an object reference supporting the ProxyPushSupplier interface can do the following operations, no cap πŸ‘‘


⭐ EXPORTS ⭐

connect_push_consumer(Object, PushConsumer) -> Return

Types:

Object = #objref
PushConsumer = #objref of PushConsumer type
Return = ok | {'EXCEPTION', E}
E = #'CosEventChannelAdmin_AlreadyConnected'{} |
#'CosEventChannelAdmin_TypeError'{}

This one connects the PushConsumer object to the ProxyPushSupplier object. The whole linking-up moment πŸ’–

  • Pass a nil object reference? Nope. The CORBA standard BAD_PARAM exception gets raised, periodt.
  • Is the ProxyPushSupplier already connected to a PushConsumer? Then you get the CosEventChannelAdmin_AlreadyConnected exception, sorry babe 😭
  • And heads up: implementations of ProxyPushSuppliers may require additional interface functionality, and if those requirements aren't met, the CosEventChannelAdmin_TypeError exception will be raised. So don't come unprepared πŸ’€

disconnect_push_supplier(Object) -> Return

Types:

Object = #objref
Return = ok

This operation disconnects the proxy push supplier from the event channel, and it sends a notification about the loss of the connection to the push consumer attached to it. It's giving we need to talk πŸ’” but make it protocol.


Bestie reminder: this is Ericsson AB's work, from cosEvent 5.2.2, and this page is literally titled CosEventCh...shSupplier(3) β€” that truncated lil name is iconic actually. Slay, go connect some consumers πŸŽ€πŸ¦‹
πŸ“¦ where this page comes from