sky.engine.field
Class CharField

java.lang.Object
  sky.engine.field.BaseField
      sky.engine.field.CharField

All Implemented Interfaces:

Field

Direct Known Subclasses:

CharListField

public class CharField

extends BaseField

implements Field

Field Summary

Fields inherited from class sky.engine.field.BaseField

_aliases, _default, _defaulted, _maxlen, _minlen, _name, _required, _values, _vislen, STRINGS

Constructor Summary

CharField(java.lang.String name, boolean required, int minlen, int maxlen)
Constructor

CharField(java.lang.String name, boolean required, java.lang.String dflt, int minlen, int maxlen, int vislen)
Constructor

Method Summary

void	addValue(java.lang.String value) Add specified input string as a value of this field.
java.lang.String	checkValue(java.lang.String value) Check whether the specified string is valid value for this field.

Methods inherited from class sky.engine.field.BaseField

addAlias, clear, destory, getAliases, getData, getDataSize, getHTMLData, getName, getRequired, getSQLData, getStringData, hasAliases, hasValue, removeAliases, removeValues, toHTML, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface sky.engine.field.Field

addAlias, clear, destory, getAliases, getDataSize, getHTMLData, getName, getRequired, getSQLData, getStringData, hasAliases, removeAliases, removeValues, toHTML, toString

Constructor Detail

CharField

public CharField(java.lang.String name,
                 boolean required,
                 int minlen,
                 int maxlen)

Constructor

Parameters:

name - field name

required - true if this field must have a value; else, false.

minlen - minimum number of chracters in field value.

maxlen - maximum number of characters in field value.

CharField

public CharField(java.lang.String name,
                 boolean required,
                 java.lang.String dflt,
                 int minlen,
                 int maxlen,
                 int vislen)

Constructor

Parameters:

name - field name

required - true if this field is required; else, flase.

dflt - default value of this field if the user does not specify a value.

minlen - minimum number of characters in field value.

maxlen - maximum number of characters in field value.

vislen - visible length of this field.

Method Detail

checkValue

public java.lang.String checkValue(java.lang.String value)
                            throws ErrorMessage

Check whether the specified string is valid value for this field. This function also removes any newlines at the end of the string. This method is called by addValue method.

Specified by:

checkValue in interface Field

Parameters:

value - input string.

Returns:

input string from which newlines at the end of the string have been removed.

Throws:

ErrorMessage - if there is the input string is not a valid value.

addValue

public void addValue(java.lang.String value)
              throws ErrorMessage

Add specified input string as a value of this field.

Specified by:

addValue in interface Field

Parameters:

value - input string.

Throws:

ErrorMessage - if their is a problem in adding this string as field value.