package at.gv.egovernment.moa.spss.api.cmsverify;

import java.io.InputStream;
import java.util.Date;

/**
 * Object that encapsulates a request to verify a CMS signature.
 * 
 * @author Patrick Peck
 * @author Stephan Grill
 * @version $Id$
 */
public interface VerifyCMSSignatureRequest {
  /**
   * Indicates, that signature checks for all signatories must be returned.
   */
  public static int[] ALL_SIGNATORIES = new int[] { -1 };
  /**
   * Gets the positions of signatories whose signature must be verified.
   * 
   * @return The positions of signatories.
   */
  public int[] getSignatories();
  /**
   * Gets the date and time for which the signature verification has to 
   * be performed.
   * 
   * @return Date and time for which the signature verification has
   * to be performed.
   */
  public Date getDateTime();
  /**
   * Gets the binary CMS signature.
   * 
   * @return An <code>InputStream</code> from which the binary CMS signature
   * can be read.
   */
  public InputStream getCMSSignature();
  /** 
   * Gets the data object necessary for the verification.
   * 
   * @return The data object necessary for verification.
   */
  public CMSDataObject getDataObject();
  /**
   * Gets the profile ID of trusted certificates to be used for signature
   * verification.
   * 
   * @return The profile ID of trusted certificates.
   */
  public String getTrustProfileId();
}