This class enables the client to perform transactional publishing, representing a nirvana transaction. More...

Public Member Functions
void	Abort () throws nSessionNotConnectedException, nRequestTimedOutException, nChannelNotFoundException, nSecurityException, nUnexpectedResponseException,nSessionPausedException, nTransactionNotStartedException, nTransactionNoSuchTXIDException, nTransactionAlreadyCommittedException, nTransactionAlreadyAbortedException
	Aborts the transaction associated with the txid provided and this channel. More...

void	abort () throws nSessionNotConnectedException, nRequestTimedOutException, nChannelNotFoundException, nSecurityException, nUnexpectedResponseException, nTransactionNotStartedException, nTransactionNoSuchTXIDException, nTransactionAlreadyCommittedException, nSessionPausedException,nTransactionAlreadyAbortedException
	Aborts the transaction associated with the txid provided and this channel. More...

void	Commit () throws nSessionNotConnectedException, nSessionPausedException,nRequestTimedOutException, nTransactionNotStartedException, nUnexpectedResponseException, nChannelNotFoundException, nTransactionNoSuchTXIDException, nSecurityException, nTransactionAlreadyCommittedException, nTransactionAlreadyAbortedException
	Commits the transaction id associated to this channel on the server. More...

void	commit () throws nSessionNotConnectedException,nRequestTimedOutException, nTransactionNotStartedException, nUnexpectedResponseException,nSessionPausedException, nChannelNotFoundException, nTransactionNoSuchTXIDException, nSecurityException, nTransactionAlreadyCommittedException, nTransactionAlreadyAbortedException
	Commits the transaction id associated to this channel on the server. More...

void	Commit (Date timeToPublish) throws nSessionNotConnectedException, nSessionPausedException,nRequestTimedOutException, nTransactionNotStartedException, nUnexpectedResponseException, nChannelNotFoundException, nTransactionNoSuchTXIDException, nSecurityException, nTransactionAlreadyCommittedException, nTransactionAlreadyAbortedException
	Commits the transaction id associated to this channel on the server. More...

void	commit (Date timeToPublish) throws nSessionNotConnectedException, nSessionPausedException,nRequestTimedOutException, nTransactionNotStartedException, nUnexpectedResponseException, nChannelNotFoundException, nTransactionNoSuchTXIDException, nSecurityException, nTransactionAlreadyCommittedException, nTransactionAlreadyAbortedException
	Commits the transaction id associated to this channel on the server. More...

void	Commit (long delay) throws nSessionNotConnectedException, nSessionPausedException,nRequestTimedOutException, nTransactionNotStartedException, nUnexpectedResponseException, nChannelNotFoundException, nTransactionNoSuchTXIDException, nSecurityException, nTransactionAlreadyCommittedException, nTransactionAlreadyAbortedException
	Commits the transaction id associated to this channel on the server. More...

void	commit (long delay) throws nSessionNotConnectedException, nSessionPausedException, nRequestTimedOutException, nTransactionNotStartedException, nUnexpectedResponseException, nChannelNotFoundException, nTransactionNoSuchTXIDException, nSecurityException, nTransactionAlreadyCommittedException, nTransactionAlreadyAbortedException
	Commits the transaction id associated to this channel on the server. More...

nTransactionAttributes	getAttributes ()
	Gets the transaction attributes object associated with this transaction. More...

long	getEndEID () throws nTransactionNotCommittedException
	Gets the end event id of the range to be published by this transaction. More...

long	getStartEID () throws nTransactionNotCommittedException
	Gets the start event id of the range to be published by this transaction. More...

long	getTXID ()
	Gets the end transaction id associated with this transaction. More...

boolean	IsAborted () throws nSessionNotConnectedException, nSessionPausedException, nRequestTimedOutException, nTransactionIncompleteException
	Checks if this transaction is aborted. More...

boolean	isAborted () throws nSessionNotConnectedException, nSessionPausedException,nRequestTimedOutException, nTransactionIncompleteException
	Checks if this transaction is aborted. More...

boolean	IsAborted (boolean forceRemoteCheck) throws nSessionNotConnectedException,nSessionPausedException, nRequestTimedOutException, nTransactionIncompleteException
	Method that checks if this transaction is aborted. More...

