public interface ProactiveHandler extends EditHandler
init(), appendTLV()...
will be used to handle generic Proactive commands (standard or future
definitions...). The ProactiveHandler class is a Temporary JCRE Entry Point Object.
The Toolkit Applets, which need to send Proactive commands,
shall call the getTheHandler() static method to get the
reference of this system instance.ViewHandler,
EditHandler,
ProactiveResponseHandler,
ToolkitException| Modifier and Type | Method and Description |
|---|---|
void |
init(byte type,
byte qualifier,
byte dstDevice)
Initializes the next Proactive command with Command Details and Device
Identities TLV.
|
void |
initCloseChannel(byte bChannelId)
Builds a Close Channel Proactive command without sending the command.
|
void |
initDisplayText(byte qualifier,
byte dcs,
byte[] buffer,
short offset,
short length)
Builds a Display Text Proactive command without sending the command.
|
void |
initGetInkey(byte qualifier,
byte dcs,
byte[] buffer,
short offset,
short length)
Builds a Get Inkey Proactive command without sending the command.
|
void |
initGetInput(byte qualifier,
byte dcs,
byte[] buffer,
short offset,
short length,
short minRespLength,
short maxRespLength)
Initialize the building of a Get Input Proactive command.
|
void |
initMoreTime()
Builds a More Time Proactive command without sending the command.
|
byte |
send()
Sends the current Proactive command.
|
appendArray, appendTLV, appendTLV, appendTLV, appendTLV, appendTLV, appendTLV, appendTLV, appendTLV, clearcompareValue, copy, copyValue, findAndCompareValue, findAndCompareValue, findAndCopyValue, findAndCopyValue, findTLV, getCapacity, getLength, getValueByte, getValueLength, getValueShortvoid init(byte type,
byte qualifier,
byte dstDevice)
type - the command typequalifier - the command qualifierdstDevice - the destination devicebyte send() throws ToolkitException
ToolkitException - with the following reason codes: UNAVAILABLE_ELEMENT if the Result Comprehension TLV is missing.
OUT_OF_TLV_BOUNDARIES if the general result byte is missing in the Result Comprehension TLV.
COMMAND_NOT_ALLOWED if the Proactive command to be sent or one of its parameter is
not allowed by the CAT Runtime Environment.void initDisplayText(byte qualifier,
byte dcs,
byte[] buffer,
short offset,
short length)
throws java.lang.NullPointerException,
java.lang.ArrayIndexOutOfBoundsException,
ToolkitException
qualifier - Display Text command qualifierdcs - data coding schemebuffer - reference to the text string source bufferoffset - offset of the text string in the source bufferlength - length of the text string in the source bufferjava.lang.NullPointerException - if buffer is nulljava.lang.ArrayIndexOutOfBoundsException - if offset or length or both would cause access outside array boundsToolkitException - with the following reason codes: HANDLER_OVERFLOW if the ProactiveHandler buffer is to small to put the requested data void initGetInkey(byte qualifier,
byte dcs,
byte[] buffer,
short offset,
short length)
throws java.lang.NullPointerException,
java.lang.ArrayIndexOutOfBoundsException,
ToolkitException
qualifier - Get Inkey command qualifierdcs - data coding schemebuffer - reference to the displayed text string source bufferoffset - offset of the displayed text string in the source bufferlength - length of the displayed text string in the source bufferjava.lang.NullPointerException - if buffer is nulljava.lang.ArrayIndexOutOfBoundsException - if offset or length or both would cause access outside array boundsToolkitException - with the following reason codes: HANDLER_OVERFLOW if the ProactiveHandler buffer is to small to put the requested datavoid initGetInput(byte qualifier,
byte dcs,
byte[] buffer,
short offset,
short length,
short minRespLength,
short maxRespLength)
throws java.lang.NullPointerException,
java.lang.ArrayIndexOutOfBoundsException,
ToolkitException
qualifier - Get Input command qualifierdcs - data coding schemebuffer - reference to the displayed text string source bufferoffset - offset of the displayed text string in the source bufferlength - length of the displayed text string in the source bufferminRespLength - minimal length of the response text stringmaxRespLength - maximal length of the response text stringjava.lang.NullPointerException - if buffer is nulljava.lang.ArrayIndexOutOfBoundsException - if offset or length or both would cause access outside array boundsToolkitException - with the following reason codes: HANDLER_OVERFLOW if the ProactiveHandler buffer is to small to put the requested datavoid initCloseChannel(byte bChannelId)
bChannelId - the channel identifier to be closed.void initMoreTime()