com.hidglobal.ia.service.transaction

Interface TransactionInfo

public interface TransactionInfo

Method Summary

Modifier and Type	Method and Description
Container	getContainer() Retrieves the container associated with that transaction.
Transaction	getTransaction(char[] sessionPassword, Parameter[] params) Retrieves a transaction associated with that transaction info.
Key	getTransactionProtectionKey() Retrieves the transaction protection key associated with that transaction.
String	getUniqueIdentifier() Retrieves the transaction unique identifier.

Method Detail

getContainer

Container getContainer()

Retrieves the container associated with that transaction.

Returns:

the container.

getTransactionProtectionKey

Key getTransactionProtectionKey()

Retrieves the transaction protection key associated with that transaction.

Returns:

The container.

getUniqueIdentifier

String getUniqueIdentifier()

Retrieves the transaction unique identifier.

Returns:

unique identifier.

getTransaction

Transaction getTransaction(char[] sessionPassword,
                           Parameter[] params)
                    throws AuthenticationException,
                           RemoteException,
                           UnsupportedDeviceException,
                           PasswordExpiredException,
                           LostCredentialsException,
                           InternalException,
                           InvalidPasswordException,
                           TransactionContainerInvalidException,
                           TransactionExpiredException,
                           ServerOperationFailedException

Retrieves a transaction associated with that transaction info.

Parameters:

sessionPassword - transaction protection key password (can be null if not required by the policy)

params - array of Parameter objects required to retrieve the transaction.

Returns:

a Transaction (Transaction) instance containing transaction details.

Throws:

AuthenticationException - if password is incorrect.

RemoteException - if server responds with any other error.

UnsupportedDeviceException - if device is not supported by policy.

PasswordExpiredException - if expired password is given (changePassword required).

LostCredentialsException - if provisioning key data has been corrupted or lost.

InternalException - if an unexpected error occurred.

InvalidPasswordException - if password validation fails.

TransactionContainerInvalidException - if the transaction id refers to a container that does not exist.

TransactionExpiredException - if transaction has expired.

ServerOperationFailedException - if the server encounters a failure for the operation requested.