boolean	isAborted (boolean forceRemoteCheck) throws nSessionNotConnectedException, nSessionPausedException, nRequestTimedOutException, nTransactionIncompleteException
	Method that checks if this transaction is aborted. More...

boolean	IsCommitted () throws nSessionNotConnectedException, nSessionPausedException, nUnknownTransactionIdException, nRequestTimedOutException, nTransactionIncompleteException
	Checks if this transaction is committed. More...

boolean	isCommitted () throws nSessionNotConnectedException,nSessionPausedException,nUnknownTransactionIdException, nRequestTimedOutException, nTransactionIncompleteException
	Checks if this transaction is committed. More...

boolean	IsCommitted (boolean forceRemoteCheck) throws nSessionNotConnectedException, nSessionPausedException, nUnknownTransactionIdException, nRequestTimedOutException ,nTransactionIncompleteException
	Method that checks if this transaction is committed. More...

boolean	isCommitted (boolean forceRemoteCheck) throws nSessionNotConnectedException, nSessionPausedException, nUnknownTransactionIdException, nRequestTimedOutException, nTransactionIncompleteException
	Method that checks if this transaction is committed. More...

void	publish (nConsumeEvent e) throws nSessionNotConnectedException, nSessionPausedException,nTransactionAlreadyCommittedException, nSecurityException, nTransactionAlreadyAbortedException
	Adds the specified nConsumeEvent to this transaction. More...

void	publish (String tag, Document adom) throws nSessionNotConnectedException, nSessionPausedException,nTransactionAlreadyCommittedException, nSecurityException, nTransactionAlreadyAbortedException
	Adds the specified XML DOM document to this transaction. More...

void	publish (java.util.Vector events) throws nSessionNotConnectedException, nTransactionAlreadyCommittedException, nTransactionNoEventsException, nSecurityException, nSessionPausedException,nTransactionAlreadyAbortedException
	Adds the specified collection of nConsumeEvent objects to this transaction. More...

void	push (nConsumeEvent event) throws nSessionNotConnectedException, nSessionPausedException,nTransactionAlreadyCommittedException, nTransactionNoEventsException, nSecurityException, nTransactionAlreadyAbortedException
	Pushes the specified nConsumeEvent to this transaction. More...

Static Public Member Functions
static boolean	IsAborted (nAbstractChannel chan, long txid) throws nSessionNotConnectedException, nSessionPausedException,nRequestTimedOutException, nTransactionException
	Static method that checks if a transaction is aborted. More...

static boolean	IsCommitted (nAbstractChannel chan, long txid) throws nSessionNotConnectedException, nSessionPausedException,nRequestTimedOutException, nTransactionException
	Static method that checks if a transaction is committed. More...

Detailed Description

This class enables the client to perform transactional publishing, representing a nirvana transaction.

Member Function Documentation

void com.pcbsys.nirvana.client.nTransaction.Abort ( ) throws nSessionNotConnectedException, nRequestTimedOutException, nChannelNotFoundException, nSecurityException, nUnexpectedResponseException,nSessionPausedException, nTransactionNotStartedException, nTransactionNoSuchTXIDException, nTransactionAlreadyCommittedException, nTransactionAlreadyAbortedException

Aborts the transaction associated with the txid provided and this channel.

Deprecated:: As of version 2.0 use the corresponding abort()

Exceptions

nSessionNotConnectedException	The session is not currently conencted to the server when this call was made
nRequestTimedOutException	The server did not respond within the timeout peroid
nChannelNotFoundException	The channel, typically, has been deleted
nSecurityException	The client does not have permissions to perform this operation
nUnexpectedResponseException	The server responded with with an unknown response, see the message for more information
nTransactionNotStartedException	The transaction has not been started
nTransactionNoSuchTXIDException	There is no known TXID, typically the transaction has timed out
nTransactionAlreadyCommittedException	The transaction has already been committed
nTransactionAlreadyAbortedException	The transaction has already been aborted
nSessionPausedException	The session is currently paused

void com.pcbsys.nirvana.client.nTransaction.abort ( ) throws nSessionNotConnectedException, nRequestTimedOutException, nChannelNotFoundException, nSecurityException, nUnexpectedResponseException, nTransactionNotStartedException, nTransactionNoSuchTXIDException, nTransactionAlreadyCommittedException, nSessionPausedException,nTransactionAlreadyAbortedException

