com.smartgwt.client.types
Enum FieldType

java.lang.Object
  java.lang.Enum<FieldType>
      com.smartgwt.client.types.FieldType

All Implemented Interfaces:

ValueEnum, Serializable, Comparable<FieldType>

public enum FieldType
extends Enum<FieldType>
implements ValueEnum

The types listed below are built-in types that 'databound components' understand and treat specially (using type-specific form controls, validators, formatters, sorting logic, etc).

You can declare custom types via SimpleType, with settings that will influence DataBound components. You can also create your own subclasses of databound components to add further custom, reusable behaviors based on field.type.

field.type can also be the ID of another DataSource, which allows you to model nested structures such as XML documents (in fact, XMLTools.loadXMLSchema(String, com.smartgwt.client.data.XSDLoadCallback, com.smartgwt.client.rpc.RPCRequest) ; models XML schema in this way). Nested DataSource declarations affect how XML and JSON data is deserialized into JavaScript objects in the 'client-side integration') pipeline, so that you can load complex XML documents and have them deserialized into a correctly typed JavaScript object model.

Note: to declared related but separate objects, as in an "Account" object that can be related to both a "Contact" object and "Order" objects, use foreignKey, not a nested structure declaration.

Enum Constant Summary

BINARY
Arbitrary binary data.

BOOLEAN
A boolean value, e.g.

CREATOR
Fields of this type are automatically populated by the Smart GWT Server with the current authenticated userId as part of add operations.

CREATORTIMESTAMP
Fields of this type are automatically populated by the Smart GWT Server with the current date and time as part of add and update operations.

DATE
A date, including time of day.

DATETIME
A date and time, accurate to the second.

ENUM
A text value constrained to a set of legal values specified by the field's valueMap , as though an IsOneOfValidator validator had been declared.

FLOAT
A floating point (decimal) number, e.g.

IMAGE
A string representing a well-formed URL that points to an image.

IMAGEFILE
Binary data comprising an image.

INTEGER
A whole number, e.g.

INTENUM
An enum whose values are numeric.

LINK
A string representing a well-formed URL.

MODIFIER
Fields of this type are automatically populated by the Smart GWT Server with the current authenticated userId as part of add and update operations.

MODIFIERTIMESTAMP
Fields of this type are automatically populated by the Smart GWT Server with the current date and time as part of add and update operations.

PASSWORD
Password field type

SEQUENCE
If you are using the SmartGWT SQL datasource connector, a sequence is a unique, increasing whole number, incremented whenever a new record is added.

TEXT
Generic text, e.g.

TIME
A time of day, with no date.

Method Summary

String	getValue()
static FieldType	valueOf(String name) Returns the enum constant of this type with the specified name.
static FieldType[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

TEXT

public static final FieldType TEXT

Generic text, e.g. "John Doe". This is the default field type. Use field.length to set length.

BOOLEAN

public static final FieldType BOOLEAN

A boolean value, e.g. true

INTEGER

public static final FieldType INTEGER

A whole number, e.g. 123

FLOAT

public static final FieldType FLOAT

A floating point (decimal) number, e.g. 1.23

DATE

public static final FieldType DATE

A date, including time of day. Represented on the client as a JavaScript Date object. object.

TIME

public static final FieldType TIME

A time of day, with no date. Represented internally on the client as a JavaScript Date object in UTC/GMT by default

DATETIME

public static final FieldType DATETIME

A date and time, accurate to the second. Represented on the client as a JavaScript Date object.

ENUM

public static final FieldType ENUM

A text value constrained to a set of legal values specified by the field's valueMap , as though an IsOneOfValidator validator had been declared.

INTENUM

public static final FieldType INTENUM

An enum whose values are numeric.

SEQUENCE

public static final FieldType SEQUENCE

If you are using the SmartGWT SQL datasource connector, a sequence is a unique, increasing whole number, incremented whenever a new record is added. Otherwise, sequence behaves identically to integer. This type is typically used with field.primaryKey to auto-generate unique primary keys.

LINK

public static final FieldType LINK

A string representing a well-formed URL. Some components will render this as an HTML link (using an anchor tag for example).

IMAGE

public static final FieldType IMAGE

A string representing a well-formed URL that points to an image. Some components will render an IMG tag with the value of this field as the 'src' attribute to render the image.

BINARY

public static final FieldType BINARY

Arbitrary binary data. When this field type is present, three additional fields are automatically generated. They are: <fieldName>_filename, <fieldName>_filesize, and <fieldName>_date_created where <fieldName> is the value of the name attribute of this field. These fields are marked as hidden :true to suppress their rendering by default. You can show one or more of these fields by specifying the field with a hidden:false override in the fields array of the databound component.

IMAGEFILE

public static final FieldType IMAGEFILE

Binary data comprising an image.

MODIFIER

public static final FieldType MODIFIER

Fields of this type are automatically populated by the Smart GWT Server with the current authenticated userId as part of add and update operations. By default, fields of this type are hidden and not editable; the server ignores any value that the client sends in a field of this type.

MODIFIERTIMESTAMP

public static final FieldType MODIFIERTIMESTAMP

Fields of this type are automatically populated by the Smart GWT Server with the current date and time as part of add and update operations. By default, fields of this type are hidden and not editable; the server ignores any value that the client sends in a field of this type.

CREATOR

public static final FieldType CREATOR

Fields of this type are automatically populated by the Smart GWT Server with the current authenticated userId as part of add operations. By default, fields of this type are hidden and not editable; the server ignores any value that the client sends in a field of this type.

CREATORTIMESTAMP

public static final FieldType CREATORTIMESTAMP

Fields of this type are automatically populated by the Smart GWT Server with the current date and time as part of add and update operations. By default, fields of this type are hidden and not editable; the server ignores any value that the client sends in a field of this type.

PASSWORD

public static final FieldType PASSWORD

Password field type

Method Detail

values

public static FieldType[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (FieldType c : FieldType.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static FieldType valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

getValue

public String getValue()

Specified by:

getValue in interface ValueEnum