CardSelectorSpi (Calypsonet Terminal Card API - 1.0.0)

```
public interface CardSelectorSpi
```
Data elements for filtering cards and selecting applications.
These elements are of three kinds:
- The card protocol, corresponding to the underlying technology: ISO14443-A, ISO14443-B or any other proprietary or standardized communication technology.
- The power-on data pattern.
- The selection of the application as defined by ISO7816-4.
These filter elements offered in the card selector, are all optional but can also be combined.
If no filtering is specified, any card that responds when inserted in the reader will be considered selected.
Conversely, if one or more filters have been defined, the card will not be selected if one of them rejects the card.
For the selection by the card protocol, we assume that the reader access layer has provided constants in the form of strings defining the supported protocols.
Similarly, for power-on data selection, it is assumed that the reader access layer has provided the structure of the returned data or rules for interpreting it in the form of regular expressions.
The selection by DF Name is governed by standardized elements such as the AID and the different values of FileOccurrence, FileControlInformation.
Since:

1.0.0

Nested Class Summary

Nested Classes
Modifier and Type	Interface	Description
`static class`	`CardSelectorSpi.FileControlInformation`	Types of templates available in return for the Select Application command, according to the ISO7816-4 standard.
`static class`	`CardSelectorSpi.FileOccurrence`	Navigation options through the different applications contained in the card according to the ISO7816-4 standard.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`byte[]`	`getAid()`	Gets the ISO7816-4 Application Identifier (AID).
`java.lang.String`	`getCardProtocol()`	Gets the card protocol name.
`CardSelectorSpi.FileControlInformation`	`getFileControlInformation()`	Gets the `CardSelectorSpi.FileControlInformation` parameter defining the output type of the select command.
`CardSelectorSpi.FileOccurrence`	`getFileOccurrence()`	Gets the `CardSelectorSpi.FileOccurrence` parameter defining the navigation within the card applications list.
`java.lang.String`	`getPowerOnDataRegex()`	Gets the regular expression to be applied to the card's power-on data.
`java.util.Set<java.lang.Integer>`	`getSuccessfulSelectionStatusWords()`	Gets the list of successful selection status words.

- Method Detail
  - getCardProtocol
```
java.lang.String getCardProtocol()
```
    Gets the card protocol name.
    
    Returns:
    
    Null if no card protocol has been set.
    
    Since:
    
    1.0.0
  - getPowerOnDataRegex
```
java.lang.String getPowerOnDataRegex()
```
    Gets the regular expression to be applied to the card's power-on data.
    
    Returns:
    
    Null if no power-on data regex has been set.
    
    Since:
    
    1.0.0
  - getAid
```
byte[] getAid()
```
    Gets the ISO7816-4 Application Identifier (AID).
    
    Returns:
    
    Null if no AID has been set.
    
    Since:
    
    1.0.0
  - getFileOccurrence
```
CardSelectorSpi.FileOccurrence getFileOccurrence()
```
    Gets the CardSelectorSpi.FileOccurrence parameter defining the navigation within the card applications list.
    
    Returns:
    
    A not null reference.
    
    Since:
    
    1.0.0
  - getFileControlInformation
```
CardSelectorSpi.FileControlInformation getFileControlInformation()
```
    Gets the CardSelectorSpi.FileControlInformation parameter defining the output type of the select command.
    
    Returns:
    
    A not null reference.
    
    Since:
    
    1.0.0
  - getSuccessfulSelectionStatusWords
```
java.util.Set<java.lang.Integer> getSuccessfulSelectionStatusWords()
```
    Gets the list of successful selection status words.
    
    Returns:
    
    A set of integer values containing at least 9000h.
    
    Since:
    
    1.0.0