Aborts the transaction associated with the txid provided and this channel.

Exceptions

nSessionNotConnectedException	The session is not currently conencted to the server when this call was made
nRequestTimedOutException	The server did not respond within the timeout peroid
nChannelNotFoundException	The channel, typically, has been deleted
nSecurityException	The client does not have permissions to perform this operation
nUnexpectedResponseException	The server responded with with an unknown response, see the message for more information
nTransactionNotStartedException	The transaction has not been started
nTransactionNoSuchTXIDException	There is no known TXID, typically the transaction has timed out
nTransactionAlreadyCommittedException	The transaction has already been committed
nTransactionAlreadyAbortedException	The transaction has already been aborted
nSessionPausedException	The session is currently paused

void com.pcbsys.nirvana.client.nTransaction.Commit ( ) throws nSessionNotConnectedException, nSessionPausedException,nRequestTimedOutException, nTransactionNotStartedException, nUnexpectedResponseException, nChannelNotFoundException, nTransactionNoSuchTXIDException, nSecurityException, nTransactionAlreadyCommittedException, nTransactionAlreadyAbortedException

Commits the transaction id associated to this channel on the server.

        <p/>
        We then wait for the server to respond.  The server responds with the
        EID's of the events that have been put on to this channel for the
        supplied transaction id.  Once this process is complete we remove the
        supplied transaction id from the list of transactions found within the
        controlling nSession.

Exceptions

nSessionNotConnectedException	The session is not currently conencted to the server when this call was made
nRequestTimedOutException	The server did not respond within the timeout peroid
nChannelNotFoundException	The channel, typically, has been deleted
nSecurityException	The client does not have permissions to perform this operation
nUnexpectedResponseException	The server responded with with an unknown response, see the message for more information
nTransactionNotStartedException	The transaction has not been started
nTransactionNoSuchTXIDException	There is no known TXID, typically the transaction has timed out
nTransactionAlreadyCommittedException	The transaction has already been committed
nTransactionAlreadyAbortedException	The transaction has already been aborted
nSessionPausedException	The session is currently paused

Deprecated:: As of version 2.0 use the corresponding commit()

void com.pcbsys.nirvana.client.nTransaction.commit ( ) throws nSessionNotConnectedException,nRequestTimedOutException, nTransactionNotStartedException, nUnexpectedResponseException,nSessionPausedException, nChannelNotFoundException, nTransactionNoSuchTXIDException, nSecurityException, nTransactionAlreadyCommittedException, nTransactionAlreadyAbortedException

Commits the transaction id associated to this channel on the server.

We then wait for the server to respond. The server responds with the EID's of the events that have been put on to this channel for the supplied transaction id. Once this process is complete we remove the supplied transaction id from the list of transactions found within the controlling nSession.

Exceptions

nSessionNotConnectedException	The session is not currently conencted to the server when this call was made
nRequestTimedOutException	The server did not respond within the timeout peroid
nChannelNotFoundException	The channel, typically, has been deleted
nSecurityException	The client does not have permissions to perform this operation
nUnexpectedResponseException	The server responded with with an unknown response, see the message for more information
nTransactionNotStartedException	The transaction has not been started
nTransactionNoSuchTXIDException	There is no known TXID, typically the transaction has timed out
nTransactionAlreadyCommittedException	The transaction has already been committed
nTransactionAlreadyAbortedException	The transaction has already been aborted
nSessionPausedException	The session is currently paused

void com.pcbsys.nirvana.client.nTransaction.Commit ( Date timeToPublish ) throws nSessionNotConnectedException, nSessionPausedException,nRequestTimedOutException, nTransactionNotStartedException, nUnexpectedResponseException, nChannelNotFoundException, nTransactionNoSuchTXIDException, nSecurityException, nTransactionAlreadyCommittedException, nTransactionAlreadyAbortedException

Commits the transaction id associated to this channel on the server.

        <p/>
        We then wait for the server to respond.  The server responds with the
        EID's of the events that have been put on to this channel for the
        supplied transaction id.  Once this process is complete we remove the
        supplied transaction id from the list of transactions found within the
        controlling nSession.

