com.smartgwt.client.core

Class DataClass

java.lang.Object

com.smartgwt.client.core.JsObject

com.smartgwt.client.core.DataClass

All Implemented Interfaces:

com.google.gwt.event.shared.HasHandlers

Direct Known Subclasses:

AceCompletionResult, AcePosition, AnimateShowEffect, CreateScreenSettings, Criteria, DataSourceField, DiscoverTreeSettings, DrawnValue, DrawShapeCommand, DSLoadSettings, FacetValueMap, FileSpec, FormItemEventInfo, FormItemIcon, Gradient, GroupSpecifier, HeaderSpan, ImgProperties, KeyIdentifier, ListProperties, LoadProjectSettings, MetricSettings, NavigationBarViewState, NotifyAction, NotifySettings, OperationBinding, PortalPosition, PrintProperties, QualityIndicatedLocator, RefDataClass, RelativeDate, RPCRequest, RPCResponse, SCStatefulImgConfig, SerializationContext, SerializationSettings, Shadow, SortSpecifier, StretchItem, UserFormula, UserSummary, Validator, XmlNamespaces

public class DataClass
extends JsObject
implements com.google.gwt.event.shared.HasHandlers

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	factoryCreated
protected java.util.Map<java.lang.String,java.lang.Object>	factoryProperties

Fields inherited from class com.smartgwt.client.core.JsObject

jsObj

Constructor Summary

Constructors

Constructor and Description
DataClass()
DataClass(com.google.gwt.core.client.JavaScriptObject jsObj)

Method Summary

