Class Mrz


  • public final class Mrz
    extends java.lang.Object
    MRZ de un MRTD ICAO.
    • Constructor Summary

      Constructors 
      Constructor Description
      Mrz​(byte[] rawBytes)
      Construye la MRZ del un MRTD a partir del contenido del fichero DG1 o de su representación textual tal y como está immpresa en el soporte.
      Mrz​(java.lang.String mrzStr)
      Construye la MRZ del un MRTD a partir de su representación textual tal y como está immpresa en el soporte.
    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      private static char checkDigit​(java.lang.String str)
      Calcula el dígito de control 7-3-1 de un fragmento la MRZ.
      private static char checkDigit​(java.lang.String str, boolean preferFillerOverZero)
      Calcula el dígito de control 7-3-1 para un fragmento de la MRZ.
      private static int decodeMrzDigit​(byte ch)
      Obtiene el valor numérico de un caracter MRZ (para el cálculo de los dígitos de control).
      byte[] getBytes()
      Obtiene el contenido binario del MRZ.
      java.util.Date getDateOfBirth()
      Obtiene la fecha de nacimiento del titular.
      java.util.Date getDateOfExpiry()
      Obtiene la fecha de caducidad del MRTD.
      java.lang.String getDocumentNumber()
      Obtiene el número de soporte del MRTD.
      Mrz.IcaoDocumentType getDocumentType()
      Obtiene el tipo de MRTD.
      Mrz.IcaoDocumentVariant getDocumentVariant()
      Obtiene la variante de este MRTD.
      java.lang.String getIssuerCountry()
      Obtiene el país emisor del MRTD.
      byte[] getMrzInformation()
      Devuelve el 'MRZ Information' como array de octetos.
      byte[] getMrzPswd​(CryptoHelper cryptoHelper)
      Calcula el valor de inicialización (BAC, EAC, PACE) de la MRZ.
      java.lang.String getName()
      Obtiene el nombre del titular.
      java.lang.String getNationality()
      Obtiene la nacionalidad del titular.
      byte[] getRawData()
      Obtiene el contenido binario directo del objeto DG01.
      Gender getSex()
      Obtiene el sexo del titular.
      java.lang.String getSubjectNumber()
      Obtiene el número del MRTD.
      java.lang.String getSurname()
      Obtiene los apellidos del titular.
      private static java.lang.String readString​(java.io.DataInputStream stringStream, int count)  
      private static java.lang.String readStringWithFillers​(java.io.DataInputStream stringStream, int count)  
      java.lang.String toString()  
      private static java.lang.String trimFillerChars​(java.lang.String str)
      Reemplaza el caracter '<' por ' ' y elimina los espacios en blanco al principio y al final.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
    • Field Detail

      • sdFormat

        private final java.text.SimpleDateFormat sdFormat
      • mrzString

        private final java.lang.String mrzString
      • rawData

        private final byte[] rawData
      • documentCode

        private final java.lang.String documentCode
      • issuerCountry

        private final java.lang.String issuerCountry
      • documentNumber

        private final java.lang.String documentNumber
        Número de soporte.
      • name

        private final java.lang.String name
      • surname

        private final java.lang.String surname
      • dateOfBirth

        private final java.lang.String dateOfBirth
      • sex

        private final java.lang.String sex
      • dateOfExpiry

        private final java.lang.String dateOfExpiry
      • nationality

        private final java.lang.String nationality
      • subjectNumber

        private final java.lang.String subjectNumber
    • Constructor Detail

      • Mrz

        public Mrz​(java.lang.String mrzStr)
            throws java.io.IOException
        Construye la MRZ del un MRTD a partir de su representación textual tal y como está immpresa en el soporte.
        Parameters:
        mrzStr - Texto de la MRZ impresa.
        Throws:
        java.io.IOException - Si la MRZ no se puede analizar por no estar en el formato esperado.
      • Mrz

        public Mrz​(byte[] rawBytes)
            throws java.io.IOException
        Construye la MRZ del un MRTD a partir del contenido del fichero DG1 o de su representación textual tal y como está immpresa en el soporte.
        Parameters:
        rawBytes - Contenido del fichero DG1 del MRTD o texto de la MRZ impresa.
        Throws:
        java.io.IOException - Si la MRZ no se puede analizar por no estar en el formato esperado.
    • Method Detail

      • toString

        public java.lang.String toString()
        Overrides:
        toString in class java.lang.Object
      • getBytes

        public byte[] getBytes()
        Obtiene el contenido binario del MRZ. Puede ser el contenido del fichero DG1 del MRTD o simplemente el texto impreso en el soporte.
        Returns:
        Contenido binario del MRZ.
      • readString

        private static java.lang.String readString​(java.io.DataInputStream stringStream,
                                                   int count)
                                            throws java.io.IOException
        Throws:
        java.io.IOException
      • trimFillerChars

        private static java.lang.String trimFillerChars​(java.lang.String str)
        Reemplaza el caracter '<' por ' ' y elimina los espacios en blanco al principio y al final.
        Parameters:
        str - Texto de entrada.
        Returns:
        Texto con las sustituciones hechas.
      • readStringWithFillers

        private static java.lang.String readStringWithFillers​(java.io.DataInputStream stringStream,
                                                              int count)
                                                       throws java.io.IOException
        Throws:
        java.io.IOException
      • getName

        public java.lang.String getName()
        Obtiene el nombre del titular.
        Returns:
        Nombre del titular.
      • getSurname

        public java.lang.String getSurname()
        Obtiene los apellidos del titular.
        Returns:
        Apellidos del titular.
      • getDateOfBirth

        public java.util.Date getDateOfBirth()
                                      throws java.text.ParseException
        Obtiene la fecha de nacimiento del titular.
        Returns:
        Fecha de nacimiento del titular.
        Throws:
        java.text.ParseException - Si la fecha encontrada no está en el formato esperado.
      • getNationality

        public java.lang.String getNationality()
        Obtiene la nacionalidad del titular.
        Returns:
        Nacionalidad del titular.
      • getSex

        public Gender getSex()
        Obtiene el sexo del titular.
        Returns:
        Sexo del titular.
      • getDateOfExpiry

        public java.util.Date getDateOfExpiry()
                                       throws java.text.ParseException
        Obtiene la fecha de caducidad del MRTD.
        Returns:
        Fecha de caducidad del MRTD.
        Throws:
        java.text.ParseException - Si la fecha encontrada no está en el formato esperado.
      • getDocumentNumber

        public java.lang.String getDocumentNumber()
        Obtiene el número de soporte del MRTD.
        Returns:
        Número de soporte del MRTD.
      • getIssuerCountry

        public java.lang.String getIssuerCountry()
        Obtiene el país emisor del MRTD.
        Returns:
        País emisor del MRTD.
      • getDocumentType

        public Mrz.IcaoDocumentType getDocumentType()
        Obtiene el tipo de MRTD.
        Returns:
        Tipo de MRTD.
      • getSubjectNumber

        public java.lang.String getSubjectNumber()
        Obtiene el número del MRTD.
        Returns:
        Número del MRTD.
      • getRawData

        public byte[] getRawData()
        Obtiene el contenido binario directo del objeto DG01.
        Returns:
        Contenido binario directo del objeto DG01.
      • getMrzInformation

        public byte[] getMrzInformation()
        Devuelve el 'MRZ Information' como array de octetos.
        Returns:
        'MRZ Information' (binario).
      • checkDigit

        private static char checkDigit​(java.lang.String str)
        Calcula el dígito de control 7-3-1 de un fragmento la MRZ.
        Parameters:
        str - Fragmento de la MRZ.
        Returns:
        Dígito de control (de '0' a '9').
      • checkDigit

        private static char checkDigit​(java.lang.String str,
                                       boolean preferFillerOverZero)
        Calcula el dígito de control 7-3-1 para un fragmento de la MRZ. Si preferFillerOverZero está establecido a true entonces '<' se devolverá en la comprobación del dígito 0.
        Parameters:
        str - Porción de la MRZ.
        preferFillerOverZero - Preferencia de relleno.
        Returns:
        Dígito de control (del '0' al '9' o '<').
      • decodeMrzDigit

        private static int decodeMrzDigit​(byte ch)
        Obtiene el valor numérico de un caracter MRZ (para el cálculo de los dígitos de control).
        Parameters:
        ch - Caracter de la MRZ.
        Returns:
        Valor numérico del caracter.
        Throws:
        java.lang.NumberFormatException - Si el caracter no es válido para una MRZ.
      • getMrzPswd

        public byte[] getMrzPswd​(CryptoHelper cryptoHelper)
                          throws java.io.IOException
        Calcula el valor de inicialización (BAC, EAC, PACE) de la MRZ. Siguiendo la especificación ICAO 9303:
        KDFπ(π) = KDF(f(π),3)
        K= f(π) = SHA-1(Serial Number || Date of Birth || Date of Expiry).
        Aquí se genera el valor de K que deberá posteriormente ser pasado como parámetro de la función KDF(K,3) para generar la contraseña.
        Parameters:
        cryptoHelper - Clase para la realización de operaciones criptográficas.
        Returns:
        K Valor de inicialización.
        Throws:
        java.io.IOException - Si no se puede obtener el valor.
      • getDocumentVariant

        public Mrz.IcaoDocumentVariant getDocumentVariant()
        Obtiene la variante de este MRTD.
        Returns:
        Variante de este MRTD.