Deprecated:: As of version 2.0 use the corresponding commit(Date timeToPublish)

Parameters

timeToPublish date at which the transaction will be committed

Exceptions

nSessionNotConnectedException	The session is not currently conencted to the server when this call was made
nRequestTimedOutException	The server did not respond within the timeout peroid
nChannelNotFoundException	The channel, typically, has been deleted
nSecurityException	The client does not have permissions to perform this operation
nUnexpectedResponseException	The server responded with with an unknown response, see the message for more information
nTransactionNotStartedException	The transaction has not been started
nTransactionNoSuchTXIDException	There is no known TXID, typically the transaction has timed out
nTransactionAlreadyCommittedException	The transaction has already been committed
nTransactionAlreadyAbortedException	The transaction has already been aborted
nSessionPausedException	The session is currently paused

void com.pcbsys.nirvana.client.nTransaction.commit ( Date timeToPublish ) throws nSessionNotConnectedException, nSessionPausedException,nRequestTimedOutException, nTransactionNotStartedException, nUnexpectedResponseException, nChannelNotFoundException, nTransactionNoSuchTXIDException, nSecurityException, nTransactionAlreadyCommittedException, nTransactionAlreadyAbortedException

Commits the transaction id associated to this channel on the server.

This methos allows the transaction to be committed at a future date, rather than immediately.

We then wait for the server to respond. The server responds with the EID's of the events that have been put on to this channel for the supplied transaction id. Once this process is complete we remove the supplied transaction id from the list of transactions found within the controlling nSession.

Parameters

timeToPublish date at which the transaction will be committed

Exceptions

nSessionNotConnectedException	The session is not currently conencted to the server when this call was made
nRequestTimedOutException	The server did not respond within the timeout peroid
nChannelNotFoundException	The channel, typically, has been deleted
nSecurityException	The client does not have permissions to perform this operation
nUnexpectedResponseException	The server responded with with an unknown response, see the message for more information
nTransactionNotStartedException	The transaction has not been started
nTransactionNoSuchTXIDException	There is no known TXID, typically the transaction has timed out
nTransactionAlreadyCommittedException	The transaction has already been committed
nTransactionAlreadyAbortedException	The transaction has already been aborted
nSessionPausedException	The session is currently paused

void com.pcbsys.nirvana.client.nTransaction.Commit ( long delay ) throws nSessionNotConnectedException, nSessionPausedException,nRequestTimedOutException, nTransactionNotStartedException, nUnexpectedResponseException, nChannelNotFoundException, nTransactionNoSuchTXIDException, nSecurityException, nTransactionAlreadyCommittedException, nTransactionAlreadyAbortedException

Commits the transaction id associated to this channel on the server.

        <p/>
        We then wait for the server to respond.  The server responds with the
        EID's of the events that have been put on to this channel for the
        supplied transaction id.  Once this process is complete we remove the
        supplied transaction id from the list of transactions found within the
        controlling nSession.

Deprecated:: As of version 2.0 use the corresponding commit(Date timeToPublish)

Parameters

delay - the number of millseconds to delay the commit for at the server

Exceptions

nSessionNotConnectedException	The session is not currently conencted to the server when this call was made
nRequestTimedOutException	The server did not respond within the timeout peroid
nChannelNotFoundException	The channel, typically, has been deleted
nSecurityException	The client does not have permissions to perform this operation
nUnexpectedResponseException	The server responded with with an unknown response, see the message for more information
nTransactionNotStartedException	The transaction has not been started
nTransactionNoSuchTXIDException	There is no known TXID, typically the transaction has timed out
nTransactionAlreadyCommittedException	The transaction has already been committed
nTransactionAlreadyAbortedException	The transaction has already been aborted
nSessionPausedException	The session is currently paused

void com.pcbsys.nirvana.client.nTransaction.commit ( long delay ) throws nSessionNotConnectedException, nSessionPausedException, nRequestTimedOutException, nTransactionNotStartedException, nUnexpectedResponseException, nChannelNotFoundException, nTransactionNoSuchTXIDException, nSecurityException, nTransactionAlreadyCommittedException, nTransactionAlreadyAbortedException

