[DDB Mapper V2] Add @SdkPreviewApi to public APIs

services-custom/dynamodb-mapper/pom.xml

@@ -21,7 +21,7 @@
     <parent>
         <groupId>software.amazon.awssdk</groupId>
         <artifactId>services-custom</artifactId>
-        <version>2.55.14-SNAPSHOT</version>
+        <version>2.57.5-SNAPSHOT</version>
     </parent>
     <artifactId>dynamodb-mapper</artifactId>
     <name>AWS Java SDK :: DynamoDB :: Mapper</name>

services-custom/dynamodb-mapper/src/main/java/software/amazon/awssdk/mapper/dynamodb/AbstractDynamoDBMapper.java

@@ -15,6 +15,7 @@
 
 package software.amazon.awssdk.mapper.dynamodb;
 
+import software.amazon.awssdk.annotations.SdkPreviewApi;
 import software.amazon.awssdk.annotations.SdkPublicApi;
 import software.amazon.awssdk.mapper.dynamodb.DynamoDBMapper.FailedBatch;
 import software.amazon.awssdk.services.dynamodb.model.AttributeValue;
@@ -33,6 +34,7 @@
  * {@code UnsupportedOperationException}.
  */
 @SdkPublicApi
+@SdkPreviewApi
 public class AbstractDynamoDBMapper implements IDynamoDBMapper {
 
     private final DynamoDBMapperConfig config;

services-custom/dynamodb-mapper/src/main/java/software/amazon/awssdk/mapper/dynamodb/ArgumentMarshaller.java

@@ -15,6 +15,7 @@
 
 package software.amazon.awssdk.mapper.dynamodb;
 
+import software.amazon.awssdk.annotations.SdkPreviewApi;
 import software.amazon.awssdk.annotations.SdkPublicApi;
 import software.amazon.awssdk.services.dynamodb.model.AttributeValue;
 
@@ -23,6 +24,7 @@
  * behavior.
  */
 @SdkPublicApi
+@SdkPreviewApi
 public interface ArgumentMarshaller {
 
     /**

services-custom/dynamodb-mapper/src/main/java/software/amazon/awssdk/mapper/dynamodb/ArgumentUnmarshaller.java

@@ -15,6 +15,7 @@
 
 package software.amazon.awssdk.mapper.dynamodb;
 
+import software.amazon.awssdk.annotations.SdkPreviewApi;
 import software.amazon.awssdk.annotations.SdkPublicApi;
 import java.lang.reflect.Method;
 import java.text.ParseException;
@@ -27,6 +28,7 @@
  * into an object.
  */
 @SdkPublicApi
+@SdkPreviewApi
 public interface ArgumentUnmarshaller {
 
     /**

services-custom/dynamodb-mapper/src/main/java/software/amazon/awssdk/mapper/dynamodb/AttributeTransformer.java

@@ -15,6 +15,7 @@
 
 package software.amazon.awssdk.mapper.dynamodb;
 
+import software.amazon.awssdk.annotations.SdkPreviewApi;
 import software.amazon.awssdk.annotations.SdkPublicApi;
 import java.util.Map;
 
@@ -31,6 +32,7 @@
  * untransform(transform(value)) == value.
  */
 @SdkPublicApi
+@SdkPreviewApi
 public interface AttributeTransformer {
     /**
      * Parameters for the {@code transform} and {@code untransform} methods,

services-custom/dynamodb-mapper/src/main/java/software/amazon/awssdk/mapper/dynamodb/AttributeTransformerChain.java

@@ -15,6 +15,7 @@
 
 package software.amazon.awssdk.mapper.dynamodb;
 
+import software.amazon.awssdk.annotations.SdkPreviewApi;
 import software.amazon.awssdk.annotations.SdkPublicApi;
 import java.util.ArrayList;
 import java.util.Arrays;
@@ -30,6 +31,7 @@
  * {@code AttributeTransformer} instances.
  */
 @SdkPublicApi
+@SdkPreviewApi
 public final class AttributeTransformerChain implements AttributeTransformer {
 
     private final List<AttributeTransformer> transformers;

services-custom/dynamodb-mapper/src/main/java/software/amazon/awssdk/mapper/dynamodb/BatchLoadContext.java

@@ -16,6 +16,7 @@
 
 package software.amazon.awssdk.mapper.dynamodb;
 
+import software.amazon.awssdk.annotations.SdkPreviewApi;
 import software.amazon.awssdk.annotations.SdkPublicApi;
 import java.util.Objects;
 import software.amazon.awssdk.services.dynamodb.model.BatchGetItemRequest;
@@ -28,6 +29,7 @@
  * @author avinam
  */
 @SdkPublicApi
+@SdkPreviewApi
 public final class BatchLoadContext {
     /**
      * The BatchGetItemResponse returned by the DynamoDB client.

services-custom/dynamodb-mapper/src/main/java/software/amazon/awssdk/mapper/dynamodb/ConversionSchema.java

@@ -15,6 +15,7 @@
 
 package software.amazon.awssdk.mapper.dynamodb;
 
+import software.amazon.awssdk.annotations.SdkPreviewApi;
 import software.amazon.awssdk.annotations.SdkPublicApi;
 import java.util.HashMap;
 import java.util.Map;
@@ -26,6 +27,7 @@
  * class.
  */
 @SdkPublicApi
+@SdkPreviewApi
 public interface ConversionSchema {
 
     /**

services-custom/dynamodb-mapper/src/main/java/software/amazon/awssdk/mapper/dynamodb/ConversionSchemas.java

@@ -15,6 +15,7 @@
 
 package software.amazon.awssdk.mapper.dynamodb;
 
+import software.amazon.awssdk.annotations.SdkPreviewApi;
 import software.amazon.awssdk.annotations.SdkPublicApi;
 import software.amazon.awssdk.mapper.dynamodb.ArgumentMarshaller.BinaryAttributeMarshaller;
 import software.amazon.awssdk.mapper.dynamodb.ArgumentMarshaller.BinarySetAttributeMarshaller;
@@ -130,6 +131,7 @@
  * </ul>
  */
 @SdkPublicApi
+@SdkPreviewApi
 public final class ConversionSchemas {
 
     private static final Logger LOGGER = Logger.loggerFor(ConversionSchemas.class);

services-custom/dynamodb-mapper/src/main/java/software/amazon/awssdk/mapper/dynamodb/DynamoDB.java

@@ -19,10 +19,12 @@
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
+import software.amazon.awssdk.annotations.SdkPreviewApi;
 
 /**
  * Annotation to mark other annotations as being part of DyanmoDB.
  */
+@SdkPreviewApi
 @Retention(RetentionPolicy.RUNTIME)
 @Target(ElementType.ANNOTATION_TYPE)
 public @interface DynamoDB {

services-custom/dynamodb-mapper/src/main/java/software/amazon/awssdk/mapper/dynamodb/DynamoDBAttribute.java

@@ -19,6 +19,7 @@
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
+import software.amazon.awssdk.annotations.SdkPreviewApi;
 
 /**
  * Interface for marking a class property as an attribute in a DynamoDB table.
@@ -39,6 +40,7 @@
  * Getter methods not marked with this annotation are assumed to be modeled
  * properties, unless marked with {@link DynamoDBIgnore}.
  */
+@SdkPreviewApi
 @DynamoDB
 @Retention(RetentionPolicy.RUNTIME)
 @Target({ElementType.FIELD, ElementType.METHOD})

services-custom/dynamodb-mapper/src/main/java/software/amazon/awssdk/mapper/dynamodb/DynamoDBAutoGenerateStrategy.java

@@ -15,10 +15,13 @@
 
 package software.amazon.awssdk.mapper.dynamodb;
 
+import software.amazon.awssdk.annotations.SdkPreviewApi;
+
 /**
  * Enumeration of possible auto-generation strategies.
  * @see DynamoDBAutoGeneratedTimestamp
  */
+@SdkPreviewApi
 public enum DynamoDBAutoGenerateStrategy {
 
     /**

services-custom/dynamodb-mapper/src/main/java/software/amazon/awssdk/mapper/dynamodb/DynamoDBAutoGenerated.java

@@ -19,6 +19,7 @@
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
+import software.amazon.awssdk.annotations.SdkPreviewApi;
 
 /**
  * Annotation to mark a property as using a custom auto-generator.
@@ -69,6 +70,7 @@
  *
  * <p>May be used as a meta-annotation.</p>
  */
+@SdkPreviewApi
 @DynamoDB
 @Retention(RetentionPolicy.RUNTIME)
 @Target({ElementType.TYPE, ElementType.FIELD, ElementType.METHOD, ElementType.ANNOTATION_TYPE})

services-custom/dynamodb-mapper/src/main/java/software/amazon/awssdk/mapper/dynamodb/DynamoDBAutoGeneratedDefault.java

@@ -19,6 +19,7 @@
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
+import software.amazon.awssdk.annotations.SdkPreviewApi;
 
 /**
  * Annotation to assign a default value on creation if value is null.
@@ -31,6 +32,7 @@
  * <p>Only compatible with standard string types.</p>
  *
  */
+@SdkPreviewApi
 @DynamoDB
 @DynamoDBAutoGenerated(generator=DynamoDBAutoGeneratedDefault.Generator.class)
 @Retention(RetentionPolicy.RUNTIME)

services-custom/dynamodb-mapper/src/main/java/software/amazon/awssdk/mapper/dynamodb/DynamoDBAutoGeneratedKey.java

@@ -19,6 +19,7 @@
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
+import software.amazon.awssdk.annotations.SdkPreviewApi;
 
 /**
  * Annotation for marking a hash key or range key property in a class to
@@ -32,6 +33,7 @@
  * @see software.amazon.awssdk.mapper.dynamodb.DynamoDBGeneratedUuid
  * @see java.util.UUID
  */
+@SdkPreviewApi
 @DynamoDBGeneratedUuid(DynamoDBAutoGenerateStrategy.CREATE)
 @Retention(RetentionPolicy.RUNTIME)
 @Target({ElementType.FIELD, ElementType.METHOD})

services-custom/dynamodb-mapper/src/main/java/software/amazon/awssdk/mapper/dynamodb/DynamoDBAutoGeneratedTimestamp.java

@@ -20,6 +20,7 @@
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
 import java.util.Date;
+import software.amazon.awssdk.annotations.SdkPreviewApi;
 
 /**
  * Annotation for auto-generating a date/timestamp.
@@ -42,6 +43,7 @@
  *
  * <p>Compatible with {@link DynamoDBTypeConvertedTimestamp}</p>
  */
+@SdkPreviewApi
 @DynamoDBAutoGenerated(generator=DynamoDBAutoGeneratedTimestamp.Generator.class)
 @Retention(RetentionPolicy.RUNTIME)
 @Target({ElementType.FIELD, ElementType.METHOD})

services-custom/dynamodb-mapper/src/main/java/software/amazon/awssdk/mapper/dynamodb/DynamoDBAutoGenerator.java

@@ -15,6 +15,7 @@
 
 package software.amazon.awssdk.mapper.dynamodb;
 
+import software.amazon.awssdk.annotations.SdkPreviewApi;
 import software.amazon.awssdk.annotations.SdkPublicApi;
 import software.amazon.awssdk.annotations.SdkInternalApi;
 
@@ -41,6 +42,7 @@
  * @see software.amazon.awssdk.mapper.dynamodb.DynamoDBAutoGenerated
  */
 @SdkPublicApi
+@SdkPreviewApi
 public interface DynamoDBAutoGenerator<T extends Object> {
 
     /**

services-custom/dynamodb-mapper/src/main/java/software/amazon/awssdk/mapper/dynamodb/DynamoDBConvertedBool.java

@@ -19,6 +19,7 @@
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
+import software.amazon.awssdk.annotations.SdkPreviewApi;
 
 /**
  * Annotation to convert a {@link Boolean} to the DynamoDB {@code S} type.
@@ -47,6 +48,7 @@
  *
  * <p>May be used as a meta-annotation.</p>
  */
+@SdkPreviewApi
 @DynamoDB
 @DynamoDBTypeConverted(converter=DynamoDBConvertedBool.Converter.class)
 @DynamoDBTyped(DynamoDBMapperFieldModel.DynamoDBAttributeType.S)

services-custom/dynamodb-mapper/src/main/java/software/amazon/awssdk/mapper/dynamodb/DynamoDBDeleteExpression.java

@@ -16,6 +16,7 @@
 
 package software.amazon.awssdk.mapper.dynamodb;
 
+import software.amazon.awssdk.annotations.SdkPreviewApi;
 import software.amazon.awssdk.annotations.SdkPublicApi;
 import java.util.HashMap;
 import java.util.Map;
@@ -31,6 +32,7 @@
  * @see DynamoDBMapper#delete(Object, DynamoDBDeleteExpression)
  */
 @SdkPublicApi
+@SdkPreviewApi
 public final class DynamoDBDeleteExpression {
 
     /** Optional expected attributes */

services-custom/dynamodb-mapper/src/main/java/software/amazon/awssdk/mapper/dynamodb/DynamoDBDelimited.java

@@ -15,6 +15,7 @@
 
 package software.amazon.awssdk.mapper.dynamodb;
 
+import software.amazon.awssdk.annotations.SdkPreviewApi;
 import software.amazon.awssdk.mapper.dynamodb.StandardBeanProperties.Bean;
 import software.amazon.awssdk.mapper.dynamodb.StandardBeanProperties.BeanMap;
 
@@ -93,6 +94,7 @@
  *
  * <p>May be used as a meta-annotation.</p>
  */
+@SdkPreviewApi
 @DynamoDB
 @DynamoDBTypeConverted(converter=DynamoDBDelimited.Converter.class)
 @DynamoDBTyped(DynamoDBMapperFieldModel.DynamoDBAttributeType.S)

services-custom/dynamodb-mapper/src/main/java/software/amazon/awssdk/mapper/dynamodb/DynamoDBDocument.java

@@ -20,12 +20,14 @@
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
+import software.amazon.awssdk.annotations.SdkPreviewApi;
 
 /**
  * An annotation that marks a class which can be serialized to a DynamoDB
  * document or sub-document. Behaves exactly the same as {@link DynamoDBTable},
  * but without requiring you to specify a {@code tableName}.
  */
+@SdkPreviewApi
 @DynamoDB
 @DynamoDBTyped(DynamoDBMapperFieldModel.DynamoDBAttributeType.M)
 @Retention(RetentionPolicy.RUNTIME)

services-custom/dynamodb-mapper/src/main/java/software/amazon/awssdk/mapper/dynamodb/DynamoDBFlattened.java

@@ -19,6 +19,7 @@
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
+import software.amazon.awssdk.annotations.SdkPreviewApi;
 
 /**
  * Annotation for flattening a complex type.
@@ -55,6 +56,7 @@
  *
  * <p>May be used as a meta-annotation.</p>
  */
+@SdkPreviewApi
 @DynamoDB
 @Retention(RetentionPolicy.RUNTIME)
 @Target({ElementType.TYPE, ElementType.FIELD, ElementType.METHOD, ElementType.ANNOTATION_TYPE})

services-custom/dynamodb-mapper/src/main/java/software/amazon/awssdk/mapper/dynamodb/DynamoDBGeneratedUuid.java

@@ -21,6 +21,7 @@
 import java.lang.annotation.Target;
 
 import java.util.UUID;
+import software.amazon.awssdk.annotations.SdkPreviewApi;
 
 /**
  * Annotation for auto-generating a {@link UUID}.
@@ -40,6 +41,7 @@
  *
  * @see java.util.UUID
  */
+@SdkPreviewApi
 @DynamoDB
 @DynamoDBAutoGenerated(generator=DynamoDBGeneratedUuid.Generator.class)
 @Retention(RetentionPolicy.RUNTIME)

services-custom/dynamodb-mapper/src/main/java/software/amazon/awssdk/mapper/dynamodb/DynamoDBHashKey.java

@@ -19,6 +19,7 @@
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
+import software.amazon.awssdk.annotations.SdkPreviewApi;
 
 /**
  * Annotation for marking a property as the hash key for a modeled class.
@@ -28,6 +29,7 @@
  * <p>
  * This annotation is required.
  */
+@SdkPreviewApi
 @DynamoDB
 @DynamoDBKeyed(software.amazon.awssdk.services.dynamodb.model.KeyType.HASH)
 @Retention(RetentionPolicy.RUNTIME)

services-custom/dynamodb-mapper/src/main/java/software/amazon/awssdk/mapper/dynamodb/DynamoDBIgnore.java

@@ -19,6 +19,7 @@
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
+import software.amazon.awssdk.annotations.SdkPreviewApi;
 
 /**
  * Annotation for marking a class property as non-modeled. Applied to the getter
@@ -29,6 +30,7 @@
  * All getter methods not marked with this annotation are assumed to be modeled
  * properties and included in any save() requests.
  */
+@SdkPreviewApi
 @DynamoDB
 @Retention(RetentionPolicy.RUNTIME)
 @Target({ElementType.FIELD, ElementType.METHOD})