You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@juneau.apache.org by ja...@apache.org on 2018/07/22 17:14:45 UTC
[juneau] branch master updated (3f6d4af -> d2ff5b4)
This is an automated email from the ASF dual-hosted git repository.
jamesbognar pushed a change to branch master
in repository https://gitbox.apache.org/repos/asf/juneau.git.
from 3f6d4af Javadocs
new e352e13 Mark TODOs scheduled for 7.2.0
new d2ff5b4 Javadocs
The 2 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
.../java/org/apache/juneau/IgnoredClassesTest.java | 1 -
.../main/java/org/apache/juneau/jena/N3Parser.java | 4 +-
.../java/org/apache/juneau/jena/N3Serializer.java | 4 +-
.../java/org/apache/juneau/jena/NTripleParser.java | 4 +-
.../org/apache/juneau/jena/NTripleSerializer.java | 4 +-
.../apache/juneau/jena/RdfXmlAbbrevSerializer.java | 4 +-
.../java/org/apache/juneau/jena/RdfXmlParser.java | 4 +-
.../org/apache/juneau/jena/RdfXmlSerializer.java | 4 +-
.../java/org/apache/juneau/jena/TurtleParser.java | 4 +-
.../org/apache/juneau/jena/TurtleSerializer.java | 4 +-
.../main/java/org/apache/juneau/PropertyStore.java | 11 ---
.../java/org/apache/juneau/annotation/Example.java | 5 --
.../org/apache/juneau/http/annotation/Items.java | 6 +-
.../apache/juneau/http/annotation/Response.java | 2 -
.../juneau/http/annotation/ResponseHeader.java | 2 +-
.../org/apache/juneau/http/annotation/Schema.java | 9 +-
.../apache/juneau/http/annotation/SubItems.java | 17 ++--
.../apache/juneau/httppart/OpenApiPartParser.java | 18 +++-
.../juneau/httppart/OpenApiPartSerializer.java | 18 +++-
.../apache/juneau/json/SimpleJsonSerializer.java | 23 +++++-
.../org/apache/juneau/utils/StringMessage.java | 1 -
juneau-doc/src/main/javadoc/overview.html | 96 ++++++++++++----------
.../rest/test/client/ThirdPartyProxyResource.java | 4 -
.../org/apache/juneau/rest/client/RestCall.java | 2 -
.../juneau/rest/client/RestClientBuilder.java | 5 +-
25 files changed, 152 insertions(+), 104 deletions(-)
[juneau] 02/02: Javadocs
Posted by ja...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
jamesbognar pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/juneau.git
commit d2ff5b4bd0ce11b6aae304579c9f5c46211ed42e
Author: JamesBognar <ja...@apache.org>
AuthorDate: Sun Jul 22 13:14:32 2018 -0400
Javadocs
---
.../main/java/org/apache/juneau/jena/N3Parser.java | 2 +-
.../java/org/apache/juneau/jena/N3Serializer.java | 2 +-
.../java/org/apache/juneau/jena/NTripleParser.java | 2 +-
.../org/apache/juneau/jena/NTripleSerializer.java | 2 +-
.../apache/juneau/jena/RdfXmlAbbrevSerializer.java | 2 +-
.../java/org/apache/juneau/jena/RdfXmlParser.java | 2 +-
.../org/apache/juneau/jena/RdfXmlSerializer.java | 2 +-
.../java/org/apache/juneau/jena/TurtleParser.java | 2 +-
.../org/apache/juneau/jena/TurtleSerializer.java | 2 +-
.../main/java/org/apache/juneau/PropertyStore.java | 11 -------
.../java/org/apache/juneau/annotation/Example.java | 5 ---
.../org/apache/juneau/http/annotation/Items.java | 6 ++--
.../apache/juneau/http/annotation/RequestBean.java | 2 +-
.../apache/juneau/http/annotation/Response.java | 2 --
.../juneau/http/annotation/ResponseHeader.java | 2 +-
.../org/apache/juneau/http/annotation/Schema.java | 9 ++++--
.../apache/juneau/http/annotation/SubItems.java | 17 +++++++---
.../apache/juneau/httppart/OpenApiPartParser.java | 18 ++++++++++-
.../juneau/httppart/OpenApiPartSerializer.java | 18 ++++++++++-
.../apache/juneau/json/SimpleJsonSerializer.java | 21 ++++++++++++-
juneau-doc/src/main/javadoc/overview.html | 36 +++++++++++++---------
.../org/apache/juneau/rest/client/RestCall.java | 2 --
.../juneau/rest/client/RestClientBuilder.java | 5 ++-
23 files changed, 113 insertions(+), 59 deletions(-)
diff --git a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/N3Parser.java b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/N3Parser.java
index 6948f4f..b9c09f0 100644
--- a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/N3Parser.java
+++ b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/N3Parser.java
@@ -17,7 +17,7 @@ import static org.apache.juneau.jena.Constants.*;
import org.apache.juneau.*;
/**
- * TODO(7.2.0)
+ * Subclass of {@link RdfParser} for parsing RDF in N3 notation.
*/
public class N3Parser extends RdfParser {
diff --git a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/N3Serializer.java b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/N3Serializer.java
index ccef4cb..9e909fb 100644
--- a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/N3Serializer.java
+++ b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/N3Serializer.java
@@ -17,7 +17,7 @@ import static org.apache.juneau.jena.Constants.*;
import org.apache.juneau.*;
/**
- * TODO(7.2.0)
+ * Subclass of {@link RdfSerializer} for serializing RDF in N3 notation.
*/
public class N3Serializer extends RdfSerializer {
diff --git a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/NTripleParser.java b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/NTripleParser.java
index 2d11f2e..42734e9 100644
--- a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/NTripleParser.java
+++ b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/NTripleParser.java
@@ -17,7 +17,7 @@ import static org.apache.juneau.jena.Constants.*;
import org.apache.juneau.*;
/**
- * TODO(7.2.0)
+ * Subclass of {@link RdfParser} for parsing RDF in N-Triple notation.
*/
public class NTripleParser extends RdfParser {
diff --git a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/NTripleSerializer.java b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/NTripleSerializer.java
index 196d6e9..d3b2740 100644
--- a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/NTripleSerializer.java
+++ b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/NTripleSerializer.java
@@ -17,7 +17,7 @@ import static org.apache.juneau.jena.Constants.*;
import org.apache.juneau.*;
/**
- * TODO(7.2.0)
+ * Subclass of {@link RdfSerializer} for serializing RDF in N-Triple notation.
*/
public class NTripleSerializer extends RdfSerializer {
diff --git a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlAbbrevSerializer.java b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlAbbrevSerializer.java
index d60f4fa..698bf73 100644
--- a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlAbbrevSerializer.java
+++ b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlAbbrevSerializer.java
@@ -17,7 +17,7 @@ import static org.apache.juneau.jena.Constants.*;
import org.apache.juneau.*;
/**
- * TODO(7.2.0)
+ * Subclass of {@link RdfParser} for parsing RDF in Abbreviated-XML notation.
*/
public class RdfXmlAbbrevSerializer extends RdfSerializer {
diff --git a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlParser.java b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlParser.java
index d673bdf..ab15863 100644
--- a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlParser.java
+++ b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlParser.java
@@ -17,7 +17,7 @@ import static org.apache.juneau.jena.Constants.*;
import org.apache.juneau.*;
/**
- * TODO(7.2.0)
+ * Subclass of {@link RdfParser} for parsing RDF in standard XML notation.
*/
public class RdfXmlParser extends RdfParser {
diff --git a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlSerializer.java b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlSerializer.java
index e3350e3..90869ec 100644
--- a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlSerializer.java
+++ b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlSerializer.java
@@ -17,7 +17,7 @@ import static org.apache.juneau.jena.Constants.*;
import org.apache.juneau.*;
/**
- * TODO(7.2.0)
+ * Subclass of {@link RdfSerializer} for serializing RDF in standard XML notation.
*/
public class RdfXmlSerializer extends RdfSerializer {
diff --git a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/TurtleParser.java b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/TurtleParser.java
index fdad43d..89fc383 100644
--- a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/TurtleParser.java
+++ b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/TurtleParser.java
@@ -17,7 +17,7 @@ import static org.apache.juneau.jena.Constants.*;
import org.apache.juneau.*;
/**
- * TODO(7.2.0)
+ * Subclass of {@link RdfParser} for parsing RDF in Turtle notation.
*/
public class TurtleParser extends RdfParser {
diff --git a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/TurtleSerializer.java b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/TurtleSerializer.java
index d632920..b6dfdd9 100644
--- a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/TurtleSerializer.java
+++ b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/TurtleSerializer.java
@@ -17,7 +17,7 @@ import static org.apache.juneau.jena.Constants.*;
import org.apache.juneau.*;
/**
- * TODO(7.2.0)
+ * Subclass of {@link RdfSerializer} for serializing RDF in Turtle notation.
*/
public class TurtleSerializer extends RdfSerializer {
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/PropertyStore.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/PropertyStore.java
index 91f0027..2dabe3c 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/PropertyStore.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/PropertyStore.java
@@ -183,17 +183,6 @@ import org.apache.juneau.json.*;
* <p class='bcode w800'>
* <js>"{class}.{name}.{type}/add.{key}"</js> <jc>// Add a map entry (or delete if the value is null).</jc>
* </p>
- *
- * <h5 class='topic'>Setting properties</h5>
- *
- * <p>
- * TODO(7.2.0)
- *
- * <h5 class='topic'>Retrieving properties</h5>
- *
- * <p>
- * TODO(7.2.0)
- *
*/
@SuppressWarnings("unchecked")
public final class PropertyStore {
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/annotation/Example.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/annotation/Example.java
index 0ec01c2..11d84e1 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/annotation/Example.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/annotation/Example.java
@@ -54,11 +54,6 @@ import java.lang.annotation.*;
* <ja>@Example</js>(<js>"{foo:'bar',baz:123}"</js>)
* <jk>public class</jk> C {...}
* </p>
- *
- * <h5 class='section'>See Also:</h5>
- * <ul>
- * <li>TODO(7.2.0)
- * </ul>
*/
@Documented
@Target({FIELD,METHOD,TYPE})
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/Items.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/Items.java
index 2209ff3..db62f82 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/Items.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/Items.java
@@ -324,7 +324,10 @@ public @interface Items {
String $ref() default "";
/**
- * TODO(7.2.0)
+ * <mk>items</mk> field of the Swagger <a class="doclink" href="https://swagger.io/specification/v2/#itemsObject">Items</a> object.
+ *
+ * <p>
+ * Describes the type of items in the array.
*/
SubItems items() default @SubItems;
@@ -419,5 +422,4 @@ public @interface Items {
* </ul>
*/
String[] value() default {};
-
}
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/RequestBean.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/RequestBean.java
index bbbdf02..d25749a 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/RequestBean.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/RequestBean.java
@@ -87,7 +87,7 @@ import org.apache.juneau.httppart.*;
* <br>Schema-based serialization and parsing is allowed just as if used as individual parameter types.
*
* <p>
- * TODO(7.2.0) - Swagger-info in <ja>@RequestBean</ja>s is not currently reflected in generated Swagger documentation.
+ * TODO - Swagger-info in <ja>@RequestBean</ja>s is not currently reflected in generated Swagger documentation.
*
* <h5 class='section'>See Also:</h5>
* <ul>
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/Response.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/Response.java
index 2425562..2c75e10 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/Response.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/Response.java
@@ -124,8 +124,6 @@ public @interface Response {
* The HTTP response code.
*
* The default value is <code>500</code> for exceptions and <code>200</code> for return types.
- *
- * TODO(7.2.0) - Can also be used on throwable to specify the HTTP status code to set when thrown.
*/
int[] code() default {};
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/ResponseHeader.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/ResponseHeader.java
index 813c20d..cf31686 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/ResponseHeader.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/ResponseHeader.java
@@ -494,7 +494,7 @@ public @interface ResponseHeader {
* Free-form value for the Swagger <a class="doclink" href="https://swagger.io/specification/v2/#headerObject">Header</a> object.
*
* <p>
- * This is a JSON object that makes up the swagger information for this Header object.
+ * This is a <a class='doclink' href='../../../../../overview-summary.html#juneau-marshall.JsonDetails.SimplifiedJson'>Simplified JSON</a> object that makes up the swagger information for this field.
*
* <p>
* The following are completely equivalent ways of defining the swagger description of the Header object:
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/Schema.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/Schema.java
index 7a82147..c299746 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/Schema.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/Schema.java
@@ -602,7 +602,10 @@ public @interface Schema {
ExternalDocs externalDocs() default @ExternalDocs;
/**
- * TODO(7.2.0)
+ * <mk>example</mk> field of the Swagger <a class="doclink" href="https://swagger.io/specification/v2/#schemaObject">Schema</a> object.
+ *
+ * <p>
+ * A free-form property to include an example of an instance for this schema.
*
* <p>
* This attribute defines a JSON representation of the body value that is used by <code>BasicRestInfoProvider</code> to construct
@@ -621,7 +624,7 @@ public @interface Schema {
String[] example() default {};
/**
- * TODO(7.2.0)
+ * <mk>x-examples</mk> field of the Swagger <a class="doclink" href="https://swagger.io/specification/v2/#schemaObject">Schema</a> object.
*
* <p>
* This is a JSON object whose keys are media types and values are string representations of that value.
@@ -639,7 +642,7 @@ public @interface Schema {
String[] examples() default {};
/**
- * TODOTODO(7.2.0)
+ * Specifies that schema information for this part should not be shown in the generated Swagger documentation.
*/
boolean ignore() default false;
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/SubItems.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/SubItems.java
index 2ed0158..f21f14d 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/SubItems.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/SubItems.java
@@ -278,6 +278,18 @@ public @interface SubItems {
String $ref() default "";
/**
+ * <mk>items</mk> field of the Swagger <a class="doclink" href="https://swagger.io/specification/v2/#itemsObject">Items</a> object.
+ *
+ * <p>
+ * Describes the type of items in the array.
+ *
+ * <p>
+ * This is a <a class='doclink' href='../../../../../overview-summary.html#juneau-marshall.JsonDetails.SimplifiedJson'>Simplified JSON</a> object.
+ * <br>It must be declared free-form because it's not possible to nest annotations in Java.
+ */
+ String[] items() default {};
+
+ /**
* Free-form value for the Swagger <a class="doclink" href="https://swagger.io/specification/v2/#itemsObject">Items</a> object.
*
* <p>
@@ -368,9 +380,4 @@ public @interface SubItems {
* </ul>
*/
String[] value() default {};
-
- /**
- * TODO(7.2.0)
- */
- String[] items() default {};
}
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/httppart/OpenApiPartParser.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/httppart/OpenApiPartParser.java
index 1f9df10..9a84c66 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/httppart/OpenApiPartParser.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/httppart/OpenApiPartParser.java
@@ -17,6 +17,7 @@ import java.nio.charset.*;
import java.util.*;
import org.apache.juneau.*;
+import org.apache.juneau.http.annotation.*;
import org.apache.juneau.parser.*;
import org.apache.juneau.transform.*;
@@ -24,7 +25,17 @@ import org.apache.juneau.transform.*;
* OpenAPI part parser.
*
* <p>
- * TODO(7.2.0)
+ * Used in junction with the following annotations to provide schema-based parsing of POJOs:
+ * <ul>
+ * <li class='ja'>{@link Body}
+ * <li class='ja'>{@link FormData}
+ * <li class='ja'>{@link Query}
+ * <li class='ja'>{@link Header}
+ * <li class='ja'>{@link Path}
+ * </ul>
+ *
+ * <p>
+ * The list of valid POJO types per type/format are as follows:
*
* <table class='styled'>
* <tr><th>Type</th><th>Format</th><th>Valid parameter types</th></tr>
@@ -163,6 +174,11 @@ import org.apache.juneau.transform.*;
* </td>
* </tr>
* </table>
+ *
+ * <h5 class='section'>See Also:</h5>
+ * <ul>
+ * <li class='link'><a class="doclink" href="../../../../overview-summary.html#juneau-marshall.OpenApiDetails">Overview > juneau-marshall > OpenAPI Details</a>
+ * </ul>
*/
public class OpenApiPartParser extends UonPartParser {
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/httppart/OpenApiPartSerializer.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/httppart/OpenApiPartSerializer.java
index be9c109..28a91b5 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/httppart/OpenApiPartSerializer.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/httppart/OpenApiPartSerializer.java
@@ -16,6 +16,7 @@ import java.io.*;
import java.util.*;
import org.apache.juneau.*;
+import org.apache.juneau.http.annotation.*;
import org.apache.juneau.serializer.*;
import org.apache.juneau.transform.*;
@@ -23,7 +24,17 @@ import org.apache.juneau.transform.*;
* Serializes POJOs to values suitable for transmission as HTTP headers, query/form-data parameters, and path variables.
*
* <p>
- * TODO(7.2.0)
+ * Used in junction with the following annotations to provide schema-based serialization of POJOs:
+ * <ul>
+ * <li class='ja'>{@link Body}
+ * <li class='ja'>{@link FormData}
+ * <li class='ja'>{@link Query}
+ * <li class='ja'>{@link Header}
+ * <li class='ja'>{@link Path}
+ * </ul>
+ *
+ * <p>
+ * The list of valid POJO types per type/format are as follows:
*
* <table class='styled'>
* <tr><th>Type</th><th>Format</th><th>Valid parameter types</th></tr>
@@ -141,6 +152,11 @@ import org.apache.juneau.transform.*;
* </td>
* </tr>
* </table>
+ *
+ * <h5 class='section'>See Also:</h5>
+ * <ul>
+ * <li class='link'><a class="doclink" href="../../../../overview-summary.html#juneau-marshall.OpenApiDetails">Overview > juneau-marshall > OpenAPI Details</a>
+ * </ul>
*/
public class OpenApiPartSerializer extends UonPartSerializer {
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/SimpleJsonSerializer.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/SimpleJsonSerializer.java
index bda3bc7..b6831e3 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/SimpleJsonSerializer.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/SimpleJsonSerializer.java
@@ -15,7 +15,26 @@ package org.apache.juneau.json;
import org.apache.juneau.*;
/**
- * TODO(7.2.0)
+ * Serializes POJO models to Simplified JSON.
+ *
+ * <h5 class='topic'>Media types</h5>
+ *
+ * Handles <code>Accept</code> types: <code><b>application/json, text/json</b></code>
+ * <p>
+ * Produces <code>Content-Type</code> types: <code><b>application/json+simple</b></code>
+ *
+ * <h5 class='topic'>Description</h5>
+ * <p>
+ * This is a JSON serializer that uses simplified notation:
+ * <ul class='spaced-list'>
+ * <li>Lax quoting of JSON attribute names.
+ * <li>Single quotes.
+ * </ul>
+ *
+ * <h5 class='section'>See Also:</h5>
+ * <ul class='doctree'>
+ * <li class='link'><a class='doclink' href='../../../../overview-summary.html#juneau-marshall.JsonDetails.SimplifiedJson'>Overview > juneau-marshall > Simplified JSON</a>
+ * </ul>
*/
public class SimpleJsonSerializer extends JsonSerializer {
diff --git a/juneau-doc/src/main/javadoc/overview.html b/juneau-doc/src/main/javadoc/overview.html
index 7eb361b..dee3efe 100644
--- a/juneau-doc/src/main/javadoc/overview.html
+++ b/juneau-doc/src/main/javadoc/overview.html
@@ -185,11 +185,11 @@
<li><p><a class='doclink' href='#juneau-marshall.MsgPackDetails.Serializers'>MessagePack Serializers</a></p>
<li><p><a class='doclink' href='#juneau-marshall.MsgPackDetails.Parsers'>MessagePack Parsers</a></p>
</ol>
- <li><p><a class='doclink' href='#juneau-marshall.OpenApiDetails'>OpenApi Details</a></p>
+ <li><p><a class='doclink' href='#juneau-marshall.OpenApiDetails'>OpenAPI Details</a></p>
<ol>
- <li><p><a class='doclink' href='#juneau-marshall.OpenApiDetails.Methodology'>OpenApi Methodology</a></p>
- <li><p><a class='doclink' href='#juneau-marshall.OpenApiDetails.Serializers'>OpenApi Serializers</a></p>
- <li><p><a class='doclink' href='#juneau-marshall.OpenApiDetails.Parsers'>OpenApi Parsers</a></p>
+ <li><p><a class='doclink' href='#juneau-marshall.OpenApiDetails.Methodology'>OpenAPI Methodology</a></p>
+ <li><p><a class='doclink' href='#juneau-marshall.OpenApiDetails.Serializers'>OpenAPI Serializers</a></p>
+ <li><p><a class='doclink' href='#juneau-marshall.OpenApiDetails.Parsers'>OpenAPI Parsers</a></p>
</ol>
<li><p><a class='doclink' href='#juneau-marshall.SoapDetails'>SOAP Details</a></p>
<li><p><a class='doclink' href='#juneau-marshall.CsvDetails'>CSV Details</a></p>
@@ -387,6 +387,7 @@
<li><p><a class='doclink' href='#juneau-rest-client.Debugging'>Debugging</a></p>
<li><p><a class='doclink' href='#juneau-rest-client.Logging'>Logging</a></p>
<li><p><a class='doclink' href='#juneau-rest-client.Interceptors'>Interceptors</a></p>
+ <li><p><a class='doclink' href='#juneau-rest-client.UnitTesting'>Server-less Unit Testing</a></p>
<li><p><a class='doclink' href='#juneau-rest-client.Other'>Other Useful Methods</a></p>
</ol>
<li><p class='toc2'><a class='doclink' href='#juneau-microservice-server'><i>juneau-microservice-server</i></a></p>
@@ -7972,29 +7973,29 @@
</div>
- <!-- === 2.21 - OpenApi Details ================================================================= -->
+ <!-- === 2.21 - OpenAPI Details ================================================================= -->
- <h3 class='topic' onclick='toggle(this)'><a href='#juneau-marshall.OpenApiDetails' id='juneau-marshall.OpenApiDetails'>2.21 - OpenApi Details</a></h3>
+ <h3 class='topic' onclick='toggle(this)'><a href='#juneau-marshall.OpenApiDetails' id='juneau-marshall.OpenApiDetails'>2.21 - OpenAPI Details</a></h3>
<div class='topic'>
TODO(7.2.0)
- <!-- === 2.21.1 - OpenApi Methodology ======================================================= -->
+ <!-- === 2.21.1 - OpenAPI Methodology ======================================================= -->
- <h4 class='topic' onclick='toggle(this)'><a href='#juneau-marshall.OpenApiDetails.Methodology' id='juneau-marshall.OpenApiDetails.Methodology'>2.21.1 - OpenApi Methodology</a></h4>
+ <h4 class='topic' onclick='toggle(this)'><a href='#juneau-marshall.OpenApiDetails.Methodology' id='juneau-marshall.OpenApiDetails.Methodology'>2.21.1 - OpenAPI Methodology</a></h4>
<div class='topic'>
TODO(7.2.0)
</div>
- <!-- === 2.21.2 - OpenApi Serializers ======================================================= -->
+ <!-- === 2.21.2 - OpenAPI Serializers ======================================================= -->
- <h4 class='topic' onclick='toggle(this)'><a href='#juneau-marshall.OpenApiDetails.OpenApiSerializers' id='juneau-marshall.OpenApiDetails.OpenApiSerializers'>2.21.2 - OpenApi Serializers</a></h4>
+ <h4 class='topic' onclick='toggle(this)'><a href='#juneau-marshall.OpenApiDetails.OpenApiSerializers' id='juneau-marshall.OpenApiDetails.OpenApiSerializers'>2.21.2 - OpenAPI Serializers</a></h4>
<div class='topic'>
TODO(7.2.0)
</div>
- <!-- === 2.21.3 - OpenApi Parsers =========================================================== -->
+ <!-- === 2.21.3 - OpenAPI Parsers =========================================================== -->
- <h4 class='topic' onclick='toggle(this)'><a href='#juneau-marshall.OpenApiDetails.Parsers' id='juneau-marshall.OpenApiDetails.Parsers'>2.21.3 - OpenApi Parsers</a></h4>
+ <h4 class='topic' onclick='toggle(this)'><a href='#juneau-marshall.OpenApiDetails.Parsers' id='juneau-marshall.OpenApiDetails.Parsers'>2.21.3 - OpenAPI Parsers</a></h4>
<div class='topic'>
TODO(7.2.0)
</div>
@@ -18082,9 +18083,16 @@
</p>
</div>
- <!-- === 9.9 - Other Useful Methods ================================================================= -->
+ <!-- === 9.9 -Server-less Unit Testing ============================================================== -->
- <h3 class='topic' onclick='toggle(this)'><a href='#juneau-rest-client.Other' id='juneau-rest-client.Other'>9.9 - Other Useful Methods</a></h3>
+ <h3 class='topic' onclick='toggle(this)'><a href='#juneau-rest-client.UnitTesting' id='juneau-rest-client.UnitTesting'>9.9 - Server-less Unit Testing</a></h3>
+ <div class='topic'>
+ TODO(7.2.0)
+ </div>
+
+ <!-- === 9.10 - Other Useful Methods ================================================================ -->
+
+ <h3 class='topic' onclick='toggle(this)'><a href='#juneau-rest-client.Other' id='juneau-rest-client.Other'>9.10 - Other Useful Methods</a></h3>
<div class='topic'>
<p>
The {@link org.apache.juneau.rest.client.RestClientBuilder#rootUrl(Object)} method can be used to specify a
diff --git a/juneau-rest/juneau-rest-client/src/main/java/org/apache/juneau/rest/client/RestCall.java b/juneau-rest/juneau-rest-client/src/main/java/org/apache/juneau/rest/client/RestCall.java
index 13a7855..597fa83 100644
--- a/juneau-rest/juneau-rest-client/src/main/java/org/apache/juneau/rest/client/RestCall.java
+++ b/juneau-rest/juneau-rest-client/src/main/java/org/apache/juneau/rest/client/RestCall.java
@@ -1972,8 +1972,6 @@ public final class RestCall extends BeanSession implements Closeable {
* <p>
* The array can be arbitrarily long to indicate arbitrarily complex data structures.
*
- * TODO(7.2.0) - Describe allowed POJOs when parser is not defined.
- *
* <h5 class='section'>Notes:</h5>
* <ul class='spaced-list'>
* <li>
diff --git a/juneau-rest/juneau-rest-client/src/main/java/org/apache/juneau/rest/client/RestClientBuilder.java b/juneau-rest/juneau-rest-client/src/main/java/org/apache/juneau/rest/client/RestClientBuilder.java
index 9ac8b72..543f903 100644
--- a/juneau-rest/juneau-rest-client/src/main/java/org/apache/juneau/rest/client/RestClientBuilder.java
+++ b/juneau-rest/juneau-rest-client/src/main/java/org/apache/juneau/rest/client/RestClientBuilder.java
@@ -557,7 +557,10 @@ public class RestClientBuilder extends BeanContextBuilder {
/**
* Sets a mock connection used to construct a connection manager for working against mocked REST interfaces.
*
- * TODO(7.2.0) - Describe how to use this.
+ * <h5 class='section'>See Also:</h5>
+ * <ul>
+ * <li class='link'><a class="doclink" href="../../../../../overview-summary.html#juneau-rest-client.UnitTesting">Overview > juneau-rest-client >Server-less Unit Testing</a>
+ * </ul>
*
* @param c The mock connection.
* @return This object (for method chaining).
[juneau] 01/02: Mark TODOs scheduled for 7.2.0
Posted by ja...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
jamesbognar pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/juneau.git
commit e352e13cb8ce4741aa05b64e0f033ce071117d7a
Author: JamesBognar <ja...@apache.org>
AuthorDate: Sun Jul 22 12:11:33 2018 -0400
Mark TODOs scheduled for 7.2.0
---
.../java/org/apache/juneau/IgnoredClassesTest.java | 1 -
.../main/java/org/apache/juneau/jena/N3Parser.java | 4 +-
.../java/org/apache/juneau/jena/N3Serializer.java | 4 +-
.../java/org/apache/juneau/jena/NTripleParser.java | 4 +-
.../org/apache/juneau/jena/NTripleSerializer.java | 4 +-
.../apache/juneau/jena/RdfXmlAbbrevSerializer.java | 4 +-
.../java/org/apache/juneau/jena/RdfXmlParser.java | 4 +-
.../org/apache/juneau/jena/RdfXmlSerializer.java | 4 +-
.../java/org/apache/juneau/jena/TurtleParser.java | 4 +-
.../org/apache/juneau/jena/TurtleSerializer.java | 4 +-
.../main/java/org/apache/juneau/PropertyStore.java | 4 +-
.../java/org/apache/juneau/annotation/Example.java | 2 +-
.../org/apache/juneau/http/annotation/Items.java | 2 +-
.../apache/juneau/http/annotation/RequestBean.java | 2 +-
.../apache/juneau/http/annotation/Response.java | 2 +-
.../org/apache/juneau/http/annotation/Schema.java | 6 +--
.../apache/juneau/http/annotation/SubItems.java | 2 +-
.../apache/juneau/httppart/OpenApiPartParser.java | 2 +-
.../juneau/httppart/OpenApiPartSerializer.java | 2 +-
.../apache/juneau/json/SimpleJsonSerializer.java | 4 +-
.../org/apache/juneau/utils/StringMessage.java | 1 -
juneau-doc/src/main/javadoc/overview.html | 60 +++++++++++-----------
.../rest/test/client/ThirdPartyProxyResource.java | 4 --
.../org/apache/juneau/rest/client/RestCall.java | 2 +-
.../juneau/rest/client/RestClientBuilder.java | 2 +-
25 files changed, 64 insertions(+), 70 deletions(-)
diff --git a/juneau-core/juneau-core-test/src/test/java/org/apache/juneau/IgnoredClassesTest.java b/juneau-core/juneau-core-test/src/test/java/org/apache/juneau/IgnoredClassesTest.java
index 0a18c08..bae761c 100755
--- a/juneau-core/juneau-core-test/src/test/java/org/apache/juneau/IgnoredClassesTest.java
+++ b/juneau-core/juneau-core-test/src/test/java/org/apache/juneau/IgnoredClassesTest.java
@@ -67,5 +67,4 @@ public class IgnoredClassesTest {
return "isNotBean";
}
}
- // TODO - Ignored packages.
}
diff --git a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/N3Parser.java b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/N3Parser.java
index e9a8336..6948f4f 100644
--- a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/N3Parser.java
+++ b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/N3Parser.java
@@ -16,8 +16,8 @@ import static org.apache.juneau.jena.Constants.*;
import org.apache.juneau.*;
-/**
- * TODO
+/**
+ * TODO(7.2.0)
*/
public class N3Parser extends RdfParser {
diff --git a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/N3Serializer.java b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/N3Serializer.java
index 9ec9743..ccef4cb 100644
--- a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/N3Serializer.java
+++ b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/N3Serializer.java
@@ -16,8 +16,8 @@ import static org.apache.juneau.jena.Constants.*;
import org.apache.juneau.*;
-/**
- * TODO
+/**
+ * TODO(7.2.0)
*/
public class N3Serializer extends RdfSerializer {
diff --git a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/NTripleParser.java b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/NTripleParser.java
index 6bd0db1..2d11f2e 100644
--- a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/NTripleParser.java
+++ b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/NTripleParser.java
@@ -16,8 +16,8 @@ import static org.apache.juneau.jena.Constants.*;
import org.apache.juneau.*;
-/**
- * TODO
+/**
+ * TODO(7.2.0)
*/
public class NTripleParser extends RdfParser {
diff --git a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/NTripleSerializer.java b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/NTripleSerializer.java
index 7d2a89e..196d6e9 100644
--- a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/NTripleSerializer.java
+++ b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/NTripleSerializer.java
@@ -16,8 +16,8 @@ import static org.apache.juneau.jena.Constants.*;
import org.apache.juneau.*;
-/**
- * TODO
+/**
+ * TODO(7.2.0)
*/
public class NTripleSerializer extends RdfSerializer {
diff --git a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlAbbrevSerializer.java b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlAbbrevSerializer.java
index 07b6681..d60f4fa 100644
--- a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlAbbrevSerializer.java
+++ b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlAbbrevSerializer.java
@@ -16,8 +16,8 @@ import static org.apache.juneau.jena.Constants.*;
import org.apache.juneau.*;
-/**
- * TODO
+/**
+ * TODO(7.2.0)
*/
public class RdfXmlAbbrevSerializer extends RdfSerializer {
diff --git a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlParser.java b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlParser.java
index 714bb4a..d673bdf 100644
--- a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlParser.java
+++ b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlParser.java
@@ -16,8 +16,8 @@ import static org.apache.juneau.jena.Constants.*;
import org.apache.juneau.*;
-/**
- * TODO
+/**
+ * TODO(7.2.0)
*/
public class RdfXmlParser extends RdfParser {
diff --git a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlSerializer.java b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlSerializer.java
index ed4a86f..e3350e3 100644
--- a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlSerializer.java
+++ b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/RdfXmlSerializer.java
@@ -16,8 +16,8 @@ import static org.apache.juneau.jena.Constants.*;
import org.apache.juneau.*;
-/**
- * TODO
+/**
+ * TODO(7.2.0)
*/
public class RdfXmlSerializer extends RdfSerializer {
diff --git a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/TurtleParser.java b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/TurtleParser.java
index 517759c..fdad43d 100644
--- a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/TurtleParser.java
+++ b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/TurtleParser.java
@@ -16,8 +16,8 @@ import static org.apache.juneau.jena.Constants.*;
import org.apache.juneau.*;
-/**
- * TODO
+/**
+ * TODO(7.2.0)
*/
public class TurtleParser extends RdfParser {
diff --git a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/TurtleSerializer.java b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/TurtleSerializer.java
index 79c50b2..d632920 100644
--- a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/TurtleSerializer.java
+++ b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/TurtleSerializer.java
@@ -16,8 +16,8 @@ import static org.apache.juneau.jena.Constants.*;
import org.apache.juneau.*;
-/**
- * TODO
+/**
+ * TODO(7.2.0)
*/
public class TurtleSerializer extends RdfSerializer {
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/PropertyStore.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/PropertyStore.java
index 5add9c8..91f0027 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/PropertyStore.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/PropertyStore.java
@@ -187,12 +187,12 @@ import org.apache.juneau.json.*;
* <h5 class='topic'>Setting properties</h5>
*
* <p>
- * TODO
+ * TODO(7.2.0)
*
* <h5 class='topic'>Retrieving properties</h5>
*
* <p>
- * TODO
+ * TODO(7.2.0)
*
*/
@SuppressWarnings("unchecked")
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/annotation/Example.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/annotation/Example.java
index f77c188..0ec01c2 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/annotation/Example.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/annotation/Example.java
@@ -57,7 +57,7 @@ import java.lang.annotation.*;
*
* <h5 class='section'>See Also:</h5>
* <ul>
- * <li>TODO
+ * <li>TODO(7.2.0)
* </ul>
*/
@Documented
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/Items.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/Items.java
index 2ad69c9..2209ff3 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/Items.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/Items.java
@@ -324,7 +324,7 @@ public @interface Items {
String $ref() default "";
/**
- * TODO
+ * TODO(7.2.0)
*/
SubItems items() default @SubItems;
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/RequestBean.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/RequestBean.java
index d25749a..bbbdf02 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/RequestBean.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/RequestBean.java
@@ -87,7 +87,7 @@ import org.apache.juneau.httppart.*;
* <br>Schema-based serialization and parsing is allowed just as if used as individual parameter types.
*
* <p>
- * TODO - Swagger-info in <ja>@RequestBean</ja>s is not currently reflected in generated Swagger documentation.
+ * TODO(7.2.0) - Swagger-info in <ja>@RequestBean</ja>s is not currently reflected in generated Swagger documentation.
*
* <h5 class='section'>See Also:</h5>
* <ul>
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/Response.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/Response.java
index 6aae320..2425562 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/Response.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/Response.java
@@ -125,7 +125,7 @@ public @interface Response {
*
* The default value is <code>500</code> for exceptions and <code>200</code> for return types.
*
- * TODO - Can also be used on throwable to specify the HTTP status code to set when thrown.
+ * TODO(7.2.0) - Can also be used on throwable to specify the HTTP status code to set when thrown.
*/
int[] code() default {};
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/Schema.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/Schema.java
index f2c3c36..7a82147 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/Schema.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/Schema.java
@@ -602,7 +602,7 @@ public @interface Schema {
ExternalDocs externalDocs() default @ExternalDocs;
/**
- * TODO
+ * TODO(7.2.0)
*
* <p>
* This attribute defines a JSON representation of the body value that is used by <code>BasicRestInfoProvider</code> to construct
@@ -621,7 +621,7 @@ public @interface Schema {
String[] example() default {};
/**
- * TODO
+ * TODO(7.2.0)
*
* <p>
* This is a JSON object whose keys are media types and values are string representations of that value.
@@ -639,7 +639,7 @@ public @interface Schema {
String[] examples() default {};
/**
- * TODO
+ * TODOTODO(7.2.0)
*/
boolean ignore() default false;
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/SubItems.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/SubItems.java
index 7b19eb4..2ed0158 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/SubItems.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/annotation/SubItems.java
@@ -370,7 +370,7 @@ public @interface SubItems {
String[] value() default {};
/**
- * TODO
+ * TODO(7.2.0)
*/
String[] items() default {};
}
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/httppart/OpenApiPartParser.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/httppart/OpenApiPartParser.java
index 1106aeb..1f9df10 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/httppart/OpenApiPartParser.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/httppart/OpenApiPartParser.java
@@ -24,7 +24,7 @@ import org.apache.juneau.transform.*;
* OpenAPI part parser.
*
* <p>
- * TODO
+ * TODO(7.2.0)
*
* <table class='styled'>
* <tr><th>Type</th><th>Format</th><th>Valid parameter types</th></tr>
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/httppart/OpenApiPartSerializer.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/httppart/OpenApiPartSerializer.java
index 178035b..be9c109 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/httppart/OpenApiPartSerializer.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/httppart/OpenApiPartSerializer.java
@@ -23,7 +23,7 @@ import org.apache.juneau.transform.*;
* Serializes POJOs to values suitable for transmission as HTTP headers, query/form-data parameters, and path variables.
*
* <p>
- * TODO
+ * TODO(7.2.0)
*
* <table class='styled'>
* <tr><th>Type</th><th>Format</th><th>Valid parameter types</th></tr>
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/SimpleJsonSerializer.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/SimpleJsonSerializer.java
index a984580..bda3bc7 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/SimpleJsonSerializer.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/SimpleJsonSerializer.java
@@ -14,8 +14,8 @@ package org.apache.juneau.json;
import org.apache.juneau.*;
-/**
- * TODO
+/**
+ * TODO(7.2.0)
*/
public class SimpleJsonSerializer extends JsonSerializer {
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/utils/StringMessage.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/utils/StringMessage.java
index 24086b4..34a3482 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/utils/StringMessage.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/utils/StringMessage.java
@@ -52,7 +52,6 @@ public class StringMessage implements CharSequence, Writable {
@Override /* Writable */
public MediaType getMediaType() {
- // TODO Auto-generated method stub
return null;
}
diff --git a/juneau-doc/src/main/javadoc/overview.html b/juneau-doc/src/main/javadoc/overview.html
index dcd6f1f..7eb361b 100644
--- a/juneau-doc/src/main/javadoc/overview.html
+++ b/juneau-doc/src/main/javadoc/overview.html
@@ -4376,7 +4376,7 @@
<h4 class='topic' onclick='toggle(this)'><a href='#juneau-marshall.JsonDetails.SimplifiedJson' id='juneau-marshall.JsonDetails.SimplifiedJson'>2.15.3 - Simplified JSON</a></h4>
<div class='topic'>
- TODO
+ TODO(7.2.0)
</div>
<!-- === 2.15.4 - JSON Parsers ================================================================== -->
@@ -6593,7 +6593,7 @@
<h4 class='topic' onclick='toggle(this)'><a href='#juneau-marshall.XmlDetails.UriProperties' id='juneau-marshall.XmlDetails.UriProperties'>2.16.8 - URI Properties</a></h4>
<div class='topic'>
- TODO
+ TODO(7.2.0)
</div>
<!-- === 2.16.9 - XML-Schema Support ============================================================ -->
@@ -6859,7 +6859,7 @@
<h3 class='topic' onclick='toggle(this)'><a href='#juneau-marshall.HtmlDetails' id='juneau-marshall.HtmlDetails'>2.17 - HTML Details</a></h3>
<div class='topic'>
- TODO
+ TODO(7.2.0)
<!-- === 2.17.1 - HTML Methodology ============================================================== -->
@@ -7465,35 +7465,35 @@
<h4 class='topic' onclick='toggle(this)'><a href='#juneau-marshall.HtmlDetails.HtmlAnnotation' id='juneau-marshall.HtmlDetails.HtmlAnnotation'>2.17.4 - @Html Annotation</a></h4>
<div class='topic'>
- TODO
+ TODO(7.2.0)
</div>
<!-- === 2.17.5 - @Html(render) Annotation ====================================================== -->
<h4 class='topic' onclick='toggle(this)'><a href='#juneau-marshall.HtmlDetails.HtmlRenderAnnotation' id='juneau-marshall.HtmlDetails.HtmlRenderAnnotation'>2.17.5 - @Html(render) Annotation</a></h4>
<div class='topic'>
- TODO
+ TODO(7.2.0)
</div>
<!-- === 2.17.6 - HtmlDocSerializer ============================================================= -->
<h4 class='topic' onclick='toggle(this)'><a href='#juneau-marshall.HtmlDetails.HtmlDocSerializer' id='juneau-marshall.HtmlDetails.HtmlDocSerializer'>2.17.6 - HtmlDocSerializer</a></h4>
<div class='topic'>
- TODO
+ TODO(7.2.0)
</div>
<!-- === 2.17.7 - Custom Templates ============================================================== -->
<h4 class='topic' onclick='toggle(this)'><a href='#juneau-marshall.HtmlDetails.CustomTemplates' id='juneau-marshall.HtmlDetails.CustomTemplates'>2.17.7 - Custom Templates</a></h4>
<div class='topic'>
- TODO
+ TODO(7.2.0)
</div>
<!-- === 2.17.8 - HTML-Schema Support =========================================================== -->
<h4 class='topic' onclick='toggle(this)'><a href='#juneau-marshall.HtmlDetails.HtmlSchema' id='juneau-marshall.HtmlDetails.HtmlSchema'>2.17.8 - HTML-Schema Support</a></h4>
<div class='topic'>
- TODO
+ TODO(7.2.0)
</div>
</div>
@@ -7899,7 +7899,7 @@
<h4 class='topic' onclick='toggle(this)'><a href='#juneau-marshall.UrlEncodingDetails.UrlEncodingAnnotation' id='juneau-marshall.UrlEncodingDetails.UrlEncodingAnnotation'>2.19.4 - @UrlEncoding Annotation</a></h4>
<div class='topic'>
- TODO
+ TODO(7.2.0)
</div>
</div>
@@ -7907,7 +7907,7 @@
<h3 class='topic' onclick='toggle(this)'><a href='#juneau-marshall.MsgPackDetails' id='juneau-marshall.MsgPackDetails'>2.20 - MessagePack Details</a></h3>
<div class='topic'>
- TODO
+ TODO(7.2.0)
<!-- === 2.20.1 - MessagePack Methodology ======================================================= -->
@@ -7976,27 +7976,27 @@
<h3 class='topic' onclick='toggle(this)'><a href='#juneau-marshall.OpenApiDetails' id='juneau-marshall.OpenApiDetails'>2.21 - OpenApi Details</a></h3>
<div class='topic'>
- TODO
+ TODO(7.2.0)
<!-- === 2.21.1 - OpenApi Methodology ======================================================= -->
<h4 class='topic' onclick='toggle(this)'><a href='#juneau-marshall.OpenApiDetails.Methodology' id='juneau-marshall.OpenApiDetails.Methodology'>2.21.1 - OpenApi Methodology</a></h4>
<div class='topic'>
- TODO
+ TODO(7.2.0)
</div>
<!-- === 2.21.2 - OpenApi Serializers ======================================================= -->
<h4 class='topic' onclick='toggle(this)'><a href='#juneau-marshall.OpenApiDetails.OpenApiSerializers' id='juneau-marshall.OpenApiDetails.OpenApiSerializers'>2.21.2 - OpenApi Serializers</a></h4>
<div class='topic'>
- TODO
+ TODO(7.2.0)
</div>
<!-- === 2.21.3 - OpenApi Parsers =========================================================== -->
<h4 class='topic' onclick='toggle(this)'><a href='#juneau-marshall.OpenApiDetails.Parsers' id='juneau-marshall.OpenApiDetails.Parsers'>2.21.3 - OpenApi Parsers</a></h4>
<div class='topic'>
- TODO
+ TODO(7.2.0)
</div>
</div>
@@ -8005,21 +8005,21 @@
<h3 class='topic' onclick='toggle(this)'><a href='#juneau-marshall.SoapDetails' id='juneau-marshall.SoapDetails'>2.22 - SOAP Details</a></h3>
<div class='topic'>
- TODO
+ TODO(7.2.0)
</div>
<!-- === 2.23 - CSV Details ========================================================================= -->
<h3 class='topic' onclick='toggle(this)'><a href='#juneau-marshall.CsvDetails' id='juneau-marshall.CsvDetails'>2.23 - CSV Details</a></h3>
<div class='topic'>
- TODO
+ TODO(7.2.0)
</div>
<!-- === 2.24 - Java Serialized Object Details ====================================================== -->
<h3 class='topic' onclick='toggle(this)'><a href='#juneau-marshall.JsoDetails' id='juneau-marshall.JsoDetails'>2.24 - Java Serialized Object Details</a></h3>
<div class='topic'>
- TODO
+ TODO(7.2.0)
</div>
<!-- === 2.25 - Best Practices ====================================================================== -->
@@ -8148,7 +8148,7 @@
<h4 class='topic' onclick='toggle(this)'><a href='#juneau-marshall-rdf.RdfDetails.Methodology' id='juneau-marshall-rdf.RdfDetails.Methodology'>3.1.1 - RDF Methodology</a></h4>
<div class='topic'>
- TODO
+ TODO(7.2.0)
</div>
<!-- === 3.1.2 - RDF Serializers ================================================================ -->
@@ -8345,7 +8345,7 @@
<h4 class='topic' onclick='toggle(this)'><a href='#juneau-marshall-rdf.RdfDetails.RdfAnnotation' id='juneau-marshall-rdf.RdfDetails.RdfAnnotation'>3.1.4 - @Rdf Annotation</a></h4>
<div class='topic'>
- TODO
+ TODO(7.2.0)
</div>
<!-- === 3.1.5 - Namespaces ===================================================================== -->
@@ -13089,7 +13089,7 @@
<h3 class='topic' onclick='toggle(this)'><a href='#juneau-rest-server.HasFormData' id='juneau-rest-server.HasFormData'>7.9 - @HasFormData</a></h3>
<div class='topic'>
- TODO
+ TODO(7.2.0)
</div>
<!-- === 7.10 - @Query =============================================================================== -->
@@ -13144,7 +13144,7 @@
<h3 class='topic' onclick='toggle(this)'><a href='#juneau-rest-server.HasQuery' id='juneau-rest-server.HasQuery'>7.11 - @HasQuery</a></h3>
<div class='topic'>
- TODO
+ TODO(7.2.0)
</div>
<!-- === 7.12 - @Header ============================================================================= -->
@@ -13221,7 +13221,7 @@
<h3 class='topic' onclick='toggle(this)'><a href='#juneau-rest-server.RequestBean' id='juneau-rest-server.RequestBean'>7.14 - @RequestBean</a></h3>
<div class='topic'>
- TODO
+ TODO(7.2.0)
</div>
<!-- === 7.15 - Swagger Schema Part Parsing ========================================================= -->
@@ -13690,42 +13690,42 @@
<h3 class='topic' onclick='toggle(this)'><a href='#juneau-rest-server.Response' id='juneau-rest-server.Response'>7.16 - @Response</a></h3>
<div class='topic'>
- TODO
+ TODO(7.2.0)
</div>
<!-- === 7.17 - @Responses ========================================================================== -->
<h3 class='topic' onclick='toggle(this)'><a href='#juneau-rest-server.Responses' id='juneau-rest-server.Responses'>7.17 - @Responses</a></h3>
<div class='topic'>
- TODO
+ TODO(7.2.0)
</div>
<!-- === 7.18 - @ResponseHeader ===================================================================== -->
<h3 class='topic' onclick='toggle(this)'><a href='#juneau-rest-server.ResponseHeader' id='juneau-rest-server.ResponseHeader'>7.18 - @ResponseHeader</a></h3>
<div class='topic'>
- TODO
+ TODO(7.2.0)
</div>
<!-- === 7.19 - @ResponseStatus ===================================================================== -->
<h3 class='topic' onclick='toggle(this)'><a href='#juneau-rest-server.ResponseStatus' id='juneau-rest-server.ResponseStatus'>7.19 - @ResponseStatus</a></h3>
<div class='topic'>
- TODO
+ TODO(7.2.0)
</div>
<!-- === 7.20 - @ResponseStatuses =================================================================== -->
<h3 class='topic' onclick='toggle(this)'><a href='#juneau-rest-server.ResponseStatuses' id='juneau-rest-server.ResponseStatuses'>7.20 - @ResponseStatuses</a></h3>
<div class='topic'>
- TODO
+ TODO(7.2.0)
</div>
<!-- === 7.21 - Swagger Schema Part Serializing ===================================================== -->
<h3 class='topic' onclick='toggle(this)'><a href='#juneau-rest-server.SwaggerSchemaPartSerializing' id='juneau-rest-server.SwaggerSchemaPartSerializing'>7.21 - Swagger Schema Part Serializing</a></h3>
<div class='topic'>
- TODO
+ TODO(7.2.0)
</div>
<!-- === 7.22 - Serializers ========================================================================= -->
@@ -13800,7 +13800,7 @@
<h3 class='topic' onclick='toggle(this)'><a href='#juneau-rest-server.PartSerializers' id='juneau-rest-server.PartSerializers'>7.23 - Part Serializers</a></h3>
<div class='topic'>
- TODO
+ TODO(7.2.0)
</div>
<!-- === 7.24 - Parsers ============================================================================= -->
@@ -15281,7 +15281,7 @@
<h4 class='topic' onclick='toggle(this)'><a href='#juneau-rest-server.PredefinedWidgets' id='juneau-rest-server.PredefinedWidgets'>7.37.2 - Predefined Widgets</a></h4>
<div class='topic'>
- TODO
+ TODO(7.2.0)
</div>
<!-- === 7.37.3 - UI Customization ============================================================== -->
diff --git a/juneau-microservice/juneau-microservice-test/src/main/java/org/apache/juneau/rest/test/client/ThirdPartyProxyResource.java b/juneau-microservice/juneau-microservice-test/src/main/java/org/apache/juneau/rest/test/client/ThirdPartyProxyResource.java
index aef6c2d..cffcea8 100644
--- a/juneau-microservice/juneau-microservice-test/src/main/java/org/apache/juneau/rest/test/client/ThirdPartyProxyResource.java
+++ b/juneau-microservice/juneau-microservice-test/src/main/java/org/apache/juneau/rest/test/client/ThirdPartyProxyResource.java
@@ -56,7 +56,6 @@ public class ThirdPartyProxyResource extends BasicRestServletJena {
logFile.append("START["+new Date()+"]-").append(req.getQueryString()).append("\n");
logFile.flush();
} catch (IOException e) {
- // TODO Auto-generated catch block
e.printStackTrace();
}
}
@@ -67,7 +66,6 @@ public class ThirdPartyProxyResource extends BasicRestServletJena {
logFile.append("PRE["+new Date()+"]-").append(req.getQueryString()).append("\n");
logFile.flush();
} catch (IOException e) {
- // TODO Auto-generated catch block
e.printStackTrace();
}
}
@@ -78,7 +76,6 @@ public class ThirdPartyProxyResource extends BasicRestServletJena {
logFile.append("POST["+new Date()+"]-").append(req.getQueryString()).append("\n");
logFile.flush();
} catch (IOException e) {
- // TODO Auto-generated catch block
e.printStackTrace();
}
}
@@ -91,7 +88,6 @@ public class ThirdPartyProxyResource extends BasicRestServletJena {
logFile.append("END["+new Date()+"]-").append(req.getQueryString()).append(", time=").append(""+execTime).append(", exception=").append(e == null ? null : e.toString()).append("\n");
logFile.flush();
} catch (IOException e) {
- // TODO Auto-generated catch block
e.printStackTrace();
}
}
diff --git a/juneau-rest/juneau-rest-client/src/main/java/org/apache/juneau/rest/client/RestCall.java b/juneau-rest/juneau-rest-client/src/main/java/org/apache/juneau/rest/client/RestCall.java
index f748d00..13a7855 100644
--- a/juneau-rest/juneau-rest-client/src/main/java/org/apache/juneau/rest/client/RestCall.java
+++ b/juneau-rest/juneau-rest-client/src/main/java/org/apache/juneau/rest/client/RestCall.java
@@ -1972,7 +1972,7 @@ public final class RestCall extends BeanSession implements Closeable {
* <p>
* The array can be arbitrarily long to indicate arbitrarily complex data structures.
*
- * TODO - Describe allowed POJOs when parser is not defined.
+ * TODO(7.2.0) - Describe allowed POJOs when parser is not defined.
*
* <h5 class='section'>Notes:</h5>
* <ul class='spaced-list'>
diff --git a/juneau-rest/juneau-rest-client/src/main/java/org/apache/juneau/rest/client/RestClientBuilder.java b/juneau-rest/juneau-rest-client/src/main/java/org/apache/juneau/rest/client/RestClientBuilder.java
index d3fa4bb..9ac8b72 100644
--- a/juneau-rest/juneau-rest-client/src/main/java/org/apache/juneau/rest/client/RestClientBuilder.java
+++ b/juneau-rest/juneau-rest-client/src/main/java/org/apache/juneau/rest/client/RestClientBuilder.java
@@ -557,7 +557,7 @@ public class RestClientBuilder extends BeanContextBuilder {
/**
* Sets a mock connection used to construct a connection manager for working against mocked REST interfaces.
*
- * TODO - Describe how to use this.
+ * TODO(7.2.0) - Describe how to use this.
*
* @param c The mock connection.
* @return This object (for method chaining).