Modifier and Type	Method and Description
void	applyFactoryProperties()
protected <H extends com.google.gwt.event.shared.EventHandler> com.google.gwt.event.shared.HandlerRegistration	doAddHandler(H handler, com.google.gwt.event.shared.GwtEvent.Type<H> type)
void	fireEvent(com.google.gwt.event.shared.GwtEvent<?> event)
java.lang.String	getAttribute(java.lang.String property) Returns attribute value as a String
java.lang.Boolean	getAttributeAsBoolean(java.lang.String property) Returns attribute value set as a Boolean.
java.lang.Boolean	getAttributeAsBoolean(java.lang.String property, boolean allowNull) Returns attribute value set as a Boolean.
java.util.Date	getAttributeAsDate(java.lang.String property) Returns attribute value as a Date.
java.lang.Double	getAttributeAsDouble(java.lang.String property) Returns attribute as a Double.
double[]	getAttributeAsDoubleArray(java.lang.String property) Returns attribute as a double array.
java.lang.Float	getAttributeAsFloat(java.lang.String property) Returns attribute value as a Float.
java.lang.Integer	getAttributeAsInt(java.lang.String property) Returns attribute value as an Integer.
int[]	getAttributeAsIntArray(java.lang.String property) Returns attribute as an int array.
com.google.gwt.core.client.JavaScriptObject	getAttributeAsJavaScriptObject(java.lang.String property) Returns attribute value as a JavaScript Object.
java.lang.Long	getAttributeAsLong(java.lang.String property) Returns attribute as a Long.
java.util.Map	getAttributeAsMap(java.lang.String property) Returns attribute value as a Map.
java.lang.Object	getAttributeAsObject(java.lang.String property) Returns attribute value as a Java Object.
Record	getAttributeAsRecord(java.lang.String property) Get the attribute value as a Record.
java.lang.String	getAttributeAsString(java.lang.String property) Returns attribute value as a String.
java.lang.String[]	getAttributeAsStringArray(java.lang.String property) Returns attribute as a String array.
java.lang.String[]	getAttributes()
int	getHandlerCount(com.google.gwt.event.shared.GwtEvent.Type<?> type)
boolean	isFactoryCreated()
DataClass	setAttribute(java.lang.String property, BaseClass value) Set attribute value to a BaseClass.
DataClass	setAttribute(java.lang.String property, BaseClass[] value) Set attribute value to a BaseClass array.
DataClass	setAttribute(java.lang.String property, BaseWidget[] value) Set attribute value to a BaseWidget array.
DataClass	setAttribute(java.lang.String property, boolean value) Set attribute value to a boolean.
DataClass	setAttribute(java.lang.String property, java.lang.Boolean value) Set attribute value to a Boolean.
DataClass	setAttribute(java.lang.String property, DataClass value) Set attribute value to a DataClass.
DataClass	setAttribute(java.lang.String property, DataClass[] value) Set attribute value to a DataClass array.
DataClass	setAttribute(java.lang.String property, java.util.Date value) Set attribute value to a Date.
DataClass	setAttribute(java.lang.String property, double value) Set attribute value to a double.
DataClass	setAttribute(java.lang.String property, java.lang.Double value) Set attribute value to a Double.
DataClass	setAttribute(java.lang.String property, double[] value) Set attribute value to a double array.
DataClass	setAttribute(java.lang.String property, java.lang.Float value) Set attribute value to a Float.
DataClass	setAttribute(java.lang.String property, int value) Set attribute value to an int.
DataClass	setAttribute(java.lang.String property, int[] value) Set attribute value to an int array.
DataClass	setAttribute(java.lang.String property, java.lang.Integer value) Set attribute value to an Integer.
DataClass	setAttribute(java.lang.String property, java.lang.Integer[] value) Set attribute value to an Integer array.
DataClass	setAttribute(java.lang.String property, com.google.gwt.core.client.JavaScriptObject value) Set attribute value to a JavaScriptObject.
DataClass	setAttribute(java.lang.String property, long value) Set attribute value to a long.
DataClass	setAttribute(java.lang.String property, java.util.Map value) Set attribute value to a Map.
DataClass	setAttribute(java.lang.String property, java.lang.Object value) Set the attribute value to an Object.
DataClass	setAttribute(java.lang.String property, java.lang.String value) Set attribute value to a String
DataClass	setAttribute(java.lang.String property, java.lang.String[] value) Set attribute value to a String array.
DataClass	setAttribute(java.lang.String property, ValueEnum value) Set attribute value to a ValueEnum.
DataClass	setAttribute(java.lang.String property, ValueEnum[] value) Set attribute value to a ValueEnum array.
DataClass	setAttributeAsJavaObject(java.lang.String property, java.lang.Object value) Set the attribute value to an Object.
void	setFactoryCreated(boolean createdByBeanFactory)

Methods inherited from class com.smartgwt.client.core.JsObject

equals, getJsObj, hashCode, isCreated, setJavaScriptObject, setJsObj

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail

factoryProperties

protected java.util.Map<java.lang.String,java.lang.Object> factoryProperties

factoryCreated

protected boolean factoryCreated

Constructor Detail

DataClass

public DataClass()

DataClass

public DataClass(com.google.gwt.core.client.JavaScriptObject jsObj)

Method Detail

applyFactoryProperties

public void applyFactoryProperties()

setFactoryCreated

public void setFactoryCreated(boolean createdByBeanFactory)

isFactoryCreated

public boolean isFactoryCreated()

setAttribute

public DataClass setAttribute(java.lang.String property,
                              java.lang.String value)

Set attribute value to a String

Parameters:

property -

value -

Returns:

DataClass instance, for chaining setter calls

getAttribute

public java.lang.String getAttribute(java.lang.String property)

Returns attribute value as a String

Parameters:

property -

Returns:

getAttributeAsString

public java.lang.String getAttributeAsString(java.lang.String property)

Returns attribute value as a String.

Parameters:

property -

Returns:

getAttributeAsInt

public java.lang.Integer getAttributeAsInt(java.lang.String property)

Returns attribute value as an Integer. Applies to values stored as a JavaScript number on the underlying data object.

Parameters:

property -

Returns:

getAttributeAsBoolean

