From 961cf891fd8c232ef7e2f71cf5ef745a85a7e55c Mon Sep 17 00:00:00 2001 From: Zoe Wang <33073555+zoewangg@users.noreply.github.com> Date: Wed, 7 Sep 2022 12:42:07 -0700 Subject: [PATCH 1/9] Fix javadoc to make it work with JDK17 --- .../model/intermediate/MemberModel.java | 13 ++++----- .../codegen/poet/model/ListSetters.java | 10 ++++--- .../poet/model/NonCollectionSetters.java | 7 ++--- .../codegen/poet/model/alltypesrequest.java | 24 ++++++++++++----- .../codegen/poet/model/alltypesresponse.java | 24 ++++++++++++----- .../poet/model/alltypesunionstructure.java | 24 ++++++++++++----- .../poet/model/recursivestructtype.java | 18 ++++++++----- .../xmlnamespace/testxmlnamespacerequest.java | 1 + .../testxmlnamespaceresponse.java | 1 + .../amazon/awssdk/http/HttpMetric.java | 3 ++- .../nio/netty/NettyNioAsyncHttpClient.java | 1 - pom.xml | 18 ++++++++++++- .../services/s3/presigner/S3Presigner.java | 27 +++++++------------ 13 files changed, 115 insertions(+), 56 deletions(-) diff --git a/codegen/src/main/java/software/amazon/awssdk/codegen/model/intermediate/MemberModel.java b/codegen/src/main/java/software/amazon/awssdk/codegen/model/intermediate/MemberModel.java index 41e7ef8422b7..7d8ba338126e 100644 --- a/codegen/src/main/java/software/amazon/awssdk/codegen/model/intermediate/MemberModel.java +++ b/codegen/src/main/java/software/amazon/awssdk/codegen/model/intermediate/MemberModel.java @@ -480,17 +480,18 @@ public String getDeprecatedSetterDocumentation() { + LF; } - public String getDefaultConsumerFluentSetterDocumentation() { + public String getDefaultConsumerFluentSetterDocumentation(String variableType) { return (StringUtils.isNotBlank(documentation) ? documentation : defaultSetter().replace("%s", name) + "\n") + LF + "This is a convenience method that creates an instance of the {@link " - + variable.getSimpleType() + + variableType + ".Builder} avoiding the need to create one manually via {@link " - + variable.getSimpleType() + + variableType + "#builder()}.\n" + LF + + "
"
+ "When the {@link Consumer} completes, {@link "
- + variable.getSimpleType()
+ + variableType
+ ".Builder#build()} is called immediately and its result is passed to {@link #"
+ getFluentGetterMethodName()
+ "("
@@ -500,14 +501,14 @@ public String getDefaultConsumerFluentSetterDocumentation() {
+ "@param "
+ variable.getVariableName()
+ " a consumer that will call methods on {@link "
- + variable.getSimpleType() + ".Builder}"
+ + variableType + ".Builder}"
+ LF
+ "@return " + stripHtmlTags(defaultFluentReturn())
+ LF
+ "@see #"
+ getFluentSetterMethodName()
+ "("
- + variable.getSimpleType()
+ + variable.getVariableSetterType()
+ ")";
}
diff --git a/codegen/src/main/java/software/amazon/awssdk/codegen/poet/model/ListSetters.java b/codegen/src/main/java/software/amazon/awssdk/codegen/poet/model/ListSetters.java
index 84beecae8b2c..3a9395562925 100644
--- a/codegen/src/main/java/software/amazon/awssdk/codegen/poet/model/ListSetters.java
+++ b/codegen/src/main/java/software/amazon/awssdk/codegen/poet/model/ListSetters.java
@@ -63,13 +63,17 @@ public List
+ * When the {@link Consumer} completes,
+ * {@link software.amazon.awssdk.services.jsonprotocoltests.model.SimpleStruct.Builder#build()} is called
+ * immediately and its result is passed to {@link #listOfStructs(List
* When the {@link Consumer} completes, {@link StructWithTimestamp.Builder#build()} is called immediately and
* its result is passed to {@link #structWithNestedTimestampMember(StructWithTimestamp)}.
*
@@ -1993,6 +1999,7 @@ default Builder structWithNestedTimestampMember(Consumer
* When the {@link Consumer} completes, {@link RecursiveStructType.Builder#build()} is called immediately and
* its result is passed to {@link #recursiveStruct(RecursiveStructType)}.
*
@@ -2074,6 +2082,7 @@ default Builder recursiveStruct(Consumer
* When the {@link Consumer} completes, {@link BaseType.Builder#build()} is called immediately and its result is
* passed to {@link #polymorphicTypeWithSubTypes(BaseType)}.
*
@@ -2101,6 +2110,7 @@ default Builder polymorphicTypeWithSubTypes(Consumer
* When the {@link Consumer} completes, {@link SubTypeOne.Builder#build()} is called immediately and its result
* is passed to {@link #polymorphicTypeWithoutSubTypes(SubTypeOne)}.
*
@@ -2150,6 +2160,7 @@ default Builder polymorphicTypeWithoutSubTypes(Consumer
* When the {@link Consumer} completes, {@link Underscore_Name_Type.Builder#build()} is called immediately and
* its result is passed to {@link #underscore_Name_Type(Underscore_Name_Type)}.
*
@@ -2186,6 +2197,7 @@ default Builder underscore_Name_Type(Consumer
* When the {@link Consumer} completes, {@link AllTypesUnionStructure.Builder#build()} is called immediately and
* its result is passed to {@link #allTypesUnionStructure(AllTypesUnionStructure)}.
*
diff --git a/codegen/src/test/resources/software/amazon/awssdk/codegen/poet/model/alltypesresponse.java b/codegen/src/test/resources/software/amazon/awssdk/codegen/poet/model/alltypesresponse.java
index 2c04ee94e1f3..ea1c98f4518b 100644
--- a/codegen/src/test/resources/software/amazon/awssdk/codegen/poet/model/alltypesresponse.java
+++ b/codegen/src/test/resources/software/amazon/awssdk/codegen/poet/model/alltypesresponse.java
@@ -1747,16 +1747,21 @@ public interface Builder extends JsonProtocolTestsResponse.Builder, SdkPojo, Cop
/**
* Sets the value of the ListOfStructs property for this object.
*
- * This is a convenience method that creates an instance of the {@link List
+ * When the {@link Consumer} completes,
+ * {@link software.amazon.awssdk.services.jsonprotocoltests.model.SimpleStruct.Builder#build()} is called
+ * immediately and its result is passed to {@link #listOfStructs(List
* When the {@link Consumer} completes, {@link StructWithTimestamp.Builder#build()} is called immediately and
* its result is passed to {@link #structWithNestedTimestampMember(StructWithTimestamp)}.
*
@@ -1992,6 +1998,7 @@ default Builder structWithNestedTimestampMember(Consumer
* When the {@link Consumer} completes, {@link RecursiveStructType.Builder#build()} is called immediately and
* its result is passed to {@link #recursiveStruct(RecursiveStructType)}.
*
@@ -2073,6 +2081,7 @@ default Builder recursiveStruct(Consumer
* When the {@link Consumer} completes, {@link BaseType.Builder#build()} is called immediately and its result is
* passed to {@link #polymorphicTypeWithSubTypes(BaseType)}.
*
@@ -2100,6 +2109,7 @@ default Builder polymorphicTypeWithSubTypes(Consumer
* When the {@link Consumer} completes, {@link SubTypeOne.Builder#build()} is called immediately and its result
* is passed to {@link #polymorphicTypeWithoutSubTypes(SubTypeOne)}.
*
@@ -2149,6 +2159,7 @@ default Builder polymorphicTypeWithoutSubTypes(Consumer
* When the {@link Consumer} completes, {@link Underscore_Name_Type.Builder#build()} is called immediately and
* its result is passed to {@link #underscore_Name_Type(Underscore_Name_Type)}.
*
@@ -2185,6 +2196,7 @@ default Builder underscore_Name_Type(Consumer
* When the {@link Consumer} completes, {@link AllTypesUnionStructure.Builder#build()} is called immediately and
* its result is passed to {@link #allTypesUnionStructure(AllTypesUnionStructure)}.
*
diff --git a/codegen/src/test/resources/software/amazon/awssdk/codegen/poet/model/alltypesunionstructure.java b/codegen/src/test/resources/software/amazon/awssdk/codegen/poet/model/alltypesunionstructure.java
index f5bfe8f0d458..c06e64940b14 100644
--- a/codegen/src/test/resources/software/amazon/awssdk/codegen/poet/model/alltypesunionstructure.java
+++ b/codegen/src/test/resources/software/amazon/awssdk/codegen/poet/model/alltypesunionstructure.java
@@ -2410,16 +2410,21 @@ public interface Builder extends SdkPojo, CopyableBuilder
+ * When the {@link Consumer} completes,
+ * {@link software.amazon.awssdk.services.jsonprotocoltests.model.SimpleStruct.Builder#build()} is called
+ * immediately and its result is passed to {@link #listOfStructs(List
* When the {@link Consumer} completes, {@link RecursiveStructType.Builder#build()} is called immediately and
* its result is passed to {@link #recursiveStruct(RecursiveStructType)}.
*
@@ -2736,6 +2744,7 @@ default Builder recursiveStruct(Consumer
* When the {@link Consumer} completes, {@link BaseType.Builder#build()} is called immediately and its result is
* passed to {@link #polymorphicTypeWithSubTypes(BaseType)}.
*
@@ -2763,6 +2772,7 @@ default Builder polymorphicTypeWithSubTypes(Consumer
* When the {@link Consumer} completes, {@link SubTypeOne.Builder#build()} is called immediately and its result
* is passed to {@link #polymorphicTypeWithoutSubTypes(SubTypeOne)}.
*
@@ -2812,6 +2822,7 @@ default Builder polymorphicTypeWithoutSubTypes(Consumer
* When the {@link Consumer} completes, {@link Underscore_Name_Type.Builder#build()} is called immediately and
* its result is passed to {@link #underscore_Name_Type(Underscore_Name_Type)}.
*
@@ -2848,6 +2859,7 @@ default Builder underscore_Name_Type(Consumer
* When the {@link Consumer} completes, {@link AllTypesUnionStructure.Builder#build()} is called immediately and
* its result is passed to {@link #allTypesUnionStructure(AllTypesUnionStructure)}.
*
diff --git a/codegen/src/test/resources/software/amazon/awssdk/codegen/poet/model/recursivestructtype.java b/codegen/src/test/resources/software/amazon/awssdk/codegen/poet/model/recursivestructtype.java
index 91f4850cb9e0..b952493bc537 100644
--- a/codegen/src/test/resources/software/amazon/awssdk/codegen/poet/model/recursivestructtype.java
+++ b/codegen/src/test/resources/software/amazon/awssdk/codegen/poet/model/recursivestructtype.java
@@ -277,6 +277,7 @@ public interface Builder extends SdkPojo, CopyableBuilder
+ * When the {@link Consumer} completes,
+ * {@link software.amazon.awssdk.services.jsonprotocoltests.model.RecursiveStructType.Builder#build()} is called
+ * immediately and its result is passed to {@link #recursiveList(List
* When the {@link Consumer} completes, {@link XmlNamespaceMember.Builder#build()} is called immediately and its
* result is passed to {@link #xmlNamespaceMember(XmlNamespaceMember)}.
*
diff --git a/codegen/src/test/resources/software/amazon/awssdk/codegen/poet/model/xmlnamespace/testxmlnamespaceresponse.java b/codegen/src/test/resources/software/amazon/awssdk/codegen/poet/model/xmlnamespace/testxmlnamespaceresponse.java
index 7f3471fb6435..5cc0fc34be26 100644
--- a/codegen/src/test/resources/software/amazon/awssdk/codegen/poet/model/xmlnamespace/testxmlnamespaceresponse.java
+++ b/codegen/src/test/resources/software/amazon/awssdk/codegen/poet/model/xmlnamespace/testxmlnamespaceresponse.java
@@ -214,6 +214,7 @@ public interface Builder extends ProtocolRestXmlResponse.Builder, SdkPojo, Copya
* This is a convenience method that creates an instance of the {@link XmlNamespaceMember.Builder} avoiding the
* need to create one manually via {@link XmlNamespaceMember#builder()}.
*
+ *
* When the {@link Consumer} completes, {@link XmlNamespaceMember.Builder#build()} is called immediately and its
* result is passed to {@link #xmlNamespaceMember(XmlNamespaceMember)}.
*
diff --git a/http-client-spi/src/main/java/software/amazon/awssdk/http/HttpMetric.java b/http-client-spi/src/main/java/software/amazon/awssdk/http/HttpMetric.java
index 7a58f5ff8c76..34f6ff9ec418 100644
--- a/http-client-spi/src/main/java/software/amazon/awssdk/http/HttpMetric.java
+++ b/http-client-spi/src/main/java/software/amazon/awssdk/http/HttpMetric.java
@@ -100,7 +100,8 @@ public final class HttpMetric {
/**
* The status code of the HTTP response.
*
- * @implSpec This is reported by the SDK core, and should not be reported by an individual HTTP client implementation.
+ *
+ * This is reported by the SDK core, and should not be reported by an individual HTTP client implementation.
*/
public static final SdkMetric
* Example Usage
- *
* This is a shorter method of invoking {@link #presignPutObject(PutObjectPresignRequest)} without needing
* to call {@code PutObjectPresignRequest.builder()} or {@code .build()}.
*
@@ -344,10 +342,8 @@ default PresignedPutObjectRequest presignPutObject(Consumer
* Example Usage
- *
* This is a shorter method of invoking {@link #presignCreateMultipartUpload(CreateMultipartUploadPresignRequest)} without
* needing to call {@code CreateMultipartUploadPresignRequest.builder()} or {@code .build()}.
*
@@ -390,10 +386,9 @@ default PresignedCreateMultipartUploadRequest presignCreateMultipartUpload(
/**
* Presign a {@link UploadPartRequest} so that it can be executed at a later time without requiring additional
* signing or authentication.
- *
*
* Example Usage
- *
* This is a shorter method of invoking {@link #presignUploadPart(UploadPartPresignRequest)} without needing
* to call {@code UploadPartPresignRequest.builder()} or {@code .build()}.
*
@@ -435,10 +430,9 @@ default PresignedUploadPartRequest presignUploadPart(Consumer
*
* Example Usage
- *
* This is a shorter method of invoking {@link #presignCompleteMultipartUpload(CompleteMultipartUploadPresignRequest)} without
* needing to call {@code CompleteMultipartUploadPresignRequest.builder()} or {@code .build()}.
*
@@ -481,10 +475,9 @@ default PresignedCompleteMultipartUploadRequest presignCompleteMultipartUpload(
/**
* Presign a {@link AbortMultipartUploadRequest} so that it can be executed at a later time without requiring additional
* signing or authentication.
- *
*
* Example Usage
- *
* This is a shorter method of invoking {@link #presignAbortMultipartUpload(AbortMultipartUploadPresignRequest)} without
* needing to call {@code AbortMultipartUploadPresignRequest.builder()} or {@code .build()}.
*
From 1faaaf1d99f94cea7372e3c67fc6c1d3ed3578cf Mon Sep 17 00:00:00 2001
From: Zoe Wang <33073555+zoewangg@users.noreply.github.com>
Date: Wed, 7 Sep 2022 15:50:37 -0700
Subject: [PATCH 2/9] Fix build
---
pom.xml | 3 +--
1 file changed, 1 insertion(+), 2 deletions(-)
diff --git a/pom.xml b/pom.xml
index 7302d36ea079..9bbf9deae309 100644
--- a/pom.xml
+++ b/pom.xml
@@ -221,9 +221,8 @@
* {@code
@@ -329,7 +327,7 @@ default PresignedGetObjectRequest presignGetObject(Consumer
* {@code
@@ -374,7 +370,7 @@ default PresignedPutObjectRequest presignPutObject(Consumer
* {@code
@@ -420,7 +415,7 @@ default PresignedCreateMultipartUploadRequest presignCreateMultipartUpload(
/**
* Presign a {@link UploadPartRequest} so that it can be executed at a later time without requiring additional
* signing or authentication.
- *
+ *
* {@code
@@ -465,7 +459,7 @@ default PresignedUploadPartRequest presignUploadPart(Consumer
* {@code
@@ -511,7 +504,7 @@ default PresignedCompleteMultipartUploadRequest presignCompleteMultipartUpload(
/**
* Presign a {@link AbortMultipartUploadRequest} so that it can be executed at a later time without requiring additional
* signing or authentication.
- *
+ *