Package org.calypsonet.terminal.card

Interface CardSelectionResponseApi

public interface CardSelectionResponseApi

Data from the start-up phase with the card: selection data and any additional responses.

Includes the status of the selection itself and the responses to any commands that may have been executed afterwards.

Since:

1.0.0

See Also:

CardSelectionRequestSpi

Method Summary

Modifier and Type	Method	Description
CardResponseApi	getCardResponse()	Gets the responses of the card to the requests present in the CardRequestSpi from the CardSelectionRequestSpi.
java.lang.String	getPowerOnData()	Gets the card's power-on data.
ApduResponseApi	getSelectApplicationResponse()	Gets the ApduResponseApi received from the card in response to the Select Application command.
boolean	hasMatched()	Gives the selection process status.

Method Detail

getPowerOnData

java.lang.String getPowerOnData()

Gets the card's power-on data.

The power-on data is defined as the data retrieved by the reader when the card is inserted.

In the case of a contact reader, this is the Answer To Reset data (ATR) defined by ISO7816.

In the case of a contactless reader, the reader decides what this data is.
Some contactless readers provide a virtual ATR (partially standardized by the PC/SC standard), but other devices can have their own definition, including for example elements from the anti-collision stage of the ISO14443 protocol (ATQA, ATQB, ATS, SAK, etc) or any proprietary definitions.

These data being variable from one reader to another, they are defined here in string format which can be either a hexadecimal string or any other relevant information.

Returns:

Null if no power-on data is available.

Since:

1.0.0

getSelectApplicationResponse

ApduResponseApi getSelectApplicationResponse()

Gets the ApduResponseApi received from the card in response to the Select Application command.

Returns:

Null if no Select Application command was performed.

Since:

1.0.0

hasMatched

boolean hasMatched()

Gives the selection process status.

Returns:

True if the card inserted matches the selection filters.

Since:

1.0.0

getCardResponse

CardResponseApi getCardResponse()

Gets the responses of the card to the requests present in the CardRequestSpi from the CardSelectionRequestSpi.

Returns:

Null if no requests have been set.

Since:

1.0.0