public java.lang.Boolean getAttributeAsBoolean(java.lang.String property)

Returns attribute value set as a Boolean. For convenience in checking boolean properties, getAttributeAsBoolean will return Boolean false if the attribute value is null or not a Boolean. Use the two parameter variant of this API getAttributeAsBoolean(String, boolean) if you want null returned for null attribute values.

Parameters:

property - the property name

Returns:

the property value

getAttributeAsBoolean

public java.lang.Boolean getAttributeAsBoolean(java.lang.String property,
                                               boolean allowNull)

Returns attribute value set as a Boolean. If the attribute value is null or not a Boolean, the return value depends upon allowNull. If allowNull is true, null will be returned; otherwise Boolean false will be returned. For a simpler approach that never returns null, use the one parameter variant of this API getAttributeAsBoolean(String).

Parameters:

property - the property name

allowNull - whether to allow null

Returns:

the property value

getAttributeAsDouble

public java.lang.Double getAttributeAsDouble(java.lang.String property)

Returns attribute as a Double. Applies to values stored as a JavaScript Number on the underlying data object.

Parameters:

property -

Returns:

getAttributeAsLong

public java.lang.Long getAttributeAsLong(java.lang.String property)

Returns attribute as a Long. Applies to values stored as a JavaScript Number on the underlying data object.

Parameters:

property -

Returns:

getAttributeAsDoubleArray

public double[] getAttributeAsDoubleArray(java.lang.String property)

Returns attribute as a double array. Applies to values stored as a JavaScript Array of Numbers on the underlying data object.

Parameters:

property -

Returns:

setAttribute

public DataClass setAttribute(java.lang.String property,
                              DataClass[] value)

Set attribute value to a DataClass array. Value will be stored as a JavaScript Array of the underlying JavaScript objects for each entry.

Parameters:

property -

value -

Returns:

DataClass instance, for chaining setter calls

setAttribute

public DataClass setAttribute(java.lang.String property,
                              BaseClass[] value)

Set attribute value to a BaseClass array. Value will be stored as a JavaScript Array of the underlying JavaScript objects for each entry.

Parameters:

property -

value -

Returns:

DataClass instance, for chaining setter calls

setAttribute

public DataClass setAttribute(java.lang.String property,
                              BaseWidget[] value)

Set attribute value to a BaseWidget array. Value will be stored as a JavaScript Array of the underlying JavaScript objects for each entry.

Parameters:

property -

value -

Returns:

DataClass instance, for chaining setter calls

getAttributeAsIntArray

public int[] getAttributeAsIntArray(java.lang.String property)

Returns attribute as an int array. Applies to values stored as a JavaScript Array of Numbers on the underlying data object.

Parameters:

property -

Returns:

setAttribute

public DataClass setAttribute(java.lang.String property,
                              java.lang.String[] value)

Set attribute value to a String array. Value will be stored as a JavaScript Array of Strings on the underlying data object.

Parameters:

property -

value -

Returns:

DataClass instance, for chaining setter calls

getAttributeAsStringArray

public java.lang.String[] getAttributeAsStringArray(java.lang.String property)

Returns attribute as a String array. Applies to values stored as a JavaScript Array of Strings on the underlying data object.

Parameters:

property -

Returns:

setAttribute

public DataClass setAttribute(java.lang.String property,
                              DataClass value)

Set attribute value to a DataClass. Value will be stored as the underlying JavaScript object for the DataClass instance passed in.

Parameters:

property -

value -

Returns:

DataClass instance, for chaining setter calls

setAttribute

public DataClass setAttribute(java.lang.String property,
                              BaseClass value)

Set attribute value to a BaseClass. Value will be stored as the underlying JavaScript object for the BaseClass instance passed in.

Parameters:

property -

value -

Returns:

DataClass instance, for chaining setter calls

setAttribute

public DataClass setAttribute(java.lang.String property,
                              com.google.gwt.core.client.JavaScriptObject value)

