javacardx.biometry1toN

Interface OwnerBioTemplateData

All Superinterfaces:

BioTemplateData

public interface OwnerBioTemplateData
extends BioTemplateData

The OwnerBioTemplateData interface should be implemented by the applet which owns the Biometric Template Data containers. It extends the BioTemplateData interface and adds functionality to enroll a Biometric Template Data.

Since:

3.0.5

Method Summary

Methods

Modifier and Type	Method and Description
void	doFinal() Finalizes the enrollment of biometric template data.
void	init(byte[] bArray, short offset, short length) Initializes the enrollment of biometric template data.
void	update(byte[] bArray, short offset, short length) Continues the enrollment of biometric template data.

Methods inherited from interface javacardx.biometry1toN.BioTemplateData

getBioType, getPublicData, isInitialized

Method Detail

init

void init(byte[] bArray,
        short offset,
        short length)
          throws Bio1toNException

Initializes the enrollment of biometric template data. This method is also used to update biometric template data. It resets the validated flag and, in the update case, uninitializes the previous reference. Note: A correct enrollment sequence is : init,[update],doFinal. Calling #init and doFinal is mandatory, calling update is optional.

Parameters:

bArray - byte array containing the biometric template data

offset - starting offset in the bArray

length - byte length of the template data in the bArray

Throws:

Bio1toNException - with the following reason codes:

• Bio1toNException.INVALID_DATA if the submitted biometric template data does not have the required format.

update

void update(byte[] bArray,
          short offset,
          short length)
            throws Bio1toNException

Continues the enrollment of biometric template data. This method should only be used if all the input data required for enrollment is not available in one byte array. It can be called several times. Note: A correct enrollment sequence is : init,[update],doFinal. Calling init and doFinal is mandatory, calling update is optional.

Parameters:

bArray - byte array containing the biometric template data

offset - starting offset in the bArray

length - byte length of the biometric template data in the bArray

Throws:

Bio1toNException - with the following reason codes:

• Bio1toNException.ILLEGAL_USE if the biometric template data is already initialized or the current enrollment state doesn't expect this method.
• Bio1toNException.INVALID_DATA if the submitted biometric template data does not have the required format.

doFinal

void doFinal()
             throws Bio1toNException

Finalizes the enrollment of biometric template data. Final action of enrollment is to designate a biometric template data as being complete and ready for use (marks the reference as initialized, resets the try counter and unblocks the reference). This routine may also include some error checking prior to the validation of biometric template data as ready for use. Note: A correct enrollment sequence is : init,[update],doFinal. Calling init and doFinal is mandatory, calling update is optional.

Throws:

Bio1toNException - with the following reason codes:

• Bio1toNException.ILLEGAL_USE if the biometric template data is already initialized or the current enrollment state doesn't expect this method.
• Bio1toNException.INVALID_DATA if the submitted biometric template data does not have the required format.