org.eclipse.keyple.calypso.transaction

Class PoSelection

java.lang.Object

org.eclipse.keyple.core.card.selection.AbstractCardSelection<AbstractPoCommandBuilder<? extends AbstractPoResponseParser>>

org.eclipse.keyple.calypso.transaction.PoSelection

public class PoSelection
extends org.eclipse.keyple.core.card.selection.AbstractCardSelection<AbstractPoCommandBuilder<? extends AbstractPoResponseParser>>

This service extends AbstractCardSelection to manage specific features of Calypso POs during the selection step.

The prefixed "prepare" methods allow to feed the global selection process by sending APDU orders to the PO after the card selection. These APUDs will be sent to the PO in the order in which they were prepared.

The parse method creates a CalypsoPo from the CardSelectionResponse received.

Since:

0.9

Field Summary

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

cardSelector

Constructor Summary

Constructors

Constructor and Description
PoSelection(PoSelector poSelector) Constructor.

Method Summary

Modifier and Type	Method and Description
protected CalypsoPo	parse(org.eclipse.keyple.core.card.message.CardSelectionResponse cardSelectionResponse) Parses the provided CardSelectionResponse and create a CalypsoPo object.
void	prepareReadRecordFile(byte sfi, int recordNumber) Adds a command APDU to read a single record from the indicated EF.
void	prepareSelectFile(byte[] lid) Adds a command APDU to select file with an LID provided as a 2-byte byte array.
void	prepareSelectFile(SelectFileControl selectControl) Adds a command APDU to select file according to the provided SelectFileControl enum entry indicating the navigation case: FIRST, NEXT or CURRENT.
void	prepareSelectFile(short lid) Adds a command APDU to select file with an LID provided as a short.

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

PoSelection

public PoSelection(PoSelector poSelector)

Constructor.

The PoSelector provided contains the selection data to target a particular PO.

Parameters:

poSelector - A reference to a PoSelector

Since:

0.9

Method Detail

prepareReadRecordFile

public final void prepareReadRecordFile(byte sfi,
                                        int recordNumber)

Adds a command APDU to read a single record from the indicated EF.

Parameters:

sfi - the SFI of the EF to read

recordNumber - the record number to read

Throws:

java.lang.IllegalArgumentException - if one of the provided argument is out of range

Since:

0.9

prepareSelectFile

public void prepareSelectFile(byte[] lid)

Adds a command APDU to select file with an LID provided as a 2-byte byte array.

Parameters:

lid - LID of the EF to select as a byte array

Throws:

java.lang.IllegalArgumentException - if the argument is not an array of 2 bytes

Since:

0.9

prepareSelectFile

public void prepareSelectFile(short lid)

Adds a command APDU to select file with an LID provided as a short.

Parameters:

lid - A short

Since:

0.9

prepareSelectFile

public void prepareSelectFile(SelectFileControl selectControl)

Adds a command APDU to select file according to the provided SelectFileControl enum entry indicating the navigation case: FIRST, NEXT or CURRENT.

Parameters:

selectControl - A SelectFileControl enum entry

Since:

0.9

parse

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

Parses the provided CardSelectionResponse and create a CalypsoPo object.

The CalypsoPo is filled with the PO identification data from the FCI and the possible responses to additional APDU commands executed after the selection.

Specified by:

parse in class org.eclipse.keyple.core.card.selection.AbstractCardSelection<AbstractPoCommandBuilder<? extends AbstractPoResponseParser>>

Parameters:

cardSelectionResponse - A reference to a CardSelectionResponse

Returns:

A new CalypsoPo

Throws:

CalypsoDesynchronizedExchangesException - if the number of responses is different from the number of requests

CalypsoPoCommandException - if a response from the PO was unexpected