com.latencybusters.lbm
Class LBMTopic

java.lang.Object
  com.latencybusters.lbm.LBMTopic

public class LBMTopic
extends java.lang.Object

LBM Topic class. It is recommended that topic objects be instantiated from the LBMContext factory methods allocTopic and lookupTopic (for sources and receivers respectively).

Warning: It is not safe to instantiate this object from a context thread callback.

Constructor Summary

LBMTopic(LBMContext lbmctx, java.lang.String symbol)
Turn a Topic string into an LBMTopic object usable by receivers.

LBMTopic(LBMContext lbmctx, java.lang.String symbol, LBMReceiverAttributes lbmrattr)
Turn a Topic string into an LBMTopic object usable by receivers.

LBMTopic(LBMContext lbmctx, java.lang.String symbol, LBMSourceAttributes lbmsattr)
Turn a Topic string into an LBMTopic object usable by sources.

Method Summary

boolean

setReceiver()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

LBMTopic

public LBMTopic(LBMContext lbmctx,
                java.lang.String symbol)
         throws LBMException

Turn a Topic string into an LBMTopic object usable by receivers. (Note: This constructor cannot be used to initialize a source topic.) It is recommended that topic objects be instantiated from the LBMContext factory methods allocTopic and lookupTopic (for sources and receivers respectively).

Warning: It is not safe to call this constructor from a context thread callback.

Parameters:

lbmctx - LBMContext object for the topic

symbol - Topic string (Topic strings should be limited in length to 246 characters, not including the final null).

Throws:

LBMException - if any topic lookup error occurs.

See Also:

LBMReceiver

LBMTopic

public LBMTopic(LBMContext lbmctx,
                java.lang.String symbol,
                LBMReceiverAttributes lbmrattr)
         throws LBMException

Turn a Topic string into an LBMTopic object usable by receivers. It is recommended that topic objects be instantiated from the LBMContext factory methods allocTopic and lookupTopic (for sources and receivers respectively).

Warning: It is not safe to call this constructor from a context thread callback.

Parameters:

lbmctx - LBMContext object for the topic

symbol - Topic string (Topic strings should be limited in length to 246 characters, not including the final null).

lbmrattr - LBMReceiverAttributes object used to initialize the topic object.

Throws:

LBMException - if any topic lookup error occurs.

See Also:

LBMReceiver

LBMTopic

public LBMTopic(LBMContext lbmctx,
                java.lang.String symbol,
                LBMSourceAttributes lbmsattr)
         throws LBMException

Turn a Topic string into an LBMTopic object usable by sources. It is recommended that topic objects be instantiated from the LBMContext factory methods allocTopic and lookupTopic (for sources and receivers respectively).

Warning: It is not safe to call this constructor from a context thread callback.

Parameters:

lbmctx - LBMContext object for the topic

symbol - Topic string (Topic strings should be limited in length to 246 characters, not including the final null).

lbmsattr - LBMSourceAttributes object used to initialize the topic object.

Throws:

LBMException - if any topic allocation error occurs.

See Also:

LBMSource

Method Detail

setReceiver

public boolean setReceiver()