org.jmrtd.lds.icao

Class DG2File

java.lang.Object

org.jmrtd.lds.AbstractTaggedLDSFile

org.jmrtd.lds.DataGroup

org.jmrtd.lds.CBEFFDataGroup<FaceInfo>

org.jmrtd.lds.icao.DG2File

All Implemented Interfaces:

Serializable, LDSElement, LDSFile

public class DG2File
extends CBEFFDataGroup<FaceInfo>

File structure for the EF_DG2 file. Datagroup 2 contains the facial features of the document holder. See A 13.3 in MRTD's LDS document (or equivalent in Doc 9303).

Version:

$Revision: 1613 $

Author:

Cees-Bart Breunesse ([email protected]), Martijn Oostdijk ([email protected])

See Also:

Serialized Form

Field Summary

Fields inherited from interface org.jmrtd.lds.LDSFile

EF_COM_TAG, EF_DG1_TAG, EF_DG10_TAG, EF_DG11_TAG, EF_DG12_TAG, EF_DG13_TAG, EF_DG14_TAG, EF_DG15_TAG, EF_DG16_TAG, EF_DG2_TAG, EF_DG3_TAG, EF_DG4_TAG, EF_DG5_TAG, EF_DG6_TAG, EF_DG7_TAG, EF_DG8_TAG, EF_DG9_TAG, EF_SOD_TAG

Constructor Summary

Constructors

Constructor and Description
DG2File(InputStream inputStream) Creates a new file based on an input stream.
DG2File(List<FaceInfo> faceInfos) Creates a new file with the specified records.

Method Summary

Modifier and Type	Method and Description
void	addFaceInfo(FaceInfo faceInfo) Adds a face info to this file.
byte[]	getEncoded() Gets the contents of this file as byte array, includes the ICAO tag and length.
List<FaceInfo>	getFaceInfos() Gets the face infos embedded in this file.
protected void	readContent(InputStream inputStream) Reads the contents of the data group from an input stream.
void	removeFaceInfo(int index) Removes a face info from this file.
String	toString() Gets a textual representation of this file.
protected void	writeContent(OutputStream outputStream) Writes the contents of the data group to an output stream.

Methods inherited from class org.jmrtd.lds.CBEFFDataGroup

add, addAll, equals, getSubRecords, hashCode, remove, writeOptionalRandomData

Methods inherited from class org.jmrtd.lds.AbstractTaggedLDSFile

getLength, getTag, readObject, writeObject

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

DG2File

public DG2File(List<FaceInfo> faceInfos)

Creates a new file with the specified records.

Parameters:

faceInfos - records

DG2File

public DG2File(InputStream inputStream)
        throws IOException

Creates a new file based on an input stream.

Parameters:

inputStream - an input stream

Throws:

IOException - on error reading from input stream

Method Detail

readContent

protected void readContent(InputStream inputStream)
                    throws IOException

Description copied from class: AbstractTaggedLDSFile

Reads the contents of the data group from an input stream. Client code implementing this method should only read the contents from the input stream, not the tag or length of the data group.

Specified by:

readContent in class AbstractTaggedLDSFile

Parameters:

inputStream - the input stream to read from

Throws:

IOException - on error reading from input stream

writeContent

protected void writeContent(OutputStream outputStream)
                     throws IOException

Description copied from class: AbstractTaggedLDSFile

Writes the contents of the data group to an output stream. Client code implementing this method should only write the contents to the output stream, not the tag or length of the data group.

Specified by:

writeContent in class AbstractTaggedLDSFile

Parameters:

outputStream - the output stream to write to

Throws:

IOException - on error writing to output stream

toString

public String toString()

Gets a textual representation of this file.

Overrides:

toString in class DataGroup

Returns:

a textual representation of this file

getFaceInfos

public List<FaceInfo> getFaceInfos()

Gets the face infos embedded in this file.

Returns:

face infos

addFaceInfo

public void addFaceInfo(FaceInfo faceInfo)

Adds a face info to this file.

Parameters:

faceInfo - the face info to add

removeFaceInfo

public void removeFaceInfo(int index)

Removes a face info from this file.

Parameters:

index - the index of the face info to remove

getEncoded

public byte[] getEncoded()

Gets the contents of this file as byte array, includes the ICAO tag and length.

Specified by:

getEncoded in interface LDSElement

Returns:

a byte array containing the file