Set attribute value to a JavaScriptObject.

Parameters:

property -

value -

Returns:

DataClass instance, for chaining setter calls

setAttribute

public DataClass setAttribute(java.lang.String property,
                              java.util.Date value)

Set attribute value to a Date. Value will be stored as a JavaScript Date on the underlying data object

Parameters:

property -

value -

Returns:

DataClass instance, for chaining setter calls

setAttribute

public DataClass setAttribute(java.lang.String property,
                              java.util.Map value)

Set attribute value to a Map. Value will be stored as a JavaScript Object on the underlying data object, with property/value pairs matching the keys/values specified on the Map. Note that this is a recursive conversion - each value will also be converted to the equivalent JavaScript type where appropriate.

Parameters:

property -

value -

Returns:

DataClass instance, for chaining setter calls

setAttribute

public DataClass setAttribute(java.lang.String property,
                              ValueEnum[] value)

Set attribute value to a ValueEnum array. Value will be stored as a JavaScript Array containing the each Enum value.

Parameters:

property -

value -

Returns:

DataClass instance, for chaining setter calls

setAttribute

public DataClass setAttribute(java.lang.String property,
                              ValueEnum value)

Set attribute value to a ValueEnum. The value of the ValueEnum will be stored on the underlying data object.

Parameters:

property -

value -

Returns:

DataClass instance, for chaining setter calls

setAttribute

public DataClass setAttribute(java.lang.String property,
                              java.lang.Object value)

Set the attribute value to an Object.

The values provided as attributes are generally expected to contain valid values for a field of a DataBoundComponent. Therefore this method converts the value passed in to an equivalent object in JavaScript before storing on underlying data object.
Developers can use setAttributeAsJavaObject(String, Object) to store Java objects without converting to JavaScript.

Conversions that occur include:

• Numeric data types will be represented as JavaScript Number
• Dates (and subclasses) will be stored as JavaScript Date
• Java Arrays will be stored as JavaScript Array, with members converted to the equivalent JavaScript type where appropriate
• Java Collections (including List, Set) will be stored as JavaScript Array, with members converted to the equivalent JavaScript object (recursively) where appropriate
• Maps are stored as JavaScript Objects with each key mapped to a property on the object. Property values are converted to the equivalent JavaScript object (recursively) where appropriate

Other Java Objects, including POJOs are stored on the underlying data object unconverted. Developers can retrieve such values via getAttributeAsObject(String).

Parameters:

property - the attribute name

value - the attribute value.

Returns:

DataClass instance, for chaining setter calls

setAttributeAsJavaObject

public DataClass setAttributeAsJavaObject(java.lang.String property,
                                          java.lang.Object value)

Set the attribute value to an Object.

Unlike setAttribute(String, Object), this method will store the value passed in as-is rather than converting to an equivalent object in JavaScript.

Parameters:

property -

value -

Returns:

DataClass instance, for chaining setter calls

setAttribute

public DataClass setAttribute(java.lang.String property,
                              boolean value)

Set attribute value to a boolean.

Parameters:

property -

value -

Returns:

DataClass instance, for chaining setter calls

setAttribute

public DataClass setAttribute(java.lang.String property,
                              java.lang.Boolean value)

Set attribute value to a Boolean.

Parameters:

property -

value -

Returns:

DataClass instance, for chaining setter calls

setAttribute

public DataClass setAttribute(java.lang.String property,
                              int value)

Set attribute value to an int. Value will be stored as a JavaScript Number on the underlying data object

Parameters:

property -

value -

Returns:

DataClass instance, for chaining setter calls

setAttribute

public DataClass setAttribute(java.lang.String property,
                              java.lang.Integer value)

Set attribute value to an Integer. Value will be stored as a JavaScript Number on the underlying data object

Parameters:

property -

value -

Returns:

DataClass instance, for chaining setter calls

setAttribute

