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) {
