org.simalliance.openmobileapi

Class SERecognizerByATR

java.lang.Object

org.simalliance.openmobileapi.SERecognizer

org.simalliance.openmobileapi.SERecognizerByATR

public class SERecognizerByATR
extends SERecognizer

Instances of this class can be used to find a Secure Element with a specific ATR (or ATR pattern).

Field Summary

Fields

Modifier and Type	Field and Description
static int	ATR_MAX_LENGTH The maximum length of an ATR.
static int	ATR_MIN_LENGTH The minimum length of an ATR (At least TS and t0 shall be present.

Constructor Summary

Constructors

Constructor and Description
SERecognizerByATR(byte[] atr, byte[] mask) Initializes a new instance of the SERecognizerByATR class.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	isMatching(Session session) If the ATR length is correct, masks it and compares it with the expected one.

Methods inherited from class java.lang.Object

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

Field Detail

ATR_MIN_LENGTH

public static final int ATR_MIN_LENGTH

The minimum length of an ATR (At least TS and t0 shall be present.

See Also:

Constant Field Values

ATR_MAX_LENGTH

public static final int ATR_MAX_LENGTH

The maximum length of an ATR.

See Also:

Constant Field Values

Constructor Detail

SERecognizerByATR

public SERecognizerByATR(byte[] atr,
                 byte[] mask)
                  throws java.lang.IllegalArgumentException

Initializes a new instance of the SERecognizerByATR class.

Parameters:

atr - A byte array containing the ATR bytes values that are searched for.

mask - A byte array containing an AND-mask to be applied to the Secure Element ATR values before to be compared with the searched value.

Throws:

java.lang.IllegalArgumentException - when either the ATR or the Mask parameters have an invalid length, or if they are null.

Method Detail

isMatching

public boolean isMatching(Session session)
                   throws java.lang.IllegalArgumentException

If the ATR length is correct, masks it and compares it with the expected one.

Specified by:

isMatching in class SERecognizer

Parameters:

session - The session from which the ATR will be get.

Returns:

true if the masked ATRs match, or false if either ATRs don't match or session ATR has an invalid length.

Throws:

java.lang.IllegalArgumentException - if session is null.