Merge pull request awsdocs#43 from awsdocs/kms_snippets

adding code snippet references to kms article

Author: jschwarzwalder

doc_source/examples-crypto-kms.rst

@@ -41,8 +41,7 @@ Import the following classes for these examples.
 
 **Imports**
 
-.. literalinclude:: example_code/s3/src/main/java/aws/example/s3/S3Encrypt.java
-   :lines: 16-31
+.. literalinclude:: s3.java1.s3_encrypt.import.txt
    :language: java
 
 .. _encryption-only-kms:
@@ -57,8 +56,7 @@ managed key for encryption, pass the |KMS| key ID or alias to the
 
 **Code**
 
-.. literalinclude:: example_code/s3/src/main/java/aws/example/s3/S3Encrypt.java
-  :lines: 237-243
+.. literalinclude:: s3.java1.s3_encrypt.kms_encryption_only_build.txt
   :dedent: 8
   :language: java
 
@@ -67,8 +65,7 @@ Call the :methodname:`putObject` method on the |S3| encryption client to upload
 
 **Code**
 
-.. literalinclude:: example_code/s3/src/main/java/aws/example/s3/S3Encrypt.java
-  :lines: 247
+.. literalinclude:: s3.java1.s3_encrypt.kms_encryption_only_put_object.txt
   :dedent: 8
   :language: java
 
@@ -77,12 +74,11 @@ You can retrieve the object using the same client. This example calls the
 
 **Code**
 
-.. literalinclude:: example_code/s3/src/main/java/aws/example/s3/S3Encrypt.java
-  :lines: 249
+.. literalinclude:: s3.java1.s3_encrypt.kms_encryption_only_retrieve.txt
   :dedent: 8
   :language: java
 
-See the :sdk-examples-java-s3:`complete example <S3Encrypt.java#L236-L250>` on GitHub.
+See the :sdk-examples-java-s3:`complete example <S3Encrypt.java>` on GitHub.
 
 .. _authenticated-encryption-kms:
 
@@ -106,23 +102,21 @@ To enable this mode, specify the :classname:`AuthenticatedEncryption` value in t
 
 **Code**
 
-.. literalinclude:: example_code/s3/src/main/java/aws/example/s3/S3Encrypt.java
-   :lines: 257-263
+.. literalinclude:: s3.java1.s3_encrypt.kms_authenticated_encryption_builder.txt
    :dedent: 8
    :language: java
-
+   
 The :classname:`AuthenticatedEncryption` mode can retrieve unencrypted objects and
 objects encrypted with :classname:`EncryptionOnly` mode. The following example shows the
 |S3| encryption client retrieving an unencrypted object.
 
 **Code**
 
-.. literalinclude:: example_code/s3/src/main/java/aws/example/s3/S3Encrypt.java
-   :lines: 257-270
+.. literalinclude:: s3.java1.s3_encrypt.kms_authenticated_encryption_put_object.txt
    :dedent: 8
    :language: java
 
-See the :sdk-examples-java-s3:`complete example <S3Encrypt.java#L256-L271>` on GitHub.
+See the :sdk-examples-java-s3:`complete example <S3Encrypt.java>` on GitHub.
 
 .. _strict-authenticated-encryption-kms:
 
@@ -138,8 +132,15 @@ To enable this mode, specify the :classname:`StrictAuthenticatedEncryption` valu
 
 **Code**
 
-.. literalinclude:: example_code/s3/src/main/java/aws/example/s3/S3Encrypt.java
-   :lines: 278-284
+.. literalinclude:: s3.java1.s3_encrypt.kms_authenticated_encryption_strict_builder.txt
+   :dedent: 8
+   :language: java
+   
+Call the :methodname:`putObject` method on the |S3| encryption client to upload objects.
+
+**Code**
+
+.. literalinclude:: s3.java1.s3_encrypt.kms_authenticated_encryption_strict_put_object.txt
    :dedent: 8
    :language: java
 
@@ -149,9 +150,8 @@ authenticated mode.
 
 **Code**
 
