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 fluentDeclarations(TypeName returnType) { .varargs(true) .build()); + TypeName elementType = listElementType(); + if (elementModel().hasBuilder()) { fluentDeclarations.add(fluentAbstractSetterDeclaration(ParameterSpec.builder(asConsumerBuilderArray(), fieldName()) .build(), returnType) - .varargs(true) - .addJavadoc("$L", memberModel().getDefaultConsumerFluentSetterDocumentation()) - .build()); + .varargs(true) + .addJavadoc("$L", + memberModel().getDefaultConsumerFluentSetterDocumentation( + elementType.toString())) + .build()); } if (enumTypeInListMemberModel() != null) { diff --git a/codegen/src/main/java/software/amazon/awssdk/codegen/poet/model/NonCollectionSetters.java b/codegen/src/main/java/software/amazon/awssdk/codegen/poet/model/NonCollectionSetters.java index 5c308ec34d5b..142191a1a0ac 100644 --- a/codegen/src/main/java/software/amazon/awssdk/codegen/poet/model/NonCollectionSetters.java +++ b/codegen/src/main/java/software/amazon/awssdk/codegen/poet/model/NonCollectionSetters.java @@ -150,15 +150,16 @@ private MethodSpec fluentEnumToStringSetter(TypeName returnType) { } private MethodSpec fluentConsumerFluentSetter(TypeName returnType) { - ClassName memberClass = poetExtensions.getModelClass(memberModel().getShape().getC2jName()); + MemberModel memberModel = memberModel(); + ClassName memberClass = poetExtensions.getModelClass(memberModel.getShape().getC2jName()); ClassName builderClass = memberClass.nestedClass("Builder"); return fluentDefaultSetterDeclaration(builderConsumerParam(builderClass), returnType) .addModifiers(Modifier.DEFAULT) .addStatement("return $N($T.builder().applyMutation($N).build())", - memberModel().getFluentSetterMethodName(), + memberModel.getFluentSetterMethodName(), memberClass, fieldName()) - .addJavadoc("$L", memberModel().getDefaultConsumerFluentSetterDocumentation()) + .addJavadoc("$L", memberModel.getDefaultConsumerFluentSetterDocumentation(memberModel.getVariable().getSimpleType())) .build(); } diff --git a/codegen/src/test/resources/software/amazon/awssdk/codegen/poet/model/alltypesrequest.java b/codegen/src/test/resources/software/amazon/awssdk/codegen/poet/model/alltypesrequest.java index 0a3bb74e63a9..d2ecca7be480 100644 --- a/codegen/src/test/resources/software/amazon/awssdk/codegen/poet/model/alltypesrequest.java +++ b/codegen/src/test/resources/software/amazon/awssdk/codegen/poet/model/alltypesrequest.java @@ -1748,16 +1748,21 @@ public interface Builder extends JsonProtocolTestsRequest.Builder, SdkPojo, Copy /** * Sets the value of the ListOfStructs property for this object. * - * This is a convenience method that creates an instance of the {@link List.Builder} avoiding the - * need to create one manually via {@link List#builder()}. + * This is a convenience method that creates an instance of the + * {@link software.amazon.awssdk.services.jsonprotocoltests.model.SimpleStruct.Builder} avoiding the need to + * create one manually via + * {@link software.amazon.awssdk.services.jsonprotocoltests.model.SimpleStruct#builder()}. * - * When the {@link Consumer} completes, {@link List.Builder#build()} is called immediately and its - * result is passed to {@link #listOfStructs(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)}. * * @param listOfStructs - * a consumer that will call methods on {@link List.Builder} + * a consumer that will call methods on + * {@link software.amazon.awssdk.services.jsonprotocoltests.model.SimpleStruct.Builder} * @return Returns a reference to this object so that method calls can be chained together. - * @see #listOfStructs(List) + * @see #listOfStructs(java.util.Collection) */ Builder listOfStructs(Consumer... listOfStructs); @@ -1956,6 +1961,7 @@ public interface Builder extends JsonProtocolTestsRequest.Builder, SdkPojo, Copy * This is a convenience method that creates an instance of the {@link StructWithTimestamp.Builder} avoiding the * need to create one manually via {@link StructWithTimestamp#builder()}. * + *

* 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 StructWithNestedBlobType.Builder#build()} is called immediately * and its result is passed to {@link #structWithNestedBlob(StructWithNestedBlobType)}. * @@ -2047,6 +2054,7 @@ default Builder structWithNestedBlob(Consumer * This is a convenience method that creates an instance of the {@link RecursiveStructType.Builder} avoiding the * need to create one manually via {@link RecursiveStructType#builder()}. * + *

* 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 recursiveS * This is a convenience method that creates an instance of the {@link BaseType.Builder} avoiding the need to * create one manually via {@link BaseType#builder()}. * + *

* 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 polymorph * This is a convenience method that creates an instance of the {@link SubTypeOne.Builder} avoiding the need to * create one manually via {@link SubTypeOne#builder()}. * + *

* 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 poly * This is a convenience method that creates an instance of the {@link Underscore_Name_Type.Builder} avoiding * the need to create one manually via {@link Underscore_Name_Type#builder()}. * + *

* 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 unde * This is a convenience method that creates an instance of the {@link AllTypesUnionStructure.Builder} avoiding * the need to create one manually via {@link AllTypesUnionStructure#builder()}. * + *

* 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.Builder} avoiding the - * need to create one manually via {@link List#builder()}. + * This is a convenience method that creates an instance of the + * {@link software.amazon.awssdk.services.jsonprotocoltests.model.SimpleStruct.Builder} avoiding the need to + * create one manually via + * {@link software.amazon.awssdk.services.jsonprotocoltests.model.SimpleStruct#builder()}. * - * When the {@link Consumer} completes, {@link List.Builder#build()} is called immediately and its - * result is passed to {@link #listOfStructs(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)}. * * @param listOfStructs - * a consumer that will call methods on {@link List.Builder} + * a consumer that will call methods on + * {@link software.amazon.awssdk.services.jsonprotocoltests.model.SimpleStruct.Builder} * @return Returns a reference to this object so that method calls can be chained together. - * @see #listOfStructs(List) + * @see #listOfStructs(java.util.Collection) */ Builder listOfStructs(Consumer... listOfStructs); @@ -1955,6 +1960,7 @@ public interface Builder extends JsonProtocolTestsResponse.Builder, SdkPojo, Cop * This is a convenience method that creates an instance of the {@link StructWithTimestamp.Builder} avoiding the * need to create one manually via {@link StructWithTimestamp#builder()}. * + *

* 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 StructWithNestedBlobType.Builder#build()} is called immediately * and its result is passed to {@link #structWithNestedBlob(StructWithNestedBlobType)}. * @@ -2046,6 +2053,7 @@ default Builder structWithNestedBlob(Consumer * This is a convenience method that creates an instance of the {@link RecursiveStructType.Builder} avoiding the * need to create one manually via {@link RecursiveStructType#builder()}. * + *

* 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 recursiveS * This is a convenience method that creates an instance of the {@link BaseType.Builder} avoiding the need to * create one manually via {@link BaseType#builder()}. * + *

* 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 polymorph * This is a convenience method that creates an instance of the {@link SubTypeOne.Builder} avoiding the need to * create one manually via {@link SubTypeOne#builder()}. * + *

* 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 poly * This is a convenience method that creates an instance of the {@link Underscore_Name_Type.Builder} avoiding * the need to create one manually via {@link Underscore_Name_Type#builder()}. * + *

* 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 unde * This is a convenience method that creates an instance of the {@link AllTypesUnionStructure.Builder} avoiding * the need to create one manually via {@link AllTypesUnionStructure#builder()}. * + *

* 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.Builder} avoiding the - * need to create one manually via {@link List#builder()}. + * This is a convenience method that creates an instance of the + * {@link software.amazon.awssdk.services.jsonprotocoltests.model.SimpleStruct.Builder} avoiding the need to + * create one manually via + * {@link software.amazon.awssdk.services.jsonprotocoltests.model.SimpleStruct#builder()}. * - * When the {@link Consumer} completes, {@link List.Builder#build()} is called immediately and its - * result is passed to {@link #listOfStructs(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)}. * * @param listOfStructs - * a consumer that will call methods on {@link List.Builder} + * a consumer that will call methods on + * {@link software.amazon.awssdk.services.jsonprotocoltests.model.SimpleStruct.Builder} * @return Returns a reference to this object so that method calls can be chained together. - * @see #listOfStructs(List) + * @see #listOfStructs(java.util.Collection) */ Builder listOfStructs(Consumer... listOfStructs); @@ -2618,6 +2623,7 @@ public interface Builder extends SdkPojo, CopyableBuilder * When the {@link Consumer} completes, {@link StructWithTimestamp.Builder#build()} is called immediately and * its result is passed to {@link #structWithNestedTimestampMember(StructWithTimestamp)}. * @@ -2655,6 +2661,7 @@ default Builder structWithNestedTimestampMember(Consumer * When the {@link Consumer} completes, {@link StructWithNestedBlobType.Builder#build()} is called immediately * and its result is passed to {@link #structWithNestedBlob(StructWithNestedBlobType)}. * @@ -2709,6 +2716,7 @@ default Builder structWithNestedBlob(Consumer * This is a convenience method that creates an instance of the {@link RecursiveStructType.Builder} avoiding the * need to create one manually via {@link RecursiveStructType#builder()}. * + *

* 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 recursiveS * This is a convenience method that creates an instance of the {@link BaseType.Builder} avoiding the need to * create one manually via {@link BaseType#builder()}. * + *

* 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 polymorph * This is a convenience method that creates an instance of the {@link SubTypeOne.Builder} avoiding the need to * create one manually via {@link SubTypeOne#builder()}. * + *

* 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 poly * This is a convenience method that creates an instance of the {@link Underscore_Name_Type.Builder} avoiding * the need to create one manually via {@link Underscore_Name_Type#builder()}. * + *

* 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 unde * This is a convenience method that creates an instance of the {@link AllTypesUnionStructure.Builder} avoiding * the need to create one manually via {@link AllTypesUnionStructure#builder()}. * + *

* 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 RecursiveStructType.Builder#build()} is called immediately and * its result is passed to {@link #recursiveStruct(RecursiveStructType)}. * @@ -310,16 +311,21 @@ default Builder recursiveStruct(Consumer recursiveStruct) { /** * Sets the value of the RecursiveList property for this object. * - * This is a convenience method that creates an instance of the {@link List.Builder} - * avoiding the need to create one manually via {@link List#builder()}. + * This is a convenience method that creates an instance of the + * {@link software.amazon.awssdk.services.jsonprotocoltests.model.RecursiveStructType.Builder} avoiding the need + * to create one manually via + * {@link software.amazon.awssdk.services.jsonprotocoltests.model.RecursiveStructType#builder()}. * - * When the {@link Consumer} completes, {@link List.Builder#build()} is called immediately - * and its result is passed to {@link #recursiveList(List)}. + *

+ * 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)}. * * @param recursiveList - * a consumer that will call methods on {@link List.Builder} + * a consumer that will call methods on + * {@link software.amazon.awssdk.services.jsonprotocoltests.model.RecursiveStructType.Builder} * @return Returns a reference to this object so that method calls can be chained together. - * @see #recursiveList(List) + * @see #recursiveList(java.util.Collection) */ Builder recursiveList(Consumer... recursiveList); diff --git a/codegen/src/test/resources/software/amazon/awssdk/codegen/poet/model/xmlnamespace/testxmlnamespacerequest.java b/codegen/src/test/resources/software/amazon/awssdk/codegen/poet/model/xmlnamespace/testxmlnamespacerequest.java index 9d5e60d21a0e..907a75855a50 100644 --- a/codegen/src/test/resources/software/amazon/awssdk/codegen/poet/model/xmlnamespace/testxmlnamespacerequest.java +++ b/codegen/src/test/resources/software/amazon/awssdk/codegen/poet/model/xmlnamespace/testxmlnamespacerequest.java @@ -215,6 +215,7 @@ public interface Builder extends ProtocolRestXmlRequest.Builder, SdkPojo, Copyab * 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/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 HTTP_STATUS_CODE = metric("HttpStatusCode", Integer.class, MetricLevel.TRACE); diff --git a/http-clients/netty-nio-client/src/main/java/software/amazon/awssdk/http/nio/netty/NettyNioAsyncHttpClient.java b/http-clients/netty-nio-client/src/main/java/software/amazon/awssdk/http/nio/netty/NettyNioAsyncHttpClient.java index c88173223cbc..78a3fa80fa87 100644 --- a/http-clients/netty-nio-client/src/main/java/software/amazon/awssdk/http/nio/netty/NettyNioAsyncHttpClient.java +++ b/http-clients/netty-nio-client/src/main/java/software/amazon/awssdk/http/nio/netty/NettyNioAsyncHttpClient.java @@ -239,7 +239,6 @@ public interface Builder extends SdkAsyncHttpClient.Builder) and can cause increased latencies. If the client is overloaded * enough such that the pending connection queue fills up, subsequent requests may be rejected or time out * (see {@link #connectionAcquisitionTimeout(Duration)}). - *

* * @param maxConcurrency New value for max concurrency. * @return This builder for method chaining. diff --git a/pom.xml b/pom.xml index a9fa8e0ab296..7302d36ea079 100644 --- a/pom.xml +++ b/pom.xml @@ -138,7 +138,7 @@ 3.1.2 3.0.0-M5 3.1.1 - 3.0.1 + 3.4.1 yyyy 3.1.1 1.6 @@ -218,6 +218,22 @@ org.apache.maven.plugins maven-javadoc-plugin ${maven-javadoc-plugin.version} + + + generate-javadocs + package + + javadoc + + + false + 8 + true + false + none + + + diff --git a/services/s3/src/main/java/software/amazon/awssdk/services/s3/presigner/S3Presigner.java b/services/s3/src/main/java/software/amazon/awssdk/services/s3/presigner/S3Presigner.java index 29113edff7fe..c2aa3e457403 100644 --- a/services/s3/src/main/java/software/amazon/awssdk/services/s3/presigner/S3Presigner.java +++ b/services/s3/src/main/java/software/amazon/awssdk/services/s3/presigner/S3Presigner.java @@ -299,10 +299,8 @@ default PresignedGetObjectRequest presignGetObject(Consumer - * + *

* Example Usage - *

* *

      * {@code
@@ -329,7 +327,7 @@ default PresignedGetObjectRequest presignGetObject(Consumer
+     * 

* 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 - *

* *

      * {@code
@@ -374,7 +370,7 @@ default PresignedPutObjectRequest presignPutObject(Consumer
+     * 

* 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 - *

* *

      * {@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.
-     * 

+ *

* 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 - *

* *

      * {@code
@@ -465,7 +459,7 @@ default PresignedUploadPartRequest presignUploadPart(Consumer
+     * 

* 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 - *

* *

      * {@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.
-     * 

+ *

* 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 @@ generate-javadocs - package - javadoc + jar false From 33f168f3c97d41a267e76f7a8489646d5cc1e913 Mon Sep 17 00:00:00 2001 From: Zoe Wang <33073555+zoewangg@users.noreply.github.com> Date: Wed, 7 Sep 2022 16:58:49 -0700 Subject: [PATCH 3/9] Skip Javadoc generation for tests profiles and service modules --- pom.xml | 6 ++++++ services/pom.xml | 8 ++++++++ 2 files changed, 14 insertions(+) diff --git a/pom.xml b/pom.xml index 9bbf9deae309..3c24696a7775 100644 --- a/pom.xml +++ b/pom.xml @@ -651,6 +651,7 @@ true true true + true @@ -715,6 +716,7 @@ true true true + true @@ -731,6 +733,7 @@ true true true + true @@ -780,6 +783,7 @@ true true true + true @@ -818,6 +822,7 @@ true true true + true @@ -863,6 +868,7 @@ true true true + true diff --git a/services/pom.xml b/services/pom.xml index 3cf66e10b59d..359d97b66fac 100644 --- a/services/pom.xml +++ b/services/pom.xml @@ -496,6 +496,14 @@ true + + org.apache.maven.plugins + maven-javadoc-plugin + ${maven-javadoc-plugin.version} + + true + + From da95320c0baa66650a0cc0b41c94c3a6cffeaa0b Mon Sep 17 00:00:00 2001 From: Zoe Wang <33073555+zoewangg@users.noreply.github.com> Date: Thu, 8 Sep 2022 11:46:10 -0700 Subject: [PATCH 4/9] Fix source --- pom.xml | 1 + 1 file changed, 1 insertion(+) diff --git a/pom.xml b/pom.xml index 3c24696a7775..3ca3c2c3beeb 100644 --- a/pom.xml +++ b/pom.xml @@ -913,6 +913,7 @@ false true false + 8 true true From dd870f5295a1558d73181c7bacb456ce85618ee8 Mon Sep 17 00:00:00 2001 From: Zoe Wang <33073555+zoewangg@users.noreply.github.com> Date: Thu, 8 Sep 2022 14:08:15 -0700 Subject: [PATCH 5/9] Update buildspec --- buildspecs/release-javadoc.yml | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/buildspecs/release-javadoc.yml b/buildspecs/release-javadoc.yml index 7fec529f9ac4..d4cbb62a8827 100644 --- a/buildspecs/release-javadoc.yml +++ b/buildspecs/release-javadoc.yml @@ -1,12 +1,14 @@ version: 0.2 - +env: + variables: + JAVA_HOME: "/usr/lib/jvm/java-17-amazon-corretto/" phases: install: - runtime-versions: - java: "$JAVA_RUNTIME" - commands: - - pip install awscli==1.19.34 --upgrade --user + - apt-get update; apt-get install -y java-17-amazon-corretto-jdk + - update-alternatives --auto javac + - update-alternatives --auto java + - pip install awscli==1.19.34 --upgrade --user pre_build: commands: From 39f2fc0b1e4fd454970d504dd4851161a1ca3bf5 Mon Sep 17 00:00:00 2001 From: Zoe Wang <33073555+zoewangg@users.noreply.github.com> Date: Thu, 8 Sep 2022 19:58:00 -0700 Subject: [PATCH 6/9] Fix provide feedback button --- pom.xml | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/pom.xml b/pom.xml index 3ca3c2c3beeb..a097d0a01c32 100644 --- a/pom.xml +++ b/pom.xml @@ -1302,12 +1302,13 @@ software.amazon.awssdk* -

AWS SDK for Java API Reference - ${project.version}]]>
- +
AWS SDK for Java API Reference - ${project.version} + + ]]> +
Provide feedback