uicc.usim.geolocation
Class GeoLocationException

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by java.lang.RuntimeException
              extended by javacard.framework.CardRuntimeException
                  extended by uicc.usim.geolocation.GeoLocationException
All Implemented Interfaces:
java.io.Serializable

public class GeoLocationException
extends javacard.framework.CardRuntimeException

Geographical Location exception and its associated constants.

See Also:
Serialized Form

Field Summary
static short FUNCTION_DISABLED
          This reason code (= 2) is used to indicate that the geographical location is disabled
static short INCORRECT_INFORMATION
          This reason code (= 5) is used to indicate that the information in the ProactiveResponseHandler or in the EnvelopeHandler is not correct.
static short INCORRECT_PARAMETERS
          This reason code (= 1) is used to indicate that the parameters are incorrect
static short UNABLE_TO_ACHIEVE_ACCURACY
          This reason code (= 4) is used to indicate that the requested accuracy cannot be achieved
static short UNABLE_TO_PROCESS_COMMAND
          This reason code (= 3) is used to indicate that the operation could not be processed
 
Constructor Summary
GeoLocationException(short reason)
          Construct a GeoLocationException instance with the specified reason.
 
Method Summary
static void throwIt(short reason)
          Throws the JCRE instance of the GeoLocationException class with the specified reason.
 
Methods inherited from class javacard.framework.CardRuntimeException
getReason, setReason
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

INCORRECT_PARAMETERS

public static final short INCORRECT_PARAMETERS
This reason code (= 1) is used to indicate that the parameters are incorrect

See Also:
Constant Field Values

FUNCTION_DISABLED

public static final short FUNCTION_DISABLED
This reason code (= 2) is used to indicate that the geographical location is disabled

See Also:
Constant Field Values

UNABLE_TO_PROCESS_COMMAND

public static final short UNABLE_TO_PROCESS_COMMAND
This reason code (= 3) is used to indicate that the operation could not be processed

See Also:
Constant Field Values

UNABLE_TO_ACHIEVE_ACCURACY

public static final short UNABLE_TO_ACHIEVE_ACCURACY
This reason code (= 4) is used to indicate that the requested accuracy cannot be achieved

See Also:
Constant Field Values

INCORRECT_INFORMATION

public static final short INCORRECT_INFORMATION
This reason code (= 5) is used to indicate that the information in the ProactiveResponseHandler or in the EnvelopeHandler is not correct.

See Also:
Constant Field Values
Constructor Detail

GeoLocationException

public GeoLocationException(short reason)
Construct a GeoLocationException instance with the specified reason. To conserve on resources use throwIt() method to re-use the JCRE instance of this class.

Parameters:
reason - the reason for the exception
Method Detail

throwIt

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

Parameters:
reason - the reason for the exception.
Throws:
GeoLocationException - always