public class AdminFileViewBuilder
extends java.lang.Object
AdminFileViewBuilder class provides a way to get a administrative view of a UICC File system server.
The AdminFileView objects returned by the methods of this class are permanent JCRE
Entry Point Objects.| Modifier and Type | Method and Description |
|---|---|
static AdminFileView |
getTheAdminFileView(javacard.framework.AID aid,
byte bType)
Method to get a reference to a AdminFileView object on an ADF file system server.
|
static AdminFileView |
getTheAdminFileView(byte[] buffer,
short bOffset,
byte bLength,
byte bType)
Method to get a reference to a AdminFileView object on an ADF file system server.
|
static AdminFileView |
getTheUICCAdminFileView(byte bType)
Method to get a reference to a AdminFileView object on the UICC file system server.
|
public static AdminFileView getTheUICCAdminFileView(byte bType) throws javacard.framework.SystemException
null if the Applet.register()
has not yet been invoked, or the filesystem server returns nullbType - defining the type of the file context associated with the AdminFileView object
the following values are allowed
JCSystem.NOT_A_TRANSIENT_OBJECT
JCSystem.CLEAR_ON_RESET
JCSystem.CLEAR_ON_DESELECTjavacard.framework.SystemException - with the following reason codes:SystemException.ILLEGAL_VALUE if bType is not a valid value.
SystemException.NO_TRANSIENT_SPACE if sufficient transient space is not available.
SystemException.ILLEGAL_TRANSIENT if the current applet context
is not the currently selected applet context and CLEAR_ON_DESELECT is specified.
public static AdminFileView getTheAdminFileView(javacard.framework.AID aid, byte bType) throws java.lang.NullPointerException, javacard.framework.SystemException
null if the Applet.register()
has not yet been invoked, or the filesystem server does not
exist or the filesystem server returns nullbType - defining the type of the file context associated with the AdminFileView object
the following values are allowed
JCSystem.NOT_A_TRANSIENT_OBJECT
JCSystem.CLEAR_ON_RESET
JCSystem.CLEAR_ON_DESELECTaid - Description of the Parameterjava.lang.NullPointerException - if buffer is nulljavacard.framework.SystemException - with the following reason codes:SystemException.ILLEGAL_VALUE if bType is not a valid value.
SystemException.NO_TRANSIENT_SPACE if sufficient transient space is not available.
SystemException.ILLEGAL_TRANSIENT if the current applet context
is not the currently selected applet context and CLEAR_ON_DESELECT is specified.
public static AdminFileView getTheAdminFileView(byte[] buffer, short bOffset, byte bLength, byte bType) throws java.lang.NullPointerException, java.lang.ArrayIndexOutOfBoundsException, javacard.framework.SystemException
null if the Applet.register()
has not yet been invoked, or the filesystem server does not
exist or the filesystem server returns null
Notes:
bOffset or bLength
is negative an ArrayIndexOutOfBoundsException exception is thrown.
bOffset+bLength is greater than buffer.length, the length
of the buffer array an ArrayIndexOutOfBoundsException exception is thrown.
buffer - thats holds the AIDbOffset - offset into the buffer indicating the start of the AIDbType - defining the type of the file context associated with the AdminFileView object
the following values are allowed
JCSystem.NOT_A_TRANSIENT_OBJECT
JCSystem.CLEAR_ON_RESET
JCSystem.CLEAR_ON_DESELECTbLength - the length of the AID bytes in bufferjava.lang.NullPointerException - if buffer is nulljava.lang.ArrayIndexOutOfBoundsException - in case of access outside array boundsjavacard.framework.SystemException - with the following reason codes:SystemException.ILLEGAL_VALUE if bType is not a valid value or bLength is not in the range of 5 - 16 bytes.
SystemException.NO_TRANSIENT_SPACE if sufficient transient space is not available.
SystemException.ILLEGAL_TRANSIENT if the current applet context
is not the currently selected applet context and CLEAR_ON_DESELECT is specified.