public class Operator
extends java.lang.Object
This class is not meant to be created and used, it is actually documentation of settings
allowed in a DataSource descriptor (.ds.xml file), for use with Smart GWT Pro Edition and
above.
See com.smartgwt.client.docs.serverds
for how to use this documentation.
Use with DataSource.addSearchOperator()
to define custom filtering behaviors for client-side filtering.
Modifier and Type | Field and Description |
---|---|
FormItem |
editorType
|
FieldType[] |
fieldTypes
List of types that this Operator is valid for.
|
boolean |
hidden
Whether this operator should be offered to users by default in interfaces such as the
FilterBuilder . |
OperatorId |
ID
Unique id for an operator, which appears within
AdvancedCriteria as the Operator property. |
boolean |
requiresServer
Whether this operator needs to be executed on the server side.
|
java.lang.String |
symbol
The text use when using this operator as an
expression in a FormItem. |
java.lang.String |
textTitle
User-visible title for this operator when used with text-based fields - eg, "equals (match
case)" rather than just "equals".
|
Identifier |
textTitleProperty
Name of a property on the Operators class that provides the title for this operator when used
with text-based fields.
|
java.lang.String |
title
User-visible title for this operator, such as "doesn't contain".
|
Identifier |
titleProperty
Name of a property on the Operators class that provides the title for this operator.
|
java.lang.String |
usageHint
Usage hint text specific to this Operator and shown, for example, in the hover-text of
ListGrid filterEditor fields. |
OperatorValueType |
valueType
Indicates the kind of value expected in a
Criterion
that uses this operator. |
Constructor and Description |
---|
Operator() |
public boolean hidden
FilterBuilder
. Setting hidden:true means the operator
can be used in a programmatic search, for example, by calling ResultSet.setCriteria()
, but does not appear in
the UI.
Default value is false
Advanced Filtering
public FieldType[] fieldTypes
If omitted, the operator is assumed to be
valid for all FieldTypes unless a list of FieldTypes is passed to DataSource.addSearchOperator()
.
Default value is null
Advanced Filtering
public Identifier titleProperty
Default value is null
Advanced Filtering
public OperatorId ID
AdvancedCriteria
as the Operator
property. A list of built-in identifiers is
here
.
Default value is null
Advanced Filtering
public java.lang.String textTitle
To simplify internationalization by separating titles
from operator code, you can use specify textTitleProperty
instead of this
property.
Default value is null
Advanced Filtering
public java.lang.String title
To simplify
internationalization by separating titles from operator code, you can use specify titleProperty
instead of this
property.
Default value is null
Advanced Filtering
public FormItem editorType
valueType
:"custom", indicates what kind of FormItem to use to provide a user interface for
creating a valid Criterion
. The default of
null
means an ordinary TextItem is fine.
Default value is null
Advanced Filtering
public java.lang.String symbol
expression
in a FormItem.
Default value is null
Advanced Filtering
public boolean requiresServer
This implies that if a
Criterion
using this operator is either introduced
into criteria
or is changed, the
server will need to be contacted to perform filtering.
Default value is false
Advanced Filtering
public OperatorValueType valueType
Criterion
that uses this operator. OperatorValueType
lists
possibilities. The default of null
is equivalent to "fieldType", indicating
that Criterion.value
is expected to
contain a value of the same type as the field indicated by Criterion.fieldName
.
Default value is null
Advanced Filtering
public java.lang.String usageHint
ListGrid
filterEditor
fields. If unset, the default for all operators, this value is derived from an attribute on the Operators class, in the format [operator.valueType]UsageHint - for example, the "between" operator uses valueRangeUsageHint.
Default value is null
Advanced Filtering
public Identifier textTitleProperty
Default value is null
Advanced Filtering