CosEventCh...llConsumer(3)

💖 CosEventChannelAdmin_ProxyPullConsumer 💖

okay bestie, so this page is from the CosEventCh...llConsumer(3) manual (Erlang module definition energy ✨), and it's all about a lil module called CosEventChannelAdmin_ProxyPullConsumer. Yes the name is long. No we are not shortening it. She's iconic, she's got the whole government name, periodt.

---

🎀 NAME 🎀

CosEventChannelAdmin_ProxyPullConsumer — this module implements a ProxyPullConsumer interface that lowkey acts as a middleman between a pull supplier and the event channel. Matchmaker vibes fr fr 💅

---

🌸 DESCRIPTION 🌸

The ProxyPullConsumer interface is step two in the whole "connecting pull suppliers to the event channel" saga. Think of a proxy consumer like a regular consumer but with one extra trick up her sleeve: she's got an additional method for connecting a supplier to the proxy consumer. Main character behavior honestly 👑

To get access to all the definitions — exceptions included, no crumbs left behind — include the necessary hrl files like this:

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

Any object that possesses an object reference that supports the ProxyPullConsumer interface can perform the following operations:

---

✨ EXPORTS ✨

🦋 connect_pull_supplier(Object, PullSupplier) -> Return

Types:

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

This operation connects the PullSupplier object to the ProxyPullConsumer object. Gluing them together. Besties forever, kinda.

🚨 Heads up though: if you pass a nil object reference, the CORBA standard BAD_PARAM exception gets raised. Not the vibe.

If the ProxyPullConsumer is already connected to a PullSupplier (she's taken, sorry), then the CosEventChannelAdmin_AlreadyConnected exception is raised.

And one more thing bestie: implementations of ProxyPullConsumers may require additional interface functionality, and if those requirements are not met, the CosEventChannelAdmin_TypeError exception will be raised. So like… read the room, meet the requirements, slay 💅

---

🍓 disconnect_pull_consumer(Object) -> Return

Types:

Object = #objref
Return = ok

This operation disconnects the proxy pull consumer from the event channel, and it sends a notification about the loss of the connection to the pull supplier attached to it. It's giving "we need to talk" text at 2am 😭 but for CORBA objects. Closure is important bestie 🫶

---

and that's the whole page, no cap ✨

This was brought to you by Ericsson AB and cosEvent version 5.2.2 — so like, credit where credit is due, she ate and left no crumbs 💖🌸🦋