com.pcbsys.nirvana.client.nDurableManager Class Reference

Class responsible for managing durable subscriptions on a channel. More...

Public Member Functions
nDurable	add (nDurableAttributes durableAttributes)
	Creates a durable object on the channel assosiated with the durable manager instance with the given durable attributes.
void	delete (nDurable durable)
	Deletes the durable object from the channel assosiated with this durable manager instance.
void	delete (String name)
	Deletes the durable object from the channel assosiated with this durable manager instance.
nDurable	get (string name)
	Returns durable object instance for the requested name.
nDurable[]	getAll ()
	Returns all durable objects existing on the channel assosiated with this durable manager instance.
void	unbind (nDurable durable)
	Unbinds the durable object from the current connection.

Detailed Description

Class responsible for managing durable subscriptions on a channel.

Durable objects can be added, deleted and retrieved using the durable manager.

Member Function Documentation

add()

nDurable com.pcbsys.nirvana.client.nDurableManager.add

(

nDurableAttributes

durableAttributes

)

Creates a durable object on the channel assosiated with the durable manager instance with the given durable attributes.

Creating durables with backing queue is no longer supported from this version.

Parameters

durableAttributes

Attributes describing the durable object to be created.

Returns

The durable instace which was created with the given attributes.

Exceptions

nIllegalStateException	Thrown if the client attempts to create shared durable object with queue support.
nIllegalArgumentException	Thrown when illegal argumets are given - null attributes or unsupported channel types.

delete() [1/2]

void com.pcbsys.nirvana.client.nDurableManager.delete

(

nDurable

durable

)

Deletes the durable object from the channel assosiated with this durable manager instance.

Operation is not supported for shared durables with backed queue.

Parameters

durable

Durable object to be deleted.

Exceptions

nIllegalStateException	Thrown if the client requests to delete not supported durable type.
nIllegalArgumentException	Thrown when illegal argumets are given.

delete() [2/2]

void com.pcbsys.nirvana.client.nDurableManager.delete

(

String

name

)

Deletes the durable object from the channel assosiated with this durable manager instance.

Operation is not supported for shared durables with backed queue.

Parameters

name	Name of the Durable object to be deleted.

Exceptions

nIllegalStateException	Thrown if the client requests to delete not supported durable type.
nIllegalArgumentException	Thrown when illegal argumets are given.

get()

nDurable com.pcbsys.nirvana.client.nDurableManager.get

(

string

name

)

Returns durable object instance for the requested name.

Retrieving shared durable objects with hidden queue is no longer supported from this version on.

Parameters

name	Name of the durable object to be retrieved

Returns

The durable instace retrieved for the given name

Exceptions

nIllegalStateException	Thrown if the client requests to get not supported durable type.
nIllegalArgumentException	Thrown when illegal argumets are given.

getAll()

nDurable[] com.pcbsys.nirvana.client.nDurableManager.getAll

(

)

Returns all durable objects existing on the channel assosiated with this durable manager instance.

Returns

Arrays of durable objects from supported tpes only

unbind()

void com.pcbsys.nirvana.client.nDurableManager.unbind

(

nDurable

durable

)

Unbinds the durable object from the current connection.

Parameters

durable

Durable object requested to be unbound

Exceptions

nIllegalStateException	Thrown if the client requests unbinding for not supported durable type.
nIllegalArgumentException	Thrown when illegal argumets are given.