This is an automated email from the ASF dual-hosted git repository. ggregory pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/commons-beanutils.git
The following commit(s) were added to refs/heads/master by this push: new bb4e5692 Javadoc bb4e5692 is described below commit bb4e56924aa572215550a2042dfef8ceb1ff05cf Author: Gary Gregory <garydgreg...@gmail.com> AuthorDate: Sun Jul 21 11:22:06 2024 -0400 Javadoc Use HTML 'em' tag instead of 'i' tag --- .../beanutils2/ContextClassLoaderLocal.java | 4 +- .../commons/beanutils2/ConvertUtilsBean.java | 6 +-- .../beanutils2/DynaBeanPropertyMapDecorator.java | 6 +-- .../apache/commons/beanutils2/LazyDynaBean.java | 18 +++---- .../apache/commons/beanutils2/LazyDynaClass.java | 4 +- .../apache/commons/beanutils2/LazyDynaList.java | 24 ++++----- .../org/apache/commons/beanutils2/LazyDynaMap.java | 18 +++---- .../commons/beanutils2/PropertyUtilsBean.java | 16 +++--- .../apache/commons/beanutils2/WrapDynaClass.java | 4 +- .../beanutils2/converters/AbstractConverter.java | 6 +-- .../beanutils2/converters/ArrayConverter.java | 20 ++++---- .../beanutils2/converters/BigDecimalConverter.java | 8 +-- .../beanutils2/converters/BigIntegerConverter.java | 8 +-- .../beanutils2/converters/BooleanConverter.java | 2 +- .../beanutils2/converters/ByteConverter.java | 8 +-- .../beanutils2/converters/CalendarConverter.java | 6 +-- .../beanutils2/converters/CharacterConverter.java | 8 +-- .../beanutils2/converters/ClassConverter.java | 6 +-- .../beanutils2/converters/ColorConverter.java | 2 +- .../beanutils2/converters/DateConverter.java | 6 +-- .../beanutils2/converters/DateTimeConverter.java | 16 +++--- .../beanutils2/converters/DimensionConverter.java | 2 +- .../beanutils2/converters/DoubleConverter.java | 8 +-- .../beanutils2/converters/DurationConverter.java | 6 +-- .../beanutils2/converters/EnumConverter.java | 6 +-- .../beanutils2/converters/FileConverter.java | 6 +-- .../beanutils2/converters/FloatConverter.java | 8 +-- .../converters/InetAddressConverter.java | 2 +- .../beanutils2/converters/IntegerConverter.java | 8 +-- .../beanutils2/converters/LocalDateConverter.java | 6 +-- .../converters/LocalDateTimeConverter.java | 6 +-- .../beanutils2/converters/LocalTimeConverter.java | 6 +-- .../beanutils2/converters/LocaleConverter.java | 2 +- .../beanutils2/converters/LongConverter.java | 8 +-- .../beanutils2/converters/MonthDayConverter.java | 6 +-- .../beanutils2/converters/NumberConverter.java | 14 ++--- .../converters/OffsetDateTimeConverter.java | 6 +-- .../beanutils2/converters/OffsetTimeConverter.java | 6 +-- .../beanutils2/converters/PathConverter.java | 6 +-- .../beanutils2/converters/PatternConverter.java | 2 +- .../beanutils2/converters/PeriodConverter.java | 6 +-- .../beanutils2/converters/PointConverter.java | 2 +- .../beanutils2/converters/ShortConverter.java | 8 +-- .../beanutils2/converters/StringConverter.java | 4 +- .../beanutils2/converters/URIConverter.java | 6 +-- .../beanutils2/converters/URLConverter.java | 6 +-- .../beanutils2/converters/UUIDConverter.java | 6 +-- .../beanutils2/converters/YearConverter.java | 6 +-- .../beanutils2/converters/YearMonthConverter.java | 6 +-- .../beanutils2/converters/ZoneIdConverter.java | 6 +-- .../beanutils2/converters/ZoneOffsetConverter.java | 6 +-- .../converters/ZonedDateTimeConverter.java | 6 +-- .../commons/beanutils2/expression/Resolver.java | 4 +- .../apache/commons/beanutils2/package-info.java | 60 +++++++++++----------- .../beanutils2/sql/AbstractJdbcDynaClass.java | 2 +- .../sql/converters/SqlDateConverter.java | 6 +-- .../sql/converters/SqlTimeConverter.java | 6 +-- .../sql/converters/SqlTimestampConverter.java | 6 +-- .../beanutils2/bugs/other/Jira18BeanFactory.java | 2 +- .../beanutils2/converters/ClassReloader.java | 4 +- .../beanutils2/converters/MemoryTestCase.java | 2 +- 61 files changed, 235 insertions(+), 235 deletions(-) diff --git a/src/main/java/org/apache/commons/beanutils2/ContextClassLoaderLocal.java b/src/main/java/org/apache/commons/beanutils2/ContextClassLoaderLocal.java index affb4e34..584ddb06 100644 --- a/src/main/java/org/apache/commons/beanutils2/ContextClassLoaderLocal.java +++ b/src/main/java/org/apache/commons/beanutils2/ContextClassLoaderLocal.java @@ -69,7 +69,7 @@ import java.util.WeakHashMap; * a component which uses this class is "undeployed" by a container the * component-specific classloader and all its associated classes (and their * static variables) are garbage-collected. Unfortunately there is one - * scenario in which this does <i>not</i> work correctly and there + * scenario in which this does <em>not</em> work correctly and there * is unfortunately no known workaround other than ensuring that the * component (or its container) calls the "unset" method on this class for * each instance of this class when the component is undeployed. The problem @@ -207,7 +207,7 @@ public class ContextClassLoaderLocal<T> { /** * Unsets the value associated with the given classloader - * @param classLoader The classloader to <i>unset</i> for + * @param classLoader The classloader to <em>unset</em> for */ public synchronized void unset(final ClassLoader classLoader) { valueByClassLoader.remove(classLoader); diff --git a/src/main/java/org/apache/commons/beanutils2/ConvertUtilsBean.java b/src/main/java/org/apache/commons/beanutils2/ConvertUtilsBean.java index 4ed83232..590bdfaf 100644 --- a/src/main/java/org/apache/commons/beanutils2/ConvertUtilsBean.java +++ b/src/main/java/org/apache/commons/beanutils2/ConvertUtilsBean.java @@ -180,7 +180,7 @@ import org.apache.commons.logging.LogFactory; * </p> * * <p> - * Converters that generate <i>arrays</i> of each of the primitive types are + * Converters that generate <em>arrays</em> of each of the primitive types are * also automatically configured (including String[]). When passed null * or invalid input, these return an empty array (not null). See class * AbstractArrayConverter for the supported input formats for these converters. @@ -462,7 +462,7 @@ public class ConvertUtilsBean { * @param throwException {@code true} if the converters should * throw an exception when a conversion error occurs, otherwise * {@code false} if a default value should be used. - * @param defaultNull {@code true}if the <i>standard</i> converters + * @param defaultNull {@code true}if the <em>standard</em> converters * (see {@link ConvertUtilsBean#registerStandard(boolean, boolean)}) * should use a default value of {@code null</code>, otherwise <code>false}. * N.B. This values is ignored if {@code throwException</code> is <code>true} @@ -709,7 +709,7 @@ public class ConvertUtilsBean { * @param throwException {@code true} if the converters should * throw an exception when a conversion error occurs, otherwise <code> * {@code false} if a default value should be used. - * @param defaultNull {@code true}if the <i>standard</i> converters + * @param defaultNull {@code true}if the <em>standard</em> converters * (see {@link ConvertUtilsBean#registerStandard(boolean, boolean)}) * should use a default value of {@code null</code>, otherwise <code>false}. * N.B. This values is ignored if {@code throwException</code> is <code>true} diff --git a/src/main/java/org/apache/commons/beanutils2/DynaBeanPropertyMapDecorator.java b/src/main/java/org/apache/commons/beanutils2/DynaBeanPropertyMapDecorator.java index 17e1e76d..ccca998e 100644 --- a/src/main/java/org/apache/commons/beanutils2/DynaBeanPropertyMapDecorator.java +++ b/src/main/java/org/apache/commons/beanutils2/DynaBeanPropertyMapDecorator.java @@ -42,9 +42,9 @@ package org.apache.commons.beanutils2; * * <ul><li>{@code Map<String, Object> fooMap = new DynaBeanPropertyMapDecorator(fooDynaBean);}</li></ul> * - * <p>The above example creates a <b><i>read only</i></b> {@code Map}. + * <p>The above example creates a <b><em>read only</em></b> {@code Map}. * To create a {@code Map} which can be modified, construct a - * {@code DynaBeanPropertyMapDecorator} with the <b><i>read only</i></b> + * {@code DynaBeanPropertyMapDecorator} with the <b><em>read only</em></b> * attribute set to {@code false}:</p> * * <ul><li><code>Map<String, Object> fooMap = @@ -52,7 +52,7 @@ package org.apache.commons.beanutils2; * * <h2>Limitations</h2> * <p>In this implementation the {@code entrySet()</code>, <code>keySet()} - * and {@code values()} methods create an <b><i>unmodifiable</i></b> + * and {@code values()} methods create an <b><em>unmodifiable</em></b> * {@code Set</code> and it does not support the Map's <code>clear()} * and {@code remove()} operations.</p> * diff --git a/src/main/java/org/apache/commons/beanutils2/LazyDynaBean.java b/src/main/java/org/apache/commons/beanutils2/LazyDynaBean.java index 136a432b..bbaabd28 100644 --- a/src/main/java/org/apache/commons/beanutils2/LazyDynaBean.java +++ b/src/main/java/org/apache/commons/beanutils2/LazyDynaBean.java @@ -32,17 +32,17 @@ import org.apache.commons.logging.LogFactory; /** * <p>DynaBean which automatically adds properties to the {@code DynaClass} - * and provides <i>Lazy List</i> and <i>Lazy Map</i> features.</p> + * and provides <em>Lazy List</em> and <em>Lazy Map</em> features.</p> * - * <p>DynaBeans deal with three types of properties - <i>simple</i>, <i>indexed</i> and <i>mapped</i> and + * <p>DynaBeans deal with three types of properties - <em>simple</em>, <em>indexed</em> and <em>mapped</em> and * have the following {@code get()</code> and <code>set()} methods for * each of these types:</p> * <ul> - * <li><i>Simple</i> property methods - {@code get(name)} and + * <li><em>Simple</em> property methods - {@code get(name)} and * {@code set(name, value)}</li> - * <li><i>Indexed</i> property methods - {@code get(name, index)} and + * <li><em>Indexed</em> property methods - {@code get(name, index)} and * {@code set(name, index, value)}</li> - * <li><i>Mapped</i> property methods - {@code get(name, key)} and + * <li><em>Mapped</em> property methods - {@code get(name, key)} and * {@code set(name, key, value)}</li> * </ul> * @@ -63,7 +63,7 @@ import org.apache.commons.logging.LogFactory; * <p>If the property <b>doesn't</b> exist, the {@code LazyDynaBean} will automatically add * a property with an {@code ArrayList</code> type to the <code>DynaClass} when * the {@code set(name, index, value)} method is called. - * It will also instantiate a new {@code ArrayList} and automatically <i>grow</i> + * It will also instantiate a new {@code ArrayList} and automatically <em>grow</em> * the {@code List} so that it is big enough to accommodate the index being set. * {@code ArrayList} is the default indexed property that LazyDynaBean uses but * this can be easily changed by overriding the {@code defaultIndexedProperty(name)} @@ -78,7 +78,7 @@ import org.apache.commons.logging.LogFactory; * <p>If the indexed property <b>does</b> exist in the {@code DynaClass} but is set to * {@code null</code> in the <code>LazyDynaBean}, then it will instantiate a * new {@code List</code> or <code>Array} as specified by the property's type - * in the {@code DynaClass</code> and automatically <i>grow</i> the <code>List} + * in the {@code DynaClass</code> and automatically <em>grow</em> the <code>List} * or {@code Array} so that it is big enough to accommodate the index being set.</p> * * <pre><code> @@ -113,8 +113,8 @@ import org.apache.commons.logging.LogFactory; * myBean.set("myMappedProperty", "myKey", "myValue"); * </code></pre> * - * <p><b><u><i>Restricted</i> DynaClass</u></b></p> - * <p>{@code MutableDynaClass</code> have a facility to <i>restrict</i> the <code>DynaClass} + * <p><b><u><em>Restricted</em> DynaClass</u></b></p> + * <p>{@code MutableDynaClass</code> have a facility to <em>restrict</em> the <code>DynaClass} * so that its properties cannot be modified. If the {@code MutableDynaClass} is * restricted then calling any of the {@code set()} methods for a property which * doesn't exist will result in a {@code IllegalArgumentException} being thrown.</p> diff --git a/src/main/java/org/apache/commons/beanutils2/LazyDynaClass.java b/src/main/java/org/apache/commons/beanutils2/LazyDynaClass.java index 8dcdf5bd..2fbf2550 100644 --- a/src/main/java/org/apache/commons/beanutils2/LazyDynaClass.java +++ b/src/main/java/org/apache/commons/beanutils2/LazyDynaClass.java @@ -33,7 +33,7 @@ import java.util.Objects; * of the {@code LazyDynaBean} which automatically adds missing properties * when any of its {@code set()} methods are called. For this reason the * {@code isDynaProperty(name)} method has been added to this implementation - * in order to determine if a property actually exists. If the more <i>normal</i> + * in order to determine if a property actually exists. If the more <em>normal</em> * behavior of returning {@code null} is required, then this can be achieved * by calling the {@code setReturnNull(true)}.</p> * @@ -210,7 +210,7 @@ public class LazyDynaClass extends BasicDynaClass implements MutableDynaClass { * * <p>The reason for not returning a {@code null} property descriptor is that * {@code BeanUtils} uses this method to check if a property exists - * before trying to set it - since these <i>Lazy</i> implementations automatically + * before trying to set it - since these <em>Lazy</em> implementations automatically * add any new properties when they are set, returning {@code null} from * this method would defeat their purpose.</p> * diff --git a/src/main/java/org/apache/commons/beanutils2/LazyDynaList.java b/src/main/java/org/apache/commons/beanutils2/LazyDynaList.java index a9f3e652..26cc5f3d 100644 --- a/src/main/java/org/apache/commons/beanutils2/LazyDynaList.java +++ b/src/main/java/org/apache/commons/beanutils2/LazyDynaList.java @@ -24,16 +24,16 @@ import java.util.Map; import java.util.Objects; /** - * <h2><i>Lazy</i> DynaBean List.</h2> + * <h2><em>Lazy</em> DynaBean List.</h2> * * <p>There are two main purposes for this class:</p> * <ul> - * <li>To provide <i>Lazy List</i> behavior - automatically - * <i>growing</i> and <i>populating</i> the {@code List} + * <li>To provide <em>Lazy List</em> behavior - automatically + * <em>growing</em> and <em>populating</em> the {@code List} * with either {@code DynaBean</code>, <code>java.util.Map} * or POJO Beans.</li> * <li>To provide a straight forward way of putting a Collection - * or Array into the lazy list <i>and</i> a straight forward + * or Array into the lazy list <em>and</em> a straight forward * way to get it out again at the end.</li> * </ul> * @@ -94,7 +94,7 @@ import java.util.Objects; * * * <h2>Example 2</h2> - * <p>Alternatively you can create an <i>empty</i> List and + * <p>Alternatively you can create an <em>empty</em> List and * specify the Class for List's elements. The LazyDynaList * uses the Class to automatically populate elements:</p> * @@ -110,7 +110,7 @@ import java.util.Objects; * </code></pre> * * <h2>Example 3</h2> - * <p>Alternatively you can create an <i>empty</i> List and specify the + * <p>Alternatively you can create an <em>empty</em> List and specify the * DynaClass for List's elements. The LazyDynaList uses * the DynaClass to automatically populate elements:</p> * @@ -131,7 +131,7 @@ import java.util.Objects; * <p><strong>N.B.</strong> You may wonder why control the type * using a {@code DynaClass</code> rather than the <code>Class} * as in the previous example - the reason is that some {@code DynaBean} - * implementations don't have a <i>default</i> empty constructor and + * implementations don't have a <em>default</em> empty constructor and * therefore need to be instantiated using the {@code DynaClass.newInstance()} * method.</p> * @@ -252,7 +252,7 @@ public class LazyDynaList extends ArrayList<Object> { * * <p>If the index position is greater than the current * size of the List, then the List is automatically - * <i>grown</i> to the appropriate size.</p> + * <em>grown</em> to the appropriate size.</p> * * @param index The index position to insert the new element. * @param element The new element to add. @@ -304,7 +304,7 @@ public class LazyDynaList extends ArrayList<Object> { * * <p>If the index position is greater than the current * size of the List, then the List is automatically - * <i>grown</i> to the appropriate size.</p> + * <em>grown</em> to the appropriate size.</p> * * @param collection The Collection of new elements. * @param index The index position to insert the new elements at. @@ -354,7 +354,7 @@ public class LazyDynaList extends ArrayList<Object> { * * <p>If the position requested is greater than the current * size of the List, then the List is automatically - * <i>grown</i> (and populated) to the appropriate size.</p> + * <em>grown</em> (and populated) to the appropriate size.</p> * * @param index The index position to insert the new elements at. * @return The element at the specified position. @@ -374,7 +374,7 @@ public class LazyDynaList extends ArrayList<Object> { } /** - * <p>Automatically <i>grown</i> the List + * <p>Automatically <em>grown</em> the List * to the appropriate size, populating with * DynaBeans.</p> * @@ -398,7 +398,7 @@ public class LazyDynaList extends ArrayList<Object> { * * <p>If the position requested is greater than the current * size of the List, then the List is automatically - * <i>grown</i> (and populated) to the appropriate size.</p> + * <em>grown</em> (and populated) to the appropriate size.</p> * * @param index The index position to insert the new element at. * @param element The new element. diff --git a/src/main/java/org/apache/commons/beanutils2/LazyDynaMap.java b/src/main/java/org/apache/commons/beanutils2/LazyDynaMap.java index 166a5785..f1979c26 100644 --- a/src/main/java/org/apache/commons/beanutils2/LazyDynaMap.java +++ b/src/main/java/org/apache/commons/beanutils2/LazyDynaMap.java @@ -20,26 +20,26 @@ import java.util.Map; import java.util.Objects; /** - * <p>Provides a <i>light weight</i> {@code DynaBean</code> facade to a <code>Map} - * with <i>lazy</i> map/list processing.</p> + * <p>Provides a <em>light weight</em> {@code DynaBean</code> facade to a <code>Map} + * with <em>lazy</em> map/list processing.</p> * - * <p>Its a <i>light weight</i> {@code DynaBean} implementation because there is no + * <p>Its a <em>light weight</em> {@code DynaBean} implementation because there is no * actual {@code DynaClass</code> associated with this <code>DynaBean} - in fact - * it implements the {@code DynaClass} interface itself providing <i>pseudo</i> DynaClass + * it implements the {@code DynaClass} interface itself providing <em>pseudo</em> DynaClass * behavior from the actual values stored in the {@code Map}.</p> * * <p>As well providing rhe standard {@code DynaBean</code> access to the <code>Map}'s properties - * this class also provides the usual <i>Lazy</i> behavior:</p> + * this class also provides the usual <em>Lazy</em> behavior:</p> * <ul> * <li>Properties don't need to be pre-defined in a {@code DynaClass}</li> * <li>Indexed properties ({@code Lists</code> or <code>Arrays}) are automatically instantiated - * and <i>grown</i> so that they are large enough to cater for the index being set.</li> + * and <em>grown</em> so that they are large enough to cater for the index being set.</li> * <li>Mapped properties are automatically instantiated.</li> * </ul> * - * <p><b><u><i>Restricted</i> DynaClass</u></b></p> + * <p><b><u><em>Restricted</em> DynaClass</u></b></p> * <p>This class implements the {@code MutableDynaClass} interface. - * {@code MutableDynaClass</code> have a facility to <i>restrict</i> the <code>DynaClass} + * {@code MutableDynaClass</code> have a facility to <em>restrict</em> the <code>DynaClass} * so that its properties cannot be modified. If the {@code MutableDynaClass} is * restricted then calling any of the {@code set()} methods for a property which * doesn't exist will result in a {@code IllegalArgumentException} being thrown.</p> @@ -249,7 +249,7 @@ public class LazyDynaMap extends LazyDynaBean implements MutableDynaClass { * * <p>The reason for not returning a {@code null} property descriptor is that * {@code BeanUtils} uses this method to check if a property exists - * before trying to set it - since these <i>Map</i> implementations automatically + * before trying to set it - since these <em>Map</em> implementations automatically * add any new properties when they are set, returning {@code null} from * this method would defeat their purpose.</p> * diff --git a/src/main/java/org/apache/commons/beanutils2/PropertyUtilsBean.java b/src/main/java/org/apache/commons/beanutils2/PropertyUtilsBean.java index 893adb86..38327391 100644 --- a/src/main/java/org/apache/commons/beanutils2/PropertyUtilsBean.java +++ b/src/main/java/org/apache/commons/beanutils2/PropertyUtilsBean.java @@ -50,7 +50,7 @@ import org.apache.commons.logging.LogFactory; * a convenient way to access the registered classes themselves is included. * <p> * For the purposes of this class, five formats for referencing a particular - * property value of a bean are defined, with the <i>default</i> layout of an + * property value of a bean are defined, with the <em>default</em> layout of an * identifying String in parentheses. However the notation for these formats * and how they are resolved is now (since BeanUtils 1.8.0) controlled by * the configured {@link Resolver} implementation: @@ -1078,9 +1078,9 @@ public class PropertyUtilsBean { /** * Gets the configured {@link Resolver} implementation used by BeanUtils. * <p> - * The {@link Resolver} handles the <i>property name</i> + * The {@link Resolver} handles the <em>property name</em> * expressions and the implementation in use effectively - * controls the dialect of the <i>expression language</i> + * controls the dialect of the <em>expression language</em> * that BeanUtils recognizes. * <p> * {@link DefaultResolver} is the default implementation used. @@ -1834,7 +1834,7 @@ public class PropertyUtilsBean { * a method existed, and a.put(b, obj) otherwise. In version 1.5 it meant * a.put(b, obj) always (ie the same as the behavior in the current version). * In versions prior to 1.5 it meant a.setB(obj) always. [yes, this is - * all <i>very</i> unfortunate] + * all <em>very</em> unfortunate] * <p> * Users who would like to customize the meaning of "a.b" in method * setNestedProperty when a is a Map can create a custom subclass of @@ -1845,8 +1845,8 @@ public class PropertyUtilsBean { * <p> * Note, however, that the recommended solution for objects that * implement Map but want their simple properties to come first is - * for <i>those</i> objects to override their get/put methods to implement - * that behavior, and <i>not</i> to solve the problem by modifying the + * for <em>those</em> objects to override their get/put methods to implement + * that behavior, and <em>not</em> to solve the problem by modifying the * default behavior of the PropertyUtilsBean class by overriding this * method. * @@ -1892,9 +1892,9 @@ public class PropertyUtilsBean { /** * Configure the {@link Resolver} implementation used by BeanUtils. * <p> - * The {@link Resolver} handles the <i>property name</i> + * The {@link Resolver} handles the <em>property name</em> * expressions and the implementation in use effectively - * controls the dialect of the <i>expression language</i> + * controls the dialect of the <em>expression language</em> * that BeanUtils recognizes. * <p> * {@link DefaultResolver} is the default implementation used. diff --git a/src/main/java/org/apache/commons/beanutils2/WrapDynaClass.java b/src/main/java/org/apache/commons/beanutils2/WrapDynaClass.java index 8324798a..803a79a9 100644 --- a/src/main/java/org/apache/commons/beanutils2/WrapDynaClass.java +++ b/src/main/java/org/apache/commons/beanutils2/WrapDynaClass.java @@ -108,7 +108,7 @@ public class WrapDynaClass implements DynaClass { * instance for the specified bean class. * * @param beanClass Bean class for which a WrapDynaClass is requested - * @return A new <i>Wrap</i> {@link DynaClass} + * @return A new <em>Wrap</em> {@link DynaClass} */ public static WrapDynaClass createDynaClass(final Class<?> beanClass) { return createDynaClass(beanClass, null); @@ -123,7 +123,7 @@ public class WrapDynaClass implements DynaClass { * {@code PropertyUtilsBean} object is provided, the default instance is used. * @param beanClass Bean class for which a WrapDynaClass is requested * @param pu the optional {@code PropertyUtilsBean} to be used for introspection - * @return A new <i>Wrap</i> {@link DynaClass} + * @return A new <em>Wrap</em> {@link DynaClass} * @since 1.9 */ public static WrapDynaClass createDynaClass(final Class<?> beanClass, final PropertyUtilsBean pu) { diff --git a/src/main/java/org/apache/commons/beanutils2/converters/AbstractConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/AbstractConverter.java index 00f070ca..624c9add 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/AbstractConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/AbstractConverter.java @@ -117,14 +117,14 @@ public abstract class AbstractConverter<D> implements Converter<D> { private D defaultValue; /** - * Constructs a <i>Converter</i> that throws a + * Constructs a <em>Converter</em> that throws a * {@code ConversionException} if an error occurs. */ public AbstractConverter() { } /** - * Constructs a <i>Converter</i> that returns a default + * Constructs a <em>Converter</em> that returns a default * value if an error occurs. * * @param defaultValue The default value to be returned @@ -259,7 +259,7 @@ public abstract class AbstractConverter<D> implements Converter<D> { * <p> * <b>N.B.</b>This implementation simply uses the value's * {@code toString()} method and should be overridden if a - * more sophisticated mechanism for <i>conversion to a String</i> + * more sophisticated mechanism for <em>conversion to a String</em> * is required. * </p> * diff --git a/src/main/java/org/apache/commons/beanutils2/converters/ArrayConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/ArrayConverter.java index 5932fb8d..0d0045fc 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/ArrayConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/ArrayConverter.java @@ -34,7 +34,7 @@ import org.apache.commons.beanutils2.Converter; * Generic {@link Converter} implementation that handles conversion * to and from <b>array</b> objects. * <p> - * Can be configured to either return a <i>default value</i> or throw a + * Can be configured to either return a <em>default value</em> or throw a * {@code ConversionException} if a conversion error occurs. * <p> * The main features of this implementation are: @@ -51,7 +51,7 @@ import org.apache.commons.beanutils2.Converter; * <li><b>Delimited Lists</b> - can Convert <b>to</b> and <b>from</b> a * delimited list in String format.</li> * <li><b>Conversion to String</b> - converts an array to a - * {@code String} in one of two ways: as a <i>delimited list</i> + * {@code String} in one of two ways: as a <em>delimited list</em> * or by converting the first element in the array to a String - this * is controlled by the {@link ArrayConverter#setOnlyFirstToString(boolean)} * parameter.</li> @@ -60,20 +60,20 @@ import org.apache.commons.beanutils2.Converter; * within each other - see example below.</li> * <li><b>Default Value</b> * <ul> - * <li><b><i>No Default</i></b> - use the + * <li><b><em>No Default</em></b> - use the * {@link ArrayConverter#ArrayConverter(Class, Converter)} * constructor to create a converter which throws a * {@link ConversionException} if the value is missing or * invalid.</li> - * <li><b><i>Default values</i></b> - use the + * <li><b><em>Default values</em></b> - use the * {@link ArrayConverter#ArrayConverter(Class, Converter, int)} * constructor to create a converter which returns a <i>default - * value</i>. The <i>defaultSize</i> parameter controls the - * <i>default value</i> in the following way: + * value</i>. The <em>defaultSize</em> parameter controls the + * <em>default value</em> in the following way: * <ul> - * <li><i>defaultSize < 0</i> - default is {@code null}</li> - * <li><i>defaultSize = 0</i> - default is an array of length zero</li> - * <li><i>defaultSize > 0</i> - default is an array with a + * <li><em>defaultSize < 0</em> - default is {@code null}</li> + * <li><em>defaultSize = 0</em> - default is an array of length zero</li> + * <li><em>defaultSize > 0</em> - default is an array with a * length specified by {@code defaultSize} (N.B. elements * in the array will be {@code null})</li> * </ul> @@ -205,7 +205,7 @@ public class ArrayConverter<C> extends AbstractConverter<C> { * <strong>N.B.</strong> The method is called by both the * {@link ArrayConverter#convertToType(Class, Object)} and * {@link ArrayConverter#convertToString(Object)} methods for - * <i>non-array</i> types. + * <em>non-array</em> types. * @param value value to be converted * * @return Collection elements. diff --git a/src/main/java/org/apache/commons/beanutils2/converters/BigDecimalConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/BigDecimalConverter.java index 983c83ec..eea757ee 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/BigDecimalConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/BigDecimalConverter.java @@ -27,7 +27,7 @@ import java.math.BigDecimal; * or by specifying a format pattern. See the {@link NumberConverter} * documentation for further details. * <p> - * Can be configured to either return a <i>default value</i> or throw a + * Can be configured to either return a <em>default value</em> or throw a * {@code ConversionException} if a conversion error occurs. * * @since 1.3 @@ -35,7 +35,7 @@ import java.math.BigDecimal; public final class BigDecimalConverter extends NumberConverter<BigDecimal> { /** - * Constructs a <b>java.math.BigDecimal</b> <i>Converter</i> that throws + * Constructs a <b>java.math.BigDecimal</b> <em>Converter</em> that throws * a {@code ConversionException} if an error occurs. */ public BigDecimalConverter() { @@ -43,7 +43,7 @@ public final class BigDecimalConverter extends NumberConverter<BigDecimal> { } /** - * Constructs a <b>java.math.BigDecimal</b> <i>Converter</i> that returns + * Constructs a <b>java.math.BigDecimal</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned @@ -55,7 +55,7 @@ public final class BigDecimalConverter extends NumberConverter<BigDecimal> { } /** - * Constructs a <b>java.math.BigDecimal</b> <i>Converter</i> that returns + * Constructs a <b>java.math.BigDecimal</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned diff --git a/src/main/java/org/apache/commons/beanutils2/converters/BigIntegerConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/BigIntegerConverter.java index 39d3cc3b..4719b324 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/BigIntegerConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/BigIntegerConverter.java @@ -27,7 +27,7 @@ import java.math.BigInteger; * or by specifying a format pattern. See the {@link NumberConverter} * documentation for further details. * <p> - * Can be configured to either return a <i>default value</i> or throw a + * Can be configured to either return a <em>default value</em> or throw a * {@code ConversionException} if a conversion error occurs. * * @since 1.3 @@ -35,7 +35,7 @@ import java.math.BigInteger; public final class BigIntegerConverter extends NumberConverter<BigInteger> { /** - * Constructs a <b>java.math.BigInteger</b> <i>Converter</i> that throws + * Constructs a <b>java.math.BigInteger</b> <em>Converter</em> that throws * a {@code ConversionException} if an error occurs. */ public BigIntegerConverter() { @@ -43,7 +43,7 @@ public final class BigIntegerConverter extends NumberConverter<BigInteger> { } /** - * Constructs a <b>java.math.BigInteger</b> <i>Converter</i> that returns + * Constructs a <b>java.math.BigInteger</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned @@ -55,7 +55,7 @@ public final class BigIntegerConverter extends NumberConverter<BigInteger> { } /** - * Constructs a <b>java.math.BigInteger</b> <i>Converter</i> that returns + * Constructs a <b>java.math.BigInteger</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned diff --git a/src/main/java/org/apache/commons/beanutils2/converters/BooleanConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/BooleanConverter.java index ac5dd5e8..086a8126 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/BooleanConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/BooleanConverter.java @@ -22,7 +22,7 @@ package org.apache.commons.beanutils2.converters; * {@link org.apache.commons.beanutils2.Converter} implementation that * handles conversion to and from {@link Boolean} objects. * <p> - * Can be configured to either return a <i>default value</i> or throw a + * Can be configured to either return a <em>default value</em> or throw a * {@code ConversionException} if a conversion error occurs. * </p> * <p> diff --git a/src/main/java/org/apache/commons/beanutils2/converters/ByteConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/ByteConverter.java index 081e5bb0..c7616dfb 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/ByteConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/ByteConverter.java @@ -25,7 +25,7 @@ package org.apache.commons.beanutils2.converters; * or by specifying a format pattern. See the {@link NumberConverter} * documentation for further details. * <p> - * Can be configured to either return a <i>default value</i> or throw a + * Can be configured to either return a <em>default value</em> or throw a * {@code ConversionException} if a conversion error occurs. * * @since 1.3 @@ -33,7 +33,7 @@ package org.apache.commons.beanutils2.converters; public final class ByteConverter extends NumberConverter<Byte> { /** - * Constructs a <b>java.lang.Byte</b> <i>Converter</i> that throws + * Constructs a <b>java.lang.Byte</b> <em>Converter</em> that throws * a {@code ConversionException} if an error occurs. */ public ByteConverter() { @@ -41,7 +41,7 @@ public final class ByteConverter extends NumberConverter<Byte> { } /** - * Constructs a <b>java.lang.Byte</b> <i>Converter</i> that returns + * Constructs a <b>java.lang.Byte</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned @@ -53,7 +53,7 @@ public final class ByteConverter extends NumberConverter<Byte> { } /** - * Constructs a <b>java.lang.Byte</b> <i>Converter</i> that returns + * Constructs a <b>java.lang.Byte</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned diff --git a/src/main/java/org/apache/commons/beanutils2/converters/CalendarConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/CalendarConverter.java index 6ab5499b..827e4e4a 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/CalendarConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/CalendarConverter.java @@ -27,7 +27,7 @@ import java.util.Calendar; * patterns (note, there is no default String conversion for Calendar). * See the {@link DateTimeConverter} documentation for further details. * <p> - * Can be configured to either return a <i>default value</i> or throw a + * Can be configured to either return a <em>default value</em> or throw a * {@code ConversionException} if a conversion error occurs. * * @since 1.8.0 @@ -35,14 +35,14 @@ import java.util.Calendar; public final class CalendarConverter extends DateTimeConverter<Calendar> { /** - * Constructs a <b>java.util.Calendar</b> <i>Converter</i> that throws + * Constructs a <b>java.util.Calendar</b> <em>Converter</em> that throws * a {@code ConversionException} if an error occurs. */ public CalendarConverter() { } /** - * Constructs a <b>java.util.Calendar</b> <i>Converter</i> that returns + * Constructs a <b>java.util.Calendar</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned diff --git a/src/main/java/org/apache/commons/beanutils2/converters/CharacterConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/CharacterConverter.java index e702b532..4596e6f3 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/CharacterConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/CharacterConverter.java @@ -20,7 +20,7 @@ package org.apache.commons.beanutils2.converters; * {@link org.apache.commons.beanutils2.Converter} implementation that handles conversion * to and from <b>java.lang.Character</b> objects. * <p> - * Can be configured to either return a <i>default value</i> or throw a + * Can be configured to either return a <em>default value</em> or throw a * {@code ConversionException} if a conversion error occurs. * * @since 1.3 @@ -28,14 +28,14 @@ package org.apache.commons.beanutils2.converters; public final class CharacterConverter extends AbstractConverter<Character> { /** - * Constructs a <b>java.lang.Character</b> <i>Converter</i> that throws + * Constructs a <b>java.lang.Character</b> <em>Converter</em> that throws * a {@code ConversionException} if an error occurs. */ public CharacterConverter() { } /** - * Constructs a <b>java.lang.Character</b> <i>Converter</i> that returns + * Constructs a <b>java.lang.Character</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned @@ -47,7 +47,7 @@ public final class CharacterConverter extends AbstractConverter<Character> { } /** - * Constructs a <b>java.lang.Character</b> <i>Converter</i> that returns + * Constructs a <b>java.lang.Character</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned diff --git a/src/main/java/org/apache/commons/beanutils2/converters/ClassConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/ClassConverter.java index 92404759..2d530fba 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/ClassConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/ClassConverter.java @@ -24,7 +24,7 @@ package org.apache.commons.beanutils2.converters; * loader (if it exists); otherwise the class loader that loaded this class * will be used. * <p> - * Can be configured to either return a <i>default value</i> or throw a + * Can be configured to either return a <em>default value</em> or throw a * {@code ConversionException} if a conversion error occurs. * * @param <T> the type of the class. @@ -33,14 +33,14 @@ package org.apache.commons.beanutils2.converters; public final class ClassConverter<T> extends AbstractConverter<Class<T>> { /** - * Constructs a <b>java.lang.Class</b> <i>Converter</i> that throws + * Constructs a <b>java.lang.Class</b> <em>Converter</em> that throws * a {@code ConversionException} if an error occurs. */ public ClassConverter() { } /** - * Constructs a <b>java.lang.Class</b> <i>Converter</i> that returns + * Constructs a <b>java.lang.Class</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned diff --git a/src/main/java/org/apache/commons/beanutils2/converters/ColorConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/ColorConverter.java index 8a12d32d..5f5b5052 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/ColorConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/ColorConverter.java @@ -44,7 +44,7 @@ public class ColorConverter extends AbstractConverter<Color> { Pattern.compile("^(?:[A-Za-z\\d._]+)??\\[?(?:r=)?(\\d{1,3}),(?:g=)?(\\d{1,3}),(?:b=)?(\\d{1,3})\\]?$"); /** - * Construct a <b>{@link Color}</b> <i>Converter</i> that throws a {@code ConversionException} if an error occurs. + * Construct a <b>{@link Color}</b> <em>Converter</em> that throws a {@code ConversionException} if an error occurs. */ public ColorConverter() { super(); diff --git a/src/main/java/org/apache/commons/beanutils2/converters/DateConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/DateConverter.java index 30708ab7..96374eaf 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/DateConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/DateConverter.java @@ -27,7 +27,7 @@ import java.util.Date; * patterns (note, there is no default String conversion for Date). * See the {@link DateTimeConverter} documentation for further details. * <p> - * Can be configured to either return a <i>default value</i> or throw a + * Can be configured to either return a <em>default value</em> or throw a * {@code ConversionException} if a conversion error occurs. * * @since 1.8.0 @@ -35,14 +35,14 @@ import java.util.Date; public final class DateConverter extends DateTimeConverter<Date> { /** - * Constructs a <b>java.util.Date</b> <i>Converter</i> that throws + * Constructs a <b>java.util.Date</b> <em>Converter</em> that throws * a {@code ConversionException} if an error occurs. */ public DateConverter() { } /** - * Constructs a <b>java.util.Date</b> <i>Converter</i> that returns + * Constructs a <b>java.util.Date</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned diff --git a/src/main/java/org/apache/commons/beanutils2/converters/DateTimeConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/DateTimeConverter.java index f164187d..788e8b21 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/DateTimeConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/DateTimeConverter.java @@ -38,7 +38,7 @@ import org.apache.commons.beanutils2.ConversionException; * that handles conversion to and from <b>date/time</b> objects. * <p> * This implementation handles conversion for the following - * <i>date/time</i> types. + * <em>date/time</em> types. * <ul> * <li>{@link java.util.Date}</li> * <li>{@link java.util.Calendar}</li> @@ -101,14 +101,14 @@ public abstract class DateTimeConverter<D> extends AbstractConverter<D> { private boolean useLocaleFormat; /** - * Constructs a Date/Time <i>Converter</i> that throws a + * Constructs a Date/Time <em>Converter</em> that throws a * {@code ConversionException} if an error occurs. */ public DateTimeConverter() { } /** - * Constructs a Date/Time <i>Converter</i> that returns a default + * Constructs a Date/Time <em>Converter</em> that returns a default * value if an error occurs. * * @param defaultValue The default value to be returned @@ -126,7 +126,7 @@ public abstract class DateTimeConverter<D> extends AbstractConverter<D> { * one or more patterns (using {@code setPatterns()}), then * the first pattern will be used to format the date into a String. * Otherwise the default {@code DateFormat} for the default locale - * (and <i>style</i> if configured) will be used. + * (and <em>style</em> if configured) will be used. * * @param value The input value to be converted * @return the converted String value. @@ -202,7 +202,7 @@ public abstract class DateTimeConverter<D> extends AbstractConverter<D> { * with one or more patterns (using {@code setPatterns()}), then * the conversion is attempted with each of the specified patterns. * Otherwise the default {@code DateFormat} for the default locale - * (and <i>style</i> if configured) will be used. + * (and <em>style</em> if configured) will be used. * * @param <T> The desired target type of the conversion. * @param targetType Data type to which this value should be converted. @@ -329,7 +329,7 @@ public abstract class DateTimeConverter<D> extends AbstractConverter<D> { } /** - * Gets the Locale for the <i>Converter</i> + * Gets the Locale for the <em>Converter</em> * (or {@code null} if none specified). * * @return The locale to use for conversion @@ -466,7 +466,7 @@ public abstract class DateTimeConverter<D> extends AbstractConverter<D> { } /** - * Sets the Locale for the <i>Converter</i>. + * Sets the Locale for the <em>Converter</em>. * * @param locale The Locale. */ @@ -522,7 +522,7 @@ public abstract class DateTimeConverter<D> extends AbstractConverter<D> { /** * Convert a long value to the specified Date type for this - * <i>Converter</i>. + * <em>Converter</em>. * <p> * * This method handles conversion to the following types: diff --git a/src/main/java/org/apache/commons/beanutils2/converters/DimensionConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/DimensionConverter.java index bc1f15e8..7b82a41b 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/DimensionConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/DimensionConverter.java @@ -39,7 +39,7 @@ public class DimensionConverter extends AbstractConverter<Dimension> { private static final Pattern DIMENSION_PATTERN = Pattern.compile("(\\d+)(?:x(\\d+))?"); /** - * Construct a <b>{@link Dimension}</b> <i>Converter</i> that throws a {@code ConversionException} if an error + * Construct a <b>{@link Dimension}</b> <em>Converter</em> that throws a {@code ConversionException} if an error * occurs. */ public DimensionConverter() { diff --git a/src/main/java/org/apache/commons/beanutils2/converters/DoubleConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/DoubleConverter.java index 450e87d2..39f5607b 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/DoubleConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/DoubleConverter.java @@ -25,7 +25,7 @@ package org.apache.commons.beanutils2.converters; * or by specifying a format pattern. See the {@link NumberConverter} * documentation for further details. * <p> - * Can be configured to either return a <i>default value</i> or throw a + * Can be configured to either return a <em>default value</em> or throw a * {@code ConversionException} if a conversion error occurs. * * @since 1.3 @@ -33,7 +33,7 @@ package org.apache.commons.beanutils2.converters; public final class DoubleConverter extends NumberConverter<Double> { /** - * Constructs a <b>java.lang.Double</b> <i>Converter</i> that throws + * Constructs a <b>java.lang.Double</b> <em>Converter</em> that throws * a {@code ConversionException} if an error occurs. */ public DoubleConverter() { @@ -41,7 +41,7 @@ public final class DoubleConverter extends NumberConverter<Double> { } /** - * Constructs a <b>java.lang.Double</b> <i>Converter</i> that returns + * Constructs a <b>java.lang.Double</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned @@ -53,7 +53,7 @@ public final class DoubleConverter extends NumberConverter<Double> { } /** - * Constructs a <b>java.lang.Double</b> <i>Converter</i> that returns + * Constructs a <b>java.lang.Double</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned diff --git a/src/main/java/org/apache/commons/beanutils2/converters/DurationConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/DurationConverter.java index e4b396e4..c9c0bd47 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/DurationConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/DurationConverter.java @@ -22,7 +22,7 @@ import java.time.Duration; * {@link org.apache.commons.beanutils2.Converter} implementation that handles conversion * to and from <b>java.time.Duration</b> objects. * <p> - * Can be configured to either return a <i>default value</i> or throw a + * Can be configured to either return a <em>default value</em> or throw a * {@code ConversionException} if a conversion error occurs. * </p> * @@ -32,14 +32,14 @@ import java.time.Duration; public final class DurationConverter extends AbstractConverter<Duration> { /** - * Constructs a <b>java.time.Duration</b> <i>Converter</i> that throws + * Constructs a <b>java.time.Duration</b> <em>Converter</em> that throws * a {@code ConversionException} if an error occurs. */ public DurationConverter() { } /** - * Constructs a <b>java.time.Duration</b> <i>Converter</i> that returns + * Constructs a <b>java.time.Duration</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned diff --git a/src/main/java/org/apache/commons/beanutils2/converters/EnumConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/EnumConverter.java index c8337882..564c64d5 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/EnumConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/EnumConverter.java @@ -20,7 +20,7 @@ package org.apache.commons.beanutils2.converters; * {@link org.apache.commons.beanutils2.Converter} implementation that handles conversion * to and from <b>java.lang.Enum</b> objects. * <p> - * Can be configured to either return a <i>default value</i> or throw a + * Can be configured to either return a <em>default value</em> or throw a * {@code ConversionException} if a conversion error occurs. * </p> * @@ -31,14 +31,14 @@ package org.apache.commons.beanutils2.converters; public final class EnumConverter<E extends Enum<E>> extends AbstractConverter<Enum<E>> { /** - * Constructs a <b>java.lang.Enum</b> <i>Converter</i> that throws + * Constructs a <b>java.lang.Enum</b> <em>Converter</em> that throws * a {@code ConversionException} if an error occurs. */ public EnumConverter() { } /** - * Constructs a <b>java.lang.Enum</b> <i>Converter</i> that returns + * Constructs a <b>java.lang.Enum</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned diff --git a/src/main/java/org/apache/commons/beanutils2/converters/FileConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/FileConverter.java index f5abe696..c2e9c5e7 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/FileConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/FileConverter.java @@ -22,7 +22,7 @@ import java.io.File; * {@link org.apache.commons.beanutils2.Converter} implementation that handles conversion * to and from <b>java.io.File</b> objects. * <p> - * Can be configured to either return a <i>default value</i> or throw a + * Can be configured to either return a <em>default value</em> or throw a * {@code ConversionException} if a conversion error occurs. * * @since 1.6 @@ -30,14 +30,14 @@ import java.io.File; public final class FileConverter extends AbstractConverter<File> { /** - * Constructs a <b>java.io.File</b> <i>Converter</i> that throws + * Constructs a <b>java.io.File</b> <em>Converter</em> that throws * a {@code ConversionException} if an error occurs. */ public FileConverter() { } /** - * Constructs a <b>java.io.File</b> <i>Converter</i> that returns + * Constructs a <b>java.io.File</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned diff --git a/src/main/java/org/apache/commons/beanutils2/converters/FloatConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/FloatConverter.java index 0975a9bc..0fc9fc76 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/FloatConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/FloatConverter.java @@ -25,7 +25,7 @@ package org.apache.commons.beanutils2.converters; * or by specifying a format pattern. See the {@link NumberConverter} * documentation for further details. * <p> - * Can be configured to either return a <i>default value</i> or throw a + * Can be configured to either return a <em>default value</em> or throw a * {@code ConversionException} if a conversion error occurs. * * @since 1.3 @@ -33,7 +33,7 @@ package org.apache.commons.beanutils2.converters; public final class FloatConverter extends NumberConverter<Float> { /** - * Constructs a <b>java.lang.Float</b> <i>Converter</i> that throws + * Constructs a <b>java.lang.Float</b> <em>Converter</em> that throws * a {@code ConversionException} if an error occurs. */ public FloatConverter() { @@ -41,7 +41,7 @@ public final class FloatConverter extends NumberConverter<Float> { } /** - * Constructs a <b>java.lang.Float</b> <i>Converter</i> that returns + * Constructs a <b>java.lang.Float</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned @@ -53,7 +53,7 @@ public final class FloatConverter extends NumberConverter<Float> { } /** - * Constructs a <b>java.lang.Float</b> <i>Converter</i> that returns + * Constructs a <b>java.lang.Float</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned diff --git a/src/main/java/org/apache/commons/beanutils2/converters/InetAddressConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/InetAddressConverter.java index df85920c..d07ca101 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/InetAddressConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/InetAddressConverter.java @@ -30,7 +30,7 @@ import java.net.UnknownHostException; public class InetAddressConverter extends AbstractConverter<InetAddress> { /** - * Construct a <b>{@link InetAddress}</b> <i>Converter</i> that throws a {@code ConversionException} if an error + * Construct a <b>{@link InetAddress}</b> <em>Converter</em> that throws a {@code ConversionException} if an error * occurs. */ public InetAddressConverter() { diff --git a/src/main/java/org/apache/commons/beanutils2/converters/IntegerConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/IntegerConverter.java index ef24406e..d04babab 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/IntegerConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/IntegerConverter.java @@ -25,7 +25,7 @@ package org.apache.commons.beanutils2.converters; * or by specifying a format pattern. See the {@link NumberConverter} * documentation for further details. * <p> - * Can be configured to either return a <i>default value</i> or throw a + * Can be configured to either return a <em>default value</em> or throw a * {@code ConversionException} if a conversion error occurs. * * @since 1.3 @@ -33,7 +33,7 @@ package org.apache.commons.beanutils2.converters; public final class IntegerConverter extends NumberConverter<Integer> { /** - * Constructs a <b>java.lang.Integer</b> <i>Converter</i> that throws + * Constructs a <b>java.lang.Integer</b> <em>Converter</em> that throws * a {@code ConversionException} if an error occurs. */ public IntegerConverter() { @@ -41,7 +41,7 @@ public final class IntegerConverter extends NumberConverter<Integer> { } /** - * Constructs a <b>java.lang.Integer</b> <i>Converter</i> that returns + * Constructs a <b>java.lang.Integer</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned @@ -53,7 +53,7 @@ public final class IntegerConverter extends NumberConverter<Integer> { } /** - * Constructs a <b>java.lang.Integer</b> <i>Converter</i> that returns + * Constructs a <b>java.lang.Integer</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned diff --git a/src/main/java/org/apache/commons/beanutils2/converters/LocalDateConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/LocalDateConverter.java index e8d8e9cc..86e87163 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/LocalDateConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/LocalDateConverter.java @@ -28,7 +28,7 @@ import java.time.LocalDate; * See the {@link DateTimeConverter} documentation for further details. * </p> * <p> - * Can be configured to either return a <i>default value</i> or throw a + * Can be configured to either return a <em>default value</em> or throw a * {@code ConversionException} if a conversion error occurs. * </p> * @@ -38,14 +38,14 @@ import java.time.LocalDate; public final class LocalDateConverter extends DateTimeConverter<LocalDate> { /** - * Constructs a <b>java.time.LocalDate</b> <i>Converter</i> that throws + * Constructs a <b>java.time.LocalDate</b> <em>Converter</em> that throws * a {@code ConversionException} if an error occurs. */ public LocalDateConverter() { } /** - * Constructs a <b>java.time.LocalDate</b> <i>Converter</i> that returns + * Constructs a <b>java.time.LocalDate</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned diff --git a/src/main/java/org/apache/commons/beanutils2/converters/LocalDateTimeConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/LocalDateTimeConverter.java index d65a5710..b1bae089 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/LocalDateTimeConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/LocalDateTimeConverter.java @@ -28,7 +28,7 @@ import java.time.LocalDateTime; * See the {@link DateTimeConverter} documentation for further details. * </p> * <p> - * Can be configured to either return a <i>default value</i> or throw a + * Can be configured to either return a <em>default value</em> or throw a * {@code ConversionException} if a conversion error occurs. * </p> * @@ -38,14 +38,14 @@ import java.time.LocalDateTime; public final class LocalDateTimeConverter extends DateTimeConverter<LocalDateTime> { /** - * Constructs a <b>java.time.LocalDateTime</b> <i>Converter</i> that throws + * Constructs a <b>java.time.LocalDateTime</b> <em>Converter</em> that throws * a {@code ConversionException} if an error occurs. */ public LocalDateTimeConverter() { } /** - * Constructs a <b>java.time.LocalDateTime</b> <i>Converter</i> that returns + * Constructs a <b>java.time.LocalDateTime</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned diff --git a/src/main/java/org/apache/commons/beanutils2/converters/LocalTimeConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/LocalTimeConverter.java index a0eee4e9..309aad95 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/LocalTimeConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/LocalTimeConverter.java @@ -22,7 +22,7 @@ import java.time.LocalTime; * {@link org.apache.commons.beanutils2.Converter} implementation that handles conversion * to and from <b>java.time.LocalTime</b> objects. * <p> - * Can be configured to either return a <i>default value</i> or throw a + * Can be configured to either return a <em>default value</em> or throw a * {@code ConversionException} if a conversion error occurs. * </p> * @@ -32,14 +32,14 @@ import java.time.LocalTime; public final class LocalTimeConverter extends AbstractConverter<LocalTime> { /** - * Constructs a <b>java.time.LocalTime</b> <i>Converter</i> that throws + * Constructs a <b>java.time.LocalTime</b> <em>Converter</em> that throws * a {@code ConversionException} if an error occurs. */ public LocalTimeConverter() { } /** - * Constructs a <b>java.time.LocalTime</b> <i>Converter</i> that returns + * Constructs a <b>java.time.LocalTime</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned diff --git a/src/main/java/org/apache/commons/beanutils2/converters/LocaleConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/LocaleConverter.java index 9d484716..029d0b88 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/LocaleConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/LocaleConverter.java @@ -28,7 +28,7 @@ import java.util.Locale; public class LocaleConverter extends AbstractConverter<Locale> { /** - * Construct a <b>{@link Locale}</b> <i>Converter</i> that throws a {@code ConversionException} if an error occurs. + * Construct a <b>{@link Locale}</b> <em>Converter</em> that throws a {@code ConversionException} if an error occurs. */ public LocaleConverter() { super(); diff --git a/src/main/java/org/apache/commons/beanutils2/converters/LongConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/LongConverter.java index 47d5d412..2efbd41d 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/LongConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/LongConverter.java @@ -25,7 +25,7 @@ package org.apache.commons.beanutils2.converters; * or by specifying a format pattern. See the {@link NumberConverter} * documentation for further details. * <p> - * Can be configured to either return a <i>default value</i> or throw a + * Can be configured to either return a <em>default value</em> or throw a * {@code ConversionException} if a conversion error occurs. * * @since 1.3 @@ -33,7 +33,7 @@ package org.apache.commons.beanutils2.converters; public final class LongConverter extends NumberConverter<Long> { /** - * Constructs a <b>java.lang.Long</b> <i>Converter</i> that throws + * Constructs a <b>java.lang.Long</b> <em>Converter</em> that throws * a {@code ConversionException} if an error occurs. */ public LongConverter() { @@ -41,7 +41,7 @@ public final class LongConverter extends NumberConverter<Long> { } /** - * Constructs a <b>java.lang.Long</b> <i>Converter</i> that returns + * Constructs a <b>java.lang.Long</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned @@ -53,7 +53,7 @@ public final class LongConverter extends NumberConverter<Long> { } /** - * Constructs a <b>java.lang.Long</b> <i>Converter</i> that returns + * Constructs a <b>java.lang.Long</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned diff --git a/src/main/java/org/apache/commons/beanutils2/converters/MonthDayConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/MonthDayConverter.java index d68da349..8f48d088 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/MonthDayConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/MonthDayConverter.java @@ -22,7 +22,7 @@ import java.time.MonthDay; * {@link org.apache.commons.beanutils2.Converter} implementation that handles conversion * to and from <b>java.time.MonthDay</b> objects. * <p> - * Can be configured to either return a <i>default value</i> or throw a + * Can be configured to either return a <em>default value</em> or throw a * {@code ConversionException} if a conversion error occurs. * </p> * @@ -32,14 +32,14 @@ import java.time.MonthDay; public final class MonthDayConverter extends AbstractConverter<MonthDay> { /** - * Constructs a <b>java.time.MonthDay</b> <i>Converter</i> that throws + * Constructs a <b>java.time.MonthDay</b> <em>Converter</em> that throws * a {@code ConversionException} if an error occurs. */ public MonthDayConverter() { } /** - * Constructs a <b>java.time.MonthDay</b> <i>Converter</i> that returns + * Constructs a <b>java.time.MonthDay</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned diff --git a/src/main/java/org/apache/commons/beanutils2/converters/NumberConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/NumberConverter.java index 547f8a80..f188db01 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/NumberConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/NumberConverter.java @@ -78,8 +78,8 @@ import org.apache.commons.beanutils2.ConversionException; * </ul> * * <p> - * <strong>N.B.</strong>Patterns can only be specified using the <i>standard</i> - * pattern characters and NOT in <i>localized</i> form (see {@link java.text.DecimalFormat}). + * <strong>N.B.</strong>Patterns can only be specified using the <em>standard</em> + * pattern characters and NOT in <em>localized</em> form (see {@link java.text.DecimalFormat}). * For example to cater for number styles used in Germany such as {@code 0.000,00} the pattern * is specified in the normal form {@code 0,000.00</code> and the locale set to <code>Locale.GERMANY} * @@ -97,7 +97,7 @@ public abstract class NumberConverter<N extends Number> extends AbstractConverte private Locale locale; /** - * Constructs a <b>java.lang.Number</b> <i>Converter</i> + * Constructs a <b>java.lang.Number</b> <em>Converter</em> * that throws a {@code ConversionException} if a error occurs. * * @param allowDecimals Indicates whether decimals are allowed @@ -107,7 +107,7 @@ public abstract class NumberConverter<N extends Number> extends AbstractConverte } /** - * Constructs a {@link Number} <i>Converter</i> that returns + * Constructs a {@link Number} <em>Converter</em> that returns * a default value if an error occurs. * * @param allowDecimals Indicates whether decimals are allowed @@ -241,7 +241,7 @@ public abstract class NumberConverter<N extends Number> extends AbstractConverte } /** - * Gets the Locale for the <i>Converter</i> + * Gets the Locale for the <em>Converter</em> * (or {@code null} if none specified). * * @return The locale to use for conversion @@ -304,7 +304,7 @@ public abstract class NumberConverter<N extends Number> extends AbstractConverte } /** - * Sets the Locale for the <i>Converter</i>. + * Sets the Locale for the <em>Converter</em>. * * @param locale The locale to use for conversion */ @@ -409,7 +409,7 @@ public abstract class NumberConverter<N extends Number> extends AbstractConverte /** * Convert any Number object to the specified type for this - * <i>Converter</i>. + * <em>Converter</em>. * <p> * This method handles conversion to the following types: * <ul> diff --git a/src/main/java/org/apache/commons/beanutils2/converters/OffsetDateTimeConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/OffsetDateTimeConverter.java index 1e3279af..c21adea2 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/OffsetDateTimeConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/OffsetDateTimeConverter.java @@ -28,7 +28,7 @@ import java.time.OffsetDateTime; * See the {@link DateTimeConverter} documentation for further details. * </p> * <p> - * Can be configured to either return a <i>default value</i> or throw a + * Can be configured to either return a <em>default value</em> or throw a * {@code ConversionException} if a conversion error occurs. * </p> * @@ -38,14 +38,14 @@ import java.time.OffsetDateTime; public final class OffsetDateTimeConverter extends DateTimeConverter<OffsetDateTime> { /** - * Constructs a <b>java.time.OffsetDateTime</b> <i>Converter</i> that throws + * Constructs a <b>java.time.OffsetDateTime</b> <em>Converter</em> that throws * a {@code ConversionException} if an error occurs. */ public OffsetDateTimeConverter() { } /** - * Constructs a <b>java.time.OffsetDateTime</b> <i>Converter</i> that returns + * Constructs a <b>java.time.OffsetDateTime</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned diff --git a/src/main/java/org/apache/commons/beanutils2/converters/OffsetTimeConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/OffsetTimeConverter.java index 300b7cde..57fad9ea 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/OffsetTimeConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/OffsetTimeConverter.java @@ -22,7 +22,7 @@ import java.time.OffsetTime; * {@link org.apache.commons.beanutils2.Converter} implementation that handles conversion * to and from <b>java.time.OffsetTime</b> objects. * <p> - * Can be configured to either return a <i>default value</i> or throw a + * Can be configured to either return a <em>default value</em> or throw a * {@code ConversionException} if a conversion error occurs. * </p> * @@ -32,14 +32,14 @@ import java.time.OffsetTime; public final class OffsetTimeConverter extends AbstractConverter<OffsetTime> { /** - * Constructs a <b>java.time.OffsetTime</b> <i>Converter</i> that throws + * Constructs a <b>java.time.OffsetTime</b> <em>Converter</em> that throws * a {@code ConversionException} if an error occurs. */ public OffsetTimeConverter() { } /** - * Constructs a <b>java.time.OffsetTime</b> <i>Converter</i> that returns + * Constructs a <b>java.time.OffsetTime</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned diff --git a/src/main/java/org/apache/commons/beanutils2/converters/PathConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/PathConverter.java index 112098df..9ca059a2 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/PathConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/PathConverter.java @@ -23,7 +23,7 @@ import java.nio.file.Paths; * {@link org.apache.commons.beanutils2.Converter} implementation that handles conversion * to and from <b>java.nio.file.Path</b> objects. * <p> - * Can be configured to either return a <i>default value</i> or throw a + * Can be configured to either return a <em>default value</em> or throw a * {@code ConversionException} if a conversion error occurs. * * @since 2.0 @@ -31,14 +31,14 @@ import java.nio.file.Paths; public final class PathConverter extends AbstractConverter<Path> { /** - * Constructs a <b>java.nio.file.Path</b> <i>Converter</i> that throws + * Constructs a <b>java.nio.file.Path</b> <em>Converter</em> that throws * a {@code ConversionException} if an error occurs. */ public PathConverter() { } /** - * Constructs a <b>java.nio.file.Path</b> <i>Converter</i> that returns + * Constructs a <b>java.nio.file.Path</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned diff --git a/src/main/java/org/apache/commons/beanutils2/converters/PatternConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/PatternConverter.java index b4b04b75..64bf9b92 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/PatternConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/PatternConverter.java @@ -28,7 +28,7 @@ import java.util.regex.Pattern; public class PatternConverter extends AbstractConverter<Pattern> { /** - * Construct a <b>{@link Pattern}</b> <i>Converter</i> that throws a {@code ConversionException} if an error occurs. + * Construct a <b>{@link Pattern}</b> <em>Converter</em> that throws a {@code ConversionException} if an error occurs. */ public PatternConverter() { super(); diff --git a/src/main/java/org/apache/commons/beanutils2/converters/PeriodConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/PeriodConverter.java index d9ca46bb..224236ea 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/PeriodConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/PeriodConverter.java @@ -22,7 +22,7 @@ import java.time.Period; * {@link org.apache.commons.beanutils2.Converter} implementation that handles conversion * to and from <b>java.time.Period</b> objects. * <p> - * Can be configured to either return a <i>default value</i> or throw a + * Can be configured to either return a <em>default value</em> or throw a * {@code ConversionException} if a conversion error occurs. * </p> * @@ -32,14 +32,14 @@ import java.time.Period; public final class PeriodConverter extends AbstractConverter<Period> { /** - * Constructs a <b>java.time.Period</b> <i>Converter</i> that throws + * Constructs a <b>java.time.Period</b> <em>Converter</em> that throws * a {@code ConversionException} if an error occurs. */ public PeriodConverter() { } /** - * Constructs a <b>java.time.Period</b> <i>Converter</i> that returns + * Constructs a <b>java.time.Period</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned diff --git a/src/main/java/org/apache/commons/beanutils2/converters/PointConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/PointConverter.java index 1fa21ffe..b6434e58 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/PointConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/PointConverter.java @@ -32,7 +32,7 @@ public class PointConverter extends AbstractConverter<Point> { private static final Pattern POINT_SPLIT = Pattern.compile("\\s*,\\s*"); /** - * Construct a <b>{@link Point}</b> <i>Converter</i> that throws a {@code ConversionException} if an error occurs. + * Construct a <b>{@link Point}</b> <em>Converter</em> that throws a {@code ConversionException} if an error occurs. */ public PointConverter() { super(); diff --git a/src/main/java/org/apache/commons/beanutils2/converters/ShortConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/ShortConverter.java index 647b1936..96bbfc7d 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/ShortConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/ShortConverter.java @@ -25,7 +25,7 @@ package org.apache.commons.beanutils2.converters; * or by specifying a format pattern. See the {@link NumberConverter} * documentation for further details. * <p> - * Can be configured to either return a <i>default value</i> or throw a + * Can be configured to either return a <em>default value</em> or throw a * {@code ConversionException} if a conversion error occurs. * * @since 1.3 @@ -33,7 +33,7 @@ package org.apache.commons.beanutils2.converters; public final class ShortConverter extends NumberConverter<Short> { /** - * Constructs a <b>java.lang.Short</b> <i>Converter</i> that throws + * Constructs a <b>java.lang.Short</b> <em>Converter</em> that throws * a {@code ConversionException} if an error occurs. */ public ShortConverter() { @@ -41,7 +41,7 @@ public final class ShortConverter extends NumberConverter<Short> { } /** - * Constructs a <b>java.lang.Short</b> <i>Converter</i> that returns + * Constructs a <b>java.lang.Short</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned @@ -53,7 +53,7 @@ public final class ShortConverter extends NumberConverter<Short> { } /** - * Constructs a <b>java.lang.Short</b> <i>Converter</i> that returns + * Constructs a <b>java.lang.Short</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned diff --git a/src/main/java/org/apache/commons/beanutils2/converters/StringConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/StringConverter.java index a58dedb3..51b27977 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/StringConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/StringConverter.java @@ -43,14 +43,14 @@ package org.apache.commons.beanutils2.converters; public final class StringConverter extends AbstractConverter<String> { /** - * Constructs a <b>java.lang.String</b> <i>Converter</i> that throws + * Constructs a <b>java.lang.String</b> <em>Converter</em> that throws * a {@code ConversionException} if an error occurs. */ public StringConverter() { } /** - * Constructs a <b>java.lang.String</b> <i>Converter</i> that returns + * Constructs a <b>java.lang.String</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned diff --git a/src/main/java/org/apache/commons/beanutils2/converters/URIConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/URIConverter.java index 5c802750..e3c1bf62 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/URIConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/URIConverter.java @@ -22,7 +22,7 @@ import java.net.URI; * {@link org.apache.commons.beanutils2.Converter} implementation that handles conversion * to and from <b>java.net.URI</b> objects. * <p> - * Can be configured to either return a <i>default value</i> or throw a + * Can be configured to either return a <em>default value</em> or throw a * {@code ConversionException} if a conversion error occurs. * * @since 2.0 @@ -30,14 +30,14 @@ import java.net.URI; public final class URIConverter extends AbstractConverter<URI> { /** - * Constructs a <b>java.net.URI</b> <i>Converter</i> that throws + * Constructs a <b>java.net.URI</b> <em>Converter</em> that throws * a {@code ConversionException} if an error occurs. */ public URIConverter() { } /** - * Constructs a <b>java.net.URI</b> <i>Converter</i> that returns + * Constructs a <b>java.net.URI</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned diff --git a/src/main/java/org/apache/commons/beanutils2/converters/URLConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/URLConverter.java index 4eabeac0..7e93d397 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/URLConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/URLConverter.java @@ -22,7 +22,7 @@ import java.net.URL; * {@link org.apache.commons.beanutils2.Converter} implementation that handles conversion * to and from <b>java.net.URL</b> objects. * <p> - * Can be configured to either return a <i>default value</i> or throw a + * Can be configured to either return a <em>default value</em> or throw a * {@code ConversionException} if a conversion error occurs. * * @since 1.3 @@ -30,14 +30,14 @@ import java.net.URL; public final class URLConverter extends AbstractConverter<URL> { /** - * Constructs a <b>java.net.URL</b> <i>Converter</i> that throws + * Constructs a <b>java.net.URL</b> <em>Converter</em> that throws * a {@code ConversionException} if an error occurs. */ public URLConverter() { } /** - * Constructs a <b>java.net.URL</b> <i>Converter</i> that returns + * Constructs a <b>java.net.URL</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned diff --git a/src/main/java/org/apache/commons/beanutils2/converters/UUIDConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/UUIDConverter.java index 6d63f891..92dbe7fc 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/UUIDConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/UUIDConverter.java @@ -22,7 +22,7 @@ import java.util.UUID; * {@link org.apache.commons.beanutils2.Converter} implementation that handles conversion * to and from <b>java.util.UUID</b> objects. * <p> - * Can be configured to either return a <i>default value</i> or throw a + * Can be configured to either return a <em>default value</em> or throw a * {@code ConversionException} if a conversion error occurs. * * @since 2.0 @@ -30,14 +30,14 @@ import java.util.UUID; public final class UUIDConverter extends AbstractConverter<UUID> { /** - * Constructs a <b>java.util.UUID</b> <i>Converter</i> that throws + * Constructs a <b>java.util.UUID</b> <em>Converter</em> that throws * a {@code ConversionException} if an error occurs. */ public UUIDConverter() { } /** - * Constructs a <b>java.util.UUID</b> <i>Converter</i> that returns + * Constructs a <b>java.util.UUID</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned diff --git a/src/main/java/org/apache/commons/beanutils2/converters/YearConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/YearConverter.java index 5515c253..8d2dc95c 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/YearConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/YearConverter.java @@ -22,7 +22,7 @@ import java.time.Year; * {@link org.apache.commons.beanutils2.Converter} implementation that handles conversion * to and from <b>java.time.Year</b> objects. * <p> - * Can be configured to either return a <i>default value</i> or throw a + * Can be configured to either return a <em>default value</em> or throw a * {@code ConversionException} if a conversion error occurs. * </p> * @@ -32,14 +32,14 @@ import java.time.Year; public final class YearConverter extends AbstractConverter<Year> { /** - * Constructs a <b>java.time.Year</b> <i>Converter</i> that throws + * Constructs a <b>java.time.Year</b> <em>Converter</em> that throws * a {@code ConversionException} if an error occurs. */ public YearConverter() { } /** - * Constructs a <b>java.time.Year</b> <i>Converter</i> that returns + * Constructs a <b>java.time.Year</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned diff --git a/src/main/java/org/apache/commons/beanutils2/converters/YearMonthConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/YearMonthConverter.java index 8695c8ec..abab00a2 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/YearMonthConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/YearMonthConverter.java @@ -22,7 +22,7 @@ import java.time.YearMonth; * {@link org.apache.commons.beanutils2.Converter} implementation that handles conversion * to and from <b>java.time.YearMonth</b> objects. * <p> - * Can be configured to either return a <i>default value</i> or throw a + * Can be configured to either return a <em>default value</em> or throw a * {@code ConversionException} if a conversion error occurs. * </p> * @@ -32,14 +32,14 @@ import java.time.YearMonth; public final class YearMonthConverter extends AbstractConverter<YearMonth> { /** - * Constructs a <b>java.time.YearMonth</b> <i>Converter</i> that throws + * Constructs a <b>java.time.YearMonth</b> <em>Converter</em> that throws * a {@code ConversionException} if an error occurs. */ public YearMonthConverter() { } /** - * Constructs a <b>java.time.YearMonth</b> <i>Converter</i> that returns + * Constructs a <b>java.time.YearMonth</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned diff --git a/src/main/java/org/apache/commons/beanutils2/converters/ZoneIdConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/ZoneIdConverter.java index d8baeb3d..4c1a9501 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/ZoneIdConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/ZoneIdConverter.java @@ -22,7 +22,7 @@ import java.time.ZoneId; * {@link org.apache.commons.beanutils2.Converter} implementation that handles conversion * to and from <b>java.time.ZoneId</b> objects. * <p> - * Can be configured to either return a <i>default value</i> or throw a + * Can be configured to either return a <em>default value</em> or throw a * {@code ConversionException} if a conversion error occurs. * </p> * @@ -32,14 +32,14 @@ import java.time.ZoneId; public final class ZoneIdConverter extends AbstractConverter<ZoneId> { /** - * Constructs a <b>java.time.ZoneId</b> <i>Converter</i> that throws + * Constructs a <b>java.time.ZoneId</b> <em>Converter</em> that throws * a {@code ConversionException} if an error occurs. */ public ZoneIdConverter() { } /** - * Constructs a <b>java.time.ZoneId</b> <i>Converter</i> that returns + * Constructs a <b>java.time.ZoneId</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned diff --git a/src/main/java/org/apache/commons/beanutils2/converters/ZoneOffsetConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/ZoneOffsetConverter.java index 2e25a439..daab97f5 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/ZoneOffsetConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/ZoneOffsetConverter.java @@ -22,7 +22,7 @@ import java.time.ZoneOffset; * {@link org.apache.commons.beanutils2.Converter} implementation that handles conversion * to and from <b>java.time.ZoneOffset</b> objects. * <p> - * Can be configured to either return a <i>default value</i> or throw a + * Can be configured to either return a <em>default value</em> or throw a * {@code ConversionException} if a conversion error occurs. * </p> * @@ -32,14 +32,14 @@ import java.time.ZoneOffset; public final class ZoneOffsetConverter extends AbstractConverter<ZoneOffset> { /** - * Constructs a <b>java.time.ZoneOffset</b> <i>Converter</i> that throws + * Constructs a <b>java.time.ZoneOffset</b> <em>Converter</em> that throws * a {@code ConversionException} if an error occurs. */ public ZoneOffsetConverter() { } /** - * Constructs a <b>java.time.ZoneOffset</b> <i>Converter</i> that returns + * Constructs a <b>java.time.ZoneOffset</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned diff --git a/src/main/java/org/apache/commons/beanutils2/converters/ZonedDateTimeConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/ZonedDateTimeConverter.java index 6b92fc33..56558bc4 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/ZonedDateTimeConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/ZonedDateTimeConverter.java @@ -28,7 +28,7 @@ import java.time.ZonedDateTime; * See the {@link DateTimeConverter} documentation for further details. * </p> * <p> - * Can be configured to either return a <i>default value</i> or throw a + * Can be configured to either return a <em>default value</em> or throw a * {@code ConversionException} if a conversion error occurs. * </p> * @@ -38,14 +38,14 @@ import java.time.ZonedDateTime; public final class ZonedDateTimeConverter extends DateTimeConverter<ZonedDateTime> { /** - * Constructs a <b>java.time.ZonedDateTime</b> <i>Converter</i> that throws + * Constructs a <b>java.time.ZonedDateTime</b> <em>Converter</em> that throws * a {@code ConversionException} if an error occurs. */ public ZonedDateTimeConverter() { } /** - * Constructs a <b>java.time.ZonedDateTime</b> <i>Converter</i> that returns + * Constructs a <b>java.time.ZonedDateTime</b> <em>Converter</em> that returns * a default value if an error occurs. * * @param defaultValue The default value to be returned diff --git a/src/main/java/org/apache/commons/beanutils2/expression/Resolver.java b/src/main/java/org/apache/commons/beanutils2/expression/Resolver.java index cc718ce0..1807a577 100644 --- a/src/main/java/org/apache/commons/beanutils2/expression/Resolver.java +++ b/src/main/java/org/apache/commons/beanutils2/expression/Resolver.java @@ -20,8 +20,8 @@ package org.apache.commons.beanutils2.expression; * Property Name Expression Resolver. * <p> * Methods such as PropertyUtilsBean's {@code setNestedProperty()} method - * use a {@code Resolver} to process a <i>property name</i> - * expression and resolve <i>nested</i>, <i>indexed</i> and <i>mapped</i> + * use a {@code Resolver} to process a <em>property name</em> + * expression and resolve <em>nested</em>, <em>indexed</em> and <em>mapped</em> * property names. The following code provides an example usage * demonstrating all the methods: * diff --git a/src/main/java/org/apache/commons/beanutils2/package-info.java b/src/main/java/org/apache/commons/beanutils2/package-info.java index 54cc5827..e56f7fce 100644 --- a/src/main/java/org/apache/commons/beanutils2/package-info.java +++ b/src/main/java/org/apache/commons/beanutils2/package-info.java @@ -47,7 +47,7 @@ * <li>3.3 <a href="#dynamic.resultSet">ResultSetDynaClass (Wraps ResultSet in DynaBeans)</a></li> * <li>3.4 <a href="#dynamic.rowSet">RowSetDynaClass (Disconnected ResultSet as DynaBeans)</a></li> * <li>3.5 <a href="#dynamic.wrap">WrapDynaBean and WrapDynaClass</a></li> - * <li>3.6 <a href="#dynamic.lazy"><i>Lazy</i> DynaBeans</a></li> + * <li>3.6 <a href="#dynamic.lazy"><em>Lazy</em> DynaBeans</a></li> * </ul> * </li> * <li>4. <a href="#conversion">Data Type Conversions</a> @@ -650,15 +650,15 @@ * created internally, you never need to deal with them.</p> * * <a id="dynamic.lazy"></a> - * <h2>3.6 <i>Lazy</i> DynaBeans</h2> + * <h2>3.6 <em>Lazy</em> DynaBeans</h2> * * <ul> - * <li>1. <a href="#LazyDynaBean">LazyDynaBean</a> - A <i>Lazy</i> + * <li>1. <a href="#LazyDynaBean">LazyDynaBean</a> - A <em>Lazy</em> * {@link org.apache.commons.beanutils2.DynaBean}</li> - * <li>2. <a href="#LazyDynaMap">LazyDynaMap</a> - A <i>light weight</i> + * <li>2. <a href="#LazyDynaMap">LazyDynaMap</a> - A <em>light weight</em> * {@link org.apache.commons.beanutils2.DynaBean} facade to a Map - * with <i>lazy</i> map/list processing</li> - * <li>3. <a href="#LazyDynaList">LazyDynaList</a> - A <i>lazy list</i> + * with <em>lazy</em> map/list processing</li> + * <li>3. <a href="#LazyDynaList">LazyDynaList</a> - A <em>lazy list</em> * for {@link org.apache.commons.beanutils2.DynaBean DynaBean's}, * {@link java.util.Map}'s or POJO beans.</li> * <li>4. <a href="#LazyDynaClass">LazyDynaClass</a> - A @@ -666,40 +666,40 @@ * </ul> * * <p>You bought into the DynaBeans because it saves coding all those POJO JavaBeans but - * you're here because <i>lazy</i> caught your eye and wondered whats that about? - * What makes these flavors of DynaBean <i>lazy</i> are the following features:</p> + * you're here because <em>lazy</em> caught your eye and wondered whats that about? + * What makes these flavors of DynaBean <em>lazy</em> are the following features:</p> * <ul> - * <li><strong><i>Lazy</i> property addition</strong> - lazy beans use a + * <li><strong><em>Lazy</em> property addition</strong> - lazy beans use a * {@link org.apache.commons.beanutils2.DynaClass} which implements * the {@link org.apache.commons.beanutils2.MutableDynaClass} * interface. This provides the ability to add and remove a DynaClass's - * properties. <i>Lazy</i> beans use this feature to automatically add + * properties. <em>Lazy</em> beans use this feature to automatically add * a property which doesn't exist to the DynaClass when * the {@code set(name, value)} method is called.</li> - * <li><strong><i>Lazy</i> List/Array growth</strong> - If an <i>indexed</i> property is not large + * <li><strong><em>Lazy</em> List/Array growth</strong> - If an <em>indexed</em> property is not large * enough to accomodate the {@code index</code> being set then the <code>List} or - * {@code Array} is automatically <i>grown</i> so that it is.</li> - * <li><strong><i>Lazy</i> List/Array instantiation</strong> - if an <i>indexed</i> + * {@code Array} is automatically <em>grown</em> so that it is.</li> + * <li><strong><em>Lazy</em> List/Array instantiation</strong> - if an <em>indexed</em> * property doesn't exist then calling the {@link org.apache.commons.beanutils2.DynaBean DynaBean's} - * <i>indexed</i> property getter/setter methods (i.e. {@code get(name, index)} or + * <em>indexed</em> property getter/setter methods (i.e. {@code get(name, index)} or * {@code set(name, index, value)</code>) results in either a new <code>List} * or {@code Array} being instantiated. If the indexed property has not been * defined in the DynaClass then it is automatically added and a default {@code List} * implementation instantiated.</li> - * <li><strong><i>Lazy</i> Map instantiation</strong> - if a <i>mapped</i> + * <li><strong><em>Lazy</em> Map instantiation</strong> - if a <em>mapped</em> * property doesn't exist then calling the {@link org.apache.commons.beanutils2.DynaBean DynaBean's} - * <i>mapped</i> property getter/setter methods (i.e. {@code get(name, key)} or + * <em>mapped</em> property getter/setter methods (i.e. {@code get(name, key)} or * {@code set(name, key, value)</code>) results in a new <code>Map} * being instantiated. If the mapped property has not been defined in the DynaClass * then it is automatically added and a default {@code Map} implementation * instantiated.</li> - * <li><strong><i>Lazy</i> Bean instantiation</strong> - if a property is defined in + * <li><strong><em>Lazy</em> Bean instantiation</strong> - if a property is defined in * the {@code DynaClass</code> as a <code>DynaBean} or regular bean and * doesn't exist in the {@code DynaBean</code> then <code>LazyDynaBean} wiill * try to instantiate the bean using a default empty constructor.</li> * </ul> * - * <p><strong>1. {@link org.apache.commons.beanutils2.LazyDynaBean}</strong> is the standard <i>lazy</i> bean + * <p><strong>1. {@link org.apache.commons.beanutils2.LazyDynaBean}</strong> is the standard <em>lazy</em> bean * implementation. By default it is associated with a {@link org.apache.commons.beanutils2.LazyDynaClass} * which implements the {@link org.apache.commons.beanutils2.MutableDynaClass} interface - however * it can be used with any {@code MutableDynaClass} implementation. The question is <i>how do @@ -718,14 +718,14 @@ * dynaBean.set("address", 2, addressLine3); // indexed * </pre> * - * <p><strong>2. {@link org.apache.commons.beanutils2.LazyDynaMap}</strong> is a <i>light weight</i> - * {@code DynaBean</code> facade to a <code>Map} with all the usual <i>lazy</i> features. Its - * <i>light weight</i> because it doesn't have an associated {@code DynaClass} containing all the properties. + * <p><strong>2. {@link org.apache.commons.beanutils2.LazyDynaMap}</strong> is a <em>light weight</em> + * {@code DynaBean</code> facade to a <code>Map} with all the usual <em>lazy</em> features. Its + * <em>light weight</em> because it doesn't have an associated {@code DynaClass} containing all the properties. * In fact it actually implements the {@code DynaClass</code> interface itself (and <code>MutableDynaClass}) - * and derives all the <i>DynaClass</i> information from the actual contents of the {@code Map}. A + * and derives all the <em>DynaClass</em> information from the actual contents of the {@code Map}. A * {@code LazyDynaMap</code> can be created around an existing <code>Map} or can instantiate its own * {@code Map</code>. After any {@code DynaBean} processing has finished the <code>Map} can be retrieved - * and the DynaBean <i>facade</i> discarded.</p> + * and the DynaBean <em>facade</em> discarded.</p> * * <p>If you need a new {@code Map} then to use....</p> * @@ -738,7 +738,7 @@ * * Map myMap = dynaBean.getMap() // retrieve the Map * </pre> - * <p><i>or</i> to use with an existing {@code Map} ....</p> + * <p><em>or</em> to use with an existing {@code Map} ....</p> * * <pre> * Map myMap = .... // exisitng Map @@ -747,7 +747,7 @@ * </pre> * * <p><strong>3. {@link org.apache.commons.beanutils2.LazyDynaList}</strong> - * is <i>lazy list</i> for {@link org.apache.commons.beanutils2.DynaBean DynaBeans} + * is <em>lazy list</em> for {@link org.apache.commons.beanutils2.DynaBean DynaBeans} * {@link java.util.Map}'s or POJO beans. See the <a href="LazyDynaList.html">Javadoc</a> * for more details and example usage.</p> * @@ -760,10 +760,10 @@ * anything to do with the {@code DynaClass}. However sometimes there * is a requirement to set up the {@code DynaClass} first - perhaps to * define the type of array for an indexed property, or if using the DynaBean - * in <i>restricted</i> mode (see note below) is required. Doing so is + * in <em>restricted</em> mode (see note below) is required. Doing so is * straight forward...</p> * - * <p><i>Either</i> create a {@code LazyDynaClass} first... + * <p><em>Either</em> create a {@code LazyDynaClass} first... * * <pre> * MutableDynaClass dynaClass = new LazyDynaClass(); // create DynaClass @@ -775,7 +775,7 @@ * DynaBean dynaBean = new LazyDynaBean(dynaClass); // Create DynaBean with associated DynaClass * </pre> * - * <p><i>or</i> create a {@code LazyDynaBean</code> and get the <code>DynaClass}... + * <p><em>or</em> create a {@code LazyDynaBean</code> and get the <code>DynaClass}... * * <pre> * DynaBean dynaBean = new LazyDynaBean(); // Create LazyDynaBean @@ -788,9 +788,9 @@ * </pre> * * <p><strong>NOTE:</strong> One feature of {@link org.apache.commons.beanutils2.MutableDynaClass} is that it - * has a <i>Restricted</i> property. When the DynaClass is <i>restricted</i> no properties can be added + * has a <em>Restricted</em> property. When the DynaClass is <em>restricted</em> no properties can be added * or removed from the {@code DynaClass}. Neither the {@code LazyDynaBean} or {@code LazyDynaMap} - * will add properties automatically if the {@code DynaClass} is <i>restricted</i>.</p> + * will add properties automatically if the {@code DynaClass} is <em>restricted</em>.</p> * * * <a id="conversion"></a> diff --git a/src/main/java/org/apache/commons/beanutils2/sql/AbstractJdbcDynaClass.java b/src/main/java/org/apache/commons/beanutils2/sql/AbstractJdbcDynaClass.java index c68ae617..be2fd69c 100644 --- a/src/main/java/org/apache/commons/beanutils2/sql/AbstractJdbcDynaClass.java +++ b/src/main/java/org/apache/commons/beanutils2/sql/AbstractJdbcDynaClass.java @@ -132,7 +132,7 @@ abstract class AbstractJdbcDynaClass implements DynaClass, Serializable { * Gets the table column name for the specified property name. * * @param name The property name - * @return The column name (which can be different if the <i>lowerCase</i> option is used). + * @return The column name (which can be different if the <em>lowerCase</em> option is used). */ protected String getColumnName(final String name) { if (columnNameXref != null && columnNameXref.containsKey(name)) { diff --git a/src/main/java/org/apache/commons/beanutils2/sql/converters/SqlDateConverter.java b/src/main/java/org/apache/commons/beanutils2/sql/converters/SqlDateConverter.java index 3b05aca5..d359b937 100644 --- a/src/main/java/org/apache/commons/beanutils2/sql/converters/SqlDateConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/sql/converters/SqlDateConverter.java @@ -26,20 +26,20 @@ import org.apache.commons.beanutils2.converters.DateTimeConverter; * This implementation can be configured to handle conversion either by using java.sql.Date's default String conversion, or by using a Locale's default format * or by specifying a set of format patterns. See the {@link DateTimeConverter} documentation for further details. * <p> - * Can be configured to either return a <i>default value</i> or throw a {@code ConversionException} if a conversion error occurs. + * Can be configured to either return a <em>default value</em> or throw a {@code ConversionException} if a conversion error occurs. * * @since 1.3 */ public final class SqlDateConverter extends DateTimeConverter<Date> { /** - * Constructs a <b>java.sql.Date</b> <i>Converter</i> that throws a {@code ConversionException} if an error occurs. + * Constructs a <b>java.sql.Date</b> <em>Converter</em> that throws a {@code ConversionException} if an error occurs. */ public SqlDateConverter() { } /** - * Constructs a <b>java.sql.Date</b> <i>Converter</i> that returns a default value if an error occurs. + * Constructs a <b>java.sql.Date</b> <em>Converter</em> that returns a default value if an error occurs. * * @param defaultValue The default value to be returned if the value to be converted is missing or an error occurs converting the value. */ diff --git a/src/main/java/org/apache/commons/beanutils2/sql/converters/SqlTimeConverter.java b/src/main/java/org/apache/commons/beanutils2/sql/converters/SqlTimeConverter.java index ad275d52..bc806fca 100644 --- a/src/main/java/org/apache/commons/beanutils2/sql/converters/SqlTimeConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/sql/converters/SqlTimeConverter.java @@ -29,20 +29,20 @@ import org.apache.commons.beanutils2.converters.DateTimeConverter; * This implementation can be configured to handle conversion either by using java.sql.Time's default String conversion, or by using a Locale's default format * or by specifying a set of format patterns. See the {@link DateTimeConverter} documentation for further details. * <p> - * Can be configured to either return a <i>default value</i> or throw a {@code ConversionException} if a conversion error occurs. + * Can be configured to either return a <em>default value</em> or throw a {@code ConversionException} if a conversion error occurs. * * @since 1.3 */ public final class SqlTimeConverter extends DateTimeConverter<Time> { /** - * Constructs a <b>java.sql.Time</b> <i>Converter</i> that throws a {@code ConversionException} if an error occurs. + * Constructs a <b>java.sql.Time</b> <em>Converter</em> that throws a {@code ConversionException} if an error occurs. */ public SqlTimeConverter() { } /** - * Constructs a <b>java.sql.Time</b> <i>Converter</i> that returns a default value if an error occurs. + * Constructs a <b>java.sql.Time</b> <em>Converter</em> that returns a default value if an error occurs. * * @param defaultValue The default value to be returned if the value to be converted is missing or an error occurs converting the value. */ diff --git a/src/main/java/org/apache/commons/beanutils2/sql/converters/SqlTimestampConverter.java b/src/main/java/org/apache/commons/beanutils2/sql/converters/SqlTimestampConverter.java index 0836ff3a..7af5b1fe 100644 --- a/src/main/java/org/apache/commons/beanutils2/sql/converters/SqlTimestampConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/sql/converters/SqlTimestampConverter.java @@ -29,20 +29,20 @@ import org.apache.commons.beanutils2.converters.DateTimeConverter; * This implementation can be configured to handle conversion either by using java.sql.Timestamp's default String conversion, or by using a Locale's default * format or by specifying a set of format patterns. See the {@link DateTimeConverter} documentation for further details. * <p> - * Can be configured to either return a <i>default value</i> or throw a {@code ConversionException} if a conversion error occurs. + * Can be configured to either return a <em>default value</em> or throw a {@code ConversionException} if a conversion error occurs. * * @since 1.3 */ public final class SqlTimestampConverter extends DateTimeConverter<Timestamp> { /** - * Constructs a <b>java.sql.Timestamp</b> <i>Converter</i> that throws a {@code ConversionException} if an error occurs. + * Constructs a <b>java.sql.Timestamp</b> <em>Converter</em> that throws a {@code ConversionException} if an error occurs. */ public SqlTimestampConverter() { } /** - * Constructs a <b>java.sql.Timestamp</b> <i>Converter</i> that returns a default value if an error occurs. + * Constructs a <b>java.sql.Timestamp</b> <em>Converter</em> that returns a default value if an error occurs. * * @param defaultValue The default value to be returned if the value to be converted is missing or an error occurs converting the value. */ diff --git a/src/test/java/org/apache/commons/beanutils2/bugs/other/Jira18BeanFactory.java b/src/test/java/org/apache/commons/beanutils2/bugs/other/Jira18BeanFactory.java index 8d32708c..100a1a6f 100644 --- a/src/test/java/org/apache/commons/beanutils2/bugs/other/Jira18BeanFactory.java +++ b/src/test/java/org/apache/commons/beanutils2/bugs/other/Jira18BeanFactory.java @@ -22,7 +22,7 @@ import java.util.Map; import org.apache.commons.beanutils2.bugs.Jira18TestCase; /** - * Factory which creates <i>package</i> scope beans with public methods for {@link Jira18TestCase}. + * Factory which creates <em>package</em> scope beans with public methods for {@link Jira18TestCase}. */ public class Jira18BeanFactory { diff --git a/src/test/java/org/apache/commons/beanutils2/converters/ClassReloader.java b/src/test/java/org/apache/commons/beanutils2/converters/ClassReloader.java index 5e30a1ad..d8332cb9 100644 --- a/src/test/java/org/apache/commons/beanutils2/converters/ClassReloader.java +++ b/src/test/java/org/apache/commons/beanutils2/converters/ClassReloader.java @@ -37,8 +37,8 @@ import java.io.InputStream; * </p> * * <p> - * So this class takes a sneaky alternative approach: it can grab any class already loaded by a parent classloader and <i>reload</i> that class via this - * classloader. The effect is exactly as if a class (or jar file) had been present in the classpath for a container's "shared" classloader <i>and</i> been + * So this class takes a sneaky alternative approach: it can grab any class already loaded by a parent classloader and <em>reload</em> that class via this + * classloader. The effect is exactly as if a class (or jar file) had been present in the classpath for a container's "shared" classloader <em>and</em> been * present in the component-specific classpath too, without any messing about with the way unit test code is compiled or executed. */ public class ClassReloader extends ClassLoader { diff --git a/src/test/java/org/apache/commons/beanutils2/converters/MemoryTestCase.java b/src/test/java/org/apache/commons/beanutils2/converters/MemoryTestCase.java index 86425502..0899924c 100644 --- a/src/test/java/org/apache/commons/beanutils2/converters/MemoryTestCase.java +++ b/src/test/java/org/apache/commons/beanutils2/converters/MemoryTestCase.java @@ -38,7 +38,7 @@ public class MemoryTestCase { * Attempt to force garbage collection of the specified target. * * <p> - * Unfortunately there is no way to force a JVM to perform garbage collection; all we can do is <i>hint</i> to it that garbage-collection would be a good + * Unfortunately there is no way to force a JVM to perform garbage collection; all we can do is <em>hint</em> to it that garbage-collection would be a good * idea, and to consume memory in order to trigger it. * </p> *