icertificatestoresessionremote.java

一个免费的CA,基于EJB平台的,老师叫我们测试,现把之共享出来让大家参考

/*
 * Generated by XDoclet - Do not edit!
 */
package org.ejbca.core.ejb.ca.store;

/**
 * Remote interface for CertificateStoreSession.
 */
public interface ICertificateStoreSessionRemote
   extends javax.ejb.EJBObject
{
   /**
    * Stores a certificate.
    * @param incert The certificate to be stored.
    * @param cafp Fingerprint (hex) of the CAs certificate.
    * @param username username of end entity owning the certificate.
    * @param status Status of the certificate (from CertificateData).
    * @param type Type of certificate (CERTTYPE_ENDENTITY etc from CertificateDataBean).
    * @return true if storage was successful.
    */
   public boolean storeCertificate( org.ejbca.core.model.log.Admin admin,java.security.cert.Certificate incert,java.lang.String username,java.lang.String cafp,int status,int type )
      throws java.rmi.RemoteException;

   /**
    * Stores a CRL
    * @param incrl The DER coded CRL to be stored.
    * @param cafp Fingerprint (hex) of the CAs certificate.
    * @param number CRL number.
    * @return true if storage was successful.
    */
   public boolean storeCRL( org.ejbca.core.model.log.Admin admin,byte[] incrl,java.lang.String cafp,int number )
      throws java.rmi.RemoteException;

   /**
    * Lists fingerprint (primary key) of ALL certificates in the database. NOTE: Caution should be taken with this method as execution may be very heavy indeed if many certificates exist in the database (imagine what happens if there are millinos of certificates in the DB!). Should only be used for testing purposes.
    * @param admin Administrator performing the operation
    * @param issuerdn the dn of the certificates issuer.
    * @return Collection of fingerprints, i.e. Strings, reverse ordered by expireDate where last expireDate is first in array.
    */
   public java.util.Collection listAllCertificates( org.ejbca.core.model.log.Admin admin,java.lang.String issuerdn )
      throws java.rmi.RemoteException;

   /**
    * Lists fingerprint (primary key) of ALL certificates in the database. NOTE: Caution should be taken with this method as execution may be very heavy indeed if many certificates exist in the database (imagine what happens if there are millinos of certificates in the DB!). Should only be used for testing purposes.
    * @param admin Administrator performing the operation
    * @param issuerdn the dn of the certificates issuer.
    * @return Collection of fingerprints, i.e. Strings, reverse ordered by expireDate where last expireDate is first in array.
    */
   public java.util.Collection listRevokedCertificates( org.ejbca.core.model.log.Admin admin,java.lang.String issuerdn )
      throws java.rmi.RemoteException;

   /**
    * Lists certificates for a given subject signed by the given issuer.
    * @param admin Administrator performing the operation
    * @param subjectDN the DN of the subject whos certificates will be retrieved.
    * @param issuerDN the dn of the certificates issuer.
    * @return Collection of Certificates (java.security.cert.Certificate) in no specified order or an empty Collection.
    * @throws EJBException if a communication or other error occurs.
    */
   public java.util.Collection findCertificatesBySubjectAndIssuer( org.ejbca.core.model.log.Admin admin,java.lang.String subjectDN,java.lang.String issuerDN )
      throws java.rmi.RemoteException;

   /**
    * Lists certificates for a given subject.
    * @param admin Administrator performing the operation
    * @param subjectDN the DN of the subject whos certificates will be retrieved.
    * @return Collection of Certificates (java.security.cert.Certificate) in no specified order or an empty Collection.
    */
   public java.util.Collection findCertificatesBySubject( org.ejbca.core.model.log.Admin admin,java.lang.String subjectDN )
      throws java.rmi.RemoteException;

   public java.util.Collection findCertificatesByExpireTime( org.ejbca.core.model.log.Admin admin,java.util.Date expireTime )
      throws java.rmi.RemoteException;

   /**
    * Finds usernames of users having certificate(s) expiring within a specified time and that has status active.
    */
   public java.util.Collection findCertificatesByExpireTimeWithLimit( org.ejbca.core.model.log.Admin admin,java.util.Date expiretime )
      throws java.rmi.RemoteException;

   /**
    * Finds a certificate specified by issuer DN and serial number.
    * @param admin Administrator performing the operation
    * @param issuerDN issuer DN of the desired certificate.
    * @param serno serial number of the desired certificate!
    * @return Certificate if found or null
    */
   public java.security.cert.Certificate findCertificateByIssuerAndSerno( org.ejbca.core.model.log.Admin admin,java.lang.String issuerDN,java.math.BigInteger serno )
      throws java.rmi.RemoteException;

   /**
    * Implements ICertificateStoreSession::findCertificatesByIssuerAndSernos. <p/> The method retrives all certificates from a specific issuer which are identified by list of serial numbers. The collection will be empty if the issuerDN is <tt>null</tt>/empty or the collection of serial numbers is empty.
    * @param admin
    * @param issuerDN the subjectDN of a CA certificate
    * @param sernos a collection of certificate serialnumbers
    * @return Collection a list of certificates; never <tt>null</tt>
    */
   public java.util.Collection findCertificatesByIssuerAndSernos( org.ejbca.core.model.log.Admin admin,java.lang.String issuerDN,java.util.Collection sernos )
      throws java.rmi.RemoteException;

   /**
    * Finds certificate(s) for a given serialnumber.
    * @param admin Administrator performing the operation
    * @param serno the serialnumber of the certificate(s) that will be retrieved
    * @return Certificate or null if none found.
    */
   public java.util.Collection findCertificatesBySerno( org.ejbca.core.model.log.Admin admin,java.math.BigInteger serno )
      throws java.rmi.RemoteException;

   /**
    * Finds username for a given certificate serial number.
    * @param admin Administrator performing the operation
    * @param serno the serialnumber of the certificate to find username for.
    * @return username or null if none found.
    */
   public java.lang.String findUsernameByCertSerno( org.ejbca.core.model.log.Admin admin,java.math.BigInteger serno,java.lang.String issuerdn )
      throws java.rmi.RemoteException;

   /**
    * Finds certificate(s) for a given usernaem.
    * @param admin Administrator performing the operation
    * @param username the usernaem of the certificate(s) that will be retrieved
    * @return Collection of Certificates (in no specified order) or null if none found.
    */
   public java.util.Collection findCertificatesByUsername( org.ejbca.core.model.log.Admin admin,java.lang.String username )
      throws java.rmi.RemoteException;

   public org.ejbca.core.model.ca.store.CertificateInfo getCertificateInfo( org.ejbca.core.model.log.Admin admin,java.lang.String fingerprint )
      throws java.rmi.RemoteException;

   public java.security.cert.Certificate findCertificateByFingerprint( org.ejbca.core.model.log.Admin admin,java.lang.String fingerprint )
      throws java.rmi.RemoteException;

   /**
    * Lists all active (status = 20) certificates of a specific type and if given from a specific issuer. <p/> The type is the bitwise OR value of the types listed int {@link org.ejbca.core.ejb.ca.store.CertificateDataBean}:<br> <ul> <li><tt>CERTTYPE_ENDENTITY</tt><br> An user or machine certificate, which identifies a subject. </li> <li><tt>CERTTYPE_CA</tt><br> A CA certificate which is <b>not</b> a root CA. </li> <li><tt>CERTTYPE_ROOTCA</tt><br> A Root CA certificate. </li> </ul> <p/> Usage examples:<br> <ol> <li>Get all root CA certificates <p/> <code> ... ICertificateStoreSessionRemote itf = ... Collection certs = itf.findCertificatesByType(adm, CertificateDataBean.CERTTYPE_ROOTCA, null); ... </code> </li> <li>Get all subordinate CA certificates for a specific Root CA. It is assumed that the <tt>subjectDN</tt> of the Root CA certificate is located in the variable <tt>issuer</tt>. <p/> <code> ... ICertificateStoreSessionRemote itf = ... Certficate rootCA = ... String issuer = rootCA.getSubjectDN(); Collection certs = itf.findCertificatesByType(adm, CertificateDataBean.CERTTYPE_SUBCA, issuer); ... </code> </li> <li>Get <b>all</b> CA certificates. <p/> <code> ... ICertificateStoreSessionRemote itf = ... Collection certs = itf.findCertificatesByType(adm, CertificateDataBean.CERTTYPE_SUBCA + CERTTYPE_ROOTCA, null); ... </code> </li> </ol>
    * @param admin
    * @param issuerDN get all certificates issued by a specific issuer. If <tt>null</tt> or empty return certificates regardless of the issuer.
    * @param type CERTTYPE_* types from CertificateDataBean
    * @return Collection Collection of X509Certificate, never <tt>null</tt>
    */
   public java.util.Collection findCertificatesByType( org.ejbca.core.model.log.Admin admin,int type,java.lang.String issuerDN )
      throws java.rmi.RemoteException;

   /**
    * Set the status of certificates of given dn to revoked.
    * @param admin Administrator performing the operation
    * @param username the username of user to revoke certificates.
    * @param publishers and array of publiserids (Integer) of publishers to revoke the certificate in.
    * @param reason the reason of the revokation. (One of the RevokedCertInfo.REVOKATION_REASON constants.)
    */
   public void setRevokeStatus( org.ejbca.core.model.log.Admin admin,java.lang.String username,java.util.Collection publishers,int reason )
      throws java.rmi.RemoteException;

   /**
    * Set the status of certificate with given serno to revoked.
    * @param admin Administrator performing the operation
    * @param serno the serno of certificate to revoke.
    * @param publishers and array of publiserids (Integer) of publishers to revoke the certificate in.
    * @param reason the reason of the revokation. (One of the RevokedCertInfo.REVOKATION_REASON constants.)
    */
   public void setRevokeStatus( org.ejbca.core.model.log.Admin admin,java.lang.String issuerdn,java.math.BigInteger serno,java.util.Collection publishers,int reason )
      throws java.rmi.RemoteException;

   /**
    * Revokes a certificate (already revoked by the CA), in the database
    * @param cert The DER coded Certificate that has been revoked.
    * @param publishers and array of publiserids (Integer) of publishers to revoke the certificate in.
    */
   public void revokeCertificate( org.ejbca.core.model.log.Admin admin,java.security.cert.Certificate cert,java.util.Collection publishers,int reason )
      throws java.rmi.RemoteException;

   /**
    * Method revoking all certificates generated by the specified issuerdn. Sets revokedate to current time. Should only be called by CAAdminBean when a CA is about to be revoked.
    * @param admin the administrator performing the event.
    * @param issuerdn the dn of CA about to be revoked
    * @param reason the reason of revokation.
    */
   public void revokeAllCertByCA( org.ejbca.core.model.log.Admin admin,java.lang.String issuerdn,int reason )
      throws java.rmi.RemoteException;

   /**
    * Method that checks if a users all certificates have been revoked.
    * @param admin Administrator performing the operation
    * @param username the username to check for.
    * @return returns true if all certificates are revoked.
    */