Class Mrz

java.lang.Object
es.gob.jmulticard.card.icao.Mrz

public final class Mrz extends Object
MRZ de un MRTD ICAO.
  • Field Details

    • sdFormat

      private final SimpleDateFormat sdFormat
    • mrzString

      private final String mrzString
    • rawData

      private final byte[] rawData
    • documentCode

      private final String documentCode
    • documentType

      private final Mrz.IcaoDocumentType documentType
    • issuerCountry

      private final String issuerCountry
    • documentNumber

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

      private final String name
    • surname

      private final String surname
    • dateOfBirth

      private final String dateOfBirth
    • sex

      private final String sex
    • dateOfExpiry

      private final String dateOfExpiry
    • nationality

      private final String nationality
    • subjectNumber

      private final String subjectNumber
    • documentVariant

      private final Mrz.IcaoDocumentVariant documentVariant
  • Constructor Details

    • Mrz

      public Mrz(String mrzStr) throws 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:
      IOException - Si la MRZ no se puede analizar por no estar en el formato esperado.
    • Mrz

      public Mrz(byte[] rawBytes) throws 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:
      IOException - Si la MRZ no se puede analizar por no estar en el formato esperado.
  • Method Details

    • toString

      public String toString()
      Overrides:
      toString in class 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 String readString(DataInputStream stringStream, int count) throws IOException
      Throws:
      IOException
    • trimFillerChars

      private static String trimFillerChars(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 String readStringWithFillers(DataInputStream stringStream, int count) throws IOException
      Throws:
      IOException
    • getName

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

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

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

      public 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 Date getDateOfExpiry() throws ParseException
      Obtiene la fecha de caducidad del MRTD.
      Returns:
      Fecha de caducidad del MRTD.
      Throws:
      ParseException - Si la fecha encontrada no está en el formato esperado.
    • getDocumentNumber

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

      public 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 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(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(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:
      NumberFormatException - Si el caracter no es válido para una MRZ.
    • getMrzPswd

      public byte[] getMrzPswd(CryptoHelper cryptoHelper) throws 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:
      IOException - Si no se puede obtener el valor.
    • getDocumentVariant

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