sim.toolkit
Class EnvelopeResponseHandler

java.lang.Object
  |
  +--sim.toolkit.ViewHandler
        |
        +--sim.toolkit.EditHandler
              |
              +--sim.toolkit.EnvelopeResponseHandler

public final class EnvelopeResponseHandler
extends EditHandler

The EnvelopeResponseHandler class contains basic methods to handle the Envelope response data field. This class will be used by the Toolkit applet in order to edit the response to current Envelope command. No constructor is available for the Toolkit applet. The EnvelopeResponseHandler class is a Temporary JCRE Entry Point Object. The only way to get a EnvelopeResponseHandler reference is through the getTheHandler() static method.

Version:
8.1.0
See Also:
ViewHandler, EditHandler, EnvelopeHandler, ToolkitException

Method Summary
static EnvelopeResponseHandler getTheHandler()
          Returns the single system instance of the EnvelopeResponseHandler class.
 void post(byte statusType)
          Pepares the Envelope response.
 void postAsBERTLV(byte statusType, byte tag)
          Prepare the Envelope response in a BER TLV structure.
 
Methods inherited from class sim.toolkit.EditHandler
appendArray, appendTLV, appendTLV, appendTLV, appendTLV, clear
 
Methods inherited from class sim.toolkit.ViewHandler
compareValue, copy, copyValue, findAndCompareValue, findAndCompareValue, findAndCopyValue, findAndCopyValue, findTLV, getLength, getValueByte, getValueLength
 
Methods inherited from class java.lang.Object
equals
 

Method Detail

getTheHandler

public static EnvelopeResponseHandler getTheHandler()
                                             throws ToolkitException
Returns the single system instance of the EnvelopeResponseHandler class. The applet shall get the reference of the handler at its triggering, the beginning of the processToolkit method.
Returns:
reference of the system instance
Throws:
ToolkitException - with the following reason codes:
  • HANDLER_NOT_AVAILABLE if the handler is busy.

post

public void post(byte statusType)
          throws ToolkitException
Pepares the Envelope response. Should be used with Envelope SMS-PP Data Download.
Parameters:
statusType - the status to be sent to the ME (SW1_RP_ACK or SW1_RP_ERROR)
Throws:
ToolkitException - with the following reason codes:
  • HANDLER_NOT_AVAILABLE if the handler is busy

postAsBERTLV

public void postAsBERTLV(byte statusType,
                         byte tag)
                  throws ToolkitException
Prepare the Envelope response in a BER TLV structure. Should be used with Envelope Call Control by SIM or MO Short Message Control by SIM. The tag value is to be used to set the Result for Call Control and MO Short Message Control by the SIM.
Parameters:
statusType - the status to be sent to the ME (SW1_RP_ACK or SW1_RP_ERROR)
tag - the BER Tag to be used at the beginning of the SIMPLE_TLV list.
Throws:
ToolkitException - with the following reason codes:
  • HANDLER_NOT_AVAILABLE if the handler is busy