Class: FilterParameter

FilterParameter

查询过滤条件参数类。该类用于设置查询数据集的查询过滤参数。

new FilterParameter(options)

Usage
// 浏览器
<script type="text/javascript" src="https://iclient.supermap.io/dist/openlayers/iclient-ol.js"></script>
<script>
  new ol.supermap.FilterParameter(options);
  
  // 弃用的写法
  new SuperMap.FilterParameter(options);

</script>

// ES6 Import
import { FilterParameter } from '@supermapgis/iclient-ol';

new FilterParameter(options);

common/iServer/FilterParameter.js, line 6
Name Type Description
options Object

参数。

Name Type Description
attributeFilter string

属性过滤条件。

name string

查询数据集名称或者图层名称。

joinItems Array.<JoinItem> 可选

与外部表的连接信息 JoinItem 数组。

linkItems Array.<LinkItem> 可选

与外部表的关联信息 LinkItem 数组。

ids Array.<string> 可选

查询 id 数组,即属性表中的 SmID 值。

orderBy string 可选

查询排序的字段,orderBy 的字段须为数值型的。

groupBy string 可选

查询分组条件的字段。

fields Array.<string> 可选

查询字段数组。

Members

attributeFilterstring

属性过滤条件。 相当于 SQL 语句中的 WHERE 子句,其格式为:WHERE <条件表达式>, attributeFilter 就是其中的“条件表达式”。 该字段的用法为 attributeFilter = "过滤条件"。 例如,要查询字段 fieldValue 小于 100 的记录,设置 attributeFilter = "fieldValue < 100"; 要查询字段 name 的值为“酒店”的记录,设置 attributeFilter = "name like '%酒店%'",等等。

fieldsArray.<string>

查询字段数组,如果不设置则使用系统返回的所有字段。

groupBystring

查询分组条件的字段。 相当于 SQL 语句中的 GROUP BY 子句,其格式为:GROUP BY <列名>, 列名即属性表中每一列的名称,列又可称为属性,在 SuperMap 中又称为字段。 对单个字段分组时,该字段的用法为 groupBy = "字段名"; 对多个字段分组时,字段之间以英文逗号进行分割,用法为 groupBy = "字段名1, 字段名2"。 例如,现有一个全球城市数据集,该数据集有两个字段分别为“Continent”和“Country”, 分别表示某个城市所属的洲和国家。 如果要按照国家对全球的城市进行分组,可以设置 groupBy = "Country"; 如果以洲和国家对城市进行分组,设置 groupBy = "Continent, Country"。

idsArray.<string>

查询 id 数组,即属性表中的 SmID 值。

joinItemsArray.<JoinItem>

与外部表的连接信息 JoinItem 数组。

linkItemsArray.<LinkItem>

与外部表的关联信息 LinkItem 数组。

namestring

查询数据集名称或者图层名称,根据实际的查询对象而定。 一般情况下该字段为数据集名称,但在进行与地图相关功能的操作时, 需要设置为图层名称(图层名称格式:数据集名称@数据源别名)。 因为一个地图的图层可能是来自于不同数据源的数据集, 而不同的数据源中可能存在同名的数据集, 使用数据集名称不能唯一的确定数据集, 所以在进行与地图相关功能的操作时,该值需要设置为图层名称。

orderBystring

查询排序的字段,orderBy 的字段须为数值型的。 相当于 SQL 语句中的 ORDER BY 子句,其格式为:ORDER BY <列名>或ORDER BY <列名 排序规则>。 列名即属性表中每一列的名称,列又可称为属性,在 SuperMap 中又称为字段。 排序规则即按字段的升序或降序排序,asc 表示升序,desc 表示降序,不指定排序规则按升序排序。 对单个字段排序时,该字段的用法为 orderBy = "字段名",升序为orderBy = "字段名 asc";降序为 orderBy = "字段名 desc"; 对多个字段排序时,字段之间以英文逗号进行分割,用法为 orderBy = "字段名1, 字段名2 asc, 字段名2 desc"。 例如,在一个国家数据集中,有两个字段,字段名分别为“SmArea”和“pop_1994”,分别表示国家的面积和1994年的各国的人口数量, 如果要按照各国人口数量对记录进行排序,可以设置 orderBy = "pop_1994"; 如果要以面积降序和人口升序进行排序, 设置 orderBy = "SmArea desc, pop_1994 asc"。

Methods

destroy()

common/iServer/FilterParameter.js, line 109

释放资源,将引用资源的属性置空。