Adding periods

Author: WesleyRosenblum

src/examples/java/com/amazonaws/crypto/examples/FileStreamingDefaults.java

@@ -43,7 +43,7 @@ public class FileStreamingDefaults {
      * @param sourcePlaintextFile Plaintext file to encrypt
      */
     public static void run(final AwsKmsCmkId awsKmsCmk, final File sourcePlaintextFile) throws IOException {
-        // Instantiate the AWS Encryption SDK
+        // Instantiate the AWS Encryption SDK.
         final AwsCrypto awsEncryptionSdk = new AwsCrypto();
 
         // We assume that you can also write to the directory containing the plaintext file,

src/examples/java/com/amazonaws/crypto/examples/InMemoryStreamingDefaults.java

@@ -40,7 +40,7 @@ public class InMemoryStreamingDefaults {
      * @param sourcePlaintext Plaintext to encrypt
      */
     public static void run(final AwsKmsCmkId awsKmsCmk, final byte[] sourcePlaintext) throws IOException {
-        // Instantiate the AWS Encryption SDK
+        // Instantiate the AWS Encryption SDK.
         final AwsCrypto awsEncryptionSdk = new AwsCrypto();
 
         // Prepare your encryption context.

src/examples/java/com/amazonaws/crypto/examples/OneStepDefaults.java

@@ -32,7 +32,7 @@ public class OneStepDefaults {
      * @param sourcePlaintext Plaintext to encrypt
      */
     public static void run(final AwsKmsCmkId awsKmsCmk, final byte[] sourcePlaintext) {
-        // Instantiate the AWS Encryption SDK
+        // Instantiate the AWS Encryption SDK.
         final AwsCrypto awsEncryptionSdk = new AwsCrypto();
 
         // Prepare your encryption context.
@@ -55,7 +55,7 @@ public static void run(final AwsKmsCmkId awsKmsCmk, final byte[] sourcePlaintext
                         .plaintext(sourcePlaintext).build());
         final byte[] ciphertext = encryptResult.getResult();
 
-        // Demonstrate that the ciphertext and plaintext are different
+        // Demonstrate that the ciphertext and plaintext are different.
         assert !Arrays.equals(ciphertext, sourcePlaintext);
 
         // Decrypt your encrypted data using the same keyring you used on encrypt.

src/examples/java/com/amazonaws/crypto/examples/OneStepUnsigned.java

@@ -69,7 +69,7 @@ public static void run(final AwsKmsCmkId awsKmsCmk, final byte[] sourcePlaintext
                         .plaintext(sourcePlaintext).build());
         final byte[] ciphertext = encryptResult.getResult();
 
-        // Demonstrate that the ciphertext and plaintext are different
+        // Demonstrate that the ciphertext and plaintext are different.
         assert !Arrays.equals(ciphertext, sourcePlaintext);
 
         // Decrypt your encrypted data using the same keyring you used on encrypt.

src/examples/java/com/amazonaws/crypto/examples/keyring/awskms/CustomClientSupplier.java

@@ -85,7 +85,7 @@ public AWSKMS getClient(String regionId) {
      * @param sourcePlaintext Plaintext to encrypt
      */
     public static void run(final AwsKmsCmkId awsKmsCmk, final byte[] sourcePlaintext) {
-        // Instantiate the AWS Encryption SDK
+        // Instantiate the AWS Encryption SDK.
         final AwsCrypto awsEncryptionSdk = new AwsCrypto();
 
         // Prepare your encryption context.
@@ -111,7 +111,7 @@ public static void run(final AwsKmsCmkId awsKmsCmk, final byte[] sourcePlaintext
                         .plaintext(sourcePlaintext).build());
         final byte[] ciphertext = encryptResult.getResult();
 
-        // Demonstrate that the ciphertext and plaintext are different
+        // Demonstrate that the ciphertext and plaintext are different.
         assert !Arrays.equals(ciphertext, sourcePlaintext);
 
         // Decrypt your encrypted data using the same keyring you used on encrypt.

src/examples/java/com/amazonaws/crypto/examples/keyring/awskms/CustomKmsClientConfig.java

@@ -48,7 +48,7 @@ public class CustomKmsClientConfig {
      * @param sourcePlaintext Plaintext to encrypt
      */
     public static void run(final AwsKmsCmkId awsKmsCmk, final byte[] sourcePlaintext) {
-        // Instantiate the AWS Encryption SDK
+        // Instantiate the AWS Encryption SDK.
         final AwsCrypto awsEncryptionSdk = new AwsCrypto();
 
         // Prepare your encryption context.
@@ -90,7 +90,7 @@ public static void run(final AwsKmsCmkId awsKmsCmk, final byte[] sourcePlaintext
                         .plaintext(sourcePlaintext).build());
         final byte[] ciphertext = encryptResult.getResult();
 
-        // Demonstrate that the ciphertext and plaintext are different
+        // Demonstrate that the ciphertext and plaintext are different.
         assert !Arrays.equals(ciphertext, sourcePlaintext);
 
         // Decrypt your encrypted data using the same keyring you used on encrypt.

src/examples/java/com/amazonaws/crypto/examples/keyring/awskms/DiscoveryDecrypt.java

@@ -48,7 +48,7 @@ public class DiscoveryDecrypt {
      * @param sourcePlaintext Plaintext to encrypt
      */
     public static void run(final AwsKmsCmkId awsKmsCmk, final byte[] sourcePlaintext) {
-        // Instantiate the AWS Encryption SDK
+        // Instantiate the AWS Encryption SDK.
         final AwsCrypto awsEncryptionSdk = new AwsCrypto();
 
         // Prepare your encryption context.
@@ -74,7 +74,7 @@ public static void run(final AwsKmsCmkId awsKmsCmk, final byte[] sourcePlaintext
                         .plaintext(sourcePlaintext).build());
         final byte[] ciphertext = encryptResult.getResult();
 
-        // Demonstrate that the ciphertext and plaintext are different
+        // Demonstrate that the ciphertext and plaintext are different.
         assert !Arrays.equals(ciphertext, sourcePlaintext);
 
         // Decrypt your encrypted data using the KMS discovery keyring.

src/examples/java/com/amazonaws/crypto/examples/keyring/awskms/DiscoveryDecryptInRegionOnly.java

@@ -55,7 +55,7 @@ public class DiscoveryDecryptInRegionOnly {
      * @param sourcePlaintext Plaintext to encrypt
      */
     public static void run(final AwsKmsCmkId awsKmsCmk, final byte[] sourcePlaintext) {
-        // Instantiate the AWS Encryption SDK
+        // Instantiate the AWS Encryption SDK.
         final AwsCrypto awsEncryptionSdk = new AwsCrypto();
 
         // Prepare your encryption context.
@@ -90,7 +90,7 @@ public static void run(final AwsKmsCmkId awsKmsCmk, final byte[] sourcePlaintext
                         .plaintext(sourcePlaintext).build());
         final byte[] ciphertext = encryptResult.getResult();
 
-        // Demonstrate that the ciphertext and plaintext are different
+        // Demonstrate that the ciphertext and plaintext are different.
         assert !Arrays.equals(ciphertext, sourcePlaintext);
 
         // Decrypt your encrypted data using the KMS discovery keyring.

src/examples/java/com/amazonaws/crypto/examples/keyring/awskms/DiscoveryDecryptWithPreferredRegions.java

@@ -61,7 +61,7 @@ public class DiscoveryDecryptWithPreferredRegions {
      * @param sourcePlaintext Plaintext to encrypt
      */
     public static void run(final AwsKmsCmkId awsKmsCmk, final byte[] sourcePlaintext) {
-        // Instantiate the AWS Encryption SDK
+        // Instantiate the AWS Encryption SDK.
         final AwsCrypto awsEncryptionSdk = new AwsCrypto();
 
         // Prepare your encryption context.
@@ -106,7 +106,7 @@ public static void run(final AwsKmsCmkId awsKmsCmk, final byte[] sourcePlaintext
                         .plaintext(sourcePlaintext).build());
         final byte[] ciphertext = encryptResult.getResult();
 
-        // Demonstrate that the ciphertext and plaintext are different
+        // Demonstrate that the ciphertext and plaintext are different.
         assert !Arrays.equals(ciphertext, sourcePlaintext);
 
         // Decrypt your encrypted data using the multi keyring.

src/examples/java/com/amazonaws/crypto/examples/keyring/awskms/MultipleRegions.java

@@ -44,7 +44,7 @@ public class MultipleRegions {
      * @param sourcePlaintext      Plaintext to encrypt
      */
     public static void run(final AwsKmsCmkId awsKmsGeneratorCmk, final List<AwsKmsCmkId> awsKmsAdditionalCmks, byte[] sourcePlaintext) {
-        // Instantiate the AWS Encryption SDK
+        // Instantiate the AWS Encryption SDK.
         final AwsCrypto awsEncryptionSdk = new AwsCrypto();
 
         // Prepare your encryption context.
@@ -87,7 +87,7 @@ public static void run(final AwsKmsCmkId awsKmsGeneratorCmk, final List<AwsKmsCm
         // It should contain one EDK for each CMK.
         assert encryptResult.getHeaders().getEncryptedKeyBlobCount() == awsKmsAdditionalCmks.size() + 1;
 
-        // Demonstrate that the ciphertext and plaintext are different
+        // Demonstrate that the ciphertext and plaintext are different.
         assert !Arrays.equals(ciphertext, sourcePlaintext);
 
         // Decrypt your encrypted data separately using the single-CMK keyrings.

src/examples/java/com/amazonaws/crypto/examples/keyring/awskms/SingleCmk.java

@@ -41,7 +41,7 @@ public class SingleCmk {
      * @param sourcePlaintext Plaintext to encrypt
      */
     public static void run(final AwsKmsCmkId awsKmsCmk, final byte[] sourcePlaintext) {
-        // Instantiate the AWS Encryption SDK
+        // Instantiate the AWS Encryption SDK.
         final AwsCrypto awsEncryptionSdk = new AwsCrypto();
 
         // Prepare your encryption context.
@@ -64,7 +64,7 @@ public static void run(final AwsKmsCmkId awsKmsCmk, final byte[] sourcePlaintext
                         .plaintext(sourcePlaintext).build());
         final byte[] ciphertext = encryptResult.getResult();
 
-        // Demonstrate that the ciphertext and plaintext are different
+        // Demonstrate that the ciphertext and plaintext are different.
         assert !Arrays.equals(ciphertext, sourcePlaintext);
 
         // Decrypt your encrypted data using the same keyring you used on encrypt.

src/examples/java/com/amazonaws/crypto/examples/keyring/multi/AwsKmsWithEscrow.java

@@ -47,7 +47,7 @@ public class AwsKmsWithEscrow {
      * @param sourcePlaintext Plaintext to encrypt
      */
     public static void run(final AwsKmsCmkId awsKmsCmk, final byte[] sourcePlaintext) throws GeneralSecurityException {
-        // Instantiate the AWS Encryption SDK
+        // Instantiate the AWS Encryption SDK.
         final AwsCrypto awsEncryptionSdk = new AwsCrypto();
 
         // Prepare your encryption context.

src/examples/java/com/amazonaws/crypto/examples/keyring/rawaes/RawAes.java

@@ -32,7 +32,7 @@ public class RawAes {
      * @param sourcePlaintext Plaintext to encrypt
      */
     public static void run(final byte[] sourcePlaintext) {
-        // Instantiate the AWS Encryption SDK
+        // Instantiate the AWS Encryption SDK.
         final AwsCrypto awsEncryptionSdk = new AwsCrypto();
 
         // Prepare your encryption context.
@@ -73,7 +73,7 @@ public static void run(final byte[] sourcePlaintext) {
                         .plaintext(sourcePlaintext).build());
         final byte[] ciphertext = encryptResult.getResult();
 
-        // Demonstrate that the ciphertext and plaintext are different
+        // Demonstrate that the ciphertext and plaintext are different.
         assert !Arrays.equals(ciphertext, sourcePlaintext);
 
         // Decrypt your encrypted data using the same keyring you used on encrypt.

src/examples/java/com/amazonaws/crypto/examples/keyring/rawrsa/PublicPrivateKeySeparate.java

@@ -43,7 +43,7 @@ public class PublicPrivateKeySeparate {
      * @param sourcePlaintext Plaintext to encrypt
      */
     public static void run(final byte[] sourcePlaintext) throws GeneralSecurityException {
-        // Instantiate the AWS Encryption SDK
+        // Instantiate the AWS Encryption SDK.
         final AwsCrypto awsEncryptionSdk = new AwsCrypto();
 
         // Prepare your encryption context.
@@ -100,7 +100,7 @@ public static void run(final byte[] sourcePlaintext) throws GeneralSecurityExcep
                         .plaintext(sourcePlaintext).build());
         final byte[] ciphertext = encryptResult.getResult();
 
-        // Demonstrate that the ciphertext and plaintext are different
+        // Demonstrate that the ciphertext and plaintext are different.
         assert !Arrays.equals(ciphertext, sourcePlaintext);
 
         // Try to decrypt your encrypted data using the *encrypt* keyring.

src/examples/java/com/amazonaws/crypto/examples/keyring/rawrsa/RawRsa.java

@@ -33,7 +33,7 @@ public class RawRsa {
      * @param sourcePlaintext Plaintext to encrypt
      */
     public static void run(final byte[] sourcePlaintext) throws GeneralSecurityException {
-        // Instantiate the AWS Encryption SDK
+        // Instantiate the AWS Encryption SDK.
         final AwsCrypto awsEncryptionSdk = new AwsCrypto();
 
         // Prepare your encryption context.
@@ -79,7 +79,7 @@ public static void run(final byte[] sourcePlaintext) throws GeneralSecurityExcep
                         .plaintext(sourcePlaintext).build());
         final byte[] ciphertext = encryptResult.getResult();
 
-        // Demonstrate that the ciphertext and plaintext are different
+        // Demonstrate that the ciphertext and plaintext are different.
         assert !Arrays.equals(ciphertext, sourcePlaintext);
 
         // Decrypt your encrypted data using the same keyring you used on encrypt.

src/examples/java/com/amazonaws/crypto/examples/legacy/BasicEncryptionExample.java

@@ -38,13 +38,13 @@ public static void main(final String[] args) {
     }
 
     static void encryptAndDecrypt(final String keyArn) {
-        // 1. Instantiate the AWS Encryption SDK
+        // 1. Instantiate the AWS Encryption SDK.
         final AwsCrypto crypto = new AwsCrypto();
 
-        // 2. Instantiate a KMS master key provider
+        // 2. Instantiate a KMS master key provider.
         final KmsMasterKeyProvider masterKeyProvider = KmsMasterKeyProvider.builder().withKeysForEncryption(keyArn).build();
 
-        // 3. Create an encryption context
+        // 3. Create an encryption context.
         //
         // Most encrypted data should have an associated encryption context
         // to protect integrity. This sample uses placeholder values.
@@ -53,11 +53,11 @@ static void encryptAndDecrypt(final String keyArn) {
         // blogs.aws.amazon.com/security/post/Tx2LZ6WBJJANTNW/How-to-Protect-the-Integrity-of-Your-Encrypted-Data-by-Using-AWS-Key-Management
         final Map<String, String> encryptionContext = Collections.singletonMap("ExampleContextKey", "ExampleContextValue");
 
-        // 4. Encrypt the data
+        // 4. Encrypt the data.
         final CryptoResult<byte[], KmsMasterKey> encryptResult = crypto.encryptData(masterKeyProvider, EXAMPLE_DATA, encryptionContext);
         final byte[] ciphertext = encryptResult.getResult();
 
-        // 5. Decrypt the data
+        // 5. Decrypt the data.
         final CryptoResult<byte[], KmsMasterKey> decryptResult = crypto.decryptData(masterKeyProvider, ciphertext);
 
         // 6. Before verifying the plaintext, verify that the customer master key that
@@ -75,7 +75,7 @@ static void encryptAndDecrypt(final String keyArn) {
             throw new IllegalStateException("Wrong Encryption Context!");
         }
 
-        // 8. Verify that the decrypted plaintext matches the original plaintext
+        // 8. Verify that the decrypted plaintext matches the original plaintext.
         assert Arrays.equals(decryptResult.getResult(), EXAMPLE_DATA);
     }
 }

src/examples/java/com/amazonaws/crypto/examples/legacy/EscrowedEncryptExample.java

@@ -70,22 +70,22 @@ public static void main(final String[] args) throws Exception {
 
     private static void standardEncrypt(final String kmsArn, final String fileName) throws Exception {
         // Encrypt with the KMS CMK and the escrowed public key
-        // 1. Instantiate the AWS Encryption SDK
+        // 1. Instantiate the AWS Encryption SDK.
         final AwsCrypto crypto = new AwsCrypto();
 
-        // 2. Instantiate a KMS master key provider
+        // 2. Instantiate a KMS master key provider.
         final KmsMasterKeyProvider kms = new KmsMasterKeyProvider(kmsArn);
 
-        // 3. Instantiate a JCE master key provider
+        // 3. Instantiate a JCE master key provider.
         // Because the user does not have access to the private escrow key,
         // they pass in "null" for the private key parameter.
         final JceMasterKey escrowPub = JceMasterKey.getInstance(publicEscrowKey, null, "Escrow", "Escrow",
                 "RSA/ECB/OAEPWithSHA-512AndMGF1Padding");
 
-        // 4. Combine the providers into a single master key provider
+        // 4. Combine the providers into a single master key provider.
         final MasterKeyProvider<?> provider = MultipleProviderFactory.buildMultiProvider(kms, escrowPub);
 
-        // 5. Encrypt the file
+        // 5. Encrypt the file.
         // To simplify the code, we omit the encryption context. Production code should always
         // use an encryption context. For an example, see the other SDK samples.
         final FileInputStream in = new FileInputStream(fileName);
@@ -101,22 +101,22 @@ private static void standardDecrypt(final String kmsArn, final String fileName)
         // Decrypt with the KMS CMK and the escrow public key. You can use a combined provider,
         // as shown here, or just the KMS master key provider.
 
-        // 1. Instantiate the AWS Encryption SDK
+        // 1. Instantiate the AWS Encryption SDK.
         final AwsCrypto crypto = new AwsCrypto();
 
-        // 2. Instantiate a KMS master key provider
+        // 2. Instantiate a KMS master key provider.
         final KmsMasterKeyProvider kms = new KmsMasterKeyProvider(kmsArn);
 
-        // 3. Instantiate a JCE master key provider
+        // 3. Instantiate a JCE master key provider.
         // Because the user does not have access to the private
         // escrow key, they pass in "null" for the private key parameter.
         final JceMasterKey escrowPub = JceMasterKey.getInstance(publicEscrowKey, null, "Escrow", "Escrow",
                 "RSA/ECB/OAEPWithSHA-512AndMGF1Padding");
 
-        // 4. Combine the providers into a single master key provider
+        // 4. Combine the providers into a single master key provider.
         final MasterKeyProvider<?> provider = MultipleProviderFactory.buildMultiProvider(kms, escrowPub);
 
-        // 5. Decrypt the file
+        // 5. Decrypt the file.
         // To simplify the code, we omit the encryption context. Production code should always
         // use an encryption context. For an example, see the other SDK samples.
         final FileInputStream in = new FileInputStream(fileName + ".encrypted");
@@ -131,15 +131,15 @@ private static void escrowDecrypt(final String fileName) throws Exception {
         // You can decrypt the stream using only the private key.
         // This method does not call KMS.
 
-        // 1. Instantiate the AWS Encryption SDK
+        // 1. Instantiate the AWS Encryption SDK.
         final AwsCrypto crypto = new AwsCrypto();
 
-        // 2. Instantiate a JCE master key provider
-        // This method call uses the escrowed private key, not null
+        // 2. Instantiate a JCE master key provider.
+        // This method call uses the escrowed private key, not null.
         final JceMasterKey escrowPriv = JceMasterKey.getInstance(publicEscrowKey, privateEscrowKey, "Escrow", "Escrow",
                 "RSA/ECB/OAEPWithSHA-512AndMGF1Padding");
 
-        // 3. Decrypt the file
+        // 3. Decrypt the file.
         // To simplify the code, we omit the encryption context. Production code should always
         // use an encryption context. For an example, see the other SDK samples.
         final FileInputStream in = new FileInputStream(fileName + ".encrypted");

src/examples/java/com/amazonaws/crypto/examples/legacy/FileStreamingExample.java

@@ -43,16 +43,16 @@ public static void main(String[] args) throws IOException {
         srcFile = args[0];
 
         // In this example, we generate a random key. In practice,
-        // you would get a key from an existing store
+        // you would get a key from an existing store.
         SecretKey cryptoKey = retrieveEncryptionKey();
 
-        // Create a JCE master key provider using the random key and an AES-GCM encryption algorithm
+        // Create a JCE master key provider using the random key and an AES-GCM encryption algorithm.
         JceMasterKey masterKey = JceMasterKey.getInstance(cryptoKey, "Example", "RandomKey", "AES/GCM/NoPadding");
 
-        // Instantiate the AWS Encryption SDK
+        // Instantiate the AWS Encryption SDK.
         AwsCrypto crypto = new AwsCrypto();
 
-        // Create an encryption context to identify this ciphertext
+        // Create an encryption context to identify this ciphertext.
         Map<String, String> context = Collections.singletonMap("Example", "FileStreaming");
 
         // Because the file might be to large to load into memory, we stream the data, instead of
@@ -73,7 +73,7 @@ public static void main(String[] args) throws IOException {
             throw new IllegalStateException("Bad encryption context");
         }
 
-        // Return the plaintext data
+        // Return the plaintext data.
         out = new FileOutputStream(srcFile + ".decrypted");
         IOUtils.copy(decryptingStream, out);
         decryptingStream.close();