org.eclipse.keyple.calypso.transaction

Class SamSelection

java.lang.Object

org.eclipse.keyple.core.card.selection.AbstractCardSelection<AbstractSamCommandBuilder<? extends AbstractSamResponseParser>>

org.eclipse.keyple.calypso.transaction.SamSelection

public class SamSelection
extends org.eclipse.keyple.core.card.selection.AbstractCardSelection<AbstractSamCommandBuilder<? extends AbstractSamResponseParser>>

Specialized selection request to manage the specific characteristics of Calypso SAMs
Beyond the creation of a CalypsoSam object, this class also allows to execute a command to Unlock the SAM if unlockData are present in the SamSelector.
This unlock command is currently the only one allowed during the SAM selection process.

Since:

0.9

Field Summary

Fields inherited from class org.eclipse.keyple.core.card.selection.AbstractCardSelection

cardSelector

Constructor Summary

Constructors

Constructor and Description
SamSelection(SamSelector samSelector) Create a SamSelection

Method Summary

Modifier and Type	Method and Description
protected CalypsoSam	parse(org.eclipse.keyple.core.card.message.CardSelectionResponse cardSelectionResponse) Create a CalypsoSam object containing the selection data received from the plugin If an Unlock command has been prepared, its status is checked.

Methods inherited from class org.eclipse.keyple.core.card.selection.AbstractCardSelection

addCommandBuilder, getCardSelector, getCommandBuilders

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SamSelection

public SamSelection(SamSelector samSelector)

Create a SamSelection

Parameters:

samSelector - the SAM selector

Since:

0.9

Method Detail

parse

protected CalypsoSam parse(org.eclipse.keyple.core.card.message.CardSelectionResponse cardSelectionResponse)

Create a CalypsoSam object containing the selection data received from the plugin
If an Unlock command has been prepared, its status is checked.

Specified by:

parse in class org.eclipse.keyple.core.card.selection.AbstractCardSelection<AbstractSamCommandBuilder<? extends AbstractSamResponseParser>>

Parameters:

cardSelectionResponse - the card response received

Returns:

a CalypsoSam

Throws:

CalypsoDesynchronizedExchangesException - if the APDU SAM exchanges are out of sync

CalypsoSamCommandException - if the SAM has responded with an error status

Since:

0.9