org.javacardforum.javacard.biometry
Class BioException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          java.lang.RuntimeException
              javacard.framework.CardRuntimeException
                  org.javacardforum.javacard.biometry.BioException

All Implemented Interfaces:

java.io.Serializable

public class BioException

extends javacard.framework.CardRuntimeException

The BioException class encapsulates specific exceptions which can be thrown by the methods of the biometry package in case of error.

See Also:

BioBuilder, BioTemplate, OwnerBioTemplate, Serialized Form

Field Summary

static short	ILLEGAL_USE Indicates that the method should not be invoked based on the current state of the card
static short	ILLEGAL_VALUE Indicates that one or more input parameters is out of allowed bounds.
static short	INVALID_DATA Indicates that the data the system encountered is illegible.
static short	NO_SUCH_BIO_TEMPLATE Indicates that the provided bio template type is not supported by the template builder.
static short	NO_TEMPLATES_ENROLLED Indicate that no reference template is available for matching, or that the reference template is uninitialized.

Constructor Summary

BioException(short reason)
Construct a new biometric exception using a provided reason code.

Method Summary

static void

throwIt(short reason) Throws the JCRE owned instance of BioException 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

ILLEGAL_VALUE

public static final short ILLEGAL_VALUE

Indicates that one or more input parameters is out of allowed bounds.

See Also:

Constant Field Values

INVALID_DATA

public static final short INVALID_DATA

Indicates that the data the system encountered is illegible.

See Also:

Constant Field Values

NO_SUCH_BIO_TEMPLATE

public static final short NO_SUCH_BIO_TEMPLATE

Indicates that the provided bio template type is not supported by the template builder.

See Also:

Constant Field Values

NO_TEMPLATES_ENROLLED

public static final short NO_TEMPLATES_ENROLLED

Indicate that no reference template is available for matching, or that the reference template is uninitialized.

See Also:

Constant Field Values

ILLEGAL_USE

public static final short ILLEGAL_USE

Indicates that the method should not be invoked based on the current state of the card

See Also:

Constant Field Values

Constructor Detail

BioException

public BioException(short reason)

Construct a new biometric exception using a provided reason code. To conserve resources the use of throwIt(short) is recommended to throw the JCRE instance of this class.

Parameters:

reason - the reason code for this exception.

Method Detail

throwIt

public static void throwIt(short reason)
                    throws BioException

Throws the JCRE owned instance of BioException with the specified reason. JCRE owned instances of exception classes are temporary JCRE Entry Point Objects and can be accessed from any applet context. References to these objects cannot be stored in class variables or instance variables or array components. See Java Card Runtime Environment (JCRE) 2.2 Specification for details.

Parameters:

reason - the reason for the exception.

Throws:

BioException - always.