You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@turbine.apache.org by tv...@apache.org on 2016/11/29 20:29:13 UTC
svn commit: r1771953 - in
/turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake: ./ model/
validator/
Author: tv
Date: Tue Nov 29 20:29:12 2016
New Revision: 1771953
URL: http://svn.apache.org/viewvc?rev=1771953&view=rev
Log:
Fix JavaDoc
Modified:
turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/IntakeService.java
turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/IntakeServiceFacade.java
turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/IntakeServiceImpl.java
turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/Retrievable.java
turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/model/AppData.java
turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/model/Field.java
turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/model/FieldAdapter.java
turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/model/FileItemField.java
turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/model/Group.java
turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/model/XmlField.java
turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/BigDecimalValidator.java
turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/BooleanValidator.java
turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/Constraint.java
turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/DateRangeValidator.java
turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/DateStringValidator.java
turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/DefaultValidator.java
turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/DoubleValidator.java
turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/FieldReference.java
turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/FileValidator.java
turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/FloatValidator.java
turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/InitableByConstraintMap.java
turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/IntegerRangeValidator.java
turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/IntegerValidator.java
turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/LongValidator.java
turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/NumberValidator.java
turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/ShortValidator.java
turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/StringValidator.java
turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/Validator.java
Modified: turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/IntakeService.java
URL: http://svn.apache.org/viewvc/turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/IntakeService.java?rev=1771953&r1=1771952&r2=1771953&view=diff
==============================================================================
--- turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/IntakeService.java (original)
+++ turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/IntakeService.java Tue Nov 29 20:29:12 2016
@@ -20,7 +20,6 @@ package org.apache.fulcrum.intake;
*/
import java.beans.IntrospectionException;
-
import java.lang.reflect.Method;
import org.apache.fulcrum.intake.model.Group;
@@ -32,9 +31,9 @@ import org.apache.fulcrum.intake.model.G
* <p>Localization of Intake's error messages can be accomplished
* using Turbine's <code>LocalizationTool</code> from a Velocity template
* as follows:
- * <blockquote><code></pre>
+ * <code>
* $l10n.get($intake.SomeGroup.SomeField.Message)
- * </pre></code></blockquote>
+ * </code>
* </p>
*
* @author <a href="mailto:jmcnally@collab.net">John McNally</a>
@@ -98,7 +97,7 @@ public interface IntakeService
* Gets the current size of the pool for a named group.
*
* @param groupName the name of the group.
- *
+ * @return the size of the group pool
* @throws IntakeException The passed group name does not exist.
*/
int getSize(String groupName)
@@ -133,8 +132,8 @@ public interface IntakeService
* @param className the name of the object.
* @param propName the name of the property.
* @return the setter.
- * @throws ClassNotFoundException
- * @throws IntrospectionException
+ * @throws ClassNotFoundException if the class specified could not be loaded
+ * @throws IntrospectionException if the property setter could not be called
*/
Method getFieldSetter(String className, String propName)
throws ClassNotFoundException, IntrospectionException;
@@ -145,14 +144,9 @@ public interface IntakeService
* @param className the name of the object.
* @param propName the name of the property.
* @return the getter.
- * @throws ClassNotFoundException
- * @throws IntrospectionException
+ * @throws ClassNotFoundException if the class specified could not be loaded
+ * @throws IntrospectionException if the property getter could not be called
*/
Method getFieldGetter(String className, String propName)
throws ClassNotFoundException, IntrospectionException;
}
-
-
-
-
-
Modified: turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/IntakeServiceFacade.java
URL: http://svn.apache.org/viewvc/turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/IntakeServiceFacade.java?rev=1771953&r1=1771952&r2=1771953&view=diff
==============================================================================
--- turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/IntakeServiceFacade.java (original)
+++ turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/IntakeServiceFacade.java Tue Nov 29 20:29:12 2016
@@ -26,14 +26,14 @@ import org.apache.fulcrum.intake.model.G
/**
* This is a Facade class for IntakeService.
- *
+ *
* This class provides static methods that call related methods of the
* implementation of the IntakeService used by the System, according to the
* settings in your intake.xml file.
- *
+ *
* Note: How should a facade class work? It seems to me that maybe it should
* only have a hook into the Avalon Component Manager somehow?
- *
+ *
* @author <a href="mailto:jmcnally@collab.net">John McNally</a>
* @author <a href="mailto:quintonm@bellsouth.net">Quinton McCombs</a>
* @version $Id$
@@ -41,7 +41,6 @@ import org.apache.fulcrum.intake.model.G
public class IntakeServiceFacade
{
/** Static instance of the intakeService. */
-
private static IntakeService intakeService;
/**
@@ -56,7 +55,7 @@ public class IntakeServiceFacade
/**
* Gets an instance of a named group either from the pool or by calling the
* Factory Service if the pool is empty.
- *
+ *
* @param groupName
* the name of the group.
* @return a Group instance.
@@ -74,7 +73,7 @@ public class IntakeServiceFacade
/**
* Puts a group back to the pool.
- *
+ *
* @param instance
* the object instance to recycle.
* @throws IntakeException
@@ -87,7 +86,7 @@ public class IntakeServiceFacade
/**
* Gets the current size of the pool for a named group.
- *
+ *
* @param groupName
* the name of the group.
* @return the current pool size
@@ -101,7 +100,7 @@ public class IntakeServiceFacade
/**
* Names of all the defined groups.
- *
+ *
* @return array of names.
*/
public static String[] getGroupNames()
@@ -111,7 +110,7 @@ public class IntakeServiceFacade
/**
* Gets the key (usually a short identifier) for a group.
- *
+ *
* @param groupName
* the name of the group.
* @return the the key.
@@ -123,7 +122,7 @@ public class IntakeServiceFacade
/**
* Gets the group name given its key.
- *
+ *
* @param groupKey
* the key.
* @return groupName the name of the group.
@@ -135,14 +134,14 @@ public class IntakeServiceFacade
/**
* Gets the Method that can be used to set a property.
- *
+ *
* @param className
* the name of the object.
* @param propName
* the name of the property.
* @return the setter.
- * @throws ClassNotFoundException
- * @throws IntrospectionException
+ * @throws ClassNotFoundException if the class specified could not be loaded
+ * @throws IntrospectionException if the property setter could not be called
*/
public static Method getFieldSetter(String className, String propName) throws IntrospectionException, ClassNotFoundException
{
@@ -151,14 +150,14 @@ public class IntakeServiceFacade
/**
* Gets the Method that can be used to get a property value.
- *
+ *
* @param className
* the name of the object.
* @param propName
* the name of the property.
* @return the getter.
- * @throws ClassNotFoundException
- * @throws IntrospectionException
+ * @throws ClassNotFoundException if the class specified could not be loaded
+ * @throws IntrospectionException if the property getter could not be called
*/
public static Method getFieldGetter(String className, String propName) throws IntrospectionException, ClassNotFoundException
{
@@ -167,7 +166,7 @@ public class IntakeServiceFacade
/**
* Utility method for accessing the service implementation
- *
+ *
* @return a IntakeService implementation instance
*/
private static IntakeService getService()
Modified: turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/IntakeServiceImpl.java
URL: http://svn.apache.org/viewvc/turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/IntakeServiceImpl.java?rev=1771953&r1=1771952&r2=1771953&view=diff
==============================================================================
--- turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/IntakeServiceImpl.java (original)
+++ turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/IntakeServiceImpl.java Tue Nov 29 20:29:12 2016
@@ -548,8 +548,8 @@ public class IntakeServiceImpl extends A
* @param propName
* the name of the property.
* @return the setter.
- * @throws ClassNotFoundException
- * @throws IntrospectionException
+ * @throws ClassNotFoundException if the class specified could not be loaded
+ * @throws IntrospectionException if the property setter could not be called
*/
@Override
public Method getFieldSetter(String className, String propName)
@@ -607,8 +607,8 @@ public class IntakeServiceImpl extends A
* @param propName
* the name of the property.
* @return the getter.
- * @throws ClassNotFoundException
- * @throws IntrospectionException
+ * @throws ClassNotFoundException if the class specified could not be loaded
+ * @throws IntrospectionException if the property getter could not be called
*/
@Override
public Method getFieldGetter(String className, String propName)
Modified: turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/Retrievable.java
URL: http://svn.apache.org/viewvc/turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/Retrievable.java?rev=1771953&r1=1771952&r2=1771953&view=diff
==============================================================================
--- turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/Retrievable.java (original)
+++ turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/Retrievable.java Tue Nov 29 20:29:12 2016
@@ -30,13 +30,18 @@ public interface Retrievable
/**
* get an id that differentiates this object from others
* of its class.
+ *
+ * @return the unique key identifying the object
*/
String getQueryKey();
/**
* set an id that differentiates this object from others
* of its class.
+ *
+ * @param key the identifying key
+ *
+ * @throws Exception if the key could not be set
*/
void setQueryKey(String key) throws Exception;
-
}
Modified: turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/model/AppData.java
URL: http://svn.apache.org/viewvc/turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/model/AppData.java?rev=1771953&r1=1771952&r2=1771953&view=diff
==============================================================================
--- turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/model/AppData.java (original)
+++ turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/model/AppData.java Tue Nov 29 20:29:12 2016
@@ -33,7 +33,7 @@ import org.apache.fulcrum.intake.IntakeE
/**
* A class for holding application data structures.
*
- * @author <a href="mailto:jmcnally@collab.net>John McNally</a>
+ * @author <a href="mailto:jmcnally@collab.net">John McNally</a>
* @author <a href="mailto:hps@intermeta.de">Henning P. Schmiedehausen</a>
* @author <a href="mailto:tv@apache.org">Thomas Vandahl</a>
* @version $Id$
@@ -63,6 +63,7 @@ public class AppData implements Serializ
* This method is used in the IntakeService to register all the
* groups with and without prefix in the service.
*
+ * @return the list of groups
*/
public List<Group> getGroups()
{
Modified: turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/model/Field.java
URL: http://svn.apache.org/viewvc/turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/model/Field.java?rev=1771953&r1=1771952&r2=1771953&view=diff
==============================================================================
--- turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/model/Field.java (original)
+++ turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/model/Field.java Tue Nov 29 20:29:12 2016
@@ -42,7 +42,7 @@ import org.apache.fulcrum.parser.ValuePa
* Base class for Intake generated input processing classes.
*
* @author <a href="mailto:jmcnally@collab.net">John McNally</a>
- * @author <a href="mailto:dlr@finemaltcoding.com>Daniel Rall</a>
+ * @author <a href="mailto:dlr@finemaltcoding.com">Daniel Rall</a>
* @author <a href="mailto:hps@intermeta.de">Henning P. Schmiedehausen</a>
* @author <a href="mailto:quintonm@bellsouth.net">Quinton McCombs</a>
* @author <a href="mailto:jh@byteaction.de">Jürgen Hoffmann</a>
@@ -183,8 +183,6 @@ public abstract class Field<T> implement
* @param group a <code>Group</code> value
* @throws IntakeException indicates the validator was not valid or
* could not be loaded.
- * @throws SystemError only occurs is the Validation object does not
- * extend InitableByConstraintMap
*/
public Field(XmlField field, Group group) throws IntakeException
{
@@ -415,6 +413,8 @@ public abstract class Field<T> implement
/**
* Get the name of the object that takes this input
+ *
+ * @return the name of the mapped object
*/
public String getMapToObject()
{
@@ -517,6 +517,8 @@ public abstract class Field<T> implement
* Use in a hidden field assign a default value in the event the
* field is absent from the query parameters. Used to track checkboxes,
* since they only show up if checked.
+ *
+ * @return the value if not in the request
*/
public String getValueIfAbsent()
{
@@ -575,6 +577,8 @@ public abstract class Field<T> implement
* used in building data entry forms and serve as a
* user friendly description of the data contained in
* the field.
+ *
+ * @param newDisplayName the new display name for the field
*/
public void setDisplayName(String newDisplayName)
{
@@ -593,6 +597,8 @@ public abstract class Field<T> implement
/**
* Sets an error message. The field is also marked as invalid.
+ *
+ * @param message the new error message
*/
public void setMessage(String message)
{
@@ -601,6 +607,8 @@ public abstract class Field<T> implement
}
/**
+ * Set the internal flag that the field has been set
+ *
* @param setFlag the setFlag to set
*/
protected void setSet(boolean setFlag)
@@ -609,6 +617,8 @@ public abstract class Field<T> implement
}
/**
+ * Set the internal flag that the field is valid
+ *
* @param validFlag the validFlag to set
*/
protected void setValid(boolean validFlag)
@@ -617,6 +627,8 @@ public abstract class Field<T> implement
}
/**
+ * Set the internal flag that the field has been validated
+ *
* @param validated the validated to set
*/
protected void setValidated(boolean validated)
@@ -625,16 +637,9 @@ public abstract class Field<T> implement
}
/**
- * @deprecated Call validate() instead (with no parameters).
- */
- @Deprecated
- protected boolean validate(ValueParser pp)
- {
- return validate();
- }
-
- /**
* Compares request data with constraints and sets the valid flag.
+ *
+ * @return true if the validation succeeded
*/
public boolean validate()
{
@@ -757,7 +762,7 @@ public abstract class Field<T> implement
* be used as the initial value.
*
* @return an <code>Object</code> value
- * @exception IntakeException indicates the value could not be
+ * @throws IntakeException indicates the value could not be
* returned from the mapped object
*/
public T getInitialValue() throws IntakeException
@@ -790,7 +795,8 @@ public abstract class Field<T> implement
/**
* Get the value input by a user that will be validated.
*
- * @return an <code>Object</code> value
+ * @param <TT> the type of the test value
+ * @return an <code>TT</code> value
*/
@SuppressWarnings("unchecked")
public <TT> TT getTestValue()
@@ -873,6 +879,8 @@ public abstract class Field<T> implement
/**
* Loads the valid value from a bean
*
+ * @param obj the object whose getter to call
+ *
* @throws IntakeException indicates a problem during the execution of the
* object's getter method
*/
@@ -913,6 +921,8 @@ public abstract class Field<T> implement
/**
* Calls a setter method on obj, if this field has been set.
*
+ * @param obj the object whose setter to call
+ *
* @throws IntakeException indicates a problem during the execution of the
* object's setter method
*/
@@ -1052,8 +1062,10 @@ public abstract class Field<T> implement
/**
* Gets the display size of the field. This is useful when
- * building the HTML input tag. If no displaySize was set,
+ * building the HTML input tag. If no displaySize was set,
* an empty string is returned.
+ *
+ * @return the size information for this field
*/
public String getDisplaySize()
{
@@ -1063,7 +1075,9 @@ public abstract class Field<T> implement
/**
* Gets the maximum size of the field. This is useful when
* building the HTML input tag. The maxSize is set with the maxLength
- * rule. If this rule was not set, an empty string is returned.
+ * rule. If this rule was not set, an empty string is returned.
+ *
+ * @return the maximum size information of the field
*/
public String getMaxSize()
{
Modified: turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/model/FieldAdapter.java
URL: http://svn.apache.org/viewvc/turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/model/FieldAdapter.java?rev=1771953&r1=1771952&r2=1771953&view=diff
==============================================================================
--- turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/model/FieldAdapter.java (original)
+++ turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/model/FieldAdapter.java Tue Nov 29 20:29:12 2016
@@ -201,6 +201,7 @@ public class FieldAdapter extends XmlAda
* in the xml file.
*
* @param xmlField a <code>XmlField</code> value
+ * @param xmlGroup the group this field belongs to
* @return a <code>Field</code> value
* @throws IntakeException indicates that an unknown type was specified for a field.
*/
Modified: turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/model/FileItemField.java
URL: http://svn.apache.org/viewvc/turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/model/FileItemField.java?rev=1771953&r1=1771952&r2=1771953&view=diff
==============================================================================
--- turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/model/FileItemField.java (original)
+++ turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/model/FileItemField.java Tue Nov 29 20:29:12 2016
@@ -55,10 +55,10 @@ public class FileItemField
/**
* It is not possible to set the default value for this field type.
* Calling this method with a non-null parameter will result in a
- * TurbineRuntimeException
+ * IntakeRuntimeException
*
* @param prop Parameter for the default values
- * @throws TurbineRuntimeException
+ * @throws IntakeRuntimeException if the parameter is not null
*/
@Override
public void setDefaultValue(String prop)
@@ -76,10 +76,10 @@ public class FileItemField
/**
* It is not possible to set the empty value for this field type.
* Calling this method with a non-null parameter will result in a
- * TurbineRuntimeException
+ * IntakeRuntimeException
*
* @param prop Parameter for the empty values
- * @throws TurbineRuntimeException
+ * @throws IntakeRuntimeException if the parameter is not null
*/
@Override
public void setEmptyValue(String prop)
@@ -113,7 +113,7 @@ public class FileItemField
*
* @param vp a <code>ValueParser</code> value
* @return a <code>Field</code> value
- * @exception IntakeException if an error occurs
+ * @throws IntakeException if an error occurs
*/
@Override
public Field<FileItem> init(ValueParser vp)
Modified: turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/model/Group.java
URL: http://svn.apache.org/viewvc/turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/model/Group.java?rev=1771953&r1=1771952&r2=1771953&view=diff
==============================================================================
--- turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/model/Group.java (original)
+++ turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/model/Group.java Tue Nov 29 20:29:12 2016
@@ -155,6 +155,7 @@ public class Group implements Serializab
*
* @param pp a <code>ValueParser</code> value
* @return this Group
+ * @throws IntakeException if at least one field could not be initialized
*/
public Group init(ValueParser pp) throws IntakeException
{
@@ -165,8 +166,10 @@ public class Group implements Serializab
* Initializes the Group with parameters from RunData
* corresponding to key.
*
+ * @param key the group id
* @param pp a <code>ValueParser</code> value
* @return this Group
+ * @throws IntakeException if at least one field could not be initialized
*/
public Group init(String key, ValueParser pp) throws IntakeException
{
@@ -314,7 +317,7 @@ public class Group implements Serializab
*
* @param pp a <code>ValueParser</code> value
* @return an <code>ArrayList</code> value
- * @exception IntakeException if an error occurs
+ * @throws IntakeException if an error occurs
*/
public List<Group> getObjects(ValueParser pp) throws IntakeException
{
@@ -332,8 +335,10 @@ public class Group implements Serializab
}
/**
- * Get the Field .
- * @return Field.
+ * Get the Field
+ *
+ * @param fieldName the name of the field
+ * @return the named field
* @throws IntakeException indicates the field could not be found.
*/
public Field<?> get(String fieldName)
@@ -351,7 +356,7 @@ public class Group implements Serializab
}
/**
- * Get the list of Fields .
+ * Get the list of Fields.
* @return list of Fields
*/
public List<Field<?>> getFields()
@@ -362,7 +367,7 @@ public class Group implements Serializab
/**
* Set a collection of fields for this group
*
- * @param fields the fields to set
+ * @param inputFields the fields to set
*/
@XmlElement(name="field")
@XmlJavaTypeAdapter(FieldAdapter.class)
@@ -447,6 +452,8 @@ public class Group implements Serializab
* test passes call setProperties. Use this method when some data is
* known to be invalid, but you still want to set the object properties
* that are valid.
+ *
+ * @param obj the object to set the properties for
*/
public void setValidProperties(Object obj)
{
@@ -591,6 +598,8 @@ public class Group implements Serializab
/**
* A xhtml valid hidden input field that notifies intake of the
* group's presence.
+ *
+ * @param sb the string builder to append the HTML to
*/
public void appendHtmlFormInput(StringBuilder sb)
{
Modified: turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/model/XmlField.java
URL: http://svn.apache.org/viewvc/turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/model/XmlField.java?rev=1771953&r1=1771952&r2=1771953&view=diff
==============================================================================
--- turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/model/XmlField.java (original)
+++ turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/model/XmlField.java Tue Nov 29 20:29:12 2016
@@ -121,6 +121,8 @@ public class XmlField
/**
* Return Avalon logger
+ *
+ * @return the logger
*/
public Logger getLogger()
{
@@ -129,6 +131,8 @@ public class XmlField
/**
* Get the name of the property
+ *
+ * @return the raw name of the property
*/
public String getRawName()
{
@@ -137,6 +141,8 @@ public class XmlField
/**
* Get the name of the property
+ *
+ * @return the name of the property with underscores removed
*/
public String getName()
{
@@ -145,6 +151,8 @@ public class XmlField
/**
* Get the display name of the property
+ *
+ * @return the display name of the property
*/
public String getDisplayName()
{
@@ -154,6 +162,8 @@ public class XmlField
/**
* Gets the display size of the field. This is
* useful for constructing the HTML input tag.
+ *
+ * @return the display size for the field
*/
public String getDisplaySize()
{
@@ -162,6 +172,8 @@ public class XmlField
/**
* Get the parameter key of the property
+ *
+ * @return the key of the property
*/
public String getKey()
{
@@ -170,6 +182,8 @@ public class XmlField
/**
* Get the type of the property
+ *
+ * @return the type of the field
*/
public String getType()
{
@@ -177,7 +191,9 @@ public class XmlField
}
/**
- * can this field have several values?
+ * Can this field have several values?
+ *
+ * @return true if the field can have multiple values
*/
public boolean isMultiValued()
{
@@ -186,6 +202,8 @@ public class XmlField
/**
* Get the name of the object that takes this input
+ *
+ * @return the name of the mapped object
*/
public String getMapToObject()
{
@@ -194,6 +212,8 @@ public class XmlField
/**
* Get the property method that takes this input
+ *
+ * @return the property this field is mapped to
*/
public String getMapToProperty()
{
@@ -209,6 +229,8 @@ public class XmlField
/**
* Get the className of the validator
+ *
+ * @return the validator class name
*/
public String getValidator()
{
@@ -237,6 +259,8 @@ public class XmlField
/**
* Get the parent XmlGroup of the field
+ *
+ * @return the group this field belongs to
*/
public Group getGroup()
{
@@ -317,6 +341,8 @@ public class XmlField
/**
* String representation of the column. This
* is an xml representation.
+ *
+ * @return the value of this field as an XML representation
*/
@Override
public String toString()
Modified: turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/BigDecimalValidator.java
URL: http://svn.apache.org/viewvc/turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/BigDecimalValidator.java?rev=1771953&r1=1771952&r2=1771953&view=diff
==============================================================================
--- turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/BigDecimalValidator.java (original)
+++ turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/BigDecimalValidator.java Tue Nov 29 20:29:12 2016
@@ -30,6 +30,7 @@ import java.util.Locale;
* listed in NumberValidator and DefaultValidator.
*
* <table>
+ * <caption>Validation rules</caption>
* <tr><th>Name</th><th>Valid Values</th><th>Default Value</th></tr>
* <tr><td>minValue</td><td>greater than BigDecimal minValue</td>
* <td> </td></tr>
Modified: turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/BooleanValidator.java
URL: http://svn.apache.org/viewvc/turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/BooleanValidator.java?rev=1771953&r1=1771952&r2=1771953&view=diff
==============================================================================
--- turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/BooleanValidator.java (original)
+++ turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/BooleanValidator.java Tue Nov 29 20:29:12 2016
@@ -76,7 +76,7 @@ public class BooleanValidator
* in the constraints defined for this validator
*
* @param testValue a <code>String</code> to be tested
- * @exception ValidationException containing an error message if the
+ * @throws ValidationException containing an error message if the
* testValue did not pass the validation tests.
*/
@Override
@@ -102,7 +102,8 @@ public class BooleanValidator
* Parses a string value into a Boolean object.
*
* @param stringValue the value to parse
- * @return a <code>Boolean</a> object
+ * @return a <code>Boolean</code> object
+ * @throws ParseException if the value cannot be parsed to a boolean
*/
public Boolean parse(String stringValue)
throws ParseException
Modified: turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/Constraint.java
URL: http://svn.apache.org/viewvc/turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/Constraint.java?rev=1771953&r1=1771952&r2=1771953&view=diff
==============================================================================
--- turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/Constraint.java (original)
+++ turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/Constraint.java Tue Nov 29 20:29:12 2016
@@ -36,16 +36,22 @@ public interface Constraint
{
/**
* Get the name of the constraint.
+ *
+ * @return the constraint name
*/
String getName();
/**
* Get the value of the constraint.
+ *
+ * @return the constraint value
*/
String getValue();
/**
* Get the error message.
+ *
+ * @return the constraint error message
*/
String getMessage();
}
Modified: turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/DateRangeValidator.java
URL: http://svn.apache.org/viewvc/turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/DateRangeValidator.java?rev=1771953&r1=1771952&r2=1771953&view=diff
==============================================================================
--- turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/DateRangeValidator.java (original)
+++ turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/DateRangeValidator.java Tue Nov 29 20:29:12 2016
@@ -34,6 +34,7 @@ import org.apache.fulcrum.intake.validat
* Validates a DateString field in dependency on another DateString field.
*
* <table>
+ * <caption>Validation rules</caption>
* <tr>
* <th>Name</th><th>Valid Values</th><th>Default Value</th>
* </tr>
@@ -82,8 +83,8 @@ public class DateRangeValidator
/**
* Constructor to use when initializing Object
*
- * @param paramMap
- * @throws InvalidMaskException
+ * @param paramMap a map of parameters
+ * @throws InvalidMaskException one of the mask rules is invalid
*/
@Override
public void init(Map<String, ? extends Constraint> paramMap)
@@ -162,7 +163,7 @@ public class DateRangeValidator
* in the constraints defined for this validator
*
* @param testField a <code>Field</code> to be tested
- * @exception ValidationException containing an error message if the
+ * @throws ValidationException containing an error message if the
* testValue did not pass the validation tests.
*/
@Override
@@ -197,7 +198,7 @@ public class DateRangeValidator
* @param testValue a <code>String</code> to be tested
* @param group the group this field belongs to
*
- * @exception ValidationException containing an error message if the
+ * @throws ValidationException containing an error message if the
* testValue did not pass the validation tests.
*/
public void assertValidity(final String testValue, final Group group)
Modified: turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/DateStringValidator.java
URL: http://svn.apache.org/viewvc/turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/DateStringValidator.java?rev=1771953&r1=1771952&r2=1771953&view=diff
==============================================================================
--- turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/DateStringValidator.java (original)
+++ turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/DateStringValidator.java Tue Nov 29 20:29:12 2016
@@ -33,6 +33,7 @@ import org.apache.commons.lang.StringUti
* listed in DefaultValidator.
*
* <table>
+ * <caption>Validation rules</caption>
* <tr><th>Name</th><th>Valid Values</th><th>Default Value</th></tr>
* <tr><td>format</td><td>see SimpleDateFormat javadoc</td>
* <td> </td></tr>
@@ -79,8 +80,8 @@ public class DateStringValidator
/**
* Constructor to use when initializing Object
*
- * @param paramMap
- * @throws InvalidMaskException
+ * @param paramMap a map of parameters
+ * @throws InvalidMaskException one of the mask rules is invalid
*/
@Override
public void init(Map<String, ? extends Constraint> paramMap)
@@ -127,7 +128,7 @@ public class DateStringValidator
* in the constraints defined for this validator
*
* @param testValue a <code>String</code> to be tested
- * @exception ValidationException containing an error message if the
+ * @throws ValidationException containing an error message if the
* testValue did not pass the validation tests.
*/
@Override
@@ -157,6 +158,8 @@ public class DateStringValidator
* format that includes a 4 digit year, but that will parse the date using
* a format that accepts 2 digit years.
*
+ * @param s possibly a date string
+ * @return the date parsed
* @throws ParseException indicates that the string could not be
* parsed into a date.
*/
Modified: turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/DefaultValidator.java
URL: http://svn.apache.org/viewvc/turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/DefaultValidator.java?rev=1771953&r1=1771952&r2=1771953&view=diff
==============================================================================
--- turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/DefaultValidator.java (original)
+++ turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/DefaultValidator.java Tue Nov 29 20:29:12 2016
@@ -31,6 +31,7 @@ import org.apache.fulcrum.intake.model.F
* constraints:
*
* <table>
+ * <caption>Validation rules</caption>
* <tr><th>Name</th><th>Valid Values</th><th>Default Value</th></tr>
* <tr><td>required</td><td>true|false</td><td>false</td></tr>
* <tr><td>mask</td><td>regexp</td><td> </td></tr>
@@ -92,11 +93,11 @@ abstract public class DefaultValidator<T
/**
* Extract the relevant parameters from the constraints listed
- * in <rule> tags within the intake.xml file.
+ * in <rule> tags within the intake.xml file.
*
* @param paramMap a <code>Map</code> of <code>Rule</code>'s
* containing constraints on the input.
- * @exception InvalidMaskException An invalid mask was specified for one of the rules
+ * @throws InvalidMaskException An invalid mask was specified for one of the rules
*/
@Override
public void init(Map<String, ? extends Constraint> paramMap)
@@ -155,7 +156,7 @@ abstract public class DefaultValidator<T
* in the constraints defined for this validator
*
* @param field a <code>Field</code> to be tested
- * @exception ValidationException containing an error message if the
+ * @throws ValidationException containing an error message if the
* testValue did not pass the validation tests.
*/
@Override
@@ -186,6 +187,7 @@ abstract public class DefaultValidator<T
*
* @deprecated use isValid(Field) instead
*/
+ @Deprecated
@Override
public boolean isValid(String testValue)
{
@@ -207,7 +209,7 @@ abstract public class DefaultValidator<T
* in the constraints defined for this validator
*
* @param testValue a <code>String</code> to be tested
- * @exception ValidationException containing an error message if the
+ * @throws ValidationException containing an error message if the
* testValue did not pass the validation tests.
*/
@Override
Modified: turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/DoubleValidator.java
URL: http://svn.apache.org/viewvc/turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/DoubleValidator.java?rev=1771953&r1=1771952&r2=1771953&view=diff
==============================================================================
--- turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/DoubleValidator.java (original)
+++ turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/DoubleValidator.java Tue Nov 29 20:29:12 2016
@@ -28,6 +28,7 @@ import java.util.Locale;
* listed in NumberValidator and DefaultValidator.
*
* <table>
+ * <caption>Validation rules</caption>
* <tr><th>Name</th><th>Valid Values</th><th>Default Value</th></tr>
* <tr><td>minValue</td><td>greater than Double.MIN_VALUE</td>
* <td> </td></tr>
Modified: turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/FieldReference.java
URL: http://svn.apache.org/viewvc/turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/FieldReference.java?rev=1771953&r1=1771952&r2=1771953&view=diff
==============================================================================
--- turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/FieldReference.java (original)
+++ turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/FieldReference.java Tue Nov 29 20:29:12 2016
@@ -30,6 +30,7 @@ import org.apache.fulcrum.intake.model.G
* comparisons are supported:
*
* <table>
+ * <caption>Validation rules</caption>
* <tr>
* <th>Name</th><th>Valid Values</th><th>Default Value</th>
* </tr>
@@ -188,7 +189,9 @@ public class FieldReference
* @param value the parsed value of the related field
* @param group the group the related field belongs to
*
- * @throws ValidationException
+ * @param <T> the field type
+ *
+ * @throws ValidationException if the validation against at least one related field fails
*/
public static <T> void checkReferences(List<FieldReference> fieldReferences, CompareCallback<T> compareCallback,
T value, Group group)
Modified: turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/FileValidator.java
URL: http://svn.apache.org/viewvc/turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/FileValidator.java?rev=1771953&r1=1771952&r2=1771953&view=diff
==============================================================================
--- turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/FileValidator.java (original)
+++ turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/FileValidator.java Tue Nov 29 20:29:12 2016
@@ -48,7 +48,7 @@ public class FileValidator
* in the constraints defined for this validator
*
* @param testValue a <code>FileItem</code> to be tested
- * @exception ValidationException containing an error message if the
+ * @throws ValidationException containing an error message if the
* testValue did not pass the validation tests.
*/
public void assertValidity(FileItem testValue)
Modified: turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/FloatValidator.java
URL: http://svn.apache.org/viewvc/turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/FloatValidator.java?rev=1771953&r1=1771952&r2=1771953&view=diff
==============================================================================
--- turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/FloatValidator.java (original)
+++ turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/FloatValidator.java Tue Nov 29 20:29:12 2016
@@ -28,6 +28,7 @@ import java.util.Locale;
* listed in NumberValidator and DefaultValidator.
*
* <table>
+ * <caption>Validation rules</caption>
* <tr><th>Name</th><th>Valid Values</th><th>Default Value</th></tr>
* <tr><td>minValue</td><td>greater than Float.MIN_VALUE</td>
* <td> </td></tr>
Modified: turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/InitableByConstraintMap.java
URL: http://svn.apache.org/viewvc/turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/InitableByConstraintMap.java?rev=1771953&r1=1771952&r2=1771953&view=diff
==============================================================================
--- turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/InitableByConstraintMap.java (original)
+++ turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/InitableByConstraintMap.java Tue Nov 29 20:29:12 2016
@@ -32,11 +32,11 @@ public interface InitableByConstraintMap
{
/**
* Extract the relevant parameters from the constraints listed
- * in <input-param> tags within the intake.xml file.
+ * in <input-param> tags within the intake.xml file.
*
* @param inputParameters a <code>Map</code> of <code>Constraint</code>'s
* containing rules and error messages.
- * @exception InvalidMaskException one of the mask rules is invalid
+ * @throws InvalidMaskException one of the mask rules is invalid
*/
void init(Map<String, ? extends Constraint> inputParameters)
throws InvalidMaskException;
Modified: turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/IntegerRangeValidator.java
URL: http://svn.apache.org/viewvc/turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/IntegerRangeValidator.java?rev=1771953&r1=1771952&r2=1771953&view=diff
==============================================================================
--- turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/IntegerRangeValidator.java (original)
+++ turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/IntegerRangeValidator.java Tue Nov 29 20:29:12 2016
@@ -33,6 +33,7 @@ import org.apache.fulcrum.intake.validat
* Validates an int field in dependency on another int field.
*
* <table>
+ * <caption>Validation rules</caption>
* <tr>
* <th>Name</th><th>Valid Values</th><th>Default Value</th>
* </tr>
@@ -81,8 +82,8 @@ public class IntegerRangeValidator
/**
* Constructor to use when initializing Object
*
- * @param paramMap
- * @throws InvalidMaskException
+ * @param paramMap a map of parameters
+ * @throws InvalidMaskException one of the mask rules is invalid
*/
@Override
public void init(Map<String, ? extends Constraint> paramMap)
@@ -161,7 +162,7 @@ public class IntegerRangeValidator
* in the constraints defined for this validator
*
* @param testField a <code>Field</code> to be tested
- * @exception ValidationException containing an error message if the
+ * @throws ValidationException containing an error message if the
* testValue did not pass the validation tests.
*/
@Override
@@ -198,7 +199,7 @@ public class IntegerRangeValidator
* @param group the group this field belongs to
* @param locale the locale for this field
*
- * @exception ValidationException containing an error message if the
+ * @throws ValidationException containing an error message if the
* testValue did not pass the validation tests.
*/
public void assertValidity(final String testValue, final Group group, final Locale locale)
Modified: turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/IntegerValidator.java
URL: http://svn.apache.org/viewvc/turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/IntegerValidator.java?rev=1771953&r1=1771952&r2=1771953&view=diff
==============================================================================
--- turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/IntegerValidator.java (original)
+++ turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/IntegerValidator.java Tue Nov 29 20:29:12 2016
@@ -26,6 +26,7 @@ import java.util.Locale;
* listed in NumberValidator and DefaultValidator.
*
* <table>
+ * <caption>Validation rules</caption>
* <tr><th>Name</th><th>Valid Values</th><th>Default Value</th></tr>
* <tr><td>minValue</td><td>greater than Integer.MIN_VALUE</td>
* <td> </td></tr>
Modified: turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/LongValidator.java
URL: http://svn.apache.org/viewvc/turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/LongValidator.java?rev=1771953&r1=1771952&r2=1771953&view=diff
==============================================================================
--- turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/LongValidator.java (original)
+++ turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/LongValidator.java Tue Nov 29 20:29:12 2016
@@ -26,6 +26,7 @@ import java.util.Locale;
* listed in NumberValidator and DefaultValidator.
*
* <table>
+ * <caption>Validation rules</caption>
* <tr><th>Name</th><th>Valid Values</th><th>Default Value</th></tr>
* <tr><td>minValue</td><td>greater than Long.MIN_VALUE</td>
* <td> </td></tr>
Modified: turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/NumberValidator.java
URL: http://svn.apache.org/viewvc/turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/NumberValidator.java?rev=1771953&r1=1771952&r2=1771953&view=diff
==============================================================================
--- turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/NumberValidator.java (original)
+++ turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/NumberValidator.java Tue Nov 29 20:29:12 2016
@@ -30,6 +30,7 @@ import org.apache.fulcrum.intake.model.F
* listed in DefaultValidator.
*
* <table>
+ * <caption>Validation rules</caption>
* <tr><th>Name</th><th>Valid Values</th><th>Default Value</th></tr>
* <tr><td>minValue</td><td>greater than BigDecimal.MIN_VALUE</td>
* <td> </td></tr>
@@ -69,11 +70,11 @@ public abstract class NumberValidator<T
/**
* Extract the relevant parameters from the constraints listed
- * in <rule> tags within the intake.xml file.
+ * in <rule> tags within the intake.xml file.
*
* @param paramMap a <code>Map</code> of <code>rule</code>'s
* containing constraints on the input.
- * @exception InvalidMaskException an invalid mask was specified
+ * @throws InvalidMaskException an invalid mask was specified
*/
@Override
public void init(Map<String, ? extends Constraint> paramMap)
@@ -136,7 +137,7 @@ public abstract class NumberValidator<T
* in the constraints defined for this validator
*
* @param field a <code>Field</code> to be tested
- * @exception ValidationException containing an error message if the
+ * @throws ValidationException containing an error message if the
* testValue did not pass the validation tests.
*/
@Override
@@ -165,7 +166,7 @@ public abstract class NumberValidator<T
*
* @param testValue a <code>String</code> to be tested
* @param locale the Locale of the associated field
- * @exception ValidationException containing an error message if the
+ * @throws ValidationException containing an error message if the
* testValue did not pass the validation tests.
*/
public void assertValidity(String testValue, Locale locale) throws ValidationException
Modified: turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/ShortValidator.java
URL: http://svn.apache.org/viewvc/turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/ShortValidator.java?rev=1771953&r1=1771952&r2=1771953&view=diff
==============================================================================
--- turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/ShortValidator.java (original)
+++ turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/ShortValidator.java Tue Nov 29 20:29:12 2016
@@ -26,6 +26,7 @@ import java.util.Locale;
* listed in NumberValidator and DefaultValidator.
*
* <table>
+ * <caption>Validation rules</caption>
* <tr><th>Name</th><th>Valid Values</th><th>Default Value</th></tr>
* <tr><td>minValue</td><td>greater than Short.MIN_VALUE</td>
* <td> </td></tr>
Modified: turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/StringValidator.java
URL: http://svn.apache.org/viewvc/turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/StringValidator.java?rev=1771953&r1=1771952&r2=1771953&view=diff
==============================================================================
--- turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/StringValidator.java (original)
+++ turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/StringValidator.java Tue Nov 29 20:29:12 2016
@@ -29,6 +29,7 @@ import org.apache.commons.lang.StringUti
* A validator that will compare a testValue against the following
* constraints:
* <table>
+ * <caption>Validation rules</caption>
* <tr><th>Name</th><th>Valid Values</th><th>Default Value</th></tr>
* <tr><td>required</td><td>true|false</td><td>false</td></tr>
* <tr><td>mask</td><td>regexp</td><td> </td></tr>
@@ -67,11 +68,11 @@ public class StringValidator
/**
* Extract the relevant parameters from the constraints listed
- * in <rule> tags within the intake.xml file.
+ * in <rule> tags within the intake.xml file.
*
* @param paramMap a <code>Map</code> of <code>Rule</code>'s
* containing constraints on the input.
- * @exception InvalidMaskException An invalid mask was specified for one of the rules
+ * @throws InvalidMaskException An invalid mask was specified for one of the rules
*/
@Override
public void init(Map<String, ? extends Constraint> paramMap)
@@ -94,7 +95,7 @@ public class StringValidator
* in the constraints defined for this validator
*
* @param testValue a <code>String</code> to be tested
- * @exception ValidationException containing an error message if the
+ * @throws ValidationException containing an error message if the
* testValue did not pass the validation tests.
*/
@Override
Modified: turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/Validator.java
URL: http://svn.apache.org/viewvc/turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/Validator.java?rev=1771953&r1=1771952&r2=1771953&view=diff
==============================================================================
--- turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/Validator.java (original)
+++ turbine/fulcrum/trunk/intake/src/java/org/apache/fulcrum/intake/validator/Validator.java Tue Nov 29 20:29:12 2016
@@ -71,7 +71,7 @@ public interface Validator<T>
* in the constraints defined for this validator
*
* @param field a <code>Field</code> to be tested
- * @exception ValidationException containing an error message if the
+ * @throws ValidationException containing an error message if the
* testValue did not pass the validation tests.
*/
void assertValidity(Field<T> field)
@@ -93,7 +93,7 @@ public interface Validator<T>
* in the constraints defined for this validator
*
* @param testValue a <code>String</code> to be tested
- * @exception ValidationException containing an error message if the
+ * @throws ValidationException containing an error message if the
* testValue did not pass the validation tests.
*/
void assertValidity(String testValue)