org.simalliance.openmobileapi

Class Reader

java.lang.Object

org.simalliance.openmobileapi.Reader

public class Reader
extends java.lang.Object

Instances of this class represent Secure Element Readers supported to this device. These Readers can be physical devices or virtual devices. They can be removable or not. They can contain Secure Element that can or cannot be removed.

See Also:

SIMalliance Open Mobile API v3.0

Method Summary

Methods

Modifier and Type	Method and Description
void	closeSessions() Close all the sessions opened on this reader.
java.lang.String	getName() Return the name of this reader.
SEService	getSEService() Return the Secure Element service this reader is bound to.
boolean	isSecureElementPresent() Check if a Secure Element is present in this reader.
Session	openSession() Connects to a Secure Element in this reader.

Methods inherited from class java.lang.Object

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

Method Detail

getName

public java.lang.String getName()

Return the name of this reader.

• If this reader is a SIM reader, then its name must be "SIM[Slot]".
• If the reader is a SD or micro SD reader, then its name must be "SD[Slot]"
• If the reader is a embedded SE reader, then its name must be "eSE[Slot]"

Slot is a decimal number without leading zeros. The Numbering must start with 1 (e.g. SIM1, SIM2, ... or SD1, SD2, ... or eSE1, eSE2, ...). The slot number “1” for a reader is optional (SIM and SIM1 are both valid for the first SIM-reader, but if there are two readers then the second reader must be named SIM2). This applies also for other SD or SE readers.

Returns:

the reader name, as a String.

openSession

public Session openSession()
                    throws java.io.IOException

Connects to a Secure Element in this reader.
This method prepares (initialises) the Secure Element for communication before the Session object is returned (e.g. powers the Secure Element by ICC ON if its not already on). There might be multiple sessions opened at the same time on the same reader. The system ensures the interleaving of APDUs between the respective sessions.

Returns:

a Session object to be used to create Channels.

Throws:

java.io.IOException - if something went wrong with the communicating to the Secure Element or the reader.

isSecureElementPresent

public boolean isSecureElementPresent()

Check if a Secure Element is present in this reader.

Returns:

true if the SE is present, false otherwise.

getSEService

public SEService getSEService()

Return the Secure Element service this reader is bound to.

Returns:

the SEService object.

closeSessions

public void closeSessions()

Close all the sessions opened on this reader. All the channels opened by all these sessions will be closed.