org.eclipse.keyple.core.card.selection

Class AbstractCardSelection<T extends AbstractApduCommandBuilder>

java.lang.Object

org.eclipse.keyple.core.card.selection.AbstractCardSelection<T>

public abstract class AbstractCardSelection<T extends AbstractApduCommandBuilder>
extends java.lang.Object

This class provide means to create a CardSelectionRequest and analyse its result.

It embeds a CardSelector provided at construction and offers methods to manage additional APDU command builders.
The resulting CardSelectionRequest will be used as a selection case in the general selection process implemented in CardSelectionsService.

This class can also be extended to add specific features to a family of cards and create specific instances of AbstractSmartCard in return for the parse method.

Since:

0.9

Field Summary

Fields

Modifier and Type	Field and Description
protected CardSelector	cardSelector

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractCardSelection(CardSelector cardSelector) (protected) Constructor.

Method Summary

Modifier and Type	Method and Description
protected void	addCommandBuilder(T commandBuilder) Add an additional AbstractApduCommandBuilder for the command to be executed after the selection process if it succeeds.
CardSelector	getCardSelector()
protected java.util.List<T>	getCommandBuilders() Gets the list of command builders.
protected abstract AbstractSmartCard	parse(CardSelectionResponse cardSelectionResponse) Parsing method to be implemented in a card specific extension.

Methods inherited from class java.lang.Object

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

Field Detail

cardSelector

protected final CardSelector cardSelector

Constructor Detail

AbstractCardSelection

protected AbstractCardSelection(CardSelector cardSelector)

(protected)
Constructor.

Parameters:

cardSelector - A not null CardSelector.

Since:

0.9

Method Detail

getCardSelector

public CardSelector getCardSelector()

addCommandBuilder

protected final void addCommandBuilder(T commandBuilder)

Add an additional AbstractApduCommandBuilder for the command to be executed after the selection process if it succeeds.

If more than one AbstractApduCommandBuilder is added, all will be executed in the order in which they were added.

Parameters:

commandBuilder - an AbstractApduCommandBuilder

Since:

0.9

getCommandBuilders

protected final java.util.List<T> getCommandBuilders()

Gets the list of command builders.

Returns:

the current command builder list

Since:

0.9

parse

protected abstract AbstractSmartCard parse(CardSelectionResponse cardSelectionResponse)

Parsing method to be implemented in a card specific extension.

It returns an instance of AbstractSmartCard created from the data collected in the selection step (FCI, other data if any).

Parameters:

cardSelectionResponse - the card response received

Returns:

a AbstractSmartCard

Throws:

KeypleException - if an error occurs while parsing the card response

Since:

0.9