sim.access
Class SIMViewException

java.lang.Object
  |
  +--java.lang.Throwable
        |
        +--java.lang.Exception
              |
              +--java.lang.RuntimeException
                    |
                    +--javacard.framework.CardRuntimeException
                          |
                          +--sim.access.SIMViewException

public class SIMViewException
extends javacard.framework.CardRuntimeException

The SIMViewException class encapsulates specific exceptions which can be thrown by the methods of the SIMView interface in case of error.

Version:
5.4.0
See Also:
SIMView

Field Summary
static short AC_NOT_FULFILLED
          This reason code (= 3) is used to indicate that the access condition is not fulfilled by the calling applet for the called method.
static short FILE_INCONSISTENT
          This reason code (= 2) is used to indicate that the current File inconsistent with the called method.
static short FILE_NOT_FOUND
          This reason code (= 4) is used to indicate to the calling applet that the file was not found in the current directory.
static short INTERNAL_ERROR
          This reason code (= 5) is used to indicate to the calling applet that an Internal error happened during the called method.
static short INVALID_MODE
          This reason code (= 10) is used to indicate that the seek or record access mode requested is not supported by the called method.
static short INVALIDATION_STATUS_CONTRADICTION
          This reason code (= 6) is used to indicate that the called method is in contradiction with the invalidation status of the current file.
static short MAX_VALUE_REACHED
          This reason code (= 12) is used to indicate that method can not be performed as maximum value of the record is reached.
static short MEMORY_PROBLEM
          This reason code (= 13) is used to indicate that a memory problem occured.
static short NO_EF_SELECTED
          This reason code (= 1) is used to indicate that no EF is selected to complete the called method.
static short OUT_OF_FILE_BOUNDARIES
          This reason code (= 7) is used to indicate that either the length, the file offset or both passed to the called method are out of the current transparent file boundaries.
static short OUT_OF_RECORD_BOUNDARIES
          This reason code (= 8) is used to indicate that either the length, the record offset or both passed to the called method are out of the current record boundaries.
static short PATTERN_NOT_FOUND
          This reason code (= 11) is used to indicate that the requested pattern was not by the called method.
static short RECORD_NUMBER_NOT_AVAILABLE
          This reason code (= 9) is used to indicate that the indicated record number is not available is the current file.
 
Constructor Summary
SIMViewException(short reason)
          Constructs a SIMViewException with the specified reason.
 
Method Summary
static void throwIt(short reason)
          Throws the JCRE instance of SIMViewException with the specified reason.
 
Methods inherited from class javacard.framework.CardRuntimeException
getReason, setReason
 
Methods inherited from class java.lang.Object
equals
 

Field Detail

NO_EF_SELECTED

public static final short NO_EF_SELECTED
This reason code (= 1) is used to indicate that no EF is selected to complete the called method.

See Also:
Constant Field Values

FILE_INCONSISTENT

public static final short FILE_INCONSISTENT
This reason code (= 2) is used to indicate that the current File inconsistent with the called method.

See Also:
Constant Field Values

AC_NOT_FULFILLED

public static final short AC_NOT_FULFILLED
This reason code (= 3) is used to indicate that the access condition is not fulfilled by the calling applet for the called method.

See Also:
Constant Field Values

FILE_NOT_FOUND

public static final short FILE_NOT_FOUND
This reason code (= 4) is used to indicate to the calling applet that the file was not found in the current directory.

See Also:
Constant Field Values

INTERNAL_ERROR

public static final short INTERNAL_ERROR
This reason code (= 5) is used to indicate to the calling applet that an Internal error happened during the called method.

See Also:
Constant Field Values

INVALIDATION_STATUS_CONTRADICTION

public static final short INVALIDATION_STATUS_CONTRADICTION
This reason code (= 6) is used to indicate that the called method is in contradiction with the invalidation status of the current file.

See Also:
Constant Field Values

OUT_OF_FILE_BOUNDARIES

public static final short OUT_OF_FILE_BOUNDARIES
This reason code (= 7) is used to indicate that either the length, the file offset or both passed to the called method are out of the current transparent file boundaries.

See Also:
Constant Field Values

OUT_OF_RECORD_BOUNDARIES

public static final short OUT_OF_RECORD_BOUNDARIES
This reason code (= 8) is used to indicate that either the length, the record offset or both passed to the called method are out of the current record boundaries.

See Also:
Constant Field Values

RECORD_NUMBER_NOT_AVAILABLE

public static final short RECORD_NUMBER_NOT_AVAILABLE
This reason code (= 9) is used to indicate that the indicated record number is not available is the current file.

See Also:
Constant Field Values

INVALID_MODE

public static final short INVALID_MODE
This reason code (= 10) is used to indicate that the seek or record access mode requested is not supported by the called method.

See Also:
Constant Field Values

PATTERN_NOT_FOUND

public static final short PATTERN_NOT_FOUND
This reason code (= 11) is used to indicate that the requested pattern was not by the called method.

See Also:
Constant Field Values

MAX_VALUE_REACHED

public static final short MAX_VALUE_REACHED
This reason code (= 12) is used to indicate that method can not be performed as maximum value of the record is reached.

See Also:
Constant Field Values

MEMORY_PROBLEM

public static final short MEMORY_PROBLEM
This reason code (= 13) is used to indicate that a memory problem occured.

See Also:
Constant Field Values
Constructor Detail

SIMViewException

public SIMViewException(short reason)
Constructs a SIMViewException with the specified reason. To conserve on resources use throwIt() to use the JCRE instance of this class.

Parameters:
reason - the reason for the exception
Method Detail

throwIt

public static void throwIt(short reason)
                    throws SIMViewException
Throws the JCRE instance of SIMViewException with the specified reason.

Parameters:
reason - is the reason for the exception
Throws:
SIMViewException - always