--- old/src/java.xml.crypto/share/classes/com/sun/org/apache/xml/internal/security/encryption/AgreementMethod.java 2015-08-18 14:21:11.905018476 +0400
+++ new/src/java.xml.crypto/share/classes/com/sun/org/apache/xml/internal/security/encryption/AgreementMethod.java 2015-08-18 14:21:11.673018486 +0400
@@ -31,38 +31,38 @@
* based on a shared secret computed from certain types of compatible public
* keys from both the sender and the recipient. Information from the originator
* to determine the secret is indicated by an optional OriginatorKeyInfo
- * parameter child of an AgreementMethod
element while that
+ * parameter child of an {@code AgreementMethod} element while that
* associated with the recipient is indicated by an optional RecipientKeyInfo. A
* shared key is derived from this shared secret by a method determined by the
* Key Agreement algorithm.
*
* Note: XML Encryption does not provide an on-line key agreement
- * negotiation protocol. The AgreementMethod
element can be used by
+ * negotiation protocol. The {@code AgreementMethod} element can be used by
* the originator to identify the keys and computational procedure that were
* used to obtain a shared encryption key. The method used to obtain or select
* the keys or algorithm used for the agreement computation is beyond the scope
* of this specification.
*
- * The AgreementMethod
element appears as the content of a
- * ds:KeyInfo
since, like other ds:KeyInfo
children,
- * it yields a key. This ds:KeyInfo
is in turn a child of an
- * EncryptedData
or EncryptedKey
element. The
- * Algorithm attribute and KeySize child of the EncryptionMethod
- * element under this EncryptedData
or EncryptedKey
+ * The {@code AgreementMethod} element appears as the content of a
+ * {@code ds:KeyInfo} since, like other {@code ds:KeyInfo} children,
+ * it yields a key. This {@code ds:KeyInfo} is in turn a child of an
+ * {@code EncryptedData} or {@code EncryptedKey} element. The
+ * Algorithm attribute and KeySize child of the {@code EncryptionMethod}
+ * element under this {@code EncryptedData} or {@code EncryptedKey}
* element are implicit parameters to the key agreement computation. In cases
- * where this EncryptionMethod
algorithm URI
is
+ * where this {@code EncryptionMethod} algorithm {@code URI} is
* insufficient to determine the key length, a KeySize MUST have been included.
* In addition, the sender may place a KA-Nonce element under
- * AgreementMethod
to assure that different keying material is
+ * {@code AgreementMethod} to assure that different keying material is
* generated even for repeated agreements using the same sender and recipient
* public keys.
*
* If the agreed key is being used to wrap a key, then
- * AgreementMethod
would appear inside a ds:KeyInfo
- * inside an EncryptedKey
element.
+ * {@code AgreementMethod} would appear inside a {@code ds:KeyInfo}
+ * inside an {@code EncryptedKey} element.
*
* The Schema for AgreementMethod is as follows: - *
{@code ** * - *@@ -74,15 +74,15 @@ * **
byte
array.
- * @return a byte
array.
+ * Returns a {@code byte} array.
+ * @return a {@code byte} array.
*/
byte[] getKANonce();
@@ -93,30 +93,30 @@
void setKANonce(byte[] kanonce);
/**
- * Returns additional information regarding the AgreementMethod
.
- * @return additional information regarding the AgreementMethod
.
+ * Returns additional information regarding the {@code AgreementMethod}.
+ * @return additional information regarding the {@code AgreementMethod}.
*/
IteratorAgreementMethod
information.
+ * Adds additional {@code AgreementMethod} information.
*
- * @param info a Element
that represents additional information
+ * @param info a {@code Element} that represents additional information
* specified by
- * {@code *- *
AgreementMethod
information.
+ * Removes additional {@code AgreementMethod} information.
*
- * @param info a Element
that represents additional information
+ * @param info a {@code Element} that represents additional information
* specified by
- * {@code *- *
CryptographicMethod
.
+ * Returns the algorithm URI of this {@code CryptographicMethod}.
*
- * @return the algorithm URI of this CryptographicMethod
+ * @return the algorithm URI of this {@code CryptographicMethod}
*/
String getAlgorithm();
}