-.. literalinclude:: example_code/s3/src/main/java/aws/example/s3/S3Encrypt.java
-   :lines: 278-295
+.. literalinclude:: s3.java1.s3_encrypt.kms_authenticated_encryption_strict_exception.txt
    :dedent: 8
    :language: java
 
-See the :sdk-examples-java-s3:`complete example <S3Encrypt.java#L278-L296>` on GitHub.
+See the :sdk-examples-java-s3:`complete example <S3Encrypt.java>` on GitHub.

doc_source/examples-crypto-masterkey.rst

@@ -40,8 +40,7 @@ Import the following classes for these examples.
 
 **Imports**
 
-.. literalinclude:: example_code/s3/src/main/java/aws/example/s3/S3Encrypt.java
-   :lines: 16-24,26-31
+.. literalinclude:: s3.java1.s3_encrypt.import.txt
    :language: java
 
 .. _encryption-only:
@@ -67,17 +66,15 @@ To use an asymmetric key or a key pair, simply pass the key pair to the same
 
 **Code**
 
-.. literalinclude:: example_code/s3/src/main/java/aws/example/s3/S3Encrypt.java
-  :lines: 217-223
+.. literalinclude:: s3.java1.s3_encrypt.encryption_only_asymetric_key_build.txt
   :dedent: 8
   :language: java
 
 Call the :methodname:`putObject` method on the |S3| encryption client to upload objects.
 
 **Code**
 
-.. literalinclude:: example_code/s3/src/main/java/aws/example/s3/S3Encrypt.java
-  :lines: 227
+.. literalinclude:: s3.java1.s3_encrypt.encryption_only_asymetric_key_put_object.txt
   :dedent: 8
   :language: java
 
@@ -86,12 +83,11 @@ You can retrieve the object using the same client. This example calls the
 
 **Code**
 
-.. literalinclude:: example_code/s3/src/main/java/aws/example/s3/S3Encrypt.java
-  :lines: 229
+.. literalinclude:: s3.java1.s3_encrypt.encryption_only_asymetric_key_retrieve.txt
   :dedent: 8
   :language: java
 
-See the :sdk-examples-java-s3:`complete example <S3Encrypt.java#L216-L230>` on GitHub.
+See the :sdk-examples-java-s3:`complete example <S3Encrypt.java>` on GitHub.
 
 .. _authenticated-encryption:
 
@@ -114,8 +110,7 @@ To enable this mode, specify the :classname:`AuthenticatedEncryption` value in t
 
 **Code**
 
-.. literalinclude:: example_code/s3/src/main/java/aws/example/s3/S3Encrypt.java
-   :lines: 67-72
+.. literalinclude:: s3.java1.s3_encrypt.strict_authenticated_encryption_build.txt
    :dedent: 8
    :language: java
 
@@ -125,8 +120,7 @@ objects encrypted with :classname:`EncryptionOnly` mode. The following example s
 
 **Code**
 
-.. literalinclude:: example_code/s3/src/main/java/aws/example/s3/S3Encrypt.java
-   :lines: 66-79
+.. literalinclude:: s3.java1.s3_encrypt.strict_authenticated_encryption.txt
    :dedent: 8
    :language: java
 
@@ -146,8 +140,7 @@ To enable this mode, specify the :classname:`StrictAuthenticatedEncryption` valu
 
 **Code**
 
-.. literalinclude:: example_code/s3/src/main/java/aws/example/s3/S3Encrypt.java
-   :lines: 132-137
+.. literalinclude:: s3.java1.s3_encrypt.strict_authenticated_encryption_build.txt
    :dedent: 8
    :language: java
 
@@ -157,9 +150,8 @@ authenticated mode.
 
 **Code**
 
-.. literalinclude:: example_code/s3/src/main/java/aws/example/s3/S3Encrypt.java
-   :lines: 131-149
+.. literalinclude:: s3.java1.s3_encrypt.strict_authenticated_encryption.txt
    :dedent: 8
    :language: java
 
-See the :sdk-examples-java-s3:`complete example <S3Encrypt.java#L131-L150>` on GitHub.
+See the :sdk-examples-java-s3:`complete example <S3Encrypt.java>` on GitHub.