File	Doc	Category	Size	Date	Package
EnvelopeHandler.java	API Doc	phoneME MR2 API (J2ME)	8517	Wed May 02 18:00:40 BST 2007	sim.toolkit

EnvelopeHandler

• java.lang.Object
  • ViewHandler

private static final byte MY_TAG = (byte)0x54;
private byte[] data;
data = new byte[32];

void processToolkit(byte event) throws ToolkitException {
// get the EnvelopeHandler system instance
EnvelopeHandler theEnv = EnvelopeHandler.getTheHandler();
// look for MY_TAG TLV
if (theEnv.findTLV(MY_TAG, (byte)1) != TLV_NOT_FOUND) {
// check first element byte
if (theEnv.getValueByte((short)0) == (byte)1) {
// copy element part into data buffer
theEnv.copyValue((short)1,
data,
(short)0,
(short)(theEnv.getValueLength() - 1));
}
}
}

Fields Summary

Constructors Summary
private EnvelopeHandler() constructor

Methods Summary
public byte	getEnvelopeTag() Returns the Envelope BER-TLV tag. return Envelope BER-TLV tag byte[] buffer = ViewHandler.getAPDUBuffer(); return buffer[BER_TLV_TAG_OFFSET];
public byte	getItemIdentifier() Returns the item identifier byte value from the first Item Identifier TLV element in the current Envelope data field. If the element is available it becomes the TLV selected. return item identifier exception ToolkitException with the following reason codes: UNAVAILABLE_ELEMENT in case of unavailable TLV element OUT_OF_TLV_BOUNDARIES if the item identifier byte is missing in the Item Identifier Simple TLV byte[] buffer = ViewHandler.getAPDUBuffer(); currentTLVOffset = firstTLVOffset; return buffer[firstTLVOffset];
public short	getSecuredDataLength() Looks for the length of the Secured Data from the Command Packet in the first SMS TPDU or Cell Broadcast Page Simple TLV contained in the Envelope handler. This can be used on the events: - EVENT_FORMATTED_SMS_PP_ENV, EVENT_FORMATTED_SMS_PP_UPD, if the SMS TP-UD is formatted according to GSM03.48 Single Short Message. - EVENT_FORMATTED_SMS_CB, if the Cell Broadcast Page is formatted according to GSM 03.48. If the element is available it becomes the TLV selected. return the length of the Secured Data contained in the first SMS TPDU or Cell Broadcast Page TLV element (without padding bytes). If the Secured Data length is zero, no exception shall be thrown. exception ToolkitException with the following reason codes: UNAVAILABLE_ELEMENT in case of unavailable SMS TPDU or Cell Broadcast Page TLV element or wrong data format return 0;
public short	getSecuredDataOffset() Looks for the Secured Data from the Command Packet in the first SMS TPDU or Cell Broadcast Page Simple TLV contained in the Envelope handler. This can be used on the events: - EVENT_FORMATTED_SMS_PP_ENV, EVENT_FORMATTED_SMS_PP_UPD, if the SMS TP-UD is formatted according to GSM03.48 Single Short Message. - EVENT_FORMATTED_SMS_CB, if the Cell Broadcast Page is formatted according to GSM 03.48. If the element is available it becomes the TLV selected. return the offset of the Secured Data first byte in the first SMS TPDU or Cell Broadcast Page TLV element. If the Secured Data length is zero the value returned shall be the SMS TPDU TLV length. exception ToolkitException with the following reason codes: UNAVAILABLE_ELEMENT in case of unavailable SMS TPDU or Cell Broadcast Page TLV element or wrong data format return 0;
public short	getTPUDLOffset() Looks for the TP-UDL field in the first TPDU TLV element in the Envelope data field. This method can be used on the events EVENT_FORMATTED_SMS_PP_ENV, EVENT_FORMATTED_SMS_PP_UPD, EVENT_UNFORMATTED_SMS_PP_ENV, EVENT_UNFORMATTED_SMS_PP_UPD. If the element is available it becomes the TLV selected. return TPUDL offset in the first TPDU TLV element if TPUDL exists. The TPUD length can be recovered by using the getValueByte method in Handler class. exception ToolkitException with the following reason codes: UNAVAILABLE_ELEMENT in case of unavailable TPDU TLV element or if the TPUDL field does not exist // get to the SMS TLV byte[] buffer = ViewHandler.getAPDUBuffer(); short Lc = buffer[OFFSET_LC]; short SMSTLVOffset = getTLVOffset(buffer, ToolkitConstants.TAG_SMS_TPDU, Lc, (byte)1); if (SMSTLVOffset >= Lc) ToolkitException.throwIt(ToolkitException.UNAVAILABLE_ELEMENT); currentTLVOffset = SMSTLVOffset; return 0;
public static sim.toolkit.EnvelopeHandler	getTheHandler() Returns the single system instance of the EnvelopeHandler class. The applet shall get the reference of the handler at its triggering, the beginning of the processToolkit method. return reference of the system instance exception ToolkitException with the following reason codes: HANDLER_NOT_AVAILABLE if the handler is busy. EnvelopeHandler theEnvelopeHandler = new EnvelopeHandler(); // BER TLV offset is 5 in the buffer // offset for the first TLV would be BER TLV offset + 2 theEnvelopeHandler.firstTLVOffset = (short)(BER_TLV_TAG_OFFSET + 2); theEnvelopeHandler.currentTLVOffset = (short)(BER_TLV_TAG_OFFSET + 2); return theEnvelopeHandler;