diff --git a/buildspecs/release-javadoc.yml b/buildspecs/release-javadoc.yml index 7fec529f9ac4..f8c8c882c8bd 100644 --- a/buildspecs/release-javadoc.yml +++ b/buildspecs/release-javadoc.yml @@ -1,11 +1,13 @@ version: 0.2 - +env: + variables: + JAVA_HOME: "/usr/lib/jvm/java-17-amazon-corretto/" phases: install: - runtime-versions: - java: "$JAVA_RUNTIME" - commands: + - 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: @@ -16,7 +18,7 @@ phases: commands: - python ./scripts/doc_crosslinks/generate_cross_link_data.py --apiDefinitionsBasePath ./services/ --apiDefinitionsRelativeFilePath src/main/resources/codegen-resources/service-2.json --templateFilePath ./scripts/doc_crosslinks/crosslink_redirect.html --outputFilePath ./scripts/crosslink_redirect.html - mvn install -P quick -T1C - - mvn clean install javadoc:aggregate -B -Ppublic-javadoc -Dcheckstyle.skip -Dspotbugs.skip -DskipTests -Ddoclint=none -pl '!:protocol-tests,!:protocol-tests-core,!:codegen-generated-classes-test,!:sdk-benchmarks,!:module-path-tests,!:test-utils,!:http-client-tests,!:tests-coverage-reporting' + - mvn clean install javadoc:aggregate -B -Ppublic-javadoc -Dcheckstyle.skip -Dspotbugs.skip -DskipTests -Ddoclint=none -pl '!:protocol-tests,!:protocol-tests-core,!:codegen-generated-classes-test,!:sdk-benchmarks,!:s3-benchmarks,!:module-path-tests,!:test-utils,!:http-client-tests,!:tests-coverage-reporting,!:sdk-native-image-test' - RELEASE_VERSION=`mvn -q -Dexec.executable=echo -Dexec.args='${project.version}' --non-recursive exec:exec` - - aws s3 sync target/site/apidocs/ $DOC_PATH/$RELEASE_VERSION/ 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 SdkMetricProvide feedback