org.fabric3.binding.zeromq.runtime

Interface ZeroMQPubSubBroker

All Known Implementing Classes:

ZeroMQPubSubBrokerImpl

public interface ZeroMQPubSubBroker

Responsible for managing local publishers and subscribers. Unlike brokers in traditional hub-and-spoke messaging architectures, implementations do not receive or forward messages; rather, subscribers connect directly to publishers.

Method Summary

Methods

Modifier and Type	Method and Description
void	connect(java.lang.String connectionId, org.fabric3.api.binding.zeromq.model.ZeroMQMetadata metadata, boolean dedicatedThread, org.fabric3.spi.container.channel.ChannelConnection connection, java.lang.ClassLoader loader) Connects the channel connection to the publisher for the given channel.
void	release(java.lang.String connectionId, org.fabric3.api.binding.zeromq.model.ZeroMQMetadata metadata) Releases a publisher for a channel.
void	startAll() Starts all publishers and subscribers.
void	stopAll() Stops all publishers and subscribers.
void	subscribe(java.net.URI subscriberId, org.fabric3.api.binding.zeromq.model.ZeroMQMetadata metadata, org.fabric3.spi.container.channel.ChannelConnection connection, java.lang.ClassLoader loader) Subscribes a consumer to the given channel.
void	unsubscribe(java.net.URI subscriberId, org.fabric3.api.binding.zeromq.model.ZeroMQMetadata metadata) Removes a consumer from the given channel.

Method Detail

subscribe

void subscribe(java.net.URI subscriberId,
             org.fabric3.api.binding.zeromq.model.ZeroMQMetadata metadata,
             org.fabric3.spi.container.channel.ChannelConnection connection,
             java.lang.ClassLoader loader)
               throws BrokerException

Subscribes a consumer to the given channel.

Parameters:

subscriberId - the unique subscription id

metadata - the ZeroMQ metadata to configure the underlying socket

connection - the consumer connection to dispatch received message to

loader - the classloader for deserializing events, typically the consumer implementation contribution classloader

Throws:

BrokerException - if an error occurs creating the subscription

unsubscribe

void unsubscribe(java.net.URI subscriberId,
               org.fabric3.api.binding.zeromq.model.ZeroMQMetadata metadata)
                 throws BrokerException

Removes a consumer from the given channel.

Parameters:

subscriberId - the unique subscription id

metadata - the ZeroMQ metadata to configure the underlying socket

Throws:

BrokerException - if an error occurs removing the subscription

connect

void connect(java.lang.String connectionId,
           org.fabric3.api.binding.zeromq.model.ZeroMQMetadata metadata,
           boolean dedicatedThread,
           org.fabric3.spi.container.channel.ChannelConnection connection,
           java.lang.ClassLoader loader)
             throws BrokerException

Connects the channel connection to the publisher for the given channel.

Parameters:

connectionId - the unique id for the connection

metadata - the ZeroMQ metadata to configure the underlying socket

connection - the producer that dispatches messages to the publisher

loader - the classloader for the event types being sent

Throws:

BrokerException - if an error occurs removing the subscription

release

void release(java.lang.String connectionId,
           org.fabric3.api.binding.zeromq.model.ZeroMQMetadata metadata)
             throws BrokerException

Releases a publisher for a channel.

Parameters:

connectionId - the unique id for the connection

metadata - the ZeroMQ metadata to configure the underlying socket

Throws:

BrokerException - if an error occurs removing the publisher

startAll

void startAll()

Starts all publishers and subscribers.

stopAll

void stopAll()

Stops all publishers and subscribers.