Creating a Nirvana Channel

Creating a Nirvana Channel using the Nirvana Client API

Channels can be created programatically as detailed below, or they can be created using the Nirvana enterprise manager.

In order to create a channel, first of all you must create an nSession object, which is your effectively the logical and physical connection to a Nirvana Realm. This is achieved by using an RNAME for your Nirvana Realm when constructing the nSessionAttributes object, as shown below:

String[] RNAME=({“nsp://127.0.0.1:9000”});
nSessionAttributes nsa=new nSessionAttributes(RNAME);
nSession mySession=nSessionFactory.create(nsa);
mySession.init();

Once the nSession.init() method is successfully called, your connection to the realm will be established.

Using the nSession objects instance 'mySession', we can then begin creating the channel object. Channels have an associated set of attributes, that define their behaviour within the Nirvana Realm Server. As well as the name of the channel, the attributes determine the availability of the events published to a channel to any subscribers wishing to consume them,

To create a channel, we do the following:

nChannelAttributes cattrib = new nChannelAttributes();
cattrib.setMaxEvents(0);
cattrib.setTTL(0);
cattrib.setType(nChannelAttributes.PERSISTENT_TYPE);
cattrib.setName(“mychannel”);
nChannel myChannel=mySession.createChannel(cattrib);

Now we have a reference to a Nirvana channel within the realm.

An example of creating a channel programatically can be found here. For more information on Nirvana publish / subscribe, please see the API documentation.