Commits the transaction id associated to this channel on the server.

This method allows the transaction to be delayed until t+delay before it is committed

We then wait for the server to respond. The server responds with the EID's of the events that have been put on to this channel for the supplied transaction id. Once this process is complete we remove the supplied transaction id from the list of transactions found within the controlling nSession.

Parameters

delay - the number of millseconds to delay the commit for at the server

Exceptions

nSessionNotConnectedException	The session is not currently conencted to the server when this call was made
nRequestTimedOutException	The server did not respond within the timeout peroid
nChannelNotFoundException	The channel, typically, has been deleted
nSecurityException	The client does not have permissions to perform this operation
nUnexpectedResponseException	The server responded with with an unknown response, see the message for more information
nTransactionNotStartedException	The transaction has not been started
nTransactionNoSuchTXIDException	There is no known TXID, typically the transaction has timed out
nTransactionAlreadyCommittedException	The transaction has already been committed
nTransactionAlreadyAbortedException	The transaction has already been aborted
nSessionPausedException	The session is currently paused

nTransactionAttributes com.pcbsys.nirvana.client.nTransaction.getAttributes ( )

Gets the transaction attributes object associated with this transaction.

Returns: a nTransactionAttributes object with the attributes for this transaction

long com.pcbsys.nirvana.client.nTransaction.getEndEID ( ) throws nTransactionNotCommittedException

Gets the end event id of the range to be published by this transaction.

Returns: a long specifying the end event id of the range to be published by this transaction

Exceptions

nTransactionNotCommittedException is thrown if the transaction is not yet commited

long com.pcbsys.nirvana.client.nTransaction.getStartEID ( ) throws nTransactionNotCommittedException

Gets the start event id of the range to be published by this transaction.

Returns: a long specifying the start event id of the range to be published by this transaction

Exceptions

nTransactionNotCommittedException is thrown if the transaction is not yet commited

long com.pcbsys.nirvana.client.nTransaction.getTXID ( )

Gets the end transaction id associated with this transaction.

Returns: a long specifying the transaction ID

boolean com.pcbsys.nirvana.client.nTransaction.IsAborted ( ) throws nSessionNotConnectedException, nSessionPausedException, nRequestTimedOutException, nTransactionIncompleteException

Checks if this transaction is aborted.

Deprecated:: As of version 2.0 use the corresponding isAborted()

Returns: a boolean value specifying if this transaction has been aborted

Exceptions

nSessionNotConnectedException	The session is not currently conencted to the server when this call was made
nRequestTimedOutException	The server did not respond within the timeout peroid
nSessionPausedException	The session is currently paused
nTransactionIncompleteException	the transaction is invalild or incomplete

boolean com.pcbsys.nirvana.client.nTransaction.isAborted ( ) throws nSessionNotConnectedException, nSessionPausedException,nRequestTimedOutException, nTransactionIncompleteException

Checks if this transaction is aborted.

Returns: a boolean value specifying if this transaction has been aborted

Exceptions

nSessionNotConnectedException	The session is not currently conencted to the server when this call was made
nRequestTimedOutException	The server did not respond within the timeout peroid
nSessionPausedException	The session is currently paused
nTransactionIncompleteException	the transaction is invalild or incomplete

boolean com.pcbsys.nirvana.client.nTransaction.IsAborted ( boolean forceRemoteCheck ) throws nSessionNotConnectedException,nSessionPausedException, nRequestTimedOutException, nTransactionIncompleteException

Method that checks if this transaction is aborted.

Deprecated:: As of version 2.0 use the corresponding isAborted(forecRemoteCheck)

Parameters

forceRemoteCheck if false, the transaction will check its local state first before checking with the realm server, if true, it will check with the realm server only

Returns: a boolean value specifying if the transaction has been aborted

Exceptions

nSessionNotConnectedException	The session is not currently conencted to the server when this call was made
nRequestTimedOutException	The server did not respond within the timeout peroid
nSessionPausedException	The session is currently paused
nTransactionIncompleteException	the transaction is invalild or incomplete

boolean com.pcbsys.nirvana.client.nTransaction.isAborted ( boolean forceRemoteCheck ) throws nSessionNotConnectedException, nSessionPausedException, nRequestTimedOutException, nTransactionIncompleteException

