Package com.smartgwt.client.docs.serverds

This package is reference for all properties that may be specified in DataSource descriptor (.ds.xml file), for use with Smart GWT Pro Edition and above.

See: Description

Class Summary

Class	Description
AdvancedCriteria	AdvancedCriteria is a format for representing search criteria which may include operators on field values such as "less than", or may include sub-clauses such as several criteria applied to fields joined by an "OR" operator.
Criterion	An object representing a criterion to apply to a record.
DataSource	A DataSource is data-provider-independent description of a set of objects that will be loaded, edited and saved within the user interface of your application.
DataSourceField	Metadata about a DataSourceField, including its type and validators.
DSRequestModifier	An object that modifies a dsRequest based on several available values, including preceding responses from the same queue.
Mail	A Mail object describes an email that will be sent automatically by the Smart GWT Server as part of a normal DataSource operation.
OperationBinding	An operationBinding tells a DataSource how to execute one of the basic DS operations: fetch, add, update, remove.
Operator	Specification of an operator for use in filtering, for example "equals".
ServerObject	The ServerObject tells the ISC server how to find or create a server-side object involved in DMI (Direct Method Invocation).
SimpleType	An atomic type such as a string or number, that is generally stored, displayed and manipulated as a single value.
Validator	A validator describes a check that should be performed on a value the user is trying to save.

Package com.smartgwt.client.docs.serverds Description

This package is reference for all properties that may be specified in DataSource descriptor (.ds.xml file), for use with Smart GWT Pro Edition and above. Do not import this package in your Java code - it is informational only.

Each Java Class here represents an XML element, and each field is a setting that can be specified as either an attribute or a subelement.

For example, DataSource.canMultiSort can be set like this:

<DataSource canMultiSort="true"/>

Or like this:

<DataSource>
    <canMultiSort>true</canMultiSort>
</DataSource>

When a class in this package has a field that is an Array of another class, it means there is a containing XML tag named after the field, then several tags named after the class. For example, DataSource.operationBindings is an Array of OperationBinding. The XML for this is:

<DataSource>
    <operationBindings>
        <operationBinding operationType="fetch">
            ... various operationBinding settings ...
        </operationBinding>
    </operationBindings>
</DataSource>

If the field is not an Array, it means there should be a singular tag. For example, OperationBinding.mail:

<DataSource>
    <operationBindings>
        <operationBinding operationType="add">
            <mail to="admin@company.com" templateFile="messageTemplate.txt"/>
        </operationBinding>
    </operationBindings>
</DataSource>

DataSource files and other Component XML files can be localized using resource bundles - see this overview for details.

NOTE: the settings described in the special "serverds" JavaDoc package are only usable with Smart GWT Pro Edition and above, however, the "serverds" documentation is included with Smart GWT LGPL since some parts of the documentation cover concepts and approaches that are also applicable in Smart GWT LGPL.