jdk-sandbox: comparison jdk/src/share/classes/java/security/cert/X509CRL.java

equal deleted inserted replaced

-:6d0f51c99930
+:882a3948c6e6
 /*
-* Copyright (c) 1997, 2012, Oracle and/or its affiliates. All rights reserved.
+* Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.  Oracle designates this
 * <p>
 * More information can be found in
 * <a href="http://www.ietf.org/rfc/rfc3280.txt">RFC 3280: Internet X.509
 * Public Key Infrastructure Certificate and CRL Profile</a>.
 * <p>
-* The ASN.1 definition of <code>tbsCertList</code> is:
+* The ASN.1 definition of {@code tbsCertList} is:
 * <pre>
 * TBSCertList  ::=  SEQUENCE  {
 *     version                 Version OPTIONAL,
 *                             -- if present, must be v2
 *     signature               AlgorithmIdentifier,
 *     }
 * </pre>
 * <p>
 * CRLs are instantiated using a certificate factory. The following is an
 * example of how to instantiate an X.509 CRL:
-* <pre><code>
+* <pre>{@code
 * try (InputStream inStream = new FileInputStream("fileName-of-crl")) {
 *     CertificateFactory cf = CertificateFactory.getInstance("X.509");
 *     X509CRL crl = (X509CRL)cf.generateCRL(inStream);
 * }
-* </code></pre>
+* }</pre>
 *
 * @author Hemma Prafullchandra
 *
 *
 * @see CRL
 super("X.509");
 }
 /**
 * Compares this CRL for equality with the given
-* object. If the <code>other</code> object is an
+* object. If the {@code other} object is an
-* <code>instanceof</code> <code>X509CRL</code>, then
+* {@code instanceof} {@code X509CRL}, then
 * its encoded form is retrieved and compared with the
 * encoded form of this CRL.
 *
 * @param other the object to test for equality with this CRL.
 *
 * supplied by the given provider. Note that the specified Provider object
 * does not have to be registered in the provider list.
 *
 * This method was added to version 1.8 of the Java Platform Standard
 * Edition. In order to maintain backwards compatibility with existing
-* service providers, this method is not <code>abstract</code>
+* service providers, this method is not {@code abstract}
 * and it provides a default implementation.
 *
 * @param key the PublicKey used to carry out the verification.
 * @param sigProvider the signature provider.
 *
 InvalidKeyException, SignatureException {
 X509CRLImpl.verify(this, key, sigProvider);
 }
 /**
-* Gets the <code>version</code> (version number) value from the CRL.
+* Gets the {@code version} (version number) value from the CRL.
 * The ASN.1 definition for this is:
 * <pre>
 * version    Version OPTIONAL,
 *             -- if present, must be v2<p>
 * Version  ::=  INTEGER  {  v1(0), v2(1), v3(2)  }
 */
 public abstract int getVersion();
 /**
 * <strong>Denigrated</strong>, replaced by {@linkplain
-* #getIssuerX500Principal()}. This method returns the <code>issuer</code>
+* #getIssuerX500Principal()}. This method returns the {@code issuer}
 * as an implementation specific Principal object, which should not be
 * relied upon by portable code.
 *
 * <p>
-* Gets the <code>issuer</code> (issuer distinguished name) value from
+* Gets the {@code issuer} (issuer distinguished name) value from
 * the CRL. The issuer name identifies the entity that signed (and
 * issued) the CRL.
 *
 * <p>The issuer name field contains an
 * X.500 distinguished name (DN).
 *                               AttributeType,
 *                               AttributeValue }
 * AttributeType ::= OBJECT IDENTIFIER
 * AttributeValue ::= ANY
 * </pre>
-* The <code>Name</code> describes a hierarchical name composed of
+* The {@code Name} describes a hierarchical name composed of
 * attributes,
 * such as country name, and corresponding values, such as US.
-* The type of the <code>AttributeValue</code> component is determined by
+* The type of the {@code AttributeValue} component is determined by
-* the <code>AttributeType</code>; in general it will be a
+* the {@code AttributeType}; in general it will be a
-* <code>directoryString</code>. A <code>directoryString</code> is usually
+* {@code directoryString}. A {@code directoryString} is usually
-* one of <code>PrintableString</code>,
+* one of {@code PrintableString},
-* <code>TeletexString</code> or <code>UniversalString</code>.
+* {@code TeletexString} or {@code UniversalString}.
 *
 * @return a Principal whose name is the issuer distinguished name.
 */
 public abstract Principal getIssuerDN();
 /**
 * Returns the issuer (issuer distinguished name) value from the
-* CRL as an <code>X500Principal</code>.
+* CRL as an {@code X500Principal}.
 * <p>
 * It is recommended that subclasses override this method.
 *
-* @return an <code>X500Principal</code> representing the issuer
+* @return an {@code X500Principal} representing the issuer
 *          distinguished name
 * @since 1.4
 */
 public X500Principal getIssuerX500Principal() {
 if (issuerPrincipal == null) {
 }
 return issuerPrincipal;
 }
 /**
-* Gets the <code>thisUpdate</code> date from the CRL.
+* Gets the {@code thisUpdate} date from the CRL.
 * The ASN.1 definition for this is:
 * <pre>
 * thisUpdate   ChoiceOfTime
 * ChoiceOfTime ::= CHOICE {
 *     utcTime        UTCTime,
 *     generalTime    GeneralizedTime }
 * </pre>
 *
-* @return the <code>thisUpdate</code> date from the CRL.
+* @return the {@code thisUpdate} date from the CRL.
 */
 public abstract Date getThisUpdate();
 /**
-* Gets the <code>nextUpdate</code> date from the CRL.
+* Gets the {@code nextUpdate} date from the CRL.
 *
-* @return the <code>nextUpdate</code> date from the CRL, or null if
+* @return the {@code nextUpdate} date from the CRL, or null if
 * not present.
 */
 public abstract Date getNextUpdate();
 /**
 */
 public abstract Set<? extends X509CRLEntry> getRevokedCertificates();
 /**
 * Gets the DER-encoded CRL information, the
-* <code>tbsCertList</code> from this CRL.
+* {@code tbsCertList} from this CRL.
 * This can be used to verify the signature independently.
 *
 * @return the DER-encoded CRL information.
 * @exception CRLException if an encoding error occurs.
 */
 public abstract byte[] getTBSCertList() throws CRLException;
 /**
-* Gets the <code>signature</code> value (the raw signature bits) from
+* Gets the {@code signature} value (the raw signature bits) from
 * the CRL.
 * The ASN.1 definition for this is:
 * <pre>
 * signature     BIT STRING
 * </pre>
 *                             -- contains a value of the type
 *                             -- registered for use with the
 *                             -- algorithm object identifier value
 * </pre>
 *
-* <p>The algorithm name is determined from the <code>algorithm</code>
+* <p>The algorithm name is determined from the {@code algorithm}
 * OID string.
 *
 * @return the signature algorithm name.
 */
 public abstract String getSigAlgName();

changeset 18551	882a3948c6e6
parent 14342	8435a30053c1
child 18592	80cdfecea074