Method that checks if this transaction is aborted.

Parameters

forceRemoteCheck if false, the transaction will check its local state first before checking with the realm server, if true, it will check with the realm server only

Returns: a boolean value specifying if the transaction has been aborted

Exceptions

nSessionNotConnectedException	The session is not currently conencted to the server when this call was made
nRequestTimedOutException	The server did not respond within the timeout peroid
nSessionPausedException	The session is currently paused
nTransactionIncompleteException	the transaction is invalild or incomplete

static boolean com.pcbsys.nirvana.client.nTransaction.IsAborted	(	nAbstractChannel	chan,
		long	txid
	)		throws nSessionNotConnectedException, nSessionPausedException,nRequestTimedOutException, nTransactionException

static

Static method that checks if a transaction is aborted.

Deprecated:: As of version 2.0 use the corresponding nTransaction(nTransactionAttributes, txid)

Parameters

chan	the channel associated with the transaction
txid	the transaction id of the transaction you want to check on the server

Returns: a boolean value specifying if the transaction has been aborted

Exceptions

nSessionNotConnectedException	The session is not currently conencted to the server when this call was made
nRequestTimedOutException	The server did not respond within the timeout peroid
nSessionPausedException	The session is currently paused
nTransactionException

boolean com.pcbsys.nirvana.client.nTransaction.IsCommitted ( ) throws nSessionNotConnectedException, nSessionPausedException, nUnknownTransactionIdException, nRequestTimedOutException, nTransactionIncompleteException

Checks if this transaction is committed.

Deprecated:: As of version 2.0 use the corresponding isCommitted()

Returns: a boolean value specifying if this transaction has been committed

Exceptions

nSessionNotConnectedException	The session is not currently conencted to the server when this call was made
nRequestTimedOutException	The server did not respond within the timeout peroid
nSessionPausedException	The session is currently paused
nTransactionIncompleteException	the transaction is invalild or incomplete
nUnknownTransactionIdException	the transaction id is not known on this server

boolean com.pcbsys.nirvana.client.nTransaction.isCommitted ( ) throws nSessionNotConnectedException,nSessionPausedException,nUnknownTransactionIdException, nRequestTimedOutException, nTransactionIncompleteException

Checks if this transaction is committed.

Returns: a boolean value specifying if this transaction has been committed

Exceptions

nSessionNotConnectedException	The session is not currently conencted to the server when this call was made
nRequestTimedOutException	The server did not respond within the timeout peroid
nSessionPausedException	The session is currently paused
nTransactionIncompleteException	the transaction is invalild or incomplete
nUnknownTransactionIdException	the transaction id is not known on this server

boolean com.pcbsys.nirvana.client.nTransaction.IsCommitted ( boolean forceRemoteCheck ) throws nSessionNotConnectedException, nSessionPausedException, nUnknownTransactionIdException, nRequestTimedOutException ,nTransactionIncompleteException

Method that checks if this transaction is committed.

Deprecated:: As of version 2.0 use the corresponding isCommitted(forceRemoteCheck)

Parameters

forceRemoteCheck if false, the transaction will check its local state first before checking with the realms server, if true, it will check with the realm server only

Returns: a boolean value specifying if the transaction has been committed

Exceptions

nSessionNotConnectedException	The session is not currently conencted to the server when this call was made
nRequestTimedOutException	The server did not respond within the timeout peroid
nSessionPausedException	The session is currently paused
nTransactionIncompleteException	the transaction is invalild or incomplete
nUnknownTransactionIdException	the transaction id is not known on this server

boolean com.pcbsys.nirvana.client.nTransaction.isCommitted ( boolean forceRemoteCheck ) throws nSessionNotConnectedException, nSessionPausedException, nUnknownTransactionIdException, nRequestTimedOutException, nTransactionIncompleteException

Method that checks if this transaction is committed.

Parameters

forceRemoteCheck if false, the transaction will check its local state first before checking with the realms server, if true, it will check with the realm server only

Returns: a boolean value specifying if the transaction has been committed

Exceptions

