Package br.ufsc.labsec.signature.conformanceVerifier.pdf

Class ObjectEvaluation

java.lang.Object
br.ufsc.labsec.signature.conformanceVerifier.pdf.PDDocumentUtils
br.ufsc.labsec.signature.conformanceVerifier.pdf.ObjectEvaluation
public class ObjectEvaluation
extends PDDocumentUtils
Esta classe engloba métodos para a avaliação de objetos em uma assinatura PDF.

  • Field Details

    • objects

      protected List<org.apache.pdfbox.cos.COSObjectKey> objects
      Lista de objetos a serem avaliados

    • p

      protected int p
      Valor do parâmetro de transformação

  • Constructor Details

  • Method Details

    • parseDictionary

      protected List<Action> parseDictionary​(org.apache.pdfbox.cos.COSDictionary dictionary1, org.apache.pdfbox.cos.COSDictionary dictionary2, Action.Path path, org.apache.pdfbox.cos.COSObjectKey origin, Map<org.apache.pdfbox.cos.COSObjectKey,​List<Action>> visited)

    • computeDocument

      protected byte[] computeDocument​(ObjectEvaluation.SelectiveComputation selectiveComputation) throws IOException
      Computa o documento PDF, retornando os bytes do documento com as informações

      Appendix 1: Computation of Object Digests

      Section 1.2.1: Document

      When calculating a digest for the document, the following items are included, in order:

           * A) The values of the following entries in the document catalog (see Table 3.25), if present: AA, Legal; and Perms
     * B) The values of the following entries in the document information dictionary (see Table 10.2), if present: Title, Author, Keywords, and Subject
     * C) All page objects in the document, in page order, as described in Section I.2.2, "Page Objects"
     * D) All named pages specified in the Pages name tree, sorted by name, as described in Section I.2.3, "Named Pages"
     * E) All embedded files specified in the EmbeddedFiles name tree, sorted by name, as described in Section I.2.4, "Embedded Files"
     * Exception 1: we include the AcroForm signature fields in the computation.
      Parameters:
      selectiveComputation - computação seletiva que define quais objetos devem ser considerados exceções
      Returns:
      os bytes do documento com as informações computadas
      Throws:
      IOException - se ocorrer algum erro de I/O durante a computação do documento

    • ifPresent

      protected void ifPresent​(org.apache.pdfbox.cos.COSDictionary dictionary, org.apache.pdfbox.cos.COSName entry, MessageDigest digest, Set<org.apache.pdfbox.cos.COSObjectKey> visited, ObjectEvaluation.SelectiveComputation selectiveComputation) throws IOException
      Throws:
      IOException

    • ifPresent

      protected void ifPresent​(org.apache.pdfbox.cos.COSDictionary dictionary, org.apache.pdfbox.cos.COSName entry, MessageDigest digest, Set<org.apache.pdfbox.cos.COSObjectKey> visited, ObjectEvaluation.SelectiveComputation selectiveComputation, boolean inheritable) throws IOException
      Throws:
      IOException

    • ifPresent

      protected void ifPresent​(org.apache.pdfbox.cos.COSDictionary dictionary, org.apache.pdfbox.cos.COSName entry, MessageDigest digest, Set<org.apache.pdfbox.cos.COSObjectKey> visited, ObjectEvaluation.SelectiveComputation selectiveComputation, boolean inheritable, Callable<?> callable) throws IOException
      Throws:
      IOException

    • computePageObject

      protected boolean computePageObject​(org.apache.pdfbox.cos.COSBase base, MessageDigest digest, Set<org.apache.pdfbox.cos.COSObjectKey> visited, Set<org.apache.pdfbox.cos.COSObjectKey> previousExistingFields, ObjectEvaluation.SelectiveComputation selectiveComputation, org.apache.pdfbox.pdmodel.PDDocument document) throws IOException
      Computa os objetos de página.

      Appendix 1: Computation of Object Digests

      Section 1.2.2: Page Objects

      For page objects (see Table 3.27), the digest includes the values of the following entries, in order, if present. For entries listed as inheritable, their values may be inherited from ancestor nodes in the page tree if not specified explicitly.

         * A) MediaBox (inheritable), CropBox (inheritable), Resources (inheritable), Contents, Rotate (inheritable), AA, ANNOTS
      Parameters:
      base - o objeto base a ser computado
      digest - o fluxo de saída onde os bytes computados serão escritos
      visited - um conjunto de chaves de objetos visitados para evitar computação duplicada
      previousExistingFields - um conjunto de chaves de objetos de campos existentes anteriormente
      selectiveComputation - a computação seletiva que define quais objetos devem ser considerados exceções
      document - o documento PDF atual, usado para verificar se o objeto é uma página válida
      Returns:
      verdadeiro se o objeto foi computado com sucesso, falso caso contrário
      Throws:
      IOException - se ocorrer algum erro de I/O durante a computação do objeto de página

    • computeNamedPage

      protected boolean computeNamedPage​(org.apache.pdfbox.cos.COSBase base, MessageDigest digest, Set<org.apache.pdfbox.cos.COSObjectKey> visited, Set<org.apache.pdfbox.cos.COSObjectKey> previousExistingFields, ObjectEvaluation.SelectiveComputation selectiveComputation, org.apache.pdfbox.pdmodel.PDDocument document) throws IOException
      Computa uma página nomeada.

      Appendix 1: Computation of Object Digests

      Section 1.2.3: Named Pages

      For named pages (see Section 8.6.5, “Named Pages”), only the Contents and Annots entries are digested, as shown in Section I.2.2, “Page Objects,” above.

      Parameters:
      base - o objeto base a ser computado
      digest - o fluxo de saída onde os bytes computados serão escritos
      visited - um conjunto de chaves de objetos visitados para evitar computação duplicada
      previousExistingFields - um conjunto de chaves de objetos de campos existentes anteriormente
      selectiveComputation - a computação seletiva que define quais objetos devem ser considerados exceções
      document - o documento PDF atual, usado para verificar se o objeto é uma página válida
      Returns:
      verdadeiro se o objeto foi computado com sucesso, falso caso contrário
      Throws:
      IOException - se ocorrer algum erro de I/O durante a computação do objeto de página nomeada

    • computeEmbeddedFiles

      protected boolean computeEmbeddedFiles​(org.apache.pdfbox.cos.COSString filename, org.apache.pdfbox.cos.COSBase base, MessageDigest digest, Set<org.apache.pdfbox.cos.COSObjectKey> visited, ObjectEvaluation.SelectiveComputation selectiveComputation) throws IOException
      Computa os arquivos incorporados.

      Appendix 1: Computation of Object Digests

      Section 1.2.4: Embedded Files

      The document’s embedded files (as specified in the EmbeddedFiles name tree) are sorted by name. For each embedded file, the following values are digested, in order: 

           * A) The name of the embedded file
     * B) The stream corresponding to the file
      Parameters:
      filename - o nome do arquivo incorporado
      base - o objeto base que representa o arquivo incorporado
      digest - o fluxo de saída onde os bytes computados serão escritos
      visited - um conjunto de chaves de objetos visitados para evitar computação duplicada
      selectiveComputation - a computação seletiva que define quais objetos devem ser considerados exceções
      Returns:
      verdadeiro se o arquivo incorporado foi computado com sucesso, falso caso contrário
      Throws:
      IOException - se ocorrer algum erro de I/O durante a computação do arquivo incorporado

    • computeAnnotations

      protected boolean computeAnnotations​(org.apache.pdfbox.cos.COSBase base, MessageDigest digest, Set<org.apache.pdfbox.cos.COSObjectKey> visited, Set<org.apache.pdfbox.cos.COSObjectKey> existingSignatureFields, ObjectEvaluation.SelectiveComputation selectiveComputation, org.apache.pdfbox.pdmodel.PDDocument document) throws IOException
      Computa as anotações de um array de objetos.
      Parameters:
      base - o objeto base que contém o array de anotações
      digest - o fluxo de saída onde os bytes computados serão escritos
      visited - um conjunto de chaves de objetos visitados para evitar computação duplicada
      existingSignatureFields - um conjunto de chaves de objetos de campos de assinatura existentes anteriormente
      selectiveComputation - a computação seletiva que define quais objetos devem ser considerados exceções
      document - o documento PDF atual, usado para verificar se o objeto é uma anotação válida
      Returns:
      verdadeiro se as anotações foram computadas com sucesso, falso caso contrário
      Throws:
      IOException - se ocorrer algum erro de I/O durante a computação das anotações

    • computeAnnotation

      protected boolean computeAnnotation​(org.apache.pdfbox.cos.COSBase base, MessageDigest digest, Set<org.apache.pdfbox.cos.COSObjectKey> visited, ObjectEvaluation.SelectiveComputation selectiveComputation) throws IOException
      Computa os objetos de anotação.

      Appendix 1: Computation of Object Digests

      Section 1.2.5: Annotation Dictionaries

      For annotation dictionaries (see Table 8.44), the values of the following entries are digested, in order, if present

           * A) Contents, T, F, A, AA, Dest, QuadPoints, InkList, Name, FS, Sound.
     ** FS (If FS refers to the contents of a remote file, the contents of that file are not digested)
     * B) If Movie is present, the values of its F and Poster are also digested.
     * C) For stamp annotations, the value of AP is also digested.
     * Exception 1: The Rect entry is not included in the computation.
     However, we compute it to preserve the position of the annotation.
      Parameters:
      base - o objeto base que representa a anotação
      digest - o fluxo de saída onde os bytes computados serão escritos
      visited - um conjunto de chaves de objetos visitados para evitar computação duplicada
      selectiveComputation - a computação seletiva que define quais objetos devem ser considerados exceções
      Returns:
      verdadeiro se a anotação foi computada com sucesso, falso caso contrário
      Throws:
      IOException - se ocorrer algum erro de I/O durante a computação da anotação

    • computeFormField

      public boolean computeFormField​(org.apache.pdfbox.cos.COSBase base, MessageDigest digest, Set<org.apache.pdfbox.cos.COSObjectKey> visited, ObjectEvaluation.SelectiveComputation selectiveComputation) throws IOException
      Computa os campos de formulário.

      Appendix 1: Computation of Object Digests

      Section 1.2.6: Form Fields

      For form fields (see Table 8.69), the values of the following entries are digested, in order, if present:

           * T, FT (inheritable), DV (inheritable), V, A (inheritable), AA (inheritable), F, Lock, SV
     * Exception 1: The F entry is not included in the computation for signature fields. Since the insertion of a signature field may change the flags to lock the field, we compute it.
      Parameters:
      base - o objeto base que representa o campo de formulário
      digest - o fluxo de saída onde os bytes computados serão escritos
      visited - um conjunto de chaves de objetos visitados para evitar computação duplicada
      selectiveComputation - a computação seletiva que define quais objetos devem ser considerados exceções
      Returns:
      verdadeiro se o campo de formulário foi computado com sucesso, falso caso contrário
      Throws:
      IOException - se ocorrer algum erro de I/O durante a computação do campo de formulário

    • computeAction

      public boolean computeAction​(org.apache.pdfbox.cos.COSBase base, MessageDigest digest, Set<org.apache.pdfbox.cos.COSObjectKey> visited, ObjectEvaluation.SelectiveComputation selectiveComputation) throws IOException
      Computa uma ação.

      Appendix 1: Computation of Object Digests

      Section 1.2.7: Action Dictionaries

      For most actions (see Section 8.5, “Actions”), the values of the following entries in the action dictionary are digested, in order, if present: 

           * A) S, D, F, NewWindow, O, P, B, Base, Sound, Vol, Annot, T, H, N, JS and URI. 
      
     * B) Rendition actions (see “Rendition Actions” on page 668) are treated differently than the other types.
      Parameters:
      base - o objeto base que representa o dicionário de ações
      digest - o fluxo de saída onde os bytes computados serão escritos
      visited - um conjunto de chaves de objetos visitados para evitar computação duplicada
      selectiveComputation - a computação seletiva que define quais objetos devem ser considerados exceções
      Returns:
      verdadeiro se a ação foi computada com sucesso, falso caso contrário
      Throws:
      IOException - se ocorrer algum erro de I/O durante a computação da ação

    • computeAdditionalActions

      public boolean computeAdditionalActions​(org.apache.pdfbox.cos.COSBase base, MessageDigest digest, Set<org.apache.pdfbox.cos.COSObjectKey> visited, ObjectEvaluation.SelectiveComputation selectiveComputation) throws IOException
      Computa ações adicionais de um dicionário de ações.

      Appendix 1: Computation of Object Digests

      Section 1.2.8: Additional-Actions

      Additional-actions dictionaries (see Section 8.5.2, “Trigger Events”) can be the value of the AA entry of a catalog, page, annotation or field dictionary. If the additional action is valid, the values of the following entries in the additional-actions dictionary are digested, in order, if present: 

           * E, X, D, U, Fo, Bl, O, C, K, F, V, C, WC, WS, DS, WP, and DP
      Parameters:
      base - o objeto base que representa o dicionário de ações adicionais
      digest - o fluxo de saída onde os bytes computados serão escritos
      visited - um conjunto de chaves de objetos visitados para evitar computação duplicada
      selectiveComputation - a computação seletiva que define quais objetos devem ser considerados exceções
      Returns:
      verdadeiro se as ações adicionais foram computadas com sucesso, falso caso contrário
      Throws:
      IOException - se ocorrer algum erro de I/O durante a computação das ações adicionais

    • isAACatalogValid

      public boolean isAACatalogValid​(org.apache.pdfbox.cos.COSBase base)

    • isAAPageValid

      public boolean isAAPageValid​(org.apache.pdfbox.cos.COSBase base)

    • isAAAnnotationValid

      public boolean isAAAnnotationValid​(org.apache.pdfbox.cos.COSBase base)

    • isAAFormFieldValid

      public boolean isAAFormFieldValid​(org.apache.pdfbox.cos.COSBase base)

    • allValidEntries

      public boolean allValidEntries​(org.apache.pdfbox.cos.COSBase base, Set<org.apache.pdfbox.cos.COSName> validEntries)

    • computeFields

      public byte[] computeFields​(org.apache.pdfbox.pdmodel.PDDocument document, ObjectEvaluation.FieldMDP fieldMDP) throws IOException
      Throws:
      IOException

    • compute

      protected boolean compute​(org.apache.pdfbox.cos.COSBase a, MessageDigest digest, Set<org.apache.pdfbox.cos.COSObjectKey> visited, ObjectEvaluation.SelectiveComputation selectiveComputation) throws IOException
      Escreve em um digest os dados de uma estrutura interna do PDF.
      Parameters:
      a - Estrutura de PDF contendo conteúdo
      digest - Escrita do conteúdo de estrutura PDF
      visited - Mapa de objetos visitados para evitar recursão
      selectiveComputation - Parâmetros de verificação para computações seletivas.
      Throws:
      IOException

    • appendIdentifier

      protected void appendIdentifier​(org.apache.pdfbox.cos.COSBase base, MessageDigest digest) throws IOException
      Throws:
      IOException

    • tryComputeObjectOr

      protected void tryComputeObjectOr​(org.apache.pdfbox.cos.COSBase base, MessageDigest digest, Set<org.apache.pdfbox.cos.COSObjectKey> visited, Callable<?> runnable) throws IOException
      Throws:
      IOException

    • computeObject

      protected void computeObject​(org.apache.pdfbox.cos.COSObject object, MessageDigest digest, Set<org.apache.pdfbox.cos.COSObjectKey> visited, ObjectEvaluation.SelectiveComputation selectiveComputation) throws IOException
      Throws:
      IOException

    • computeNull

      protected void computeNull​(org.apache.pdfbox.cos.COSNull cosnull, MessageDigest digest) throws IOException
      Throws:
      IOException

    • computeInteger

      protected void computeInteger​(org.apache.pdfbox.cos.COSInteger cosinteger, MessageDigest digest) throws IOException
      Throws:
      IOException

    • computeFloat

      protected void computeFloat​(org.apache.pdfbox.cos.COSFloat cosfloat, MessageDigest digest) throws IOException
      Throws:
      IOException

    • computeBoolean

      protected void computeBoolean​(org.apache.pdfbox.cos.COSBoolean cosboolean, MessageDigest digest) throws IOException
      Throws:
      IOException

    • computeName

      protected void computeName​(org.apache.pdfbox.cos.COSName cosname, MessageDigest digest) throws IOException
      Throws:
      IOException

    • computeString

      protected void computeString​(org.apache.pdfbox.cos.COSString cosstring, MessageDigest digest) throws IOException
      Throws:
      IOException

    • computeDictionary

      protected void computeDictionary​(org.apache.pdfbox.cos.COSDictionary cosDictionary, MessageDigest digest, Set<org.apache.pdfbox.cos.COSObjectKey> visited, ObjectEvaluation.SelectiveComputation selectiveComputation) throws IOException
      Throws:
      IOException

    • computeArray

      protected void computeArray​(org.apache.pdfbox.cos.COSArray array, MessageDigest digest, Set<org.apache.pdfbox.cos.COSObjectKey> visited, ObjectEvaluation.SelectiveComputation selectiveComputation) throws IOException
      Throws:
      IOException

    • computeStream

      protected boolean computeStream​(org.apache.pdfbox.cos.COSBase base, MessageDigest digest, Set<org.apache.pdfbox.cos.COSObjectKey> visited, ObjectEvaluation.SelectiveComputation selectiveComputation) throws IOException
      Throws:
      IOException

    • ifPresentKeyValuePair

      protected void ifPresentKeyValuePair​(org.apache.pdfbox.cos.COSDictionary dictionary, org.apache.pdfbox.cos.COSName key, MessageDigest digest, Set<org.apache.pdfbox.cos.COSObjectKey> visited, ObjectEvaluation.SelectiveComputation selectiveComputation) throws IOException
      Throws:
      IOException

    • writeKeyValuePair

      protected void writeKeyValuePair​(org.apache.pdfbox.cos.COSName key, org.apache.pdfbox.cos.COSBase value, MessageDigest digest, Set<org.apache.pdfbox.cos.COSObjectKey> visited, ObjectEvaluation.SelectiveComputation selectiveComputation) throws IOException
      Throws:
      IOException

    • writeName

      protected void writeName​(org.apache.pdfbox.cos.COSName cosname, MessageDigest digest)

    • write4bytesInteger

      protected void write4bytesInteger​(int integer, MessageDigest digest)

    • compare

      protected List<Action> compare​(org.apache.pdfbox.cos.COSBase a, org.apache.pdfbox.cos.COSBase b, Action.Path path, org.apache.pdfbox.cos.COSObjectKey origin, Map<org.apache.pdfbox.cos.COSObjectKey,​List<Action>> visited)

    • parseArray

      protected List<Action> parseArray​(org.apache.pdfbox.cos.COSArray array1, org.apache.pdfbox.cos.COSArray array2, Action.Path path, org.apache.pdfbox.cos.COSObjectKey origin, Map<org.apache.pdfbox.cos.COSObjectKey,​List<Action>> visited)

    • findInCOSArray

      protected int findInCOSArray​(org.apache.pdfbox.cos.COSArray array, org.apache.pdfbox.cos.COSBase base, Action.Path path, Map<org.apache.pdfbox.cos.COSObjectKey,​List<Action>> visited)
      Busca a posição do elemento no array
      Parameters:
      array - O array de objetos
      base - O objeto base
      Returns:
      O índice do objeto no array

    • isEqual

      protected boolean isEqual​(org.apache.pdfbox.cos.COSBase base1, org.apache.pdfbox.cos.COSBase base2, Action.Path path, Map<org.apache.pdfbox.cos.COSObjectKey,​List<Action>> visited)
      Método de comparação entre dois objetos
      Parameters:
      base1 - Um objeto a ser comparado
      base2 - Outro objeto a ser comparado
      Returns:
      Indica se os objetos são iguais