Package uicc.system

Class HandlerBuilder

java.lang.Object

uicc.system.HandlerBuilder

public final class HandlerBuilder
extends java.lang.Object

The HandlerBuilder class is a class to create objects that are implementing TLV handler interfaces.

Field Summary

Fields

Modifier and Type	Field	Description
static byte	BER_EDIT_HANDLER
static byte	EDIT_HANDLER

Method Summary

Modifier and Type	Method	Description
static ViewHandler	buildTLVHandler(byte type, short capacity)	Allocates a TLVHandler with an internal buffer of length capacity
static ViewHandler	buildTLVHandler(byte type, short capacity, byte[] buffer, short offset, short length)	Allocates a TLVHandler with an internal buffer of length capacity.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

EDIT_HANDLER

public static final byte EDIT_HANDLER

See Also:

Constant Field Values

BER_EDIT_HANDLER

public static final byte BER_EDIT_HANDLER

See Also:

Constant Field Values

Method Detail

buildTLVHandler

public static ViewHandler buildTLVHandler(byte type,
                                          short capacity)
                                   throws javacard.framework.SystemException

Allocates a TLVHandler with an internal buffer of length capacity

Parameters:

type - indicating the type of the Handler

capacity - the length of the internal buffer of the Handler.It corresponds to the maximum size of the TLV list managed by the handler.

Returns:

a ViewHandler object

Throws:

javacard.framework.SystemException - with the following reason code:

• ILLEGAL_VALUE
  • if the type does not match with the predefined values
  • if capacityis negative
• NO_RESOURCE if there are not enough resources in the card to allocate the handler

buildTLVHandler

public static ViewHandler buildTLVHandler(byte type,
                                          short capacity,
                                          byte[] buffer,
                                          short offset,
                                          short length)
                                   throws java.lang.ArrayIndexOutOfBoundsException,
                                          javacard.framework.SystemException,
                                          java.lang.NullPointerException,
                                          ToolkitException

Allocates a TLVHandler with an internal buffer of length capacity. Copies the buffer content to an internal buffer of the TLVHandler starting at offset. The internal buffer shall be at least length long.

Parameters:

type - indicating the type of the Handler

capacity - the length of the internal buffer of the Handler. It corresponds to the maximum size of the TLV list managed by the handler.

buffer - holding initialization data for the TLV Handler the content of this buffer will be copied into the internal buffer of the handler and will be unchanged.

offset - offset into the buffer indicating the start of the content that has to be copied into the internal buffer of the handler

length - length of the content that has to be copied from the buffer

Returns:

a ViewHandler object

Throws:

javacard.framework.SystemException - with the following reason code:

• ILLEGAL_VALUE
  • if the type does not match with the predefined values
  • if capacity is negative
• NO_RESOURCE if there are not enough resources in the card to allocate the handler

java.lang.NullPointerException - if buffer is null

java.lang.ArrayIndexOutOfBoundsException -

• if offset would cause access outside array bounds, or if length is negative.
• if offset+length is greater than the length of the buffer

ToolkitException - with the following reason code:

• BAD_INPUT_PARAMETER if length is greater than capacity