Diffusion .NET Client Library  6.1.5
 All Classes Namespaces Functions Variables Enumerations Enumerator Properties Events Pages
PushTechnology.ClientInterface.TopicDetails.Details.IRoutingTopicDetails Interface Reference

Details of a routing topic. More...

Inheritance diagram for PushTechnology.ClientInterface.TopicDetails.Details.IRoutingTopicDetails:
PushTechnology.ClientInterface.Client.Topics.ITopicDetails

Public Member Functions

IRoutingTopicDetailsBuilder CreateBuilder ()
 Returns a new builder initialised with the values from these details. More...
 

Additional Inherited Members

- Properties inherited from PushTechnology.ClientInterface.Client.Topics.ITopicDetails
TopicDetailsLevel Level [get]
 Returns the level of detail available. More...
 
TopicType Type [get]
 Returns the topic type. More...
 
ITopicDetailsSchema Schema [get]
 Returns the topic schema. More...
 
ITopicDetailsAttributes Attributes [get]
 Returns the topic attributes. More...
 

Detailed Description

Details of a routing topic.

This is a form of topic that allows the topic to route its subscriptions through to one or more topics, and for messages published on those topics to be routed back through the routing topic.

The result is that the client may subscribe to a topic which is in reality supported by another topic and the mapping of the routing topic to the actual topic can be different for each client.

As an example of use you may wish for all clients to simply subscribe to a topic called 'Prices', but depending on the client type, the actual topic could differ (Prices/Discount, Prices/Standard etc.).

An instance of this data may map any number of clients to any number of different 'real' topics. Each real topic must have a stateful topic attached.

The full class name of a subscription handler class which will action the mappings at the server may be supplied. The class must implement the com.pushtechnology.diffusion.api.data.routing.RoutingTopicDataSubscriptionHandler interface defined by the Classic API. Alternatively, if no handler is supplied, subscriptions to routing topics may be handled using the ISubscriptionControl feature.

The easiest way to create an instance of such details is using ITopicControl.NewDetails(TopicType), for example:

var control = session.TopicControl; var details = control.NewDetails( TopicType.ROUTING );

The above would create details for a routing topic that will be controlled by the ISubscriptionControl feature. Alternatively the details can be created using a builder obtained as follows:

var builder = control.CreateDetailsBuilder<IRoutingTopicDetailsBuilder>();

Member Function Documentation

IRoutingTopicDetailsBuilder PushTechnology.ClientInterface.TopicDetails.Details.IRoutingTopicDetails.CreateBuilder ( )

Returns a new builder initialised with the values from these details.

Returns

The documentation for this interface was generated from the following file: