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 2017/02/24 22:15:28 UTC
[5/9] incubator-juneau git commit: Clean up javadocs
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/msgpack/MsgPackParserSession.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/msgpack/MsgPackParserSession.java b/juneau-core/src/main/java/org/apache/juneau/msgpack/MsgPackParserSession.java
index 0b165de..6829b17 100644
--- a/juneau-core/src/main/java/org/apache/juneau/msgpack/MsgPackParserSession.java
+++ b/juneau-core/src/main/java/org/apache/juneau/msgpack/MsgPackParserSession.java
@@ -33,23 +33,23 @@ public final class MsgPackParserSession extends ParserSession {
* Create a new session using properties specified in the context.
*
* @param ctx The context creating this session object.
- * The context contains all the configuration settings for this object.
+ * The context contains all the configuration settings for this object.
* @param input The input. Can be any of the following types:
- * <ul>
- * <li><jk>null</jk>
- * <li>{@link Reader}
- * <li>{@link CharSequence}
- * <li>{@link InputStream} containing UTF-8 encoded text.
- * <li>{@link File} containing system encoded text.
- * </ul>
+ * <ul>
+ * <li><jk>null</jk>
+ * <li>{@link Reader}
+ * <li>{@link CharSequence}
+ * <li>{@link InputStream} containing UTF-8 encoded text.
+ * <li>{@link File} containing system encoded text.
+ * </ul>
* @param op The override properties.
- * These override any context properties defined in the context.
+ * These override any context properties defined in the context.
* @param javaMethod The java method that called this parser, usually the method in a REST servlet.
* @param outer The outer object for instantiating top-level non-static inner classes.
* @param locale The session locale.
- * If <jk>null</jk>, then the locale defined on the context is used.
+ * If <jk>null</jk>, then the locale defined on the context is used.
* @param timeZone The session timezone.
- * If <jk>null</jk>, then the timezone defined on the context is used.
+ * If <jk>null</jk>, then the timezone defined on the context is used.
* @param mediaType The session media type (e.g. <js>"application/json"</js>).
*/
public MsgPackParserSession(MsgPackParserContext ctx, ObjectMap op, Object input, Method javaMethod, Object outer, Locale locale, TimeZone timeZone, MediaType mediaType) {
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/msgpack/MsgPackSerializer.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/msgpack/MsgPackSerializer.java b/juneau-core/src/main/java/org/apache/juneau/msgpack/MsgPackSerializer.java
index cd842d6..123155d 100644
--- a/juneau-core/src/main/java/org/apache/juneau/msgpack/MsgPackSerializer.java
+++ b/juneau-core/src/main/java/org/apache/juneau/msgpack/MsgPackSerializer.java
@@ -25,13 +25,13 @@ import org.apache.juneau.transform.*;
*
* <h5 class='section'>Media types:</h5>
* <p>
- * Handles <code>Accept</code> types: <code>octal/msgpack</code>
+ * Handles <code>Accept</code> types: <code>octal/msgpack</code>
* <p>
- * Produces <code>Content-Type</code> types: <code>octal/msgpack</code>
+ * Produces <code>Content-Type</code> types: <code>octal/msgpack</code>
*
* <h5 class='section'>Configurable properties:</h5>
* <p>
- * This class has the following properties associated with it:
+ * This class has the following properties associated with it:
* <ul>
* <li>{@link MsgPackSerializerContext}
* <li>{@link SerializerContext}
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/msgpack/MsgPackSerializerSession.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/msgpack/MsgPackSerializerSession.java b/juneau-core/src/main/java/org/apache/juneau/msgpack/MsgPackSerializerSession.java
index 4b87867..c91a11d 100644
--- a/juneau-core/src/main/java/org/apache/juneau/msgpack/MsgPackSerializerSession.java
+++ b/juneau-core/src/main/java/org/apache/juneau/msgpack/MsgPackSerializerSession.java
@@ -36,15 +36,15 @@ public final class MsgPackSerializerSession extends SerializerSession {
* Create a new session using properties specified in the context.
*
* @param ctx The context creating this session object.
- * The context contains all the configuration settings for this object.
+ * The context contains all the configuration settings for this object.
* @param output The output object. See {@link JsonSerializerSession#getOutputStream()} for valid class types.
* @param op The override properties.
- * These override any context properties defined in the context.
+ * These override any context properties defined in the context.
* @param javaMethod The java method that called this parser, usually the method in a REST servlet.
* @param locale The session locale.
- * If <jk>null</jk>, then the locale defined on the context is used.
+ * If <jk>null</jk>, then the locale defined on the context is used.
* @param timeZone The session timezone.
- * If <jk>null</jk>, then the timezone defined on the context is used.
+ * If <jk>null</jk>, then the timezone defined on the context is used.
* @param mediaType The session media type (e.g. <js>"application/json"</js>).
*/
protected MsgPackSerializerSession(MsgPackSerializerContext ctx, ObjectMap op, Object output, Method javaMethod, Locale locale, TimeZone timeZone, MediaType mediaType) {
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/parser/InputStreamParser.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/parser/InputStreamParser.java b/juneau-core/src/main/java/org/apache/juneau/parser/InputStreamParser.java
index 6abdeb5..f24609a 100644
--- a/juneau-core/src/main/java/org/apache/juneau/parser/InputStreamParser.java
+++ b/juneau-core/src/main/java/org/apache/juneau/parser/InputStreamParser.java
@@ -19,17 +19,17 @@ import org.apache.juneau.annotation.*;
*
* <h5 class='section'>Description:</h5>
* <p>
- * This class is typically the parent class of all byte-based parsers.
- * It has 1 abstract method to implement...
+ * This class is typically the parent class of all byte-based parsers.
+ * It has 1 abstract method to implement...
* <ul>
* <li><code>parse(InputStream, ClassMeta, ParserContext)</code>
* </ul>
*
* <h6 class='topic'>@Consumes annotation</h6>
* <p>
- * The media types that this parser can handle is specified through the {@link Consumes @Consumes} annotation.
+ * The media types that this parser can handle is specified through the {@link Consumes @Consumes} annotation.
* <p>
- * However, the media types can also be specified programmatically by overriding the {@link #getMediaTypes()} method.
+ * However, the media types can also be specified programmatically by overriding the {@link #getMediaTypes()} method.
*/
public abstract class InputStreamParser extends Parser {
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/parser/Parser.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/parser/Parser.java b/juneau-core/src/main/java/org/apache/juneau/parser/Parser.java
index e3d9f9a..dab1bf0 100644
--- a/juneau-core/src/main/java/org/apache/juneau/parser/Parser.java
+++ b/juneau-core/src/main/java/org/apache/juneau/parser/Parser.java
@@ -34,14 +34,14 @@ import org.apache.juneau.utils.*;
*
* <h6 class='topic'>@Consumes annotation</h6>
* <p>
- * The media types that this parser can handle is specified through the {@link Consumes @Consumes} annotation.
+ * The media types that this parser can handle is specified through the {@link Consumes @Consumes} annotation.
* <p>
- * However, the media types can also be specified programmatically by overriding the {@link #getMediaTypes()} method.
+ * However, the media types can also be specified programmatically by overriding the {@link #getMediaTypes()} method.
*
* <a id='ValidDataConversions'></a><h6 class='topic'>Valid data conversions</h6>
- * Parsers can parse any parsable POJO types, as specified in the <a class="doclink" href="../../../../overview-summary.html#Core.PojoCategories">POJO Categories</a>.
+ * Parsers can parse any parsable POJO types, as specified in the <a class="doclink" href="../../../../overview-summary.html#Core.PojoCategories">POJO Categories</a>.
* <p>
- * Some examples of conversions are shown below...
+ * Some examples of conversions are shown below...
* </p>
* <table class='styled'>
* <tr>
@@ -95,15 +95,15 @@ import org.apache.juneau.utils.*;
* </tr>
* </table>
* <p>
- * In addition, any class types with {@link PojoSwap PojoSwaps} associated with them on the registered
- * {@link #getBeanContext() beanContext} can also be passed in.
+ * In addition, any class types with {@link PojoSwap PojoSwaps} associated with them on the registered
+ * {@link #getBeanContext() beanContext} can also be passed in.
* <p>
- * For example, if the {@link CalendarSwap} transform is used to generalize {@code Calendar} objects to {@code String} objects. When registered
+ * For example, if the {@link CalendarSwap} transform is used to generalize {@code Calendar} objects to {@code String} objects. When registered
* with this parser, you can construct {@code Calendar} objects from {@code Strings} using the following syntax...
* <p class='bcode'>
* Calendar c = parser.parse(<js>"'Sun Mar 03 04:05:06 EST 2001'"</js>, GregorianCalendar.<jk>class</jk>);
* <p>
- * If <code>Object.<jk>class</jk></code> is specified as the target type, then the parser
+ * If <code>Object.<jk>class</jk></code> is specified as the target type, then the parser
* automatically determines the data types and generates the following object types...
* </p>
* <table class='styled'>
@@ -117,8 +117,8 @@ import org.apache.juneau.utils.*;
*
* <a id='SupportedTypes'></a><h6 class='topic'>Supported types</h6>
* <p>
- * Several of the methods below take {@link Type} parameters to identify the type of
- * object to create. Any of the following types can be passed in to these methods...
+ * Several of the methods below take {@link Type} parameters to identify the type of
+ * object to create. Any of the following types can be passed in to these methods...
* </p>
* <ul>
* <li>{@link ClassMeta}
@@ -127,10 +127,10 @@ import org.apache.juneau.utils.*;
* <li>{@link GenericArrayType}
* </ul>
* <p>
- * However, {@code ParameterizedTypes} and {@code GenericArrayTypes} should not contain
- * {@link WildcardType WildcardTypes} or {@link TypeVariable TypeVariables}.
+ * However, {@code ParameterizedTypes} and {@code GenericArrayTypes} should not contain
+ * {@link WildcardType WildcardTypes} or {@link TypeVariable TypeVariables}.
* <p>
- * Passing in <jk>null</jk> or <code>Object.<jk>class</jk></code> typically signifies that it's up to the parser
+ * Passing in <jk>null</jk> or <code>Object.<jk>class</jk></code> typically signifies that it's up to the parser
* to determine what object type is being parsed parsed based on the rules above.
*/
public abstract class Parser extends CoreApi {
@@ -160,10 +160,10 @@ public abstract class Parser extends CoreApi {
/**
* Workhorse method. Subclasses are expected to implement this method.
* @param session The runtime session object returned by {@link #createSession(Object, ObjectMap, Method, Object, Locale, TimeZone, MediaType)}.
- * If <jk>null</jk>, one will be created using {@link #createSession(Object)}.
+ * If <jk>null</jk>, one will be created using {@link #createSession(Object)}.
* @param type The class type of the object to create.
- * If <jk>null</jk> or <code>Object.<jk>class</jk></code>, object type is based on what's being parsed.
- * For example, when parsing JSON text, it may return a <code>String</code>, <code>Number</code>, <code>ObjectMap</code>, etc...
+ * If <jk>null</jk> or <code>Object.<jk>class</jk></code>, object type is based on what's being parsed.
+ * For example, when parsing JSON text, it may return a <code>String</code>, <code>Number</code>, <code>ObjectMap</code>, etc...
* @param <T> The class type of the object to create.
* @return The parsed object.
* @throws Exception If thrown from underlying stream, or if the input contains a syntax error or is malformed.
@@ -297,7 +297,7 @@ public abstract class Parser extends CoreApi {
*
* @param <T> The class type of the object being created.
* @param input The input.
- * See {@link #parse(Object, Type, Type...)} for details.
+ * See {@link #parse(Object, Type, Type...)} for details.
* @param type The object type to create.
* @return The parsed object.
* @throws ParseException If the input contains a syntax error or is malformed, or is not valid for the specified type.
@@ -314,7 +314,7 @@ public abstract class Parser extends CoreApi {
*
* @param <T> The class type of the object being created.
* @param input The input.
- * See {@link #parse(Object, Type, Type...)} for details.
+ * See {@link #parse(Object, Type, Type...)} for details.
* @param type The object type to create.
* @return The parsed object.
* @throws ParseException If the input contains a syntax error or is malformed, or is not valid for the specified type.
@@ -326,19 +326,19 @@ public abstract class Parser extends CoreApi {
/**
* Create the session object that will be passed in to the parse method.
* <p>
- * It's up to implementers to decide what the session object looks like, although typically
+ * It's up to implementers to decide what the session object looks like, although typically
* it's going to be a subclass of {@link ParserSession}.
*
* @param input The input. See {@link #parse(Object, ClassMeta)} for supported input types.
* @param op Optional additional properties.
* @param javaMethod Java method that invoked this serializer.
- * When using the REST API, this is the Java method invoked by the REST call.
- * Can be used to access annotations defined on the method or class.
+ * When using the REST API, this is the Java method invoked by the REST call.
+ * Can be used to access annotations defined on the method or class.
* @param outer The outer object for instantiating top-level non-static inner classes.
* @param locale The session locale.
- * If <jk>null</jk>, then the locale defined on the context is used.
+ * If <jk>null</jk>, then the locale defined on the context is used.
* @param timeZone The session timezone.
- * If <jk>null</jk>, then the timezone defined on the context is used.
+ * If <jk>null</jk>, then the timezone defined on the context is used.
* @param mediaType The session media type (e.g. <js>"application/json"</js>).
* @return The new session.
*/
@@ -366,9 +366,9 @@ public abstract class Parser extends CoreApi {
/**
* Parses the contents of the specified reader and loads the results into the specified map.
* <p>
- * Reader must contain something that serializes to a map (such as text containing a JSON object).
+ * Reader must contain something that serializes to a map (such as text containing a JSON object).
* <p>
- * Used in the following locations:
+ * Used in the following locations:
* <ul class='spaced-list'>
* <li>The various character-based constructors in {@link ObjectMap} (e.g. {@link ObjectMap#ObjectMap(CharSequence,Parser)}).
* </ul>
@@ -400,7 +400,7 @@ public abstract class Parser extends CoreApi {
* Implementation method.
* Default implementation throws an {@link UnsupportedOperationException}.
* @param session The runtime session object returned by {@link #createSession(Object, ObjectMap, Method, Object, Locale, TimeZone, MediaType)}.
- * If <jk>null</jk>, one will be created using {@link #createSession(Object)}.
+ * If <jk>null</jk>, one will be created using {@link #createSession(Object)}.
* @param m The map being loaded.
* @param keyType The class type of the keys, or <jk>null</jk> to default to <code>String.<jk>class</jk></code>.<br>
* @param valueType The class type of the values, or <jk>null</jk> to default to whatever is being parsed.<br>
@@ -415,7 +415,7 @@ public abstract class Parser extends CoreApi {
/**
* Parses the contents of the specified reader and loads the results into the specified collection.
* <p>
- * Used in the following locations:
+ * Used in the following locations:
* <ul class='spaced-list'>
* <li>The various character-based constructors in {@link ObjectList} (e.g. {@link ObjectList#ObjectList(CharSequence,Parser)}.
* </ul>
@@ -445,7 +445,7 @@ public abstract class Parser extends CoreApi {
* Implementation method.
* Default implementation throws an {@link UnsupportedOperationException}.
* @param session The runtime session object returned by {@link #createSession(Object, ObjectMap, Method, Object, Locale, TimeZone, MediaType)}.
- * If <jk>null</jk>, one will be created using {@link #createSession(Object)}.
+ * If <jk>null</jk>, one will be created using {@link #createSession(Object)}.
* @param c The collection being loaded.
* @param elementType The class type of the elements, or <jk>null</jk> to default to whatever is being parsed.
*
@@ -460,10 +460,10 @@ public abstract class Parser extends CoreApi {
* Parses the specified array input with each entry in the object defined by the {@code argTypes}
* argument.
* <p>
- * Used for converting arrays (e.g. <js>"[arg1,arg2,...]"</js>) into an {@code Object[]} that can be passed
+ * Used for converting arrays (e.g. <js>"[arg1,arg2,...]"</js>) into an {@code Object[]} that can be passed
* to the {@code Method.invoke(target, args)} method.
* <p>
- * Used in the following locations:
+ * Used in the following locations:
* <ul class='spaced-list'>
* <li>Used to parse argument strings in the {@link PojoIntrospector#invokeMethod(Method, Reader)} method.
* </ul>
@@ -493,7 +493,7 @@ public abstract class Parser extends CoreApi {
* Implementation method.
* Default implementation throws an {@link UnsupportedOperationException}.
* @param session The runtime session object returned by {@link #createSession(Object, ObjectMap, Method, Object, Locale, TimeZone, MediaType)}.
- * If <jk>null</jk>, one will be created using {@link #createSession(Object)}.
+ * If <jk>null</jk>, one will be created using {@link #createSession(Object)}.
* @param argTypes Specifies the type of objects to create for each entry in the array.
*
* @return An array of parsed objects.
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/parser/ParserGroup.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/parser/ParserGroup.java b/juneau-core/src/main/java/org/apache/juneau/parser/ParserGroup.java
index 3d9fa30..f78f733 100644
--- a/juneau-core/src/main/java/org/apache/juneau/parser/ParserGroup.java
+++ b/juneau-core/src/main/java/org/apache/juneau/parser/ParserGroup.java
@@ -24,7 +24,7 @@ import org.apache.juneau.*;
*
* <h5 class='section'>Description:</h5>
* <p>
- * Provides the following features:
+ * Provides the following features:
* <ul class='spaced-list'>
* <li>Finds parsers based on HTTP <code>Content-Type</code> header values.
* <li>Sets common properties on all parsers in a single method call.
@@ -34,13 +34,13 @@ import org.apache.juneau.*;
*
* <h6 class='topic'>Match ordering</h6>
* <p>
- * Parsers are matched against <code>Content-Type</code> strings in the order they exist in this group.
+ * Parsers are matched against <code>Content-Type</code> strings in the order they exist in this group.
* <p>
- * Adding new entries will cause the entries to be prepended to the group.
- * This allows for previous parsers to be overridden through subsequent calls.
+ * Adding new entries will cause the entries to be prepended to the group.
+ * This allows for previous parsers to be overridden through subsequent calls.
* <p>
- * For example, calling <code>g.append(P1.<jk>class</jk>,P2.<jk>class</jk>).append(P3.<jk>class</jk>,P4.<jk>class</jk>)</code>
- * will result in the order <code>P3, P4, P1, P2</code>.
+ * For example, calling <code>g.append(P1.<jk>class</jk>,P2.<jk>class</jk>).append(P3.<jk>class</jk>,P4.<jk>class</jk>)</code>
+ * will result in the order <code>P3, P4, P1, P2</code>.
*
* <h5 class='section'>Example:</h5>
* <p class='bcode'>
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/parser/ParserListener.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/parser/ParserListener.java b/juneau-core/src/main/java/org/apache/juneau/parser/ParserListener.java
index 64f9371..e675f5c 100644
--- a/juneau-core/src/main/java/org/apache/juneau/parser/ParserListener.java
+++ b/juneau-core/src/main/java/org/apache/juneau/parser/ParserListener.java
@@ -17,17 +17,17 @@ import org.apache.juneau.*;
/**
* Class for listening for certain parse events during a document parse.
* <p>
- * Listeners can be registered with parsers through the {@link Parser#addListener(ParserListener)} method.
- * </p>
- * It should be noted that listeners are not automatically copied over to new parsers when a parser is cloned.
+ * Listeners can be registered with parsers through the {@link Parser#addListener(ParserListener)} method.
+ * <p>
+ * It should be noted that listeners are not automatically copied over to new parsers when a parser is cloned.
*/
public class ParserListener {
/**
* Gets called when an unknown bean property is detected in a document.
* <p>
- * This method only gets called if {@link BeanContext#BEAN_ignoreUnknownBeanProperties} setting is <jk>true</jk>.
- * Otherwise, the parser will throw a {@link ParseException}.
+ * This method only gets called if {@link BeanContext#BEAN_ignoreUnknownBeanProperties} setting is <jk>true</jk>.
+ * Otherwise, the parser will throw a {@link ParseException}.
*
* @param <T> The class type of the bean.
* @param propertyName The property name encountered in the document.
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/parser/ParserReader.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/parser/ParserReader.java b/juneau-core/src/main/java/org/apache/juneau/parser/ParserReader.java
index de3187a..fa93caa 100644
--- a/juneau-core/src/main/java/org/apache/juneau/parser/ParserReader.java
+++ b/juneau-core/src/main/java/org/apache/juneau/parser/ParserReader.java
@@ -19,12 +19,12 @@ import org.apache.juneau.internal.*;
/**
* Similar to a {@link java.io.PushbackReader} with a pushback buffer of 1 character.
* <p>
- * Code is optimized to work with a 1 character buffer.
+ * Code is optimized to work with a 1 character buffer.
* <p>
- * Additionally keeps track of current line and column number, and provides the ability to set
+ * Additionally keeps track of current line and column number, and provides the ability to set
* mark points and capture characters from the previous mark point.
* <p>
- * <b>Warning:</b> Not thread safe.
+ * <b>Warning:</b> Not thread safe.
*/
public class ParserReader extends Reader {
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/parser/ParserSession.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/parser/ParserSession.java b/juneau-core/src/main/java/org/apache/juneau/parser/ParserSession.java
index 8a4a87b..c84e6e2 100644
--- a/juneau-core/src/main/java/org/apache/juneau/parser/ParserSession.java
+++ b/juneau-core/src/main/java/org/apache/juneau/parser/ParserSession.java
@@ -44,32 +44,32 @@ public class ParserSession extends BeanSession {
* Create a new session using properties specified in the context.
*
* @param ctx The context creating this session object.
- * The context contains all the configuration settings for this object.
+ * The context contains all the configuration settings for this object.
* @param input The input.
- * <br>For character-based parsers, this can be any of the following types:
- * <ul>
- * <li><jk>null</jk>
- * <li>{@link Reader}
- * <li>{@link CharSequence}
- * <li>{@link InputStream} containing UTF-8 encoded text (or whatever the encoding specified by {@link ParserContext#PARSER_inputStreamCharset}).
- * <li><code><jk>byte</jk>[]</code> containing UTF-8 encoded text (or whatever the encoding specified by {@link ParserContext#PARSER_inputStreamCharset}).
- * <li>{@link File} containing system encoded text (or whatever the encoding specified by {@link ParserContext#PARSER_fileCharset}).
- * </ul>
- * <br>For byte-based parsers, this can be any of the following types:
- * <ul>
- * <li><jk>null</jk>
- * <li>{@link InputStream}
- * <li><code><jk>byte</jk>[]</code>
- * <li>{@link File}
- * </ul>
+ * <br>For character-based parsers, this can be any of the following types:
+ * <ul>
+ * <li><jk>null</jk>
+ * <li>{@link Reader}
+ * <li>{@link CharSequence}
+ * <li>{@link InputStream} containing UTF-8 encoded text (or whatever the encoding specified by {@link ParserContext#PARSER_inputStreamCharset}).
+ * <li><code><jk>byte</jk>[]</code> containing UTF-8 encoded text (or whatever the encoding specified by {@link ParserContext#PARSER_inputStreamCharset}).
+ * <li>{@link File} containing system encoded text (or whatever the encoding specified by {@link ParserContext#PARSER_fileCharset}).
+ * </ul>
+ * <br>For byte-based parsers, this can be any of the following types:
+ * <ul>
+ * <li><jk>null</jk>
+ * <li>{@link InputStream}
+ * <li><code><jk>byte</jk>[]</code>
+ * <li>{@link File}
+ * </ul>
* @param op The override properties.
- * These override any context properties defined in the context.
+ * These override any context properties defined in the context.
* @param javaMethod The java method that called this parser, usually the method in a REST servlet.
* @param outer The outer object for instantiating top-level non-static inner classes.
* @param locale The session locale.
- * If <jk>null</jk>, then the locale defined on the context is used.
+ * If <jk>null</jk>, then the locale defined on the context is used.
* @param timeZone The session timezone.
- * If <jk>null</jk>, then the timezone defined on the context is used.
+ * If <jk>null</jk>, then the timezone defined on the context is used.
* @param mediaType The session media type (e.g. <js>"application/json"</js>).
*/
public ParserSession(ParserContext ctx, ObjectMap op, Object input, Method javaMethod, Object outer, Locale locale, TimeZone timeZone, MediaType mediaType) {
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/parser/ReaderParser.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/parser/ReaderParser.java b/juneau-core/src/main/java/org/apache/juneau/parser/ReaderParser.java
index d0ea5b9..044038d 100644
--- a/juneau-core/src/main/java/org/apache/juneau/parser/ReaderParser.java
+++ b/juneau-core/src/main/java/org/apache/juneau/parser/ReaderParser.java
@@ -19,17 +19,17 @@ import org.apache.juneau.annotation.*;
*
* <h5 class='section'>Description:</h5>
* <p>
- * This class is typically the parent class of all character-based parsers.
- * It has 1 abstract method to implement...
+ * This class is typically the parent class of all character-based parsers.
+ * It has 1 abstract method to implement...
* <ul>
* <li><code>parse(ParserSession, ClassMeta)</code>
* </ul>
*
* <h6 class='topic'>@Consumes annotation</h6>
* <p>
- * The media types that this parser can handle is specified through the {@link Consumes @Consumes} annotation.
+ * The media types that this parser can handle is specified through the {@link Consumes @Consumes} annotation.
* <p>
- * However, the media types can also be specified programmatically by overriding the {@link #getMediaTypes()} method.
+ * However, the media types can also be specified programmatically by overriding the {@link #getMediaTypes()} method.
*/
public abstract class ReaderParser extends Parser {
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/plaintext/PlainTextParser.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/plaintext/PlainTextParser.java b/juneau-core/src/main/java/org/apache/juneau/plaintext/PlainTextParser.java
index 68d6a33..86340c7 100644
--- a/juneau-core/src/main/java/org/apache/juneau/plaintext/PlainTextParser.java
+++ b/juneau-core/src/main/java/org/apache/juneau/plaintext/PlainTextParser.java
@@ -23,20 +23,20 @@ import org.apache.juneau.transform.*;
*
* <h5 class='section'>Media types:</h5>
* <p>
- * Handles <code>Accept</code> types: <code>text/plain</code>
+ * Handles <code>Accept</code> types: <code>text/plain</code>
* <p>
- * Produces <code>Content-Type</code> types: <code>text/plain</code>
+ * Produces <code>Content-Type</code> types: <code>text/plain</code>
*
* <h5 class='section'>Description:</h5>
* <p>
- * Essentially just converts plain text to POJOs via static <code>fromString()</code> or <code>valueOf()</code>, or
+ * Essentially just converts plain text to POJOs via static <code>fromString()</code> or <code>valueOf()</code>, or
* through constructors that take a single string argument.
* <p>
- * Also parses objects using a transform if the object class has an {@link PojoSwap PojoSwap<?,String>} transform defined on it.
+ * Also parses objects using a transform if the object class has an {@link PojoSwap PojoSwap<?,String>} transform defined on it.
*
* <h5 class='section'>Configurable properties:</h5>
* <p>
- * This class has the following properties associated with it:
+ * This class has the following properties associated with it:
* <ul>
* <li>{@link ParserContext}
* </ul>
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/plaintext/PlainTextSerializer.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/plaintext/PlainTextSerializer.java b/juneau-core/src/main/java/org/apache/juneau/plaintext/PlainTextSerializer.java
index 0d04110..0cc9dcf 100644
--- a/juneau-core/src/main/java/org/apache/juneau/plaintext/PlainTextSerializer.java
+++ b/juneau-core/src/main/java/org/apache/juneau/plaintext/PlainTextSerializer.java
@@ -22,19 +22,19 @@ import org.apache.juneau.transform.*;
*
* <h5 class='section'>Media types:</h5>
* <p>
- * Handles <code>Accept</code> types: <code>text/plain</code>
+ * Handles <code>Accept</code> types: <code>text/plain</code>
* <p>
- * Produces <code>Content-Type</code> types: <code>text/plain</code>
+ * Produces <code>Content-Type</code> types: <code>text/plain</code>
*
* <h5 class='section'>Description:</h5>
* <p>
- * Essentially converts POJOs to plain text using the <code>toString()</code> method.
+ * Essentially converts POJOs to plain text using the <code>toString()</code> method.
* <p>
- * Also serializes objects using a transform if the object class has an {@link PojoSwap PojoSwap<?,String>} transform defined on it.
+ * Also serializes objects using a transform if the object class has an {@link PojoSwap PojoSwap<?,String>} transform defined on it.
*
* <h5 class='section'>Configurable properties:</h5>
* <p>
- * This class has the following properties associated with it:
+ * This class has the following properties associated with it:
* <ul>
* <li>{@link SerializerContext}
* <li>{@link BeanContext}
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/serializer/OutputStreamSerializer.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/serializer/OutputStreamSerializer.java b/juneau-core/src/main/java/org/apache/juneau/serializer/OutputStreamSerializer.java
index 0901c14..1c2a2d2 100644
--- a/juneau-core/src/main/java/org/apache/juneau/serializer/OutputStreamSerializer.java
+++ b/juneau-core/src/main/java/org/apache/juneau/serializer/OutputStreamSerializer.java
@@ -22,18 +22,18 @@ import org.apache.juneau.internal.*;
*
* <h5 class='section'>Description:</h5>
* <p>
- * This class is typically the parent class of all byte-based serializers.
- * It has 1 abstract method to implement...
+ * This class is typically the parent class of all byte-based serializers.
+ * It has 1 abstract method to implement...
* <ul>
* <li>{@link #doSerialize(SerializerSession, Object)}
* </ul>
*
* <h6 class='topic'>@Produces annotation</h6>
* <p>
- * The media types that this serializer can produce is specified through the {@link Produces @Produces} annotation.
+ * The media types that this serializer can produce is specified through the {@link Produces @Produces} annotation.
* <p>
- * However, the media types can also be specified programmatically by overriding the {@link #getMediaTypes()}
- * and {@link #getResponseContentType()} methods.
+ * However, the media types can also be specified programmatically by overriding the {@link #getMediaTypes()}
+ * and {@link #getResponseContentType()} methods.
*/
public abstract class OutputStreamSerializer extends Serializer {
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/serializer/Serializer.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/serializer/Serializer.java b/juneau-core/src/main/java/org/apache/juneau/serializer/Serializer.java
index 313ff47..abd00f5 100644
--- a/juneau-core/src/main/java/org/apache/juneau/serializer/Serializer.java
+++ b/juneau-core/src/main/java/org/apache/juneau/serializer/Serializer.java
@@ -29,19 +29,19 @@ import org.apache.juneau.soap.*;
*
* <h5 class='section'>Description:</h5>
* <p>
- * Base serializer class that serves as the parent class for all serializers.
+ * Base serializer class that serves as the parent class for all serializers.
* <p>
- * Subclasses should extend directly from {@link OutputStreamSerializer} or {@link WriterSerializer}.
+ * Subclasses should extend directly from {@link OutputStreamSerializer} or {@link WriterSerializer}.
*
* <h6 class='topic'>@Produces annotation</h6>
* <p>
- * The media types that this serializer can produce is specified through the {@link Produces @Produces} annotation.
+ * The media types that this serializer can produce is specified through the {@link Produces @Produces} annotation.
* <p>
- * However, the media types can also be specified programmatically by overriding the {@link #getMediaTypes()}
- * and {@link #getResponseContentType()} methods.
+ * However, the media types can also be specified programmatically by overriding the {@link #getMediaTypes()}
+ * and {@link #getResponseContentType()} methods.
*
* <h5 class='section'>Configurable properties:</h5>
- * See {@link SerializerContext} for a list of configurable properties that can be set on this class
+ * See {@link SerializerContext} for a list of configurable properties that can be set on this class
* using the {@link #setProperty(String, Object)} method.
*/
public abstract class Serializer extends CoreApi {
@@ -81,7 +81,7 @@ public abstract class Serializer extends CoreApi {
* <p>
* This method should NOT close the context object.
* @param session The serializer session object return by {@link #createSession(Object, ObjectMap, Method, Locale, TimeZone, MediaType)}.<br>
- * If <jk>null</jk>, session is created using {@link #createSession(Object)}.
+ * If <jk>null</jk>, session is created using {@link #createSession(Object)}.
* @param o The object to serialize.
*
* @throws Exception If thrown from underlying stream, or if the input contains a syntax error or is malformed.
@@ -109,7 +109,7 @@ public abstract class Serializer extends CoreApi {
* Serialize the specified object using the specified session.
*
* @param session The serializer session object return by {@link #createSession(Object, ObjectMap, Method, Locale, TimeZone, MediaType)}.<br>
- * If <jk>null</jk>, session is created using {@link #createSession(Object)}.
+ * If <jk>null</jk>, session is created using {@link #createSession(Object)}.
* @param o The object to serialize.
* @throws SerializeException If a problem occurred trying to convert the output.
*/
@@ -155,7 +155,7 @@ public abstract class Serializer extends CoreApi {
/**
* Create the session object that will be passed in to the serialize method.
* <p>
- * It's up to implementers to decide what the session object looks like, although typically
+ * It's up to implementers to decide what the session object looks like, although typically
* it's going to be a subclass of {@link SerializerSession}.
*
* @param output The output object.
@@ -172,12 +172,12 @@ public abstract class Serializer extends CoreApi {
* </ul>
* @param op Optional additional properties.
* @param javaMethod Java method that invoked this serializer.
- * When using the REST API, this is the Java method invoked by the REST call.
- * Can be used to access annotations defined on the method or class.
+ * When using the REST API, this is the Java method invoked by the REST call.
+ * Can be used to access annotations defined on the method or class.
* @param locale The session locale.
- * If <jk>null</jk>, then the locale defined on the context is used.
+ * If <jk>null</jk>, then the locale defined on the context is used.
* @param timeZone The session timezone.
- * If <jk>null</jk>, then the timezone defined on the context is used.
+ * If <jk>null</jk>, then the timezone defined on the context is used.
* @param mediaType The session media type (e.g. <js>"application/json"</js>).
* @return The new session.
*/
@@ -211,9 +211,9 @@ public abstract class Serializer extends CoreApi {
/**
* Converts the contents of the specified object array to a list.
* <p>
- * Works on both object and primitive arrays.
+ * Works on both object and primitive arrays.
* <p>
- * In the case of multi-dimensional arrays, the outgoing list will
+ * In the case of multi-dimensional arrays, the outgoing list will
* contain elements of type n-1 dimension. i.e. if {@code type} is <code><jk>int</jk>[][]</code>
* then {@code list} will have entries of type <code><jk>int</jk>[]</code>.
*
@@ -256,14 +256,14 @@ public abstract class Serializer extends CoreApi {
/**
* Optional method that specifies HTTP request headers for this serializer.
* <p>
- * For example, {@link SoapXmlSerializer} needs to set a <code>SOAPAction</code> header.
+ * For example, {@link SoapXmlSerializer} needs to set a <code>SOAPAction</code> header.
* <p>
- * This method is typically meaningless if the serializer is being used standalone (i.e. outside of a REST server or client).
+ * This method is typically meaningless if the serializer is being used standalone (i.e. outside of a REST server or client).
*
* @param properties Optional run-time properties (the same that are passed to {@link WriterSerializer#doSerialize(SerializerSession, Object)}.
- * Can be <jk>null</jk>.
+ * Can be <jk>null</jk>.
* @return The HTTP headers to set on HTTP requests.
- * Can be <jk>null</jk>.
+ * Can be <jk>null</jk>.
*/
public ObjectMap getResponseHeaders(ObjectMap properties) {
return ObjectMap.EMPTY_MAP;
@@ -272,12 +272,12 @@ public abstract class Serializer extends CoreApi {
/**
* Optional method that returns the response <code>Content-Type</code> for this serializer if it is different from the matched media type.
* <p>
- * This method is specified to override the content type for this serializer.
- * For example, the {@link org.apache.juneau.json.JsonSerializer.Simple} class returns that it handles media type <js>"text/json+simple"</js>, but returns
+ * This method is specified to override the content type for this serializer.
+ * For example, the {@link org.apache.juneau.json.JsonSerializer.Simple} class returns that it handles media type <js>"text/json+simple"</js>, but returns
* <js>"text/json"</js> as the actual content type.
- * This allows clients to request specific 'flavors' of content using specialized <code>Accept</code> header values.
+ * This allows clients to request specific 'flavors' of content using specialized <code>Accept</code> header values.
* <p>
- * This method is typically meaningless if the serializer is being used standalone (i.e. outside of a REST server or client).
+ * This method is typically meaningless if the serializer is being used standalone (i.e. outside of a REST server or client).
*
* @return The response content type. If <jk>null</jk>, then the matched media type is used.
*/
@@ -570,7 +570,7 @@ public abstract class Serializer extends CoreApi {
* <ul>
* <li>This is equivalent to calling <code>setProperty(<jsf>SERIALIZER_trimEmptyMaps</jsf>, value)</code>.
* <li>Enabling this setting has the following effects on parsing:
- * <ul>
+ * <ul>
* <li>Bean properties with empty map values will not be set.
* </ul>
* </ul>
@@ -626,7 +626,7 @@ public abstract class Serializer extends CoreApi {
*
* <h5 class='section'>Example:</h5>
* <table class='styled'>
- * <tr><th>SERIALIZER_relativeUriBase</th><th>URI</th><th>Serialized URI</th></tr>
+ * <tr><th>SERIALIZER_relativeUriBase</th><th>URI</th><th>Serialized URI</th></tr>
* <tr>
* <td><code>http://foo:9080/bar/baz</code></td>
* <td><code>mywebapp</code></td>
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/serializer/SerializerContext.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/serializer/SerializerContext.java b/juneau-core/src/main/java/org/apache/juneau/serializer/SerializerContext.java
index 38fdfef..ba93403 100644
--- a/juneau-core/src/main/java/org/apache/juneau/serializer/SerializerContext.java
+++ b/juneau-core/src/main/java/org/apache/juneau/serializer/SerializerContext.java
@@ -153,7 +153,7 @@ public class SerializerContext extends BeanContext {
* <p>
* If <jk>true</jk>, null bean values will not be serialized to the output.
* <p>
- * Note that enabling this setting has the following effects on parsing:
+ * Note that enabling this setting has the following effects on parsing:
* <ul class='spaced-list'>
* <li>Map entries with <jk>null</jk> values will be lost.
* </ul>
@@ -193,7 +193,7 @@ public class SerializerContext extends BeanContext {
* If <jk>true</jk>, empty map values will not be serialized to the output.
* <p>
* Note that enabling this setting has the following effects on parsing:
- * <ul class='spaced-list'>
+ * <ul class='spaced-list'>
* <li>Bean properties with empty map values will not be set.
* </ul>
*/
@@ -229,7 +229,7 @@ public class SerializerContext extends BeanContext {
*
* <h5 class='section'>Example:</h5>
* <table class='styled'>
- * <tr><th>SERIALIZER_relativeUriBase</th><th>URI</th><th>Serialized URI</th></tr>
+ * <tr><th>SERIALIZER_relativeUriBase</th><th>URI</th><th>Serialized URI</th></tr>
* <tr>
* <td><code>http://foo:9080/bar/baz</code></td>
* <td><code>mywebapp</code></td>
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/serializer/SerializerGroup.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/serializer/SerializerGroup.java b/juneau-core/src/main/java/org/apache/juneau/serializer/SerializerGroup.java
index d2d6847..24df1f5 100644
--- a/juneau-core/src/main/java/org/apache/juneau/serializer/SerializerGroup.java
+++ b/juneau-core/src/main/java/org/apache/juneau/serializer/SerializerGroup.java
@@ -24,7 +24,7 @@ import org.apache.juneau.*;
*
* <h5 class='section'>Description:</h5>
* <p>
- * Provides the following features:
+ * Provides the following features:
* <ul class='spaced-list'>
* <li>Finds serializers based on HTTP <code>Accept</code> header values.
* <li>Sets common properties on all serializers in a single method call.
@@ -34,13 +34,13 @@ import org.apache.juneau.*;
*
* <h6 class='topic'>Match ordering</h6>
* <p>
- * Serializers are matched against <code>Accept</code> strings in the order they exist in this group.
+ * Serializers are matched against <code>Accept</code> strings in the order they exist in this group.
* <p>
- * Adding new entries will cause the entries to be prepended to the group.
- * This allows for previous serializers to be overridden through subsequent calls.
+ * Adding new entries will cause the entries to be prepended to the group.
+ * This allows for previous serializers to be overridden through subsequent calls.
* <p>
- * For example, calling <code>g.append(S1.<jk>class</jk>,S2.<jk>class</jk>).append(S3.<jk>class</jk>,S4.<jk>class</jk>)</code>
- * will result in the order <code>S3, S4, S1, S2</code>.
+ * For example, calling <code>g.append(S1.<jk>class</jk>,S2.<jk>class</jk>).append(S3.<jk>class</jk>,S4.<jk>class</jk>)</code>
+ * will result in the order <code>S3, S4, S1, S2</code>.
*
* <h5 class='section'>Example:</h5>
* <p class='bcode'>
@@ -131,7 +131,7 @@ public final class SerializerGroup extends Lockable {
/**
* Searches the group for a serializer that can handle the specified <code>Accept</code> value.
* <p>
- * The <code>accept</code> value complies with the syntax described in RFC2616, Section 14.1, as described below:
+ * The <code>accept</code> value complies with the syntax described in RFC2616, Section 14.1, as described below:
* <p class='bcode'>
* Accept = "Accept" ":"
* #( media-range [ accept-params ] )
@@ -144,16 +144,16 @@ public final class SerializerGroup extends Lockable {
* accept-extension = ";" token [ "=" ( token | quoted-string ) ]
* </p>
* <p>
- * The general idea behind having the serializer resolution be a two-step process is so that
+ * The general idea behind having the serializer resolution be a two-step process is so that
* the matched media type can be passed in to the {@link WriterSerializer#doSerialize(SerializerSession, Object)} method.
- * For example...
+ * For example...
* <p class='bcode'>
* String acceptHeaderValue = request.getHeader(<js>"Accept"</js>);
* String matchingMediaType = group.findMatch(acceptHeaderValue);
* if (matchingMediaType == <jk>null</jk>)
* <jk>throw new</jk> RestException(<jsf>SC_NOT_ACCEPTABLE</jsf>);
* WriterSerializer s = (WriterSerializer)group.getSerializer(matchingMediaType);
- * s.serialize(getPojo(), response.getWriter(), response.getProperties(), matchingMediaType);
+ * s.serialize(getPojo(), response.getWriter(), response.getProperties(), matchingMediaType);
* </p>
*
* @param acceptHeader The HTTP <l>Accept</l> header string.
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/serializer/SerializerSession.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/serializer/SerializerSession.java b/juneau-core/src/main/java/org/apache/juneau/serializer/SerializerSession.java
index 69b6b26..34477b7 100644
--- a/juneau-core/src/main/java/org/apache/juneau/serializer/SerializerSession.java
+++ b/juneau-core/src/main/java/org/apache/juneau/serializer/SerializerSession.java
@@ -71,26 +71,26 @@ public class SerializerSession extends BeanSession {
* Create a new session using properties specified in the context.
*
* @param ctx The context creating this session object.
- * The context contains all the configuration settings for this object.
+ * The context contains all the configuration settings for this object.
* @param output The output object.
- * <br>Character-based serializers can handle the following output class types:
- * <ul>
- * <li>{@link Writer}
- * <li>{@link OutputStream} - Output will be written as UTF-8 encoded stream.
- * <li>{@link File} - Output will be written as system-default encoded stream.
- * </ul>
- * <br>Stream-based serializers can handle the following output class types:
- * <ul>
- * <li>{@link OutputStream}
- * <li>{@link File}
- * </ul>
+ * <br>Character-based serializers can handle the following output class types:
+ * <ul>
+ * <li>{@link Writer}
+ * <li>{@link OutputStream} - Output will be written as UTF-8 encoded stream.
+ * <li>{@link File} - Output will be written as system-default encoded stream.
+ * </ul>
+ * <br>Stream-based serializers can handle the following output class types:
+ * <ul>
+ * <li>{@link OutputStream}
+ * <li>{@link File}
+ * </ul>
* @param op The override properties.
- * These override any context properties defined in the context.
+ * These override any context properties defined in the context.
* @param javaMethod The java method that called this parser, usually the method in a REST servlet.
* @param locale The session locale.
- * If <jk>null</jk>, then the locale defined on the context is used.
+ * If <jk>null</jk>, then the locale defined on the context is used.
* @param timeZone The session timezone.
- * If <jk>null</jk>, then the timezone defined on the context is used.
+ * If <jk>null</jk>, then the timezone defined on the context is used.
* @param mediaType The session media type (e.g. <js>"application/json"</js>).
*/
public SerializerSession(SerializerContext ctx, ObjectMap op, Object output, Method javaMethod, Locale locale, TimeZone timeZone, MediaType mediaType) {
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/serializer/SerializerWriter.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/serializer/SerializerWriter.java b/juneau-core/src/main/java/org/apache/juneau/serializer/SerializerWriter.java
index 1e6272b..4d1b75a 100644
--- a/juneau-core/src/main/java/org/apache/juneau/serializer/SerializerWriter.java
+++ b/juneau-core/src/main/java/org/apache/juneau/serializer/SerializerWriter.java
@@ -68,7 +68,7 @@ public class SerializerWriter extends Writer {
/**
* Performs a carriage return.
* <p>
- * Adds a newline and the specified number of tabs (if the {@code useWhitespace} setting is enabled) to the output.
+ * Adds a newline and the specified number of tabs (if the {@code useWhitespace} setting is enabled) to the output.
*
* @param depth The indentation.
* @throws IOException If a problem occurred trying to write to the writer.
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/serializer/WriterSerializer.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/serializer/WriterSerializer.java b/juneau-core/src/main/java/org/apache/juneau/serializer/WriterSerializer.java
index 8a38a88..aefcb6e 100644
--- a/juneau-core/src/main/java/org/apache/juneau/serializer/WriterSerializer.java
+++ b/juneau-core/src/main/java/org/apache/juneau/serializer/WriterSerializer.java
@@ -24,8 +24,8 @@ import org.apache.juneau.annotation.*;
*
* <h5 class='section'>Description:</h5>
* <p>
- * This class is typically the parent class of all character-based serializers.
- * It has 2 abstract methods to implement...
+ * This class is typically the parent class of all character-based serializers.
+ * It has 2 abstract methods to implement...
* <ul class='spaced-list'>
* <li>{@link #createSession(Object, ObjectMap, Method, Locale, TimeZone, MediaType)}
* <li>{@link #doSerialize(SerializerSession, Object)}
@@ -33,10 +33,10 @@ import org.apache.juneau.annotation.*;
*
* <h6 class='topic'>@Produces annotation</h6>
* <p>
- * The media types that this serializer can produce is specified through the {@link Produces @Produces} annotation.
+ * The media types that this serializer can produce is specified through the {@link Produces @Produces} annotation.
* <p>
- * However, the media types can also be specified programmatically by overriding the {@link #getMediaTypes()}
- * and {@link #getResponseContentType()} methods.
+ * However, the media types can also be specified programmatically by overriding the {@link #getMediaTypes()}
+ * and {@link #getResponseContentType()} methods.
*/
public abstract class WriterSerializer extends Serializer {
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/soap/SoapXmlSerializer.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/soap/SoapXmlSerializer.java b/juneau-core/src/main/java/org/apache/juneau/soap/SoapXmlSerializer.java
index c32dd80..a3a94b5 100644
--- a/juneau-core/src/main/java/org/apache/juneau/soap/SoapXmlSerializer.java
+++ b/juneau-core/src/main/java/org/apache/juneau/soap/SoapXmlSerializer.java
@@ -24,17 +24,17 @@ import org.apache.juneau.xml.*;
*
* <h5 class='section'>Media types:</h5>
* <p>
- * Handles <code>Accept</code> types: <code>text/xml+soap</code>
+ * Handles <code>Accept</code> types: <code>text/xml+soap</code>
* <p>
- * Produces <code>Content-Type</code> types: <code>text/xml+soap</code>
+ * Produces <code>Content-Type</code> types: <code>text/xml+soap</code>
*
* <h5 class='section'>Description:</h5>
* <p>
- * Essentially the same output as {@link XmlDocSerializer}, except wrapped in a standard SOAP envelope.
+ * Essentially the same output as {@link XmlDocSerializer}, except wrapped in a standard SOAP envelope.
*
* <h5 class='section'>Configurable properties:</h5>
* <p>
- * This class has the following properties associated with it:
+ * This class has the following properties associated with it:
* <ul>
* <li>{@link SoapXmlSerializerContext}
* <li>{@link BeanContext}
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/svl/VarResolver.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/svl/VarResolver.java b/juneau-core/src/main/java/org/apache/juneau/svl/VarResolver.java
index c6514fa..55ef915 100644
--- a/juneau-core/src/main/java/org/apache/juneau/svl/VarResolver.java
+++ b/juneau-core/src/main/java/org/apache/juneau/svl/VarResolver.java
@@ -43,7 +43,7 @@ import org.apache.juneau.svl.vars.*;
*
* <ja>@Override</ja>
* <jk>public</jk> String resolve(VarResolverSession session, String varVal) {
- * <jk>return</jk> System.<jsm>getProperty</jsm>(varVal);
+ * <jk>return</jk> System.<jsm>getProperty</jsm>(varVal);
* }
* }
*
@@ -119,7 +119,7 @@ public class VarResolver extends CoreApi {
* Register new variables with this resolver.
*
* @param vars The variable resolver classes.
- * These classes must subclass from {@link Var} and have no-arg constructors.
+ * These classes must subclass from {@link Var} and have no-arg constructors.
* @return This object (for method chaining).
*/
public VarResolver addVars(Class<?>...vars) {
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/svl/VarResolverContext.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/svl/VarResolverContext.java b/juneau-core/src/main/java/org/apache/juneau/svl/VarResolverContext.java
index fb368d4..2767154 100644
--- a/juneau-core/src/main/java/org/apache/juneau/svl/VarResolverContext.java
+++ b/juneau-core/src/main/java/org/apache/juneau/svl/VarResolverContext.java
@@ -20,8 +20,8 @@ import org.apache.juneau.internal.*;
/**
* Configurable properties on the {@link VarResolver} class.
- * <p>
- * Used to associate {@link Var Vars} and context objects with {@link VarResolver VarResolvers}.
+ * <p>
+ * Used to associate {@link Var Vars} and context objects with {@link VarResolver VarResolvers}.
* <p>
* See {@link ContextFactory} for more information about context properties.
*
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/svl/VarResolverSession.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/svl/VarResolverSession.java b/juneau-core/src/main/java/org/apache/juneau/svl/VarResolverSession.java
index e357584..419fd2a 100644
--- a/juneau-core/src/main/java/org/apache/juneau/svl/VarResolverSession.java
+++ b/juneau-core/src/main/java/org/apache/juneau/svl/VarResolverSession.java
@@ -68,7 +68,7 @@ public class VarResolverSession extends Session {
*
* @param s The string to resolve variables in.
* @return The new string with all variables resolved, or the same string if no variables were found.
- * Null input results in a blank string.
+ * Null input results in a blank string.
*/
public String resolve(String s) {
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/transform/BeanFilter.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/transform/BeanFilter.java b/juneau-core/src/main/java/org/apache/juneau/transform/BeanFilter.java
index 3817910..91ad7b1 100644
--- a/juneau-core/src/main/java/org/apache/juneau/transform/BeanFilter.java
+++ b/juneau-core/src/main/java/org/apache/juneau/transform/BeanFilter.java
@@ -19,11 +19,11 @@ import org.apache.juneau.internal.*;
/**
* Parent class for all bean filters.
* <p>
- * Bean filters are used to control aspects of how beans are handled during serialization and parsing.
+ * Bean filters are used to control aspects of how beans are handled during serialization and parsing.
* <p>
- * This class can be considered a programmatic equivalent to using the {@link Bean @Bean} annotation on bean classes.
- * Thus, it can be used to perform the same function as the <code>@Bean</code> annotation when you don't have
- * the ability to annotate those classes (e.g. you don't have access to the source code).
+ * This class can be considered a programmatic equivalent to using the {@link Bean @Bean} annotation on bean classes.
+ * Thus, it can be used to perform the same function as the <code>@Bean</code> annotation when you don't have
+ * the ability to annotate those classes (e.g. you don't have access to the source code).
*/
public class BeanFilter {
@@ -87,8 +87,8 @@ public class BeanFilter {
/**
* Returns <jk>true</jk> if the properties defined on this bean class should be ordered alphabetically.
* <p>
- * This method is only used when the {@link #getProperties()} method returns <jk>null</jk>.
- * Otherwise, the ordering of the properties in the returned value is used.
+ * This method is only used when the {@link #getProperties()} method returns <jk>null</jk>.
+ * Otherwise, the ordering of the properties in the returned value is used.
*
* @return <jk>true</jk> if bean properties should be sorted.
*/
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/transform/BeanFilterBuilder.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/transform/BeanFilterBuilder.java b/juneau-core/src/main/java/org/apache/juneau/transform/BeanFilterBuilder.java
index c579ae6..b44da60 100644
--- a/juneau-core/src/main/java/org/apache/juneau/transform/BeanFilterBuilder.java
+++ b/juneau-core/src/main/java/org/apache/juneau/transform/BeanFilterBuilder.java
@@ -20,8 +20,8 @@ import org.apache.juneau.*;
/**
* Builder class for {@link BeanFilter} objects.
* <p>
- * Bean filter builders must have a public no-arg constructor.
- * Builder settings should be set in the constructor using the provided setters on this class.
+ * Bean filter builders must have a public no-arg constructor.
+ * Builder settings should be set in the constructor using the provided setters on this class.
*
* <h5 class='section'>Example:</h5>
* <p class='bcode'>
@@ -126,7 +126,7 @@ public abstract class BeanFilterBuilder {
* String r = s.serialize(a1);
* <jsm>assertEquals</jsm>(<js>"{f0:'f0'}"</js>, r); <jc>// Note f1 is not serialized</jc>
* </p>
- * <p>
+ * <p>
* Note that this filter can be used on the parent class so that it filters to all child classes,
* or can be set individually on the child classes.
*
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/transform/InterfaceBeanFilterBuilder.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/transform/InterfaceBeanFilterBuilder.java b/juneau-core/src/main/java/org/apache/juneau/transform/InterfaceBeanFilterBuilder.java
index f3032f8..0ccafaf 100644
--- a/juneau-core/src/main/java/org/apache/juneau/transform/InterfaceBeanFilterBuilder.java
+++ b/juneau-core/src/main/java/org/apache/juneau/transform/InterfaceBeanFilterBuilder.java
@@ -18,8 +18,8 @@ import org.apache.juneau.*;
* Simple bean filter that simply identifies a class to be used as an interface
* class for all child classes.
* <p>
- * These objects are created when you pass in non-<code>BeanFilterBuilder</code> classes to {@link ContextFactory#addToProperty(String,Object)},
- * and are equivalent to adding a <code><ja>@Bean</ja>(interfaceClass=Foo.<jk>class</jk>)</code> annotation on the <code>Foo</code> class.
+ * These objects are created when you pass in non-<code>BeanFilterBuilder</code> classes to {@link ContextFactory#addToProperty(String,Object)},
+ * and are equivalent to adding a <code><ja>@Bean</ja>(interfaceClass=Foo.<jk>class</jk>)</code> annotation on the <code>Foo</code> class.
*/
public class InterfaceBeanFilterBuilder extends BeanFilterBuilder {
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/transform/PojoSwap.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/transform/PojoSwap.java b/juneau-core/src/main/java/org/apache/juneau/transform/PojoSwap.java
index fdcd3bd..7c36e7b 100644
--- a/juneau-core/src/main/java/org/apache/juneau/transform/PojoSwap.java
+++ b/juneau-core/src/main/java/org/apache/juneau/transform/PojoSwap.java
@@ -30,58 +30,58 @@ import org.apache.juneau.serializer.*;
* parser, you can convert a {@code Date} object to a {@code String} during serialization, and convert that {@code String} object back into
* a {@code Date} object during parsing.
* <p>
- * Swaps MUST declare a public no-arg constructor so that the bean context can instantiate them.
+ * Swaps MUST declare a public no-arg constructor so that the bean context can instantiate them.
* <p>
* <code>PojoSwaps</code> are associated with instances of {@link BeanContext BeanContexts} by passing the swap class to
* the {@link CoreApi#addPojoSwaps(Class...)} method.<br>
- * When associated with a bean context, fields of the specified type will automatically be converted when the
+ * When associated with a bean context, fields of the specified type will automatically be converted when the
* {@link BeanMap#get(Object)} or {@link BeanMap#put(String, Object)} methods are called.<br>
* <p>
- * <code>PojoSwaps</code> have two parameters:
- * <ol>
- * <li>{@code <T>} - The normal representation of an object.
- * <li>{@code <S>} - The swapped representation of an object.
- * </ol>
- * <br>
- * {@link Serializer Serializers} use swaps to convert objects of type T into objects of type S, and on calls to {@link BeanMap#get(Object)}.<br>
- * {@link Parser Parsers} use swaps to convert objects of type S into objects of type T, and on calls to {@link BeanMap#put(String,Object)}.
+ * <code>PojoSwaps</code> have two parameters:
+ * <ol>
+ * <li>{@code <T>} - The normal representation of an object.
+ * <li>{@code <S>} - The swapped representation of an object.
+ * </ol>
+ * <br>
+ * {@link Serializer Serializers} use swaps to convert objects of type T into objects of type S, and on calls to {@link BeanMap#get(Object)}.<br>
+ * {@link Parser Parsers} use swaps to convert objects of type S into objects of type T, and on calls to {@link BeanMap#put(String,Object)}.
*
* <h6 class='topic'>Subtypes</h6>
* <p>
- * The following abstract subclasses are provided for common swap types:
- * <ol>
- * <li>{@link StringSwap} - Objects swapped with strings.
- * <li>{@link MapSwap} - Objects swapped with {@link ObjectMap ObjectMaps}.
- * </ol>
+ * The following abstract subclasses are provided for common swap types:
+ * <ol>
+ * <li>{@link StringSwap} - Objects swapped with strings.
+ * <li>{@link MapSwap} - Objects swapped with {@link ObjectMap ObjectMaps}.
+ * </ol>
*
* <h6 class='topic'>Localization</h6>
* <p>
- * Swaps have access to the session locale and timezone through the {@link BeanSession#getLocale()} and {@link BeanSession#getTimeZone()}
+ * Swaps have access to the session locale and timezone through the {@link BeanSession#getLocale()} and {@link BeanSession#getTimeZone()}
* methods. This allows you to specify localized swap values when needed.
- * If using the REST server API, the locale and timezone are set based on the <code>Accept-Language</code> and <code>Time-Zone</code> headers
+ * If using the REST server API, the locale and timezone are set based on the <code>Accept-Language</code> and <code>Time-Zone</code> headers
* on the request.
*
* <h6 class='topic'>Swap Class Type {@code <S>}</h6>
* <p>
- * The swapped object representation of an object must be an object type that the serializers can
+ * The swapped object representation of an object must be an object type that the serializers can
* natively convert to JSON (or language-specific equivalent). The list of valid transformed types are as follows...
- * <ul class='spaced-list'>
- * <li>{@link String}
- * <li>{@link Number}
- * <li>{@link Boolean}
- * <li>{@link Collection} containing anything on this list.
- * <li>{@link Map} containing anything on this list.
- * <li>A java bean with properties of anything on this list.
- * <li>An array of anything on this list.
- * </ul>
+ * <ul class='spaced-list'>
+ * <li>{@link String}
+ * <li>{@link Number}
+ * <li>{@link Boolean}
+ * <li>{@link Collection} containing anything on this list.
+ * <li>{@link Map} containing anything on this list.
+ * <li>A java bean with properties of anything on this list.
+ * <li>An array of anything on this list.
+ * </ul>
*
* <h6 class='topic'>Normal Class Type {@code <T>}</h6>
* <p>
- * The normal object representation of an object.<br>
+ * The normal object representation of an object.<br>
*
* <h6 class='topic'>One-way vs. Two-way Serialization</h6>
* <p>
- * Note that while there is a unified interface for handling swaps during both serialization and parsing,
+ * Note that while there is a unified interface for handling swaps during both serialization and parsing,
* in many cases only one of the {@link #swap(BeanSession, Object)} or {@link #unswap(BeanSession, Object, ClassMeta)} methods will be defined
* because the swap is one-way. For example, a swap may be defined to convert an {@code Iterator} to a {@code ObjectList}, but
* it's not possible to unswap an {@code Iterator}. In that case, the {@code swap(Object}} method would
@@ -131,18 +131,18 @@ public abstract class PojoSwap<T,S> {
/**
* If this transform is to be used to serialize non-serializable POJOs, it must implement this method.
* <p>
- * The object must be converted into one of the following serializable types:
- * <ul class='spaced-list'>
- * <li>{@link String}
- * <li>{@link Number}
- * <li>{@link Boolean}
- * <li>{@link Collection} containing anything on this list.
- * <li>{@link Map} containing anything on this list.
- * <li>A java bean with properties of anything on this list.
- * <li>An array of anything on this list.
- * </ul>
+ * The object must be converted into one of the following serializable types:
+ * <ul class='spaced-list'>
+ * <li>{@link String}
+ * <li>{@link Number}
+ * <li>{@link Boolean}
+ * <li>{@link Collection} containing anything on this list.
+ * <li>{@link Map} containing anything on this list.
+ * <li>A java bean with properties of anything on this list.
+ * <li>An array of anything on this list.
+ * </ul>
* @param session The bean session to use to get the class meta.
- * This is always going to be the same bean context that created this swap.
+ * This is always going to be the same bean context that created this swap.
* @param o The object to be transformed.
*
* @return The transformed object.
@@ -155,11 +155,11 @@ public abstract class PojoSwap<T,S> {
/**
* If this transform is to be used to reconstitute POJOs that aren't true Java beans, it must implement this method.
* @param session The bean session to use to get the class meta.
- * This is always going to be the same bean context that created this swap.
+ * This is always going to be the same bean context that created this swap.
* @param f The transformed object.
* @param hint If possible, the parser will try to tell you the object type being created. For example,
* on a serialized date, this may tell you that the object being created must be of type {@code GregorianCalendar}.<br>
- * This may be <jk>null</jk> if the parser cannot make this determination.
+ * This may be <jk>null</jk> if the parser cannot make this determination.
*
* @return The narrowed object.
* @throws ParseException If this method is not implemented.
@@ -180,7 +180,7 @@ public abstract class PojoSwap<T,S> {
/**
* Returns the G class, the generialized form of the class.
* <p>
- * Subclasses must override this method if the generialized class is {@code Object},
+ * Subclasses must override this method if the generialized class is {@code Object},
* meaning it can produce multiple generialized forms.
*
* @return The transformed form of this class.
@@ -194,7 +194,7 @@ public abstract class PojoSwap<T,S> {
* This value is cached for quick lookup.
*
* @param beanContext The bean context to use to get the class meta.
- * This is always going to be the same bean context that created this swap.
+ * This is always going to be the same bean context that created this swap.
* @return The {@link ClassMeta} of the transformed class type.
*/
public ClassMeta<?> getSwapClassMeta(BeanContext beanContext) {
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/transforms/BeanStringSwap.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/transforms/BeanStringSwap.java b/juneau-core/src/main/java/org/apache/juneau/transforms/BeanStringSwap.java
index c7d1c67..f438551 100644
--- a/juneau-core/src/main/java/org/apache/juneau/transforms/BeanStringSwap.java
+++ b/juneau-core/src/main/java/org/apache/juneau/transforms/BeanStringSwap.java
@@ -18,11 +18,11 @@ import org.apache.juneau.transform.*;
/**
* Transforms beans into {@link String Strings} by simply calling the {@link Object#toString()} method.
* <p>
- * Allows you to specify classes that should just be converted to {@code Strings} instead of potentially
+ * Allows you to specify classes that should just be converted to {@code Strings} instead of potentially
* being turned into Maps by the {@link BeanContext} (or worse, throwing {@link BeanRuntimeException BeanRuntimeExceptions}).
* <p>
- * This is usually a one-way transform.
- * Beans serialized as strings cannot be reconstituted using a parser unless it is a <a class="doclink" href="../../../../overview-summary.html#Core.PojoCategories">Type 5 POJO</a>.
+ * This is usually a one-way transform.
+ * Beans serialized as strings cannot be reconstituted using a parser unless it is a <a class="doclink" href="../../../../overview-summary.html#Core.PojoCategories">Type 5 POJO</a>.
*
* @param <T> The class type of the bean.
*/
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/transforms/CalendarSwap.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/transforms/CalendarSwap.java b/juneau-core/src/main/java/org/apache/juneau/transforms/CalendarSwap.java
index a4bf22c..2b180c2 100644
--- a/juneau-core/src/main/java/org/apache/juneau/transforms/CalendarSwap.java
+++ b/juneau-core/src/main/java/org/apache/juneau/transforms/CalendarSwap.java
@@ -27,7 +27,7 @@ import org.apache.juneau.transform.*;
*
* <h6 class='topic'>Behavior-specific subclasses</h6>
* <p>
- * The following direct subclasses are provided for convenience to the following formats:
+ * The following direct subclasses are provided for convenience to the following formats:
* <ul class='spaced-list'>
* <li>{@link ToString} - To {@link String Strings} using the {@code Date.toString()} method.
* <li>{@link ISO8601DT} - To ISO8601 date-time strings.
@@ -67,13 +67,13 @@ public class CalendarSwap extends StringSwap<Calendar> {
* Only one of the <code>pattern</code> or <code>style</code> parameters should
*
* @param pattern The {@link SimpleDateFormat} pattern.
- * If <jk>null</jk>, <code>style</code> is used instead.
+ * If <jk>null</jk>, <code>style</code> is used instead.
* @param dateStyle The {@link DateFormat} date style (e.g. {@link DateFormat#SHORT}).
- * Ignored if <code>pattern</code> is not <jk>null</jk>.
- * Ignored if <code>-1</code>.
+ * Ignored if <code>pattern</code> is not <jk>null</jk>.
+ * Ignored if <code>-1</code>.
* @param timeStyle The {@link DateFormat} time style (e.g. {@link DateFormat#SHORT}).
- * Ignored if <code>pattern</code> is not <jk>null</jk>.
- * Ignored if <code>-1</code>.
+ * Ignored if <code>pattern</code> is not <jk>null</jk>.
+ * Ignored if <code>-1</code>.
* @param timeZone The timeZone to use for dates. If <jk>null</jk> then either the
* timezone specified on the {@link Calendar} object or the timezone returned
* by {@link BeanSession#getTimeZone()} is used.
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/transforms/DateSwap.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/transforms/DateSwap.java b/juneau-core/src/main/java/org/apache/juneau/transforms/DateSwap.java
index 8e8b8a7..913f649 100644
--- a/juneau-core/src/main/java/org/apache/juneau/transforms/DateSwap.java
+++ b/juneau-core/src/main/java/org/apache/juneau/transforms/DateSwap.java
@@ -27,7 +27,7 @@ import org.apache.juneau.transform.*;
*
* <h6 class='topic'>Behavior-specific subclasses</h6>
* <p>
- * The following direct subclasses are provided for convenience to the following formats:
+ * The following direct subclasses are provided for convenience to the following formats:
* <ul class='spaced-list'>
* <li>{@link ToString} - To {@link String Strings} using the {@code Date.toString()} method.
* <li>{@link ISO8601DT} - To ISO8601 date-time strings.
@@ -67,13 +67,13 @@ public class DateSwap extends StringSwap<Date> {
* Only one of the <code>pattern</code> or <code>style</code> parameters should
*
* @param pattern The {@link SimpleDateFormat} pattern.
- * If <jk>null</jk>, <code>style</code> is used instead.
+ * If <jk>null</jk>, <code>style</code> is used instead.
* @param dateStyle The {@link DateFormat} date style (e.g. {@link DateFormat#SHORT}).
- * Ignored if <code>pattern</code> is not <jk>null</jk>.
- * Ignored if <code>-1</code>.
+ * Ignored if <code>pattern</code> is not <jk>null</jk>.
+ * Ignored if <code>-1</code>.
* @param timeStyle The {@link DateFormat} time style (e.g. {@link DateFormat#SHORT}).
- * Ignored if <code>pattern</code> is not <jk>null</jk>.
- * Ignored if <code>-1</code>.
+ * Ignored if <code>pattern</code> is not <jk>null</jk>.
+ * Ignored if <code>-1</code>.
* @param timeZone The timeZone to use for dates. If <jk>null</jk> then the timezone returned
* by {@link BeanSession#getTimeZone()} is used.
*/
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/transforms/EnumerationSwap.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/transforms/EnumerationSwap.java b/juneau-core/src/main/java/org/apache/juneau/transforms/EnumerationSwap.java
index 3930aba..d1846c7 100644
--- a/juneau-core/src/main/java/org/apache/juneau/transforms/EnumerationSwap.java
+++ b/juneau-core/src/main/java/org/apache/juneau/transforms/EnumerationSwap.java
@@ -20,7 +20,7 @@ import org.apache.juneau.transform.*;
/**
* Transforms {@link Enumeration Enumerations} to {@code List<Object>} objects.
* <p>
- * This is a one-way transform, since {@code Enumerations} cannot be reconstituted.
+ * This is a one-way transform, since {@code Enumerations} cannot be reconstituted.
*/
@SuppressWarnings({"unchecked","rawtypes"})
public class EnumerationSwap extends PojoSwap<Enumeration,List> {
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/transforms/IteratorSwap.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/transforms/IteratorSwap.java b/juneau-core/src/main/java/org/apache/juneau/transforms/IteratorSwap.java
index 439e70f..37ccaff 100644
--- a/juneau-core/src/main/java/org/apache/juneau/transforms/IteratorSwap.java
+++ b/juneau-core/src/main/java/org/apache/juneau/transforms/IteratorSwap.java
@@ -20,7 +20,7 @@ import org.apache.juneau.transform.*;
/**
* Transforms {@link Iterator Iterators} to {@code List<Object>} objects.
* <p>
- * This is a one-way transform, since {@code Iterators} cannot be reconstituted.
+ * This is a one-way transform, since {@code Iterators} cannot be reconstituted.
*/
@SuppressWarnings({"unchecked","rawtypes"})
public class IteratorSwap extends PojoSwap<Iterator,List> {
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/transforms/ReaderSwap.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/transforms/ReaderSwap.java b/juneau-core/src/main/java/org/apache/juneau/transforms/ReaderSwap.java
index f8129ac..5722e04 100644
--- a/juneau-core/src/main/java/org/apache/juneau/transforms/ReaderSwap.java
+++ b/juneau-core/src/main/java/org/apache/juneau/transforms/ReaderSwap.java
@@ -28,16 +28,16 @@ import org.apache.juneau.xml.*;
*
* <h5 class='section'>Description:</h5>
* <p>
- * The {@code Reader} must contain JSON, Juneau-generated XML (output from {@link XmlSerializer}),
- * or Juneau-generated HTML (output from {@link JsonSerializer}) in order to be parsed correctly.
+ * The {@code Reader} must contain JSON, Juneau-generated XML (output from {@link XmlSerializer}),
+ * or Juneau-generated HTML (output from {@link JsonSerializer}) in order to be parsed correctly.
* <p>
- * Useful for serializing models that contain {@code Readers} created by {@code RestCall} instances.
+ * Useful for serializing models that contain {@code Readers} created by {@code RestCall} instances.
* <p>
- * This is a one-way transform, since {@code Readers} cannot be reconstituted.
+ * This is a one-way transform, since {@code Readers} cannot be reconstituted.
*
* <h6 class='topic'>Behavior-specific subclasses</h6>
* <p>
- * The following direct subclasses are provided for convenience:
+ * The following direct subclasses are provided for convenience:
* <ul class='spaced-list'>
* <li>{@link Json} - Parses JSON text.
* <li>{@link Xml} - Parses XML text.
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/transforms/XMLGregorianCalendarSwap.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/transforms/XMLGregorianCalendarSwap.java b/juneau-core/src/main/java/org/apache/juneau/transforms/XMLGregorianCalendarSwap.java
index d29327e..9808bcf 100644
--- a/juneau-core/src/main/java/org/apache/juneau/transforms/XMLGregorianCalendarSwap.java
+++ b/juneau-core/src/main/java/org/apache/juneau/transforms/XMLGregorianCalendarSwap.java
@@ -23,9 +23,9 @@ import org.apache.juneau.transform.*;
/**
* Transforms {@link XMLGregorianCalendar XMLGregorianCalendars} to ISO8601 date-time {@link String Strings}.
* <p>
- * Objects are converted to strings using {@link XMLGregorianCalendar#toXMLFormat()}.
+ * Objects are converted to strings using {@link XMLGregorianCalendar#toXMLFormat()}.
* <p>
- * Strings are converted to objects using {@link DatatypeFactory#newXMLGregorianCalendar(String)}.
+ * Strings are converted to objects using {@link DatatypeFactory#newXMLGregorianCalendar(String)}.
*/
public class XMLGregorianCalendarSwap extends StringSwap<XMLGregorianCalendar> {
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/urlencoding/UonParser.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/urlencoding/UonParser.java b/juneau-core/src/main/java/org/apache/juneau/urlencoding/UonParser.java
index 2ada474..948d92b 100644
--- a/juneau-core/src/main/java/org/apache/juneau/urlencoding/UonParser.java
+++ b/juneau-core/src/main/java/org/apache/juneau/urlencoding/UonParser.java
@@ -28,15 +28,15 @@ import org.apache.juneau.transform.*;
*
* <h5 class='section'>Media types:</h5>
* <p>
- * Handles <code>Content-Type</code> types: <code>text/uon</code>
+ * Handles <code>Content-Type</code> types: <code>text/uon</code>
*
* <h5 class='section'>Description:</h5>
* <p>
- * This parser uses a state machine, which makes it very fast and efficient.
+ * This parser uses a state machine, which makes it very fast and efficient.
*
* <h5 class='section'>Configurable properties:</h5>
* <p>
- * This class has the following properties associated with it:
+ * This class has the following properties associated with it:
* <ul>
* <li>{@link UonParserContext}
* <li>{@link ParserContext}
http://git-wip-us.apache.org/repos/asf/incubator-juneau/blob/ef1ead8e/juneau-core/src/main/java/org/apache/juneau/urlencoding/UonParserSession.java
----------------------------------------------------------------------
diff --git a/juneau-core/src/main/java/org/apache/juneau/urlencoding/UonParserSession.java b/juneau-core/src/main/java/org/apache/juneau/urlencoding/UonParserSession.java
index 54b8927..cea28dc 100644
--- a/juneau-core/src/main/java/org/apache/juneau/urlencoding/UonParserSession.java
+++ b/juneau-core/src/main/java/org/apache/juneau/urlencoding/UonParserSession.java
@@ -35,23 +35,23 @@ public class UonParserSession extends ParserSession {
* Create a new session using properties specified in the context.
*
* @param ctx The context creating this session object.
- * The context contains all the configuration settings for this object.
+ * he context contains all the configuration settings for this object.
* @param input The input. Can be any of the following types:
- * <ul>
- * <li><jk>null</jk>
- * <li>{@link Reader}
- * <li>{@link CharSequence}
- * <li>{@link InputStream} containing UTF-8 encoded text.
- * <li>{@link File} containing system encoded text.
- * </ul>
+ * <ul>
+ * <li><jk>null</jk>
+ * <li>{@link Reader}
+ * <li>{@link CharSequence}
+ * <li>{@link InputStream} containing UTF-8 encoded text.
+ * <li>{@link File} containing system encoded text.
+ * </ul>
* @param op The override properties.
- * These override any context properties defined in the context.
+ * These override any context properties defined in the context.
* @param javaMethod The java method that called this parser, usually the method in a REST servlet.
* @param outer The outer object for instantiating top-level non-static inner classes.
* @param locale The session locale.
- * If <jk>null</jk>, then the locale defined on the context is used.
+ * If <jk>null</jk>, then the locale defined on the context is used.
* @param timeZone The session timezone.
- * If <jk>null</jk>, then the timezone defined on the context is used.
+ * If <jk>null</jk>, then the timezone defined on the context is used.
* @param mediaType The session media type (e.g. <js>"application/json"</js>).
*/
public UonParserSession(UonParserContext ctx, ObjectMap op, Object input, Method javaMethod, Object outer, Locale locale, TimeZone timeZone, MediaType mediaType) {