nSessionNotConnectedException	The session is not currently conencted to the server when this call was made
nRequestTimedOutException	The server did not respond within the timeout peroid
nSessionPausedException	The session is currently paused
nTransactionIncompleteException	the transaction is invalild or incomplete
nUnknownTransactionIdException	the transaction id is not known on this server

static boolean com.pcbsys.nirvana.client.nTransaction.IsCommitted	(	nAbstractChannel	chan,
		long	txid
	)		throws nSessionNotConnectedException, nSessionPausedException,nRequestTimedOutException, nTransactionException

static

Static method that checks if a transaction is committed.

Deprecated:: As of version 2.0 use the corresponding nTransaction(nTransactionAttributes, txId)

Parameters

chan	the channel associated with the transaction
txid	the transaction id of the transaction you want to check on the server

Returns: a boolean value specifying if the transaction has been committed

Exceptions

nSessionNotConnectedException	The session is not currently conencted to the server when this call was made
nRequestTimedOutException	The server did not respond within the timeout peroid
nSessionPausedException	The session is currently paused
nTransactionException

void com.pcbsys.nirvana.client.nTransaction.publish ( nConsumeEvent e ) throws nSessionNotConnectedException, nSessionPausedException,nTransactionAlreadyCommittedException, nSecurityException, nTransactionAlreadyAbortedException

Adds the specified nConsumeEvent to this transaction.

No events will be published until this transaction is commited

Parameters

e	the nConsumeEvent object to be added to this transaction

Exceptions

nSessionNotConnectedException	The session is not currently conencted to the server when this call was made
nSecurityException	The client does not have permissions to perform this operation
nTransactionAlreadyCommittedException	The transaction has already been committed
nTransactionAlreadyAbortedException	The transaction has already been aborted
nSessionPausedException	The session is currently paused

void com.pcbsys.nirvana.client.nTransaction.publish	(	String	tag,
		Document	adom
	)		throws nSessionNotConnectedException, nSessionPausedException,nTransactionAlreadyCommittedException, nSecurityException, nTransactionAlreadyAbortedException

Adds the specified XML DOM document to this transaction.

No events will be published until this transaction is commited

Parameters

tag	a string specifying the event tag to be used
adom	an XML DOM document object specifying the XML document to be added to this transaction

Exceptions

nSessionNotConnectedException	The session is not currently conencted to the server when this call was made
nSecurityException	The client does not have permissions to perform this operation
nTransactionAlreadyCommittedException	The transaction has already been committed
nTransactionAlreadyAbortedException	The transaction has already been aborted
nSessionPausedException	The session is currently paused

void com.pcbsys.nirvana.client.nTransaction.publish ( java.util.Vector events ) throws nSessionNotConnectedException, nTransactionAlreadyCommittedException, nTransactionNoEventsException, nSecurityException, nSessionPausedException,nTransactionAlreadyAbortedException

Adds the specified collection of nConsumeEvent objects to this transaction.

No events will be published until this transaction is commited.

Parameters

events the Vector collection of nConsumeEvent objects to be added to this transaction

Exceptions

nSessionNotConnectedException	The session is not currently conencted to the server when this call was made
nSecurityException	The client does not have permissions to perform this operation
nTransactionAlreadyCommittedException	The transaction has already been committed
nTransactionAlreadyAbortedException	The transaction has already been aborted
nTransactionNoEventsException	There are no nConsumeEvents in the vector
nSessionPausedException	The session is currently paused

void com.pcbsys.nirvana.client.nTransaction.push ( nConsumeEvent event ) throws nSessionNotConnectedException, nSessionPausedException,nTransactionAlreadyCommittedException, nTransactionNoEventsException, nSecurityException, nTransactionAlreadyAbortedException

Pushes the specified nConsumeEvent to this transaction.

No events will be published until this transaction is commited

Parameters

event the nConsumeEvent object to be added to this transaction

Exceptions

nSessionNotConnectedException	is thrown if the session is not connected
nTransactionAlreadyCommittedException	is thrown if the transaction is already commited
nTransactionNoEventsException	is thrown if the transaction has no events pushed
nSecurityException	is thrown if the user has insufficient priviledges
nTransactionAlreadyAbortedException	is thrown if the transaction has been aborted.
nSessionPausedException	The session is currently paused

Public Member Functions

Static Public Member Functions

Detailed Description

Member Function Documentation