com.solacesystems.solclientj.core.handle

Interface MutableMessageDispatchTargetHandle

All Superinterfaces:

Handle, MessageSupport

public interface MutableMessageDispatchTargetHandle
extends Handle, MessageSupport

The MutableMessageDispatchTargetHandle interface allows an application to receive messages on a specific MutableTopic. Applications that need this interface must instantiate an object with the MutableMessageDispatchTargetHandle interface by calling Solclient.Allocator.newMutableMessageDispatchTargetHandle().

The allocated MutableMessageDispatchTargetHandle is used to create a subscription entry in the API by calling MessageDispatcher.subscribe(MutableMessageDispatchTargetHandle, MutableTopic, MessageCallback, boolean, int, long) SessionHandle.subscribe()} or MessageDispatcher.subscribe(MutableMessageDispatchTargetHandle, MutableTopic, MessageCallback, boolean, int, long) FlowHandle.subscribe()}

Method Summary

Modifier and Type	Method and Description
void	destroy() This method will destroy the the message dispatch associated with this instance.

Methods inherited from interface com.solacesystems.solclientj.core.handle.Handle

isBound

Methods inherited from interface com.solacesystems.solclientj.core.handle.MessageSupport

getRxMessage, takeRxMessage

Method Detail

destroy

void destroy()
      throws SolclientException

This method will destroy the the message dispatch associated with this instance. The message dispatch is bound to the Handle by a subscribe() operation. This is exactly the same as calling unsubscribe(in_outHandle, 0, 0); In many cases it is preferable to call unsubscribe() as it make the code easier to understand, and allows the application to set both flags, and correlation key.

Specified by:

destroy in interface Handle

Throws:

SolclientException - if the destroy fails