Index: modules/security/src/common/javasrc/java/security/cert/CRL.java
===================================================================
--- modules/security/src/common/javasrc/java/security/cert/CRL.java.orig 2006-03-30 08:31:04.000000000 +0100
+++ modules/security/src/common/javasrc/java/security/cert/CRL.java 2006-03-30 08:31:52.000000000 +0100
@@ -21,9 +21,12 @@
package java.security.cert;
+
/**
- * @com.intel.drl.spec_ref
+ * This class represents Certificate Revocation Lists (CRLs). They are used to
+ * indicate that a given Certificate has expired already.
*
+ * @see CertificateFactory
*/
public abstract class CRL {
// The CRL type
@@ -36,20 +39,31 @@
this.type = type;
}
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Answers the type of this CRL.
+ *
+ * @return String the type of this CRL.
+ */
public final String getType() {
return type;
}
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Answers if a given Certificate has been revoked or not.
+ *
+ * @param cert
+ * Certificate The Certificate to test
+ *
+ * @return true if the certificate has been revoked false if the certificate
+ * has not been revoked yet
+ */
public abstract boolean isRevoked(Certificate cert);
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Answers a string containing a concise, human-readable description of the
+ * receiver.
+ *
+ * @return a printable representation for the receiver.
+ */
public abstract String toString();
}
Index: modules/security/src/common/javasrc/java/security/cert/CRLException.java
===================================================================
--- modules/security/src/common/javasrc/java/security/cert/CRLException.java.orig 2006-03-30 08:31:04.000000000 +0100
+++ modules/security/src/common/javasrc/java/security/cert/CRLException.java 2006-03-30 08:31:52.000000000 +0100
@@ -34,16 +34,20 @@
*/
private static final long serialVersionUID = -6694728944094197147L;
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Constructs a new instance of this class with its walkback and message
+ * filled in.
+ *
+ * @param msg
+ * String The detail message for the exception.
+ */
public CRLException(String msg) {
super(msg);
}
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Constructs a new instance of this class with its walkback filled in.
+ */
public CRLException() {
}
Index: modules/security/src/common/javasrc/java/security/cert/CertPath.java
===================================================================
--- modules/security/src/common/javasrc/java/security/cert/CertPath.java.orig 2006-03-30 08:31:04.000000000 +0100
+++ modules/security/src/common/javasrc/java/security/cert/CertPath.java 2006-03-30 08:31:52.000000000 +0100
@@ -30,8 +30,17 @@
import java.util.List;
/**
- * @com.intel.drl.spec_ref
+ * An immutable certificate path that can be validated. All certificates in the
+ * path are of the same type (i.e., X509).
*
+ * A CertPath can be represented as a byte array in at least one
+ * supported encoding when serialized.
+ *
+ * When a List of the certificates is obtained it must be
+ * immutable.
+ *
+ * A CertPath must be thread-safe without requiring coordinated
+ * access.
*/
public abstract class CertPath implements Serializable {
/**
@@ -48,16 +57,24 @@
this.type = type;
}
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Returns the type of Certificate in the
+ * CertPath
+ *
+ * @return Certificate type
+ */
public String getType() {
return type;
}
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Returns true if Certificates in the list are the same
+ * type and the lists are equal (and by implication the certificates
+ * contained within are the same).
+ *
+ * @param other
+ * CertPath to be compared for equality
+ */
public boolean equals(Object other) {
if (this == other) {
return true;
@@ -73,18 +90,27 @@
return false;
}
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Overrides Object.hashCode() Defined as: hashCode = 31 *
+ * path.getType().hashCode() + path.getCertificates().hashCode();
+ *
+ * @return hash code for CertPath object
+ */
public int hashCode() {
int hash = getType().hashCode();
hash = hash*31 + getCertificates().hashCode();
return hash;
}
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Returns a String representation of the
+ * CertPath
+ * Certificates. It is the result of
+ * calling toString on all Certificates in
+ * the List. Certificates
+ *
+ * @return string representation of CertPath
+ */
public String toString() {
StringBuffer sb = new StringBuffer(getType());
sb.append(" Cert Path, len=");
@@ -102,26 +128,43 @@
return sb.toString();
}
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Returns an immutable List of the Certificates contained
+ * in the CertPath.
+ *
+ * @return list of Certificates in the CertPath
+ */
public abstract List getCertificates();
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Returns an encoding of the CertPath using the default
+ * encoding
+ *
+ * @return default encoding of the CertPath
+ * @throws CertificateEncodingException
+ */
public abstract byte[] getEncoded()
throws CertificateEncodingException;
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Returns an encoding of the CertPath using the specified
+ * encoding
+ *
+ * @param encoding
+ * encoding that should be generated
+ * @return default encoding of the CertPath
+ * @throws CertificateEncodingException
+ */
public abstract byte[] getEncoded(String encoding)
throws CertificateEncodingException;
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Return an Iterator over the supported encodings for a
+ * representation of the certificate path.
+ *
+ * @return Iterator over supported encodings (as
+ * Strings)
+ */
public abstract Iterator getEncodings();
/**
Index: modules/security/src/common/javasrc/java/security/cert/Certificate.java
===================================================================
--- modules/security/src/common/javasrc/java/security/cert/Certificate.java.orig 2006-03-30 08:31:04.000000000 +0100
+++ modules/security/src/common/javasrc/java/security/cert/Certificate.java 2006-03-30 08:31:52.000000000 +0100
@@ -34,8 +34,9 @@
import java.util.Arrays;
/**
- * @com.intel.drl.spec_ref
- *
+ * Abstract class to represent identity certificates. It represents a way to
+ * verify the binding of a Principal and its public key. Examples are X.509,
+ * PGP, and SDSI.
*/
public abstract class Certificate implements Serializable {
/**
@@ -53,16 +54,27 @@
this.type = type;
}
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Answers the certificate type represented by the receiver.
+ *
+ * @return the certificate type represented by the receiver.
+ */
public final String getType() {
return type;
}
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Compares the argument to the receiver, and answers true if they represent
+ * the same object using a class specific comparison. The
+ * implementation in Object answers true only if the argument is the exact
+ * same object as the receiver (==).
+ *
+ * @param other
+ * the object to compare with this object
+ * @return true if the object is the same as this object
+ * false if it is different from this object
+ * @see #hashCode
+ */
public boolean equals(Object other) {
// obj equal to itself
if (this == other) {
@@ -80,9 +92,15 @@
return false;
}
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Answers an integer hash code for the receiver. Any two objects which
+ * answer true when passed to equals must
+ * answer the same value for this method.
+ *
+ * @return the receiver's hash
+ *
+ * @see #equals
+ */
public int hashCode() {
try {
byte[] encoded = getEncoded();
@@ -96,14 +114,31 @@
}
}
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Answers the encoded representation for this certificate.
+ *
+ * @return the encoded representation for this certificate.
+ */
public abstract byte[] getEncoded() throws CertificateEncodingException;
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Verifies that this certificate was signed with the given public key.
+ *
+ * @param key
+ * PublicKey public key for which verification should be
+ * performed.
+ *
+ * @exception CertificateException
+ * if encoding errors are detected
+ * @exception NoSuchAlgorithmException
+ * if an unsupported algorithm is detected
+ * @exception InvalidKeyException
+ * if an invalid key is detected
+ * @exception NoSuchProviderException
+ * if there is no default provider
+ * @exception SignatureException
+ * if signature errors are detected
+ */
public abstract void verify(PublicKey key)
throws CertificateException,
NoSuchAlgorithmException,
@@ -111,9 +146,27 @@
NoSuchProviderException,
SignatureException;
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Verifies that this certificate was signed with the given public key. Uses
+ * the signature algorithm given by the provider.
+ *
+ * @param key
+ * PublicKey public key for which verification should be
+ * performed.
+ * @param sigProvider
+ * String the name of the signature provider.
+ *
+ * @exception CertificateException
+ * if encoding errors are detected
+ * @exception NoSuchAlgorithmException
+ * if an unsupported algorithm is detected
+ * @exception InvalidKeyException
+ * if an invalid key is detected
+ * @exception NoSuchProviderException
+ * if there is no default provider
+ * @exception SignatureException
+ * if signature errors are detected
+ */
public abstract void verify(PublicKey key, String sigProvider)
throws CertificateException,
NoSuchAlgorithmException,
@@ -121,14 +174,19 @@
NoSuchProviderException,
SignatureException;
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Answers a string containing a concise, human-readable description of the
+ * receiver.
+ *
+ * @return a printable representation for the receiver.
+ */
public abstract String toString();
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Answers the public key corresponding to this certificate.
+ *
+ * @return the public key corresponding to this certificate.
+ */
public abstract PublicKey getPublicKey();
/**
Index: modules/security/src/common/javasrc/java/security/cert/CertificateEncodingException.java
===================================================================
--- modules/security/src/common/javasrc/java/security/cert/CertificateEncodingException.java.orig 2006-03-30 08:31:04.000000000 +0100
+++ modules/security/src/common/javasrc/java/security/cert/CertificateEncodingException.java 2006-03-30 08:31:52.000000000 +0100
@@ -21,9 +21,9 @@
package java.security.cert;
+
/**
- * @com.intel.drl.spec_ref
- *
+ * This class represents an encoding exception for a certificate.
*/
public class CertificateEncodingException extends CertificateException {
/**
@@ -31,18 +31,20 @@
*/
private static final long serialVersionUID = 6219492851589449162L;
- /**
- * @com.intel.drl.spec_ref
- *
- */
+ /**
+ * Constructs a new instance of this class with its walkback and message
+ * filled in.
+ *
+ * @param msg
+ * String The detail message for the exception.
+ */
public CertificateEncodingException(String msg) {
super(msg);
}
- /**
- * @com.intel.drl.spec_ref
- *
- */
+ /**
+ * Constructs a new instance of this class with its walkback filled in.
+ */
public CertificateEncodingException() {
}
Index: modules/security/src/common/javasrc/java/security/cert/CertificateException.java
===================================================================
--- modules/security/src/common/javasrc/java/security/cert/CertificateException.java.orig 2006-03-30 08:31:04.000000000 +0100
+++ modules/security/src/common/javasrc/java/security/cert/CertificateException.java 2006-03-30 08:31:52.000000000 +0100
@@ -24,8 +24,7 @@
import java.security.GeneralSecurityException;
/**
- * @com.intel.drl.spec_ref
- *
+ * This class represents a general certificate exception.
*/
public class CertificateException extends GeneralSecurityException {
@@ -35,18 +34,20 @@
*/
private static final long serialVersionUID = 3192535253797119798L;
- /**
- * @com.intel.drl.spec_ref
- *
- */
+ /**
+ * Constructs a new instance of this class with its walkback and message
+ * filled in.
+ *
+ * @param msg
+ * String The detail message for the exception.
+ */
public CertificateException(String msg) {
super(msg);
}
- /**
- * @com.intel.drl.spec_ref
- *
- */
+ /**
+ * Constructs a new instance of this class with its walkback filled in.
+ */
public CertificateException() {
}
Index: modules/security/src/common/javasrc/java/security/cert/CertificateExpiredException.java
===================================================================
--- modules/security/src/common/javasrc/java/security/cert/CertificateExpiredException.java.orig 2006-03-30 08:31:04.000000000 +0100
+++ modules/security/src/common/javasrc/java/security/cert/CertificateExpiredException.java 2006-03-30 08:31:52.000000000 +0100
@@ -21,9 +21,9 @@
package java.security.cert;
+
/**
- * @com.intel.drl.spec_ref
- *
+ * This class indicates that a given certificate has expired.
*/
public class CertificateExpiredException extends CertificateException {
@@ -33,18 +33,20 @@
*/
private static final long serialVersionUID = 9071001339691533771L;
- /**
- * @com.intel.drl.spec_ref
- *
- */
+ /**
+ * Constructs a new instance of this class with its walkback and message
+ * filled in.
+ *
+ * @param msg
+ * String The detail message for the exception.
+ */
public CertificateExpiredException(String msg) {
super(msg);
}
- /**
- * @com.intel.drl.spec_ref
- *
- */
+ /**
+ * Constructs a new instance of this class with its walkback filled in.
+ */
public CertificateExpiredException() {
}
}
\ No newline at end of file
Index: modules/security/src/common/javasrc/java/security/cert/CertificateFactory.java
===================================================================
--- modules/security/src/common/javasrc/java/security/cert/CertificateFactory.java.orig 2006-03-30 08:31:04.000000000 +0100
+++ modules/security/src/common/javasrc/java/security/cert/CertificateFactory.java 2006-03-30 08:31:52.000000000 +0100
@@ -32,12 +32,9 @@
import org.apache.harmony.security.fortress.Engine;
-
/**
- * @com.intel.drl.spec_ref
- *
+ * This class provides the functionality of a certificate factory algorithm.
*/
-
public class CertificateFactory {
// Store CertificateFactory service name
@@ -66,14 +63,17 @@
this.spiImpl = certFacSpi;
}
- /**
- * @com.intel.drl.spec_ref
- *
- * throws CertificateException using NoSuchAlgorithmException information
- *
- * throws NullPointerException if algorithm is null (instead of
- * CertificateException as in 1.4 release)
- */
+ /**
+ * Answers a new CertificateFactory of the given type.
+ *
+ * @param type
+ * java.lang.String Type of certificate desired
+ * @return CertificateFactory a concrete implementation for the certificate
+ * type desired.
+ *
+ * @exception CertificateException
+ * If the type cannot be found
+ */
public static final CertificateFactory getInstance(String type)
throws CertificateException {
if (type == null) {
@@ -109,14 +109,20 @@
return getInstance(type, impProvider);
}
- /**
- * @com.intel.drl.spec_ref
- *
- * throws CertificateException using NoSuchAlgorithmException information
- *
- * throws NullPointerException if algorithm is null (instead of
- * CertificateException as in 1.4 release)
- */
+ /**
+ * Answers a new CertificateFactory of the given type.
+ *
+ * @param type
+ * java.lang.String Type of certificatem desired
+ * @param provider
+ * java.security.Provider Provider which has to implement the
+ * algorithm
+ * @return CertificateFactory a concrete implementation for the certificate
+ * type desired.
+ *
+ * @exception CertificateException
+ * If the type cannot be found
+ */
public static final CertificateFactory getInstance(String type,
Provider provider) throws CertificateException {
if (provider == null) {
@@ -136,40 +142,66 @@
}
}
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Returns the Provider of the certificate factory represented by the
+ * receiver.
+ *
+ * @return Provider an instance of a subclass of java.security.Provider
+ */
public final Provider getProvider() {
return provider;
}
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Returns the Certificate type
+ *
+ * @return String type of certificate being used
+ */
public final String getType() {
return type;
}
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Generates and initializes a Certificate from data from the provided input
+ * stream.
+ *
+ * @param inStream
+ * InputStream Stream from where data is read to create the
+ * Certificate
+ *
+ * @return Certificate an initialized Certificate
+ * @exception CertificateException
+ * if parsing problems are detected
+ */
public final Certificate generateCertificate(InputStream inStream)
throws CertificateException {
return spiImpl.engineGenerateCertificate(inStream);
}
- /**
- * @com.intel.drl.spec_ref
- *
- * FIXME: update to Iterator getCertPathEncodings()
- */
+ /**
+ * Returns an Iterator over the supported CertPath encodings (as Strings).
+ * The first element is the default encoding.
+ *
+ * @return Iterator Iterator over supported CertPath encodings (as Strings)
+ *
+ * FIXME: update to Iterator getCertPathEncodings()
+ */
public final Iterator getCertPathEncodings() {
return spiImpl.engineGetCertPathEncodings();
}
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Generates a CertPath from data from the provided
+ * InputStream. The default encoding is assumed.
+ *
+ * @param inStream
+ * InputStream with PKCS7 or PkiPath encoded data
+ *
+ * @return CertPath a CertPath initialized from the provided data
+ *
+ * @throws CertificateException
+ * if parsing problems are detected
+ */
public final CertPath generateCertPath(InputStream inStream)
throws CertificateException {
Iterator it = getCertPathEncodings();
@@ -179,48 +211,101 @@
return spiImpl.engineGenerateCertPath(inStream, (String) it.next());
}
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Generates a CertPath from data from the provided
+ * InputStream. The encoding is that specified by the
+ * encoding parameter.
+ *
+ * @param inStream
+ * InputStream containing certificate path data in specified
+ * encoding
+ * @param encoding
+ * encoding of the data in the input stream
+ *
+ * @return CertPath a CertPath initialized from the provided data
+ *
+ * @throws CertificateException
+ * if parsing problems are detected
+ * @throws UnsupportedOperationException
+ * if the provider does not implement this method
+ */
public final CertPath generateCertPath(InputStream inStream, String encoding)
throws CertificateException {
return spiImpl.engineGenerateCertPath(inStream, encoding);
}
- /**
- * @com.intel.drl.spec_ref
- *
- * FIXME: update parameter to (List extends Certificate> certificates)
- */
+ /**
+ * Generates a CertPath from the provided List of
+ * Certificates. The encoding is the default encoding.
+ *
+ * @param certificates
+ * List containing certificates in a format supported by the
+ * CertificateFactory
+ *
+ * @return CertPath a CertPath initialized from the provided data
+ *
+ * @throws CertificateException
+ * if parsing problems are detected
+ * @throws UnsupportedOperationException
+ * if the provider does not implement this method
+ *
+ * FIXME: update parameter to (List extends Certificate> certificates)
+ */
public final CertPath generateCertPath(List certificates)
throws CertificateException {
return spiImpl.engineGenerateCertPath(certificates);
}
- /**
- * @com.intel.drl.spec_ref
- *
- * FIXME: update returned value to Collection extends Certificate>
- */
+ /**
+ * Generates and initializes a collection of Certificates from data from the
+ * provided input stream.
+ *
+ * @param inStream
+ * InputStream Stream from where data is read to create the
+ * Certificates
+ *
+ * @return Collection an initialized collection of Certificates
+ * @exception CertificateException
+ * if parsing problems are detected
+ *
+ * FIXME: update returned value to Collection extends Certificate>
+ */
public final Collection generateCertificates(InputStream inStream)
throws CertificateException {
return spiImpl.engineGenerateCertificates(inStream);
}
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Generates and initializes a Certificate Revocation List from data from
+ * the provided input stream.
+ *
+ * @param inStream
+ * InputStream Stream from where data is read to create the CRL
+ *
+ * @return CRL an initialized Certificate Revocation List
+ * @exception CRLException
+ * if parsing problems are detected
+ */
public final CRL generateCRL(InputStream inStream) throws CRLException {
return spiImpl.engineGenerateCRL(inStream);
}
- /**
- * @com.intel.drl.spec_ref
- *
- * FIXME: update returned value to Collection extends CRL>
- */
+ /**
+ * Generates and initializes a collection of Certificate Revocation List
+ * from data from the provided input stream.
+ *
+ * @param inStream
+ * InputStream Stream from where data is read to create the CRLs
+ *
+ * @return Collection an initialized collection of Certificate Revocation
+ * List
+ * @exception CRLException
+ * if parsing problems are detected
+ *
+ * FIXME: update returned value to Collection extends CRL>
+ */
public final Collection generateCRLs(InputStream inStream)
throws CRLException {
return spiImpl.engineGenerateCRLs(inStream);
}
-}
\ No newline at end of file
+}
Index: modules/security/src/common/javasrc/java/security/cert/CertificateFactorySpi.java
===================================================================
--- modules/security/src/common/javasrc/java/security/cert/CertificateFactorySpi.java.orig 2006-03-30 08:31:04.000000000 +0100
+++ modules/security/src/common/javasrc/java/security/cert/CertificateFactorySpi.java 2006-03-30 08:31:52.000000000 +0100
@@ -27,80 +27,152 @@
import java.util.List;
/**
- * @com.intel.drl.spec_ref
- *
+ * This class is a Service Provider Interface (therefore the Spi suffix) for
+ * certificate factories to be supplied by providers.
*/
-
public abstract class CertificateFactorySpi {
-
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Constructs a new instance of this class.
+ */
public CertificateFactorySpi() {
}
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Generates and initializes a Certificate from data from the provided input
+ * stream.
+ *
+ * @param inStream
+ * InputStream Stream from where data is read to create the
+ * Certificate
+ *
+ * @return Certificate an initialized Certificate
+ * @exception CertificateException
+ * if parsing problems are detected
+ */
public abstract Certificate engineGenerateCertificate(InputStream inStream)
throws CertificateException;
- /**
- * @com.intel.drl.spec_ref
- *
- * FIXME: 1.5 updates are needed Collection extends Certificate>
- */
+ /**
+ * Generates and initializes a collection of Certificates from data from the
+ * provided input stream.
+ *
+ * @param inStream
+ * InputStream Stream from where data is read to create the
+ * Certificates
+ *
+ * @return Collection an initialized collection of Certificates
+ * @exception CertificateException
+ * if parsing problems are detected
+ *
+ * FIXME: 1.5 updates are needed Collection extends Certificate>
+ */
public abstract Collection engineGenerateCertificates(InputStream inStream)
throws CertificateException;
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Generates and initializes a Certificate Revocation List from data from
+ * the provided input stream.
+ *
+ * @param inStream
+ * InputStream Stream from where data is read to create the CRL
+ *
+ * @return CRL an initialized Certificate Revocation List
+ * @exception CRLException
+ * if parsing problems are detected
+ */
public abstract CRL engineGenerateCRL(InputStream inStream)
throws CRLException;
- /**
- * @com.intel.drl.spec_ref
- *
- * FIXME: 1.5 updates are needed Collection extends CRL>
- */
+ /**
+ * Generates and initializes a collection of Certificate Revocation List
+ * from data from the provided input stream.
+ *
+ * @param inStream
+ * InputStream Stream from where data is read to create the CRLs
+ *
+ * @return Collection an initialized collection of Certificate Revocation
+ * List
+ * @exception CRLException
+ * if parsing problems are detected
+ *
+ * FIXME: 1.5 updates are needed Collection extends CRL>
+ */
public abstract Collection engineGenerateCRLs(InputStream inStream)
throws CRLException;
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Generates a CertPath from data from the provided
+ * InputStream. The default encoding is assumed.
+ *
+ * @param inStream
+ * InputStream with PKCS7 or PkiPath encoded data
+ *
+ * @return CertPath a CertPath initialized from the provided data
+ *
+ * @throws CertificateException
+ * if parsing problems are detected
+ */
public CertPath engineGenerateCertPath(InputStream inStream)
throws CertificateException {
throw new UnsupportedOperationException(
"Method engineGenerateCertPath(InputStream inStream) is not supported");
}
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Generates a CertPath from data from the provided
+ * InputStream. The encoding is that specified by the
+ * encoding parameter.
+ *
+ * @param inStream
+ * InputStream containing certificate path data in specified
+ * encoding
+ * @param encoding
+ * encoding of the data in the input stream
+ *
+ * @return CertPath a CertPath initialized from the provided data
+ *
+ * @throws CertificateException
+ * if parsing problems are detected
+ * @throws UnsupportedOperationException
+ * if the provider does not implement this method
+ */
public CertPath engineGenerateCertPath(InputStream inStream, String encoding)
throws CertificateException {
throw new UnsupportedOperationException(
"Method engineGenerateCertPath(InputStream inStream, String encoding) is not supported");
}
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Generates a CertPath from the provided List of
+ * Certificates. The encoding is the default encoding.
+ *
+ * @param certificates
+ * List containing certificates in a format supported by the
+ * CertificateFactory
+ *
+ * @return CertPath a CertPath initialized from the provided data
+ *
+ * @throws CertificateException
+ * if parsing problems are detected
+ * @throws UnsupportedOperationException
+ * if the provider does not implement this method
+ */
public CertPath engineGenerateCertPath(List certificates)
throws CertificateException {
throw new UnsupportedOperationException(
"Method engineGenerateCertPath(List certificates) is not supported");
}
- /**
- * @com.intel.drl.spec_ref
- *
- * FIXME: 1.5 updates are needed Iterator
- */
+ /**
+ * Returns an Iterator over the supported CertPath encodings (as Strings).
+ * The first element is the default encoding.
+ *
+ * @return Iterator Iterator over supported CertPath encodings (as Strings)
+ *
+ * FIXME: 1.5 updates are needed Iterator
+ */
public Iterator engineGetCertPathEncodings() {
throw new UnsupportedOperationException(
"Method engineGetCertPathEncodings() is not supported");
}
-}
\ No newline at end of file
+}
Index: modules/security/src/common/javasrc/java/security/cert/CertificateNotYetValidException.java
===================================================================
--- modules/security/src/common/javasrc/java/security/cert/CertificateNotYetValidException.java.orig 2006-03-30 08:31:04.000000000 +0100
+++ modules/security/src/common/javasrc/java/security/cert/CertificateNotYetValidException.java 2006-03-30 08:31:52.000000000 +0100
@@ -21,9 +21,9 @@
package java.security.cert;
+
/**
- * @com.intel.drl.spec_ref
- *
+ * This class indicates that a given certificate is not valid yet.
*/
public class CertificateNotYetValidException extends CertificateException {
/**
@@ -31,16 +31,20 @@
*/
private static final long serialVersionUID = 4355919900041064702L;
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Constructs a new instance of this class with its walkback and message
+ * filled in.
+ *
+ * @param msg
+ * String The detail message for the exception.
+ */
public CertificateNotYetValidException(String msg) {
super(msg);
}
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Constructs a new instance of this class with its walkback filled in.
+ */
public CertificateNotYetValidException() {
}
}
\ No newline at end of file
Index: modules/security/src/common/javasrc/java/security/cert/CertificateParsingException.java
===================================================================
--- modules/security/src/common/javasrc/java/security/cert/CertificateParsingException.java.orig 2006-03-30 08:31:04.000000000 +0100
+++ modules/security/src/common/javasrc/java/security/cert/CertificateParsingException.java 2006-03-30 08:31:52.000000000 +0100
@@ -21,9 +21,9 @@
package java.security.cert;
+
/**
- * @com.intel.drl.spec_ref
- *
+ * This class indicates that a given certificate could not be parsed.
*/
public class CertificateParsingException extends CertificateException {
@@ -32,16 +32,20 @@
*/
private static final long serialVersionUID = -7989222416793322029L;
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Constructs a new instance of this class with its walkback and message
+ * filled in.
+ *
+ * @param msg
+ * String The detail message for the exception.
+ */
public CertificateParsingException(String msg) {
super(msg);
}
- /**
- * @com.intel.drl.spec_ref
- */
+ /**
+ * Constructs a new instance of this class with its walkback filled in.
+ */
public CertificateParsingException() {
}