public DataClass setAttribute(java.lang.String property,
                              long value)

Set attribute value to a long. Value will be stored as a JavaScript Number on the underlying data object.

Parameters:

property -

value -

Returns:

DataClass instance, for chaining setter calls

setAttribute

public DataClass setAttribute(java.lang.String property,
                              java.lang.Float value)

Set attribute value to a Float. Value will be stored as a JavaScript Number on the underlying data object

Parameters:

property -

value -

Returns:

DataClass instance, for chaining setter calls

setAttribute

public DataClass setAttribute(java.lang.String property,
                              double value)

Set attribute value to a double. Value will be stored as a JavaScript Number on the underlying data object

Parameters:

property -

value -

Returns:

DataClass instance, for chaining setter calls

setAttribute

public DataClass setAttribute(java.lang.String property,
                              java.lang.Double value)

Set attribute value to a Double. Value will be stored as a JavaScript Number on the underlying data object

Parameters:

property -

value -

Returns:

DataClass instance, for chaining setter calls

setAttribute

public DataClass setAttribute(java.lang.String property,
                              int[] value)

Set attribute value to an int array. Value will be stored as a JavaScript Array of Numbers on the underlying data object.

Parameters:

property -

value -

Returns:

DataClass instance, for chaining setter calls

setAttribute

public DataClass setAttribute(java.lang.String property,
                              java.lang.Integer[] value)

Set attribute value to an Integer array. Value will be stored as a JavaScript Array of Numbers on the underlying data object.

Parameters:

property -

value -

Returns:

DataClass instance, for chaining setter calls

setAttribute

public DataClass setAttribute(java.lang.String property,
                              double[] value)

Set attribute value to a double array. Value will be stored as a JavaScript Array of Numbers on the underlying data object

Parameters:

property -

value -

Returns:

DataClass instance, for chaining setter calls

getAttributeAsFloat

public java.lang.Float getAttributeAsFloat(java.lang.String property)

Returns attribute value as a Float. Applies to values stored as a JavaScript number on the underlying data object.

Parameters:

property -

Returns:

getAttributeAsDate

public java.util.Date getAttributeAsDate(java.lang.String property)

Returns attribute value as a Date. Applies to values stored as a JavaScript Date on the underlying data object.

Parameters:

property -

Returns:

getAttributeAsObject

public java.lang.Object getAttributeAsObject(java.lang.String property)

Returns attribute value as a Java Object.

If the attribute has been set as a Java Object (typically via a call to setAttributeAsJavaObject(String, Object)) it will be returned as is.

Values specified as JavaScript types will be converted to the equivalent Java type if possible.

Parameters:

property -

Returns:

getAttributeAsMap

public java.util.Map getAttributeAsMap(java.lang.String property)

Returns attribute value as a Map. Applies to values stored as a JavaScript Object on the underlying data object.

Parameters:

property -

Returns:

getAttributeAsRecord

public Record getAttributeAsRecord(java.lang.String property)

Get the attribute value as a Record.

Parameters:

property - the property name

Returns:

the record value

getAttributeAsJavaScriptObject

public com.google.gwt.core.client.JavaScriptObject getAttributeAsJavaScriptObject(java.lang.String property)

Returns attribute value as a JavaScript Object.

Parameters:

property -

Returns:

getAttributes

public java.lang.String[] getAttributes()

fireEvent

public void fireEvent(com.google.gwt.event.shared.GwtEvent<?> event)

Specified by:

fireEvent in interface com.google.gwt.event.shared.HasHandlers

doAddHandler

protected final <H extends com.google.gwt.event.shared.EventHandler> com.google.gwt.event.shared.HandlerRegistration doAddHandler(H handler,
                                                                                                                                  com.google.gwt.event.shared.GwtEvent.Type<H> type)

getHandlerCount

public int getHandlerCount(com.google.gwt.event.shared.GwtEvent.Type<?> type)