|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
The SIMView interface is the interface between the GSM System Services and any applet (SIM Toolkit or other). It offers some methods to communicate with the GSM System Services without compromising the GSM file system integrity (e.g. ME file context, conflicting access to files ...). All the methods are based on the commands of the GSM11.11 specification. This interface shall be implemented by a JCRE owned object. This interface is not intended for the activation of a SIM Toolkit applet.
Shareable
,
SIMViewException
Field Summary | |
static short |
FID_DF_ACES
File identifier : DF ACeS = 0x5F33 (under DF GSM) |
static short |
FID_DF_CTS
File identifier : DF CTS = 0x5F60 (under DF GSM) |
static short |
FID_DF_DCS_1800
File identifier : DF DCS-1800 = 0x7F21 |
static short |
FID_DF_FP_CTS
File identifier : DF FP-CTS = 0x7F23 |
static short |
FID_DF_GLOBALSTAR
File identifier : DF Globalstar = 0x5F31 (under DF GSM) |
static short |
FID_DF_Graphics
Deprecated. Replaced by FID_DF_GRAPHICS in version 7.4.0 |
static short |
FID_DF_GRAPHICS
File identifier : DF Graphics = 0x5F50 (under DF TELECOM) |
static short |
FID_DF_GSM
File identifier : DF GSM = 0x7F20 |
static short |
FID_DF_ICO
File identifier : DF ICO = 0x5F32 (under DF GSM) |
static short |
FID_DF_IRIDIUM
File identifier : DF IRIDIUM = 0x5F30 (under DF GSM) |
static short |
FID_DF_IS_41
File identifier : DF IS-41 = 0x7F22 |
static short |
FID_DF_MEXE
File identifier : DF MExE = 0x5F3C (under DF GSM) |
static short |
FID_DF_PCS_1900
File identifier : DF PCS-1900 = 0x5F40 (under DF GSM) |
static short |
FID_DF_PDC
File identifier : DF PDC = 0x7F80 |
static short |
FID_DF_SOLSA
File identifier : DF SoLSA = 0x5F70 (under DF GSM) |
static short |
FID_DF_TELECOM
File identifier : DF TELECOM = 0x7F10 |
static short |
FID_DF_TETRA
File identifier : DF TETRA = 0x7F90 |
static short |
FID_DF_TIA_EIA_136
File identifier : DF TIA-EIA-136 = 0x7F24 |
static short |
FID_DF_TIA_EIA_553
File identifier : DF TIA-EIA-553= 0x5F40 (under DF GSM) |
static short |
FID_DF_TIA_EIA_95
File identifier : DF TIA-EIA-95 = 0x7F25 |
static short |
FID_EF_AAEM
File identifier : EF AAeM = 0x6FB6 (under DF GSM) |
static short |
FID_EF_ACC
File identifier : EF ACC = 0x6F78 (under DF GSM) |
static short |
FID_EF_ACCOLC
File identifier : EF ACCOLC = 0x4F89 (under DF TIA-EIA-553) |
static short |
FID_EF_ACM
File identifier : EF ACM = 0x6F39 (under DF GSM) |
static short |
FID_EF_ACMMAX
File identifier : EF ACMmax = 0x6F37 (under DF GSM) |
static short |
FID_EF_AD
File identifier : EF AD = 0x6FAD (under DF GSM) |
static short |
FID_EF_ADN
File identifier : EF ADN = 0x6F3A (under DF TELECOM) |
static short |
FID_EF_AMPS_2_GSM
File identifier : EF AMPS_2_GSM = 0x4F91 (under DF TIA-EIA-553) |
static short |
FID_EF_AMPS_UI
File identifier : EF AMPS_UI = 0x4F93 (under DF TIA-EIA-553) |
static short |
FID_EF_ARPK
File identifier : EF ARPK= 0x4F42 (under DF MExE) |
static short |
FID_EF_BCCH
File identifier : EF BCCH = 0x6F74 (under DF GSM) |
static short |
FID_EF_BDN
File identifier : EF BDN = 0x6F4D (under DF TELECOM) |
static short |
FID_EF_CBMI
File identifier : EF CBMI = 0x6F45 (under DF GSM) |
static short |
FID_EF_CBMID
File identifier : EF CBMID = 0x6F48 (under DF GSM) |
static short |
FID_EF_CBMIR
File identifier : EF CBMIR = 0x6F50 (under DF GSM) |
static short |
FID_EF_CCCH
File identifier : EF CCCH = 0x4F8E (under DF TIA-EIA-553) |
static short |
FID_EF_CCP
File identifier : EF CCP = 0x6F3D (under DF TELECOM) |
static short |
FID_EF_CMI
File identifier : EF CMI = 0x6F58 (under DF TELECOM) |
static short |
FID_EF_CNL
File identifier : EF CNL = 0x6F32 (under DF GSM) |
static short |
FID_EF_COUNT
File identifier : EF COUNT = 0x4F83 (under DF TIA-EIA-553) |
static short |
FID_EF_CPBCCH
File identifier : EF CPBCCH= 0x6F63(under DF GSM) |
static short |
FID_EF_CSID
File identifier : EF CSID= 0x4F8C (under DF TIA-EIA-553) |
static short |
FID_EF_DCK
File identifier : EF DCK = 0x6F2C (under DF GSM) |
static short |
FID_EF_ECC
File identifier : EF ECC = 0x6FB7 (under DF GSM) |
static short |
FID_EF_ECCP
File identifier : EF ECCP = 0x6F4F (under DF TELECOM) |
static short |
FID_EF_ELP
File identifier : EF ELP = 0x2F05 (under MF) |
static short |
FID_EF_EMLPP
File identifier : EF eMLPP = 0x6FB5 (under DF GSM) |
static short |
FID_EF_EXT1
File identifier : EF EXT1 = 0x6F4A (under DF TELECOM) |
static short |
FID_EF_EXT2
File identifier : EF EXT2 = 0x6F4B (under DF TELECOM) |
static short |
FID_EF_EXT3
File identifier : EF EXT3 = 0x6F4C (under DF TELECOM) |
static short |
FID_EF_EXT4
File identifier : EF EXT4 = 0x6F4E (under DF TELECOM) |
static short |
FID_EF_FC1
File identifier : EF FC1= 0x4F8A (under DF TIA-EIA-553) |
static short |
FID_EF_FDN
File identifier : EF FDN = 0x6F3B (under DF TELECOM) |
static short |
FID_EF_FPLMN
File identifier : EF FPLMN = 0x6F7B (under DF GSM) |
static short |
FID_EF_GID1
File identifier : EF GID1 = 0x6F3E (under DF GSM) |
static short |
FID_EF_GID2
File identifier : EF GID2 = 0x6F3F (under DF GSM) |
static short |
FID_EF_GPI
File identifier : EF GPI = 0x4F81 (under DF TIA-EIA-553) |
static short |
FID_EF_GSM_RECON
File identifier : EF GSM_RECON = 0x4F90 (under DF TIA-EIA-553) |
static short |
FID_EF_HPLMN
File identifier : EF HPLMN = 0x6F31 (under DF GSM) |
static short |
FID_EF_HPLMNWACT
File identifier : EF HPLMNwAcT= 0x6F62 (under DF GSM) |
static short |
FID_EF_ICCID
File identifier : EF ICCID = 0x2FE2 (under MF) |
static short |
FID_EF_IMG
File identifier : EF IMG = 0x4F20 (under DF Graphics) |
static short |
FID_EF_IMSI
File identifier : EF IMSI = 0x6F07 (under DF GSM) |
static short |
FID_EF_INVSCAN
File identifier : EF InvScan= 0x6F64(under DF GSM) |
static short |
FID_EF_IPC
File identifier : EF IPC = 0x4F82 (under DF TIA-EIA-553) |
static short |
FID_EF_KC
File identifier : EF Kc = 0x6F20 (under DF GSM) |
static short |
FID_EF_KCGPRS
File identifier : EF KcGPRS = 0x6F52 (under DF GSM) |
static short |
FID_EF_LDCC
File identifier : EF LDCC = 0x4F8F (under DF TIA-EIA-553) |
static short |
FID_EF_LND
File identifier : EF LND = 0x6F44 (under DF TELECOM) |
static short |
FID_EF_LOCI
File identifier : EF LOCI = 0x6F7E (under DF GSM) |
static short |
FID_EF_LOCIGPRS
File identifier : EF LOCIGPRS = 0x6F53 (under DF GSM) |
static short |
FID_EF_LP
File identifier : EF LP = 0x6F05 (under DF GSM) |
static short |
FID_EF_MEXE_ST
File identifier : EF MExE_ST= 0x4F40 (under DF MExE) |
static short |
FID_EF_MIN
File identifier : EF MIN = 0x4F88 (under DF TIA-EIA-553) |
static short |
FID_EF_MSISDN
File identifier : EF MSISDN = 0x6F40 (under DF TELECOM) |
static short |
FID_EF_NETSEL
File identifier : EF NETSEL = 0x4F86 (under DF TIA-EIA-553) |
static short |
FID_EF_NIA
File identifier : EF NIA = 0x6F51 (under DF GSM) |
static short |
FID_EF_NSID
File identifier : EF NSID = 0x4F84 (under DF TIA-EIA-553) |
static short |
FID_EF_OPLMNWACT
File identifier : EF OPLMNwAcT= 0x6F61 (under DF GSM) |
static short |
FID_EF_ORPK
File identifier : EF ORPK= 0x4F41 (under DF MExE) |
static short |
FID_EF_PHASE
File identifier : EF Phase = 0x6FAE (under DF GSM) |
static short |
FID_EF_PLMNSEL
File identifier : EF PLMNsel = 0x6F30 (under DF GSM) |
static short |
FID_EF_PLMNWACT
File identifier : EF PLMNwAcT= 0x6F60 (under DF GSM) |
static short |
FID_EF_PSID
File identifier : EF PSID = 0x4F85 (under DF TIA-EIA-553) |
static short |
FID_EF_PUCT
File identifier : EF PUCT = 0x6F41 (under DF GSM) |
static short |
FID_EF_REG_THRESH
File identifier : EF REG_THRESH = 0x4F8D (under DF TIA-EIA-553) |
static short |
FID_EF_S_ESN
File identifier : EF S_ESN = 0x4F8B (under DF TIA-EIA-553) |
static short |
FID_EF_SAI
File identifier : EF SAI = 0x4F30 (under DF SoLSA) |
static short |
FID_EF_SDN
File identifier : EF SDN = 0x6F49 (under DF TELECOM) |
static short |
FID_EF_SID
File identifier : EF SID = 0x4F80 (under DF TIA-EIA-553) |
static short |
FID_EF_SLL
File identifier : EF SLL = 0x4F31 (under DF SoLSA) |
static short |
FID_EF_SMS
File identifier : EF SMS = 0x6F3C (under DF TELECOM) |
static short |
FID_EF_SMSP
File identifier : EF SMSP = 0x6F42 (under DF TELECOM) |
static short |
FID_EF_SMSR
File identifier : EF SMSR = 0x6F47 (under DF TELECOM) |
static short |
FID_EF_SMSS
File identifier : EF SMSS = 0x6F43 (under DF TELECOM) |
static short |
FID_EF_SPL
File identifier : EF SPL = 0x4F87 (under DF TIA-EIA-553) |
static short |
FID_EF_SPN
File identifier : EF SPN = 0x6F46 (under DF GSM) |
static short |
FID_EF_SST
File identifier : EF SST = 0x6F38 (under DF GSM) |
static short |
FID_EF_SUME
File identifier : EF SUME = 0x6F54 (under DF GSM) |
static short |
FID_EF_TPRPK
File identifier : EF TPRPK = 0x4F43 (under DF MExE) |
static short |
FID_EF_VBS
File identifier : EF VBS = 0x6FB3 (under DF GSM) |
static short |
FID_EF_VBSS
File identifier : EF VBSS = 0x6FB4 (under DF GSM) |
static short |
FID_EF_VGCS
File identifier : EF VGCS = 0x6FB1 (under DF GSM) |
static short |
FID_EF_VGCSS
File identifier : EF VGCSS = 0x6FB2 (under DF GSM) |
static short |
FID_MF
File identifier : MF = 0x3F00 |
static byte |
REC_ACC_MODE_ABSOLUTE_CURRENT
Record access mode : absolute/current record = 0x04 |
static byte |
REC_ACC_MODE_NEXT
Record access mode : next record = 0x02 |
static byte |
REC_ACC_MODE_PREVIOUS
Record access mode : previous record = 0x03 |
static byte |
SEEK_FROM_BEGINNING_FORWARD
Seek mode : from the beginning forward = 0x00 |
static byte |
SEEK_FROM_END_BACKWARD
Seek mode : from the end backward = 0x01 |
static byte |
SEEK_FROM_NEXT_FORWARD
Seek mode : from the next location forward = 0x02 |
static byte |
SEEK_FROM_PREVIOUS_BACKWARD
Seek mode : from the previous location backward = 0x03 |
Method Summary | |
short |
increase(byte[] incr,
short incrOffset,
byte[] resp,
short respOffset)
INCREASE command as defined in GSM 11.11 standard. |
void |
invalidate()
INVALIDATE command as defined in GSM 11.11 standard. |
short |
readBinary(short fileOffset,
byte[] resp,
short respOffset,
short respLength)
READ BINARY command as defined in GSM 11.11 standard. |
short |
readRecord(short recNumber,
byte mode,
short recOffset,
byte[] resp,
short respOffset,
short respLength)
READ RECORD command as defined in GSM 11.11 standard. |
void |
rehabilitate()
REHABILITATE command as defined in GSM 11.11 standard. |
short |
seek(byte mode,
byte[] patt,
short pattOffset,
short pattLength)
SEEK command as defined in GSM 11.11 standard. |
void |
select(short fid)
SELECT command as defined in GSM 11.11 standard. |
short |
select(short fid,
byte[] fci,
short fciOffset,
short fciLength)
SELECT command as defined in GSM 11.11 standard. |
short |
status(byte[] fci,
short fciOffset,
short fciLength)
STATUS command as defined in GSM 11.11 standard. |
void |
updateBinary(short fileOffset,
byte[] data,
short dataOffset,
short dataLength)
UPDATE BINARY command as defined in GSM 11.11 standard. |
void |
updateRecord(short recNumber,
byte mode,
short recOffset,
byte[] data,
short dataOffset,
short dataLength)
UPDATE RECORD command as defined in GSM 11.11 standard. |
Field Detail |
public static final short FID_MF
public static final short FID_DF_TELECOM
public static final short FID_DF_GSM
public static final short FID_DF_DCS_1800
public static final short FID_DF_IS_41
public static final short FID_DF_FP_CTS
public static final short FID_DF_PDC
public static final short FID_DF_TETRA
public static final short FID_DF_TIA_EIA_136
public static final short FID_DF_TIA_EIA_95
public static final short FID_DF_Graphics
FID_DF_GRAPHICS
in version 7.4.0
public static final short FID_DF_GRAPHICS
public static final short FID_DF_IRIDIUM
public static final short FID_DF_GLOBALSTAR
public static final short FID_DF_ICO
public static final short FID_DF_ACES
public static final short FID_DF_PCS_1900
public static final short FID_DF_CTS
public static final short FID_DF_SOLSA
public static final short FID_DF_TIA_EIA_553
public static final short FID_DF_MEXE
public static final short FID_EF_ICCID
public static final short FID_EF_ELP
public static final short FID_EF_ADN
public static final short FID_EF_FDN
public static final short FID_EF_SMS
public static final short FID_EF_CCP
public static final short FID_EF_MSISDN
public static final short FID_EF_SMSP
public static final short FID_EF_SMSS
public static final short FID_EF_LND
public static final short FID_EF_SDN
public static final short FID_EF_EXT1
public static final short FID_EF_EXT2
public static final short FID_EF_EXT3
public static final short FID_EF_BDN
public static final short FID_EF_EXT4
public static final short FID_EF_SMSR
public static final short FID_EF_ECCP
public static final short FID_EF_CMI
public static final short FID_EF_IMG
public static final short FID_EF_LP
public static final short FID_EF_IMSI
public static final short FID_EF_KC
public static final short FID_EF_PLMNSEL
public static final short FID_EF_HPLMN
public static final short FID_EF_ACMMAX
public static final short FID_EF_SST
public static final short FID_EF_ACM
public static final short FID_EF_GID1
public static final short FID_EF_GID2
public static final short FID_EF_SPN
public static final short FID_EF_PUCT
public static final short FID_EF_CBMI
public static final short FID_EF_BCCH
public static final short FID_EF_ACC
public static final short FID_EF_FPLMN
public static final short FID_EF_LOCI
public static final short FID_EF_AD
public static final short FID_EF_PHASE
public static final short FID_EF_VGCS
public static final short FID_EF_VGCSS
public static final short FID_EF_VBS
public static final short FID_EF_VBSS
public static final short FID_EF_EMLPP
public static final short FID_EF_AAEM
public static final short FID_EF_CBMID
public static final short FID_EF_ECC
public static final short FID_EF_CBMIR
public static final short FID_EF_DCK
public static final short FID_EF_CNL
public static final short FID_EF_NIA
public static final short FID_EF_KCGPRS
public static final short FID_EF_LOCIGPRS
public static final short FID_EF_SUME
public static final short FID_EF_PLMNWACT
public static final short FID_EF_OPLMNWACT
public static final short FID_EF_HPLMNWACT
public static final short FID_EF_CPBCCH
public static final short FID_EF_INVSCAN
public static final short FID_EF_SAI
public static final short FID_EF_SLL
public static final short FID_EF_SID
public static final short FID_EF_GPI
public static final short FID_EF_IPC
public static final short FID_EF_COUNT
public static final short FID_EF_NSID
public static final short FID_EF_PSID
public static final short FID_EF_NETSEL
public static final short FID_EF_SPL
public static final short FID_EF_MIN
public static final short FID_EF_ACCOLC
public static final short FID_EF_FC1
public static final short FID_EF_S_ESN
public static final short FID_EF_CSID
public static final short FID_EF_REG_THRESH
public static final short FID_EF_CCCH
public static final short FID_EF_LDCC
public static final short FID_EF_GSM_RECON
public static final short FID_EF_AMPS_2_GSM
public static final short FID_EF_AMPS_UI
public static final short FID_EF_MEXE_ST
public static final short FID_EF_ORPK
public static final short FID_EF_ARPK
public static final short FID_EF_TPRPK
public static final byte REC_ACC_MODE_NEXT
public static final byte REC_ACC_MODE_PREVIOUS
public static final byte REC_ACC_MODE_ABSOLUTE_CURRENT
public static final byte SEEK_FROM_BEGINNING_FORWARD
public static final byte SEEK_FROM_END_BACKWARD
public static final byte SEEK_FROM_NEXT_FORWARD
public static final byte SEEK_FROM_PREVIOUS_BACKWARD
Method Detail |
public short select(short fid, byte[] fci, short fciOffset, short fciLength) throws java.lang.NullPointerException, java.lang.ArrayIndexOutOfBoundsException, SIMViewException
Notes:
fciOffset
or fciLength
parameter is negative an ArrayIndexOutOfBoundsException
exception is thrown and no read is performed.
fciOffset+fciLength
is greater than fci.length
, the length
of the fci
array an ArrayIndexOutOfBoundsException
exception is thrown
and no status request is performed.
fid
- is the File Identifier of the file to be selected.fci
- is the reference to the target byte array for FCI (File Control
Information) of current file, coding is according to GSM 11.11.
If fci
is null
the NullPointerException
is thrown.fciOffset
- is the offset in the fci
buffer for the response data.fciLength
- is the length of the required data in the fci
byte array.
If the fciLength
is greater than the length of the response, the whole
response is copied into the fci
buffer and the length of the response
is returned by the method. If the fcilength
is smaller than the length
of the response, the first part of the response is copied into the fci
buffer and the fciLength
is returned by the method.
fci
buffer
(cannot be greater than fciLength
parameter)
java.lang.NullPointerException
- if fci
is null
java.lang.ArrayIndexOutOfBoundsException
- if operation would cause access of data outside
array bounds.
SIMViewException
- in case of errorFILE_NOT_FOUND
MEMORY_PROBLEM
INTERNAL_ERROR
public void select(short fid) throws SIMViewException
fid
- is the File Identifier of the file to be selected.
SIMViewException
- in case of error FILE_NOT_FOUND
MEMORY_PROBLEM
INTERNAL_ERROR
public short status(byte[] fci, short fciOffset, short fciLength) throws java.lang.NullPointerException, java.lang.ArrayIndexOutOfBoundsException, SIMViewException
Notes:
fciOffset
or fciLength
parameter is negative an ArrayIndexOutOfBoundsException
exception is thrown and no read is performed.
fciOffset+fciLength
is greater than fci.length
, the length
of the fci
array an ArrayIndexOutOfBoundsException
exception is thrown
and no status request is performed.
fci
- is the reference to the target byte array for FCI (File Control
Information) of current DF (or MF), coding is according to GSM 11.11.
If fci
is null
the NullPointerException
is thrown.fciOffset
- is the offset in the fci
buffer for the response data.fciLength
- is the length of the required data in the fci
byte array.
If the fciLength
is greater than the length of the response, the whole
response is copied into the fci
buffer and the length of the response
is returned by the method. If the fcilength
is smaller than the length
of the response, the first part of the response is copied into the fci
buffer and the fciLength
is returned by the method.
fci
buffer
(cannot be greater than fciLength
parameter)
java.lang.NullPointerException
- if fci
is null
java.lang.ArrayIndexOutOfBoundsException
- if operation would cause access of data outside
array bounds.
SIMViewException
- in case of error MEMORY_PROBLEM
INTERNAL_ERROR
public short readBinary(short fileOffset, byte[] resp, short respOffset, short respLength) throws java.lang.NullPointerException, java.lang.ArrayIndexOutOfBoundsException, SIMViewException
Notes:
respOffset
or respLength
parameter is negative a ArrayIndexOutOfBoundsException
exception is thrown and no read is performed.
respOffset+respLength
is greater than resp.length
, the length
of the resp
array a ArrayIndexOutOfBoundsException
exception is thrown
and no select is performed.
fileOffset
- is the offset in the source transparent file.resp
- is the reference to the response byte array for read data.respOffset
- is the offset in the response byte array.respLength
- is the number of bytes to read.
respOffset+respLength
java.lang.NullPointerException
- if resp
is null
java.lang.ArrayIndexOutOfBoundsException
- if reading would cause access of data outside array bounds
SIMViewException
- in case of error NO_EF_SELECTED
FILE_INCONSISTENT
AC_NOT_FULFILLED
INVALIDATION_STATUS_CONTRADICTION
OUT_OF_FILE_BOUNDARIES
MEMORY_PROBLEM
INTERNAL_ERROR
public void updateBinary(short fileOffset, byte[] data, short dataOffset, short dataLength) throws java.lang.NullPointerException, java.lang.ArrayIndexOutOfBoundsException, SIMViewException
Notes:
dataOffset
or dataLength
parameter is negative a ArrayIndexOutOfBoundsException
exception is thrown and no update is performed.
dataOffset+dataLength
is greater than data.length
, the length
of the data
array a ArrayIndexOutOfBoundsException
exception is thrown
and no update is performed.
fileOffset
- is the offset in the destination transparent file.data
- is the reference to the source byte array for data to update.dataOffset
- is the offset in the source byte array.dataLength
- is the number of bytes to update.
java.lang.NullPointerException
- if data
is null
java.lang.ArrayIndexOutOfBoundsException
- if updating would cause access of data outside array bounds
SIMViewException
- in case of errorNO_EF_SELECTED
FILE_INCONSISTENT
AC_NOT_FULFILLED
INVALIDATION_STATUS_CONTRADICTION
OUT_OF_FILE_BOUNDARIES
MEMORY_PROBLEM
INTERNAL_ERROR
public short readRecord(short recNumber, byte mode, short recOffset, byte[] resp, short respOffset, short respLength) throws java.lang.NullPointerException, java.lang.ArrayIndexOutOfBoundsException, SIMViewException
Notes:
respOffset
or respLength
parameter is negative a ArrayIndexOutOfBoundsException
exception is thrown and no read is performed.
respOffset+respLength
is greater than resp.length
, the length
of the resp
array a ArrayIndexOutOfBoundsException
exception is thrown
and no select is performed.
recNumber
- is the record number.mode
- is the mode for reading record, according to GSM 11.11.
If mode
is REC_ACC_MODE_NEXT
and the record pointer is at the last record
the RECORD_NUMBER_NOT_AVAILABLE SIMViewException
shall be thrown.
If mode
is REC_ACC_MODE_PREVIOUS
and the record pointer is at the first record,
the RECORD_NUMBER_NOT_AVAILABLE SIMViewException
shall be thrown.recOffset
- is the offset in the record for the data to read.resp
- is the reference to the response byte array for read data.respOffset
- is the offset in the response byte array.respLength
- is the number of bytes to read.
respOffset+respLength
java.lang.NullPointerException
- if resp
is null
java.lang.ArrayIndexOutOfBoundsException
- if reading would cause access of data outside array bounds
SIMViewException
- in case of error NO_EF_SELECTED
FILE_INCONSISTENT
AC_NOT_FULFILLED
INVALIDATION_STATUS_CONTRADICTION
OUT_OF_RECORD_BOUNDARIES
RECORD_NUMBER_NOT_AVAILABLE
INVALID_MODE
MEMORY_PROBLEM
INTERNAL_ERROR
public void updateRecord(short recNumber, byte mode, short recOffset, byte[] data, short dataOffset, short dataLength) throws java.lang.NullPointerException, java.lang.ArrayIndexOutOfBoundsException, SIMViewException
Notes:
dataOffset
or dataLength
parameter is negative a ArrayIndexOutOfBoundsException
exception is thrown and no select is performed.
dataOffset+dataLength
is greater than data.length
, the length
of the data
array a ArrayIndexOutOfBoundsException
exception is thrown
and no update is performed.
recNumber
- is the record number.mode
- is the mode for updating record, according to GSM 11.11.
If mode
is REC_ACC_MODE_NEXT
and the record pointer is at the last record
the RECORD_NUMBER_NOT_AVAILABLE SIMViewException
shall be thrown.
If mode
is REC_ACC_MODE_PREVIOUS
and the record pointer is at the first record,
the RECORD_NUMBER_NOT_AVAILABLE SIMViewException
shall be thrown.recOffset
- is the offset in the record for the data to update.data
- is the reference to the source byte array for data to update.dataOffset
- is the offset in the source byte array.dataLength
- is the number of bytes to update.
java.lang.NullPointerException
- if data
is null
java.lang.ArrayIndexOutOfBoundsException
- if updating would cause access of data outside array bounds
SIMViewException
- in case of errorNO_EF_SELECTED
FILE_INCONSISTENT
AC_NOT_FULFILLED
INVALIDATION_STATUS_CONTRADICTION
OUT_OF_RECORD_BOUNDARIES
RECORD_NUMBER_NOT_AVAILABLE
INVALID_MODE
MEMORY_PROBLEM
INTERNAL_ERROR
public short seek(byte mode, byte[] patt, short pattOffset, short pattLength) throws java.lang.NullPointerException, java.lang.ArrayIndexOutOfBoundsException, SIMViewException
Notes:
pattOffset
or pattLength
parameter is negative a ArrayIndexOutOfBoundsException
exception is thrown and no seek is performed.
pattOffset+pattLength
is greater than patt.length
, the length
of the patt
array a ArrayIndexOutOfBoundsException
exception is thrown
and no seek is performed.
mode
- is the seek mode, according to GSM 11.11 (no type information).
If mode
is SEEK_FROM_NEXT_FORWARD
and the record pointer is at the last record
the PATTERN_NOT_FOUND SIMViewException
shall be thrown.
If mode
is SEEK_FROM_PREVIOUS_BACKWARD
and the record pointer is at the first record,
the PATTERN_NOT_FOUND SIMViewException
shall be thrown.patt
- is the reference to the byte array containing the seek pattern.pattOffset
- is the offset of the seek pattern in the byte array.pattLength
- is the length of the seek pattern.
If pattLength
is greater than the current record size than
the OUT_OF_RECORD_BOUNDARIES SIMViewException
shall be thrown.
If pattLength
is zero
than PATTERN_NOT_FOUND SIMViewException
shall be thrown.
java.lang.NullPointerException
- if patt
is null
java.lang.ArrayIndexOutOfBoundsException
- if seeking would cause access of data outside array bounds
SIMViewException
- in case of errorNO_EF_SELECTED
PATTERN_NOT_FOUND
FILE_INCONSISTENT
AC_NOT_FULFILLED
INVALIDATION_STATUS_CONTRADICTION
INVALID_MODE
OUT_OF_RECORD_BOUNDARIES
MEMORY_PROBLEM
INTERNAL_ERROR
public short increase(byte[] incr, short incrOffset, byte[] resp, short respOffset) throws java.lang.NullPointerException, java.lang.ArrayIndexOutOfBoundsException, SIMViewException
Notes:
incrOffset
or respOffset
parameter is negative an ArrayIndexOutOfBoundsException
exception is thrown and no increase is performed.
incrOffset
is greater than incr.length
, the length
of the incr
array an ArrayIndexOutOfBoundsException
exception is thrown
and no increase is performed.
respOffset
is greater than resp.length
, the length
of the resp
array an ArrayIndexOutOfBoundsException
exception is thrown
and no increase is performed.
incr
- is the reference to the source byte array, containing the
value to add, on 3 bytes.incrOffset
- is the offset in the source byte array.resp
- is the reference to the response byte array for new record value.
If resp
buffer is smaller than the record size, the ArrayIndexOutOfBoundsException
is thrown.
If resp
buffer is bigger than the record size, the resp
buffer is filled
with the record value and left justifiedrespOffset
- is the offset in the response byte array.
resp
buffer
(cannot be greater than the record size)
java.lang.NullPointerException
- if incr
or resp
is null
java.lang.ArrayIndexOutOfBoundsException
- if increasing would cause access of data outside array bounds
SIMViewException
- in case of errorNO_EF_SELECTED
FILE_INCONSISTENT
AC_NOT_FULFILLED
INVALIDATION_STATUS_CONTRADICTION
MAX_VALUE_REACHED
MEMORY_PROBLEM
INTERNAL_ERROR
public void invalidate() throws SIMViewException
SIMViewException
- in case of errorNO_EF_SELECTED
AC_NOT_FULFILLED
INVALIDATION_STATUS_CONTRADICTION
MEMORY_PROBLEM
INTERNAL_ERROR
public void rehabilitate() throws SIMViewException
SIMViewException
- in case of error NO_EF_SELECTED
AC_NOT_FULFILLED
INVALIDATION_STATUS_CONTRADICTION
MEMORY_PROBLEM
INTERNAL_ERROR
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |