Package org.eclipse.keypop.calypso.card.transaction

Interface SecureTransactionManager<T extends SecureTransactionManager<T>>

Type Parameters:

T - The type of the lowest level child object.

All Superinterfaces:

TransactionManager<T>

All Known Subinterfaces:

SecureExtendedModeTransactionManager, SecureRegularModeTransactionManager, SecureSymmetricCryptoTransactionManager<T>

public interface SecureTransactionManager<T extends SecureTransactionManager<T>>
extends TransactionManager<T>

Contains operations common to all card transactions secured by cryptographic algorithms.

See TransactionManager parent interface for more information and details of others available card operations.

Since:

2.0.0

Method Summary

Modifier and Type	Method	Description
<E extends CardTransactionCryptoExtension> E	getCryptoExtension(java.lang.Class<E> cryptoExtensionClass)	Returns the associated CardTransactionCryptoExtension instance.
T	prepareCancelSecureSession()	Schedules the execution of a special "Close Secure Session" command in order to abort the current secure session.
T	prepareCloseSecureSession()	Schedules the execution of a "Close Secure Session" command.

Methods inherited from interface org.eclipse.keypop.calypso.card.transaction.TransactionManager

getTransactionAuditData, prepareAppendRecord, prepareChangePin, prepareCheckPinStatus, prepareDecreaseCounter, prepareDecreaseCounters, prepareGetData, prepareIncreaseCounter, prepareIncreaseCounters, prepareReadBinary, prepareReadCounter, prepareReadRecord, prepareReadRecords, prepareReadRecordsPartially, prepareSearchRecords, prepareSelectFile, prepareSelectFile, prepareSetCounter, prepareSvReadAllLogs, prepareUpdateBinary, prepareUpdateRecord, prepareVerifyPin, prepareWriteBinary, prepareWriteRecord, processCommands

Method Detail

getCryptoExtension

<E extends CardTransactionCryptoExtension> E getCryptoExtension(java.lang.Class<E> cryptoExtensionClass)

Returns the associated CardTransactionCryptoExtension instance.

Type Parameters:

E - The generic type of the expected crypto extension.

Parameters:

cryptoExtensionClass - The class of the crypto extension.

Returns:

A non-null CardTransactionCryptoExtension.

Throws:

java.lang.IllegalArgumentException - If the provided class is null.

Since:

2.0.0

prepareCloseSecureSession

T prepareCloseSecureSession()

Schedules the execution of a "Close Secure Session" command.

The ratification mechanism is disabled by default but can be enabled via the SymmetricCryptoSecuritySetting.enableRatificationMechanism() method.

In this case, a ratification command is added after the "Close Secure Session" command when the communication is done in contactless mode.

Returns:

The current instance.

Throws:

java.lang.IllegalStateException - In the following cases:

• No secure session is opened and no secure session opening is prepared
• A secure session closing is already prepared
• A secure session canceling is prepared

Since:

1.6.0

prepareCancelSecureSession

T prepareCancelSecureSession()

Schedules the execution of a special "Close Secure Session" command in order to abort the current secure session.

This command will be executed in safe mode and will not raise any exceptions.

Returns:

The current instance.

Since:

1.6.0