Package uicc.usim.geolocation

Class GeoLocationException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

javacard.framework.CardRuntimeException

uicc.usim.geolocation.GeoLocationException

All Implemented Interfaces:

Serializable

public class GeoLocationException
extends javacard.framework.CardRuntimeException

Geographical Location exception and its associated constants.

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static final short	FUNCTION_DISABLED	This reason code (= 2) is used to indicate that the geographical location is disabled
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.
static final short	INCORRECT_PARAMETERS	This reason code (= 1) is used to indicate that the parameters are incorrect
static final short	LOCATION_REQUEST_PROCESSING	This reason code (= 6) is used to indicate that the a performGeoLocationRequest is under processing (i.e.
static final short	UNABLE_TO_PROCESS_COMMAND	This reason code (= 3) is used to indicate that the operation could not be processed

Constructor Summary

Constructors

Constructor	Description
GeoLocationException(short reason)	Construct a GeoLocationException instance with the specified reason.

Method Summary

Modifier and Type	Method	Description
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

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Field Details

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

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

LOCATION_REQUEST_PROCESSING

public static final short LOCATION_REQUEST_PROCESSING

This reason code (= 6) is used to indicate that the a performGeoLocationRequest is under processing (i.e. after the sent of a location request and before receiving the "Geographical Location Reporting" ENVELOPE command).

See Also:

• Constant Field Values

Constructor Details

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 Details

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