Use Javadoc snippets (#6091)

* Use Javadoc snippets

* fixed example setters

Author: debora-ito

services-custom/dynamodb-enhanced/src/main/java/software/amazon/awssdk/enhanced/dynamodb/mapper/annotations/DynamoDbAttribute.java

@@ -28,8 +28,7 @@
  *
  * <p>
  * Example using {@link DynamoDbAttribute}:
- * <pre>
- * {@code
+ * {@snippet :
  * @DynamoDbBean
  * public class Bean {
  *      private String internalKey;
@@ -40,11 +39,10 @@
  *      }
  *
  *      public void setInternalKey(String internalKey) {
- *          return this.internalKey = internalKey;}
+ *          this.internalKey = internalKey;
  *      }
  * }
  * }
- * </pre>
  */
 @Target({ElementType.METHOD})
 @Retention(RetentionPolicy.RUNTIME)

services-custom/dynamodb-enhanced/src/main/java/software/amazon/awssdk/enhanced/dynamodb/mapper/annotations/DynamoDbBean.java

@@ -47,15 +47,15 @@
  * </ul>
  *
  * Example using attribute converter providers with one custom provider and the default provider:
- * <pre>
- * {@code
+ *
+ * {@snippet :
  * (converterProviders = {CustomAttributeConverter.class, DefaultAttributeConverterProvider.class});
  * }
- * </pre>
+ *
  * <p>
  * Example using {@link DynamoDbBean}:
- * <pre>
- * {@code
+ *
+ * {@snippet :
  * @DynamoDbBean
  * public class Customer {
  *     private String id;
@@ -73,12 +73,13 @@
  *     public Instant getCreatedOn() {
  *          return this.createdOn;
  *     }
+ *
  *     public void setCreatedOn(Instant createdOn) {
  *          this.createdOn = createdOn;
- *      }
+ *     }
  * }
  * }
- * </pre>
+ *
  */
 @Target({ElementType.TYPE})
 @Retention(RetentionPolicy.RUNTIME)

services-custom/dynamodb-enhanced/src/main/java/software/amazon/awssdk/enhanced/dynamodb/mapper/annotations/DynamoDbIgnore.java

@@ -24,9 +24,9 @@
 /**
  * Opts this attribute out of participating in the table schema. It will be completely ignored by the mapper.
  * <p>
- * Example using {@link DynamoDbAttribute}:
- * <pre>
- * {@code
+ * Example using {@link DynamoDbIgnore}:
+ *
+ * {@snippet :
  * @DynamoDbBean
  * public class Bean {
  *      private String internalKey;
@@ -37,11 +37,10 @@
  *      }
  *
  *      public void setInternalKey(String internalKey) {
- *          return this.internalKey = internalKey;}
+ *          this.internalKey = internalKey;
  *      }
  * }
  * }
- * </pre>
  */
 @Target({ElementType.METHOD})
 @Retention(RetentionPolicy.RUNTIME)

services-custom/dynamodb-enhanced/src/main/java/software/amazon/awssdk/enhanced/dynamodb/mapper/annotations/DynamoDbIgnoreNulls.java

@@ -29,14 +29,14 @@
  *
  * <p>
  * Example using {@link DynamoDbIgnoreNulls}:
- * <pre>
- * <code>
- * &#64;DynamoDbBean
+ *
+ * {@snippet :
+ * @DynamoDbBean
  * public class NestedBean {
  *     private AbstractBean innerBean1;
  *     private AbstractBean innerBean2;
  *
- *     &#64;DynamoDbIgnoreNulls
+ *     @DynamoDbIgnoreNulls
  *     public AbstractBean getInnerBean1() {
  *         return innerBean1;
  *     }
@@ -67,8 +67,7 @@
  *
  * // innerBean2 w/o @DynamoDbIgnoreNulls has a NULL attribute.
  * assertThat(nestedBean.getInnerBean2(), hasEntry("attribute", nullAttributeValue()));
- * </code>
- * </pre>
+ * }
  */
 @SdkPublicApi
 @Target({ElementType.METHOD})

services-custom/dynamodb-enhanced/src/main/java/software/amazon/awssdk/enhanced/dynamodb/mapper/annotations/DynamoDbImmutable.java

@@ -47,16 +47,14 @@
  * </ul>
  *
  * Example using attribute converter providers with one custom provider and the default provider:
- * <pre>
- * {@code
+ *
+ * {@snippet :
  * (converterProviders = {CustomAttributeConverter.class, DefaultAttributeConverterProvider.class});
  * }
- * </pre>
  *
  * <p>
  * Example using {@link DynamoDbImmutable}:
- * <pre>
- * {@code
+ * {@snippet :
  * @DynamoDbImmutable(builder = Customer.Builder.class)
  * public class Customer {
  *     private final String accountId;
@@ -104,7 +102,6 @@
  *     }
  * }
  * }
- * </pre>
  */
 @Target({ElementType.TYPE})
 @Retention(RetentionPolicy.RUNTIME)

services-custom/dynamodb-enhanced/src/main/java/software/amazon/awssdk/enhanced/dynamodb/mapper/annotations/DynamoDbPartitionKey.java

@@ -28,8 +28,7 @@
  *
  * <p>
  * Example using {@link DynamoDbPartitionKey}:
- * <pre>
- * {@code
+ * {@snippet :
  * @DynamoDbBean
  * public class Customer {
  *     private String id;
@@ -47,12 +46,12 @@
  *     public Instant getCreatedOn() {
  *          return this.createdOn;
  *     }
+ *
  *     public void setCreatedOn(Instant createdOn) {
  *          this.createdOn = createdOn;
  *      }
  * }
  * }
- * </pre>
  */
 @SdkPublicApi
 @Target({ElementType.METHOD})

services-custom/dynamodb-enhanced/src/main/java/software/amazon/awssdk/enhanced/dynamodb/mapper/annotations/DynamoDbSortKey.java

@@ -25,10 +25,9 @@
 /**
  * Denotes this attribute as being the optional primary sort key of the DynamoDb table. This attribute must map to a
  * DynamoDb scalar type (string, number or binary) to be valid.
- *
+ * <p>
  * Example using {@link DynamoDbSortKey}:
- * <pre>
- * {@code
+ * {@snippet :
  *    @DynamoDbBean
  *    public class Customer {
  *        private String accountId;
@@ -52,7 +51,7 @@
  *        }
  *    }
  * }
- * </pre>
+ *
  */
 @SdkPublicApi
 @Target({ElementType.METHOD})