| java.lang.Object
 sim.toolkit.ViewHandler
sim.toolkit.EditHandler
All known Subclasses: sim.toolkit.ProactiveHandler, sim.toolkit.EnvelopeResponseHandler,
| Constructor Summary | |
| | EditHandler()
Default constructor. | | | EditHandler(byte[] buffer, short offset, short length)
Builds a new EditHandler object. |
| Method Summary | |
| public void | appendArray(byte[] buffer, short offset, short length)
Appends a buffer into the EditHandler buffer.
A successful append does not modify the TLV selected.
The TLV list structure of the handler should be maintained by the
applet in the appended array (e.g. | | public void | appendTLV(byte tag, byte[] value, short valueOffset, short valueLength)
Appends a TLV element to the current TLV list (byte array format). | | public void | appendTLV(byte tag, byte value)
Appends a TLV element to the current TLV list (1-byte element). | | public void | appendTLV(byte tag, byte value1, byte value2)
Appends a TLV element to the current TLV list (2-byte element)
This method is useful to add double byte elements as Device Identities,
Duration or Response Length. | | public void | appendTLV(byte tag, byte value1, byte[] value2, short value2Offset, short value2Length)
Appends a TLV element to the current TLV list (1 byte and a
byte array format). | | public void | clear()
Clears the TLV list of an EditHandler and resets the current
TLV selected. |
| EditHandler | | EditHandler()(Code) | | Default constructor.
|
| appendArray | | public void appendArray(byte[] buffer, short offset, short length) throws NullPointerException, ArrayIndexOutOfBoundsException, ToolkitException(Code) | | Appends a buffer into the EditHandler buffer.
A successful append does not modify the TLV selected.
The TLV list structure of the handler should be maintained by the
applet in the appended array (e.g. the length of the TLV element
should be coded according to ISO 7816-6), if the TLV manipulation
methods are to be used afterwards with the handler.
Notes:
- If
offset or
length parameter is negative an
ArrayIndexOutOfBoundsException
exception is thrown and no append is performed.
- If
offset+length is greater than
buffer.length, the length of the
buffer array an
ArrayIndexOutOfBoundsException exception is
thrown and no append is performed.
Parameters:
buffer - the buffer containing data for copy
Parameters:
offset - the offset in the buffer
Parameters:
length - the value length of the buffer
exception:
NullPointerException - if buffer is null
exception:
ArrayIndexOutOfBoundsException - if append would cause access of data outside array bounds
exception:
ToolkitException - with the following reason codes: HANDLER_OVERFLOW if the EditHandler buffer is to small to append the requested dataHANDLER_NOT_AVAILABLE if the handler is busy
|
| appendTLV | | public void appendTLV(byte tag, byte[] value, short valueOffset, short valueLength) throws NullPointerException, ArrayIndexOutOfBoundsException, ToolkitException(Code) | | Appends a TLV element to the current TLV list (byte array format).
A successful append does not modify the TLV selected.
Notes:
- If
valueOffset or
valueLength parameter is negative an
ArrayIndexOutOfBoundsException
exception is thrown and no append is performed.
- If
valueOffset+valueLength is
greater than value.length, the length
of the value array an
ArrayIndexOutOfBoundsException exception
is thrown and no append is performed.
Parameters:
tag - the tag of the TLV to append, including the ComprehensionRequired flag
Parameters:
value - the buffer containing the TLV value
Parameters:
valueOffset - the offset of the TLV value in the buffer
Parameters:
valueLength - the value length of the TLV to append
exception:
NullPointerException - if value is null
exception:
ArrayIndexOutOfBoundsException - if append would cause access of data outside array bounds
exception:
ToolkitException - with the following reason codes: HANDLER_OVERFLOW if the EditHandler buffer is to small to append the requested dataHANDLER_NOT_AVAILABLE if the handler is busyBAD_INPUT_PARAMETER if valueLength is greater than 255
|
| appendTLV | | public void appendTLV(byte tag, byte value) throws ToolkitException(Code) | | Appends a TLV element to the current TLV list (1-byte element).
This method is useful to add single byte elements as Item Identifier
or Tone.
A successful append does not modify the TLV selected.
Parameters:
tag - the tag of the TLV to append, including the Comprehension Required flag
Parameters:
value - the TLV value on 1 byte
exception:
ToolkitException - with the following reason codes: HANDLER_OVERFLOW if the EditHandler buffer is to small to append the requested dataHANDLER_NOT_AVAILABLE if the handler is busy
|
| appendTLV | | public void appendTLV(byte tag, byte value1, byte value2) throws ToolkitException(Code) | | Appends a TLV element to the current TLV list (2-byte element)
This method is useful to add double byte elements as Device Identities,
Duration or Response Length. A successful append does not modify the
TLV selected.
Parameters:
tag - the tag of the TLV to append, including the Comprehension Required flag
Parameters:
value1 - the 1st byte (msb) of the TLV value
Parameters:
value2 - the 2nd byte (lsb) of the TLV value
exception:
ToolkitException - with the following reason codes: HANDLER_OVERFLOW if the EditHandler buffer is to small to append the requested dataHANDLER_NOT_AVAILABLE if the handler is busy
|
| appendTLV | | public void appendTLV(byte tag, byte value1, byte[] value2, short value2Offset, short value2Length) throws NullPointerException, ArrayIndexOutOfBoundsException, ToolkitException(Code) | | Appends a TLV element to the current TLV list (1 byte and a
byte array format).
A successful append does not modify the TLV selected.
Notes:
- If
value2Offset or
value2Length parameter is negative
an ArrayIndexOutOfBoundsException
exception is thrown and no append is performed.
- If
value2Offset+value2Length is greater
than value2.length, the length
of the value2 array an
ArrayIndexOutOfBoundsException exception is thrown
and no append is performed.
Parameters:
tag - the tag of the TLV to append, including the Comprehension Required flag
Parameters:
value1 - the first byte in the value field
Parameters:
value2 - the buffer containing the rest of the TLV field
Parameters:
value2Offset - the offset of the rest of the TLV field in the buffer
Parameters:
value2Length - the value length of the rest of the TLVfield to append
exception:
NullPointerException - if value2 is null
exception:
ArrayIndexOutOfBoundsException - if append would cause access of data outside array bounds.
exception:
ToolkitException - with the following reason codes: HANDLER_OVERFLOW if the EditHandler buffer is to small to append the requested dataHANDLER_NOT_AVAILABLE if the handler is busyBAD_INPUT_PARAMETER if value2Length is greater than 254
|
| clear | | public void clear() throws ToolkitException(Code) | | Clears the TLV list of an EditHandler and resets the current
TLV selected.
exception:
ToolkitException - with the following reason codes: HANDLER_NOT_AVAILABLE if the handler is busy
|
| Methods inherited from sim.toolkit.ViewHandler | public byte compareValue(short valueOffset, byte[] compareBuffer, short compareOffset, short compareLength) throws NullPointerException, ArrayIndexOutOfBoundsException, ToolkitException(Code)(Java Doc)
public short copy(byte[] dstBuffer, short dstOffset, short dstLength) throws NullPointerException, ArrayIndexOutOfBoundsException, ToolkitException(Code)(Java Doc)
public short copyValue(short valueOffset, byte[] dstBuffer, short dstOffset, short dstLength) throws NullPointerException, ArrayIndexOutOfBoundsException, ToolkitException(Code)(Java Doc)
public byte findAndCompareValue(byte tag, byte[] compareBuffer, short compareOffset) throws NullPointerException, ArrayIndexOutOfBoundsException, ToolkitException(Code)(Java Doc)
public byte findAndCompareValue(byte tag, byte occurrence, short valueOffset, byte[] compareBuffer, short compareOffset, short compareLength) throws NullPointerException, ArrayIndexOutOfBoundsException, ToolkitException(Code)(Java Doc)
public short findAndCopyValue(byte tag, byte[] dstBuffer, short dstOffset) throws NullPointerException, ArrayIndexOutOfBoundsException, ToolkitException(Code)(Java Doc)
public short findAndCopyValue(byte tag, byte occurrence, short valueOffset, byte[] dstBuffer, short dstOffset, short dstLength) throws NullPointerException, ArrayIndexOutOfBoundsException, ToolkitException(Code)(Java Doc)
public byte findTLV(byte tag, byte occurrence) throws ToolkitException(Code)(Java Doc)
public static byte[] getAPDUBuffer(byte[] buffer)(Code)(Java Doc)
public static byte[] getAPDUBuffer()(Code)(Java Doc)
protected short getLastTLVOffset(byte[] buffer, short Lc)(Code)(Java Doc)
public short getLength() throws ToolkitException(Code)(Java Doc)
protected short getTLVOffset(byte[] buffer, byte tag, short Lc, short occurrence)(Code)(Java Doc)
public byte getValueByte(short valueOffset) throws ToolkitException(Code)(Java Doc)
public short getValueLength() throws ToolkitException(Code)(Java Doc)
public static void setAPDUBuffer(byte[] buffer, short length)(Code)(Java Doc)
public static void setAPDUBuffer(short length)(Code)(Java Doc)
public static void setOutBufferData(short length)(Code)(Java Doc)
|
|
|