COSNOTIFYCHANNELADMIN_PROXYPUSHCONSUMER(3erl)

✨ NAME ✨

CosNotifyChannelAdmin_ProxyPushConsumer — bestie, this module is the moment. It implements the OMG CosNotifyChannelAdmin::ProxyPushConsumer interface, and it's giving very much "yes I relay events, what about it" energy. 👑

This page lives in the cosNotification manual, section 3erl, iykyk.

---

🌸 DESCRIPTION 🌸

Okay so before you can even look at the record definitions for these structures, you gotta do this first, no skipping:

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

That's the ticket in. 🎀

Also, this module also exports all the functions described in these other modules — so like, it's not just one vibe, it's a whole friend group:

• CosNotifyComm_NotifyPublish
• CosNotification_QoSAdmin
• CosNotifyFilter_FilterAdmin
• CosNotifyChannelAdmin_ProxyConsumer

Four modules' worth of functionality, and she said "I'll take it all". 💅

---

⭐ EXPORTS ⭐

connect_any_push_supplier(ProxyPushConsumer, PushSupplier) -> Reply

Types:

ProxyPushConsumer = #objref
PushSupplier = #objref
Reply = ok | {'EXCEPTION',
#'CosEventChannelAdmin_AlreadyConnected'{}}

So this operation connects a PushSupplier to the target object. Like, it's setting them up. 🫶 But — and this is the important part — if a connection already exists, the AlreadyConnected exception gets raised. She does not do second connections. One supplier per consumer, periodt. 😤

push(ProxyPushConsumer, Event) -> Reply

Types:

ProxyPushConsumer = #objref
Event = #any
Reply = ok | {'EXCEPTION',
#'CosEventChannelAdmin_Disconnected'{}}

This one pushes an #any{} event straight to the target object. Delivering the goods, literally. 📦✨

But heads up bestie: if no client has been connected, the Disconnected exception gets raised. Can't push to nobody. It's giving "texting a ghost". 💀

disconnect_push_consumer(ProxyPushConsumer) -> ok

Types:

ProxyPushConsumer = #objref

Invoking this operation makes the target object close the connection and terminate. That's it, that's the whole thing. She's logging off, shutting the laptop, closing the door. 🚪👋 No Reply value here, just a clean ok — the calmest goodbye in the whole API, honestly.

---

⚠️ Quick vibe check: those two exceptions (AlreadyConnected and Disconnected) are not decorative, bestie. Connect twice or push with nobody attached and that's on you. 🙈

---

And that's the whole page, angel! 💖 This one comes from Ericsson AB, part of cosNotification version 5.2.2 — shoutout to the OGs who wrote it. Now go connect responsibly. 🦋🌈