<HIDTransaction> Protocol Reference

Encapsulates a transaction and exposes an API to apply an action status. More...

#import <HIDTransaction.h>

Inheritance diagram for <HIDTransaction>:

Instance Methods
(NSString *)	- getAction:
	Returns the nature of the action. More...
(NSArray *)	- getAllowedStatuses
	Returns a list of status (for instance "accept", "deny", "report") that can be set for that transaction. More...
(NSDate *)	- getDate:
	Gets status change date for the transaction. More...
(NSDate *)	- getExpiryDate:
	Returns Retrieves the expiration date associated with requested action. More...
(id< HIDKey >)	- getSigningKey:
	Gets the Signing Key object associated with that transaction. More...
(NSString *)	- getStatus:
	Returns the status of the transaction. More...
(BOOL)	- setStatus:withSigningPassword:withSessionPassword:withParams:error:
	Communicates the status of this transaction. More...
(NSString *)	- toString
	Returns the transaction text to be displayed to the user. More...
Instance Methods inherited from <HIDServerAction>
(NSString *)	- getPayload:
	Returns an optional payload related to the request action. More...

Detailed Description

Encapsulates a transaction and exposes an API to apply an action status.

Method Documentation

- (NSString*) getAction:

(NSError **)

error

Returns the nature of the action.

Parameters

error

error details. It may be nil.

Possible error codes are:

• HIDInternal if unexpected error occurred.

Returns

the nature of the action, nil if not set yet or an error occurs.

Reimplemented from <HIDServerAction>.

- (NSArray*) getAllowedStatuses

Returns a list of status (for instance "accept", "deny", "report") that can be set for that transaction.

Returns

the NSString array contains the possible status values to be used with setStatus.

See also

- setStatus:withSigningPassword:withSessionPassword:withParams:error:

The values are retrieved from the transaction response message sent back by the server. The returned names can be used by the calling application to look up the corresponding value in a name/value pair resource file for customization/localization of displayed text to user.

- (NSDate*) getDate:

(NSError **)

error

Gets status change date for the transaction.

Parameters

error

error details. It may be nil.

Possible error codes are:

• HIDInternal if unexpected error occurred.
• HIDNotImplemented if not implemented

Returns

the date, nil if not set yet or an error occurs.

Reimplemented from <HIDServerAction>.

- (NSDate*) getExpiryDate:

(NSError **)

error

Returns Retrieves the expiration date associated with requested action.

Parameters

error

error details. It may be nil.

Possible error codes are:

• HIDInternal if unexpected error occurred.
• HIDNotImplemented if not implemented

Returns

the date, nil if not set yet or an error occurs.

Reimplemented from <HIDServerAction>.

- (id<HIDKey>) getSigningKey:

(NSError **)

error

Gets the Signing Key object associated with that transaction.

Parameters

error

error details. It may be nil.

Possible error codes are:

• HIDInternal if unexpected error occurred.

Returns

the key, nil if an error occurs.

- (NSString*) getStatus:

(NSError **)

error

Returns the status of the transaction.

Parameters

error

error details. It may be nil.

Possible error codes are:

• HIDInternal if unexpected error occurred.
• HIDNotImplemented if not implemented

Returns

the status of the transaction, nil if not set yet or an error occurs.

- (BOOL) setStatus:		(NSString *)	status
withSigningPassword:		(NSString *)	signPassword
withSessionPassword:		(NSString *)	sessionPassword
withParams:		(NSArray *)	parameters
error:		(NSError **)	error

Communicates the status of this transaction.

Parameters

status

status to apply to transaction with signature.

The status must be one of the statuses returned by the getAllowedStatuses method.

Parameters

signPassword	the password protecting the signature key. (can be nil if not required by the policy)
sessionPassword	transaction protection key password (can be nil if not required by the policy)
parameters	reserved for future use
error	error details. It may be nil.

Possible error codes are:

• HIDAuthentication if password is incorrect.
• HIDTransactionExpired if transaction is no longer valid
• HIDCredentialsExpired if key is no longer valid
• HIDInternal if unexpected error occurred.
• HIDPasswordExpired if expired password is given (changePassword required).
• HIDServerAuthentication if server rejects authentication
• HIDInvalidArgument if the given parameters are invalid or required parameters are missing.

Returns

boolean true if successful.

See also

- findKeys:error: (HIDContainer-p)

#HIDServerAction.getProtectionKey

#HIDTransaction.getSigningKey

- (NSString*) toString

Returns the transaction text to be displayed to the user.

Returns

Transaction text string.

Reimplemented from <HIDServerAction>.