package at.gv.egiz.pdfas.api.verify;

import java.util.Date;
import java.util.List;

import at.gv.egiz.pdfas.api.commons.SignatureInformation;

/**
 * Encapsulates the data of a verification of one signature.
 * 
 * @author wprinz
 */
public interface VerifyResult extends SignatureInformation
{
  /**
   * Returns the result of the certificate check.
   * 
   * @return Returns the result of the certificate check.
   */
  public SignatureCheck getCertificateCheck();

  /**
   * Returns the result of the value (and hash) check.
   * 
   * @return Returns the result of the value (and hash) check.
   */
  public SignatureCheck getValueCheckCode();

  /**
   * Returns the result of the manifest check.
   * 
   * @return Returns the result of the manifest check.
   */
  public SignatureCheck getManifestCheckCode();

  /**
   * Returns true, if the signer's certificate is a qualified certificate.
   * 
   * @return Returns true, if the signer's certificate is a qualified
   *         certificate.
   */
  public boolean isQualifiedCertificate();

  /**
   * Returns a list of Strings each stating one public property of the
   * certificate.
   * 
   * <p>
   * Such public properties are certificate extensions each being assigned an
   * own OID. For example the public property "Verwaltungseigenschaft" has the
   * OID "1.2.40.0.10.1.1.1".
   * </p>
   * 
   * @return Returns the list of Strings representing the public properties of
   *         this certificate, if any.
   */
  public List getPublicProperties();

  /**
   * Returns the verification time, which is the time when the signature was
   * verified.
   * 
   * <p>
   * Note that this is actually the Date passed to the verify methods over
   * {@link VerifyParameters#setVerificationTime(Date)} or
   * {@link VerifyAfterAnalysisParameters#setVerificationTime(Date)}. The
   * signature devices don't respond the actual verification time so there is no
   * guarantee that the set verification time was actually used as time of
   * verification. Please consult the device's documentation for more
   * information.
   * </p>
   * 
   * @return Returns the verification time, which is the time when the signature
   *         was verified.
   */
  public Date getVerificationTime();

  /**
   * Returns the hash input data as returned by MOA.
   * 
   * <p>
   * This will only return a value other than null if the corresponding
   * VerifyParameter was set to true.
   * </p>
   * <p>
   * Note that the HashInputData does not necessarily have to be exactly the
   * same as the signed data return by the
   * {@link SignatureInformation#getSignedData()} method.
   * </p>
   * 
   * @return Returns the hash input data as returned by MOA.
   * 
   * @see SignatureInformation#getSignedData()
   */
  public String getHashInputData();

}