org.simalliance.openmobileapi

Class SERecognizerByAID

java.lang.Object

org.simalliance.openmobileapi.SERecognizer

org.simalliance.openmobileapi.SERecognizerByAID

public class SERecognizerByAID
extends SERecognizer

Instances of this class can be used to find a Secure Element implementing a specific Applet, identified by its AID. The presence of such an Applet is verified by trying to open a channel to this Applet. The opened channel, if any, is closed before the end of the isMatching method.

Field Summary

Fields

Modifier and Type	Field and Description
static int	AID_MAX_LENGTH The maximum length of an AID.
static int	AID_MIN_LENGTH The minimum length of an AID.

Constructor Summary

Constructors

Constructor and Description
SERecognizerByAID(byte[] aid) Initializes a new instance of the SERecognizerByAID class.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	isMatching(Session session) Tries to open a channel with the specified AID.

Methods inherited from class java.lang.Object

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

Field Detail

AID_MIN_LENGTH

public static final int AID_MIN_LENGTH

The minimum length of an AID.

See Also:

Constant Field Values

AID_MAX_LENGTH

public static final int AID_MAX_LENGTH

The maximum length of an AID.

See Also:

Constant Field Values

Constructor Detail

SERecognizerByAID

public SERecognizerByAID(byte[] aid)
                  throws java.lang.IllegalArgumentException

Initializes a new instance of the SERecognizerByAID class.

Parameters:

aid - The expected AID.

Throws:

java.lang.IllegalArgumentException - if the length of AID is not between AID_MIN_LENGTH and AID_MAX_LENGTH or if it's null.

Method Detail

isMatching

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

Tries to open a channel with the specified AID.

Specified by:

isMatching in class SERecognizer

Parameters:

session - The session in which to open the channel.

Returns:

true if the channel could be opened, false otherwise.

Throws:

java.lang.IllegalArgumentException - if the used session is null.