FilterParameter

@interface FilterParameter : NSObject

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

Summary
FilterParameter查询过滤条件参数类。 该类用于设置查询数据集的查询过滤参数。
Properties
attributeFilter{NSString} 属性过滤条件。 相当于 SQL 语句中的 WHERE 子句,其格式为:WHERE <条件表达式>, attributeFilter 就是其中的“条件表达式”。 该字段的用法为 attributeFilter = “过滤条件”。 例如,要查询字段 fieldValue 小于100的记录,设置 attributeFilter = “fieldValue < 100”; 要查询字段 name 的值为“酒店”的记录,设置 attributeFilter = “name like ‘%酒店%’”,等等。
name{NSString} 查询数据集名称或者图层名称,根据实际的查询对象而定,必设属性。 一般情况下该字段为数据集名称,但在进行与地图相关功能的操作时, 需要设置为图层名称(图层名称格式:数据集名称@数据源别名)。 因为一个地图的图层可能是来自于不同数据源的数据集, 而不同的数据源中可能存在同名的数据集, 使用数据集名称不能唯一的确定数据集, 所以在进行与地图相关功能的操作时,该值需要设置为图层名称。
joinItems{NSMutableArray(JoinItem)} 与外部表的连接信息 JoinItem 数组。
linkItems{NSMutableArray(LinkItem)} 与外部表的关联信息 LinkItem 数组。
ids{NSMutableArray(NSString)} 查询 id 数组,即属性表中的 SmID 值。
orderBy{NSString} 查询排序的字段,orderBy的字段须为数值型的。 相当于 SQL 语句中的 ORDER BY 子句,其格式为:ORDER BY <列名>, 列名即属性表中每一列的名称,列又可称为属性,在 SuperMap 中又称为字段。 对单个字段排序时,该字段的用法为 orderBy = “字段名”; 对多个字段排序时,字段之间以英文逗号进行分割,用法为 orderBy = “字段名1, 字段名2”。 例如,现有一个国家数据集,它有两个字段分别为“SmArea”和“pop_1994”, 分别表示国家的面积和1994年的各国人口数量。 如果要按照各国人口数量对记录进行排序,则 orderBy = “pop_1994”; 如果要以面积和人口进行排序,则 orderBy = “SmArea, pop_1994”。
groupBy{NSString} 查询分组条件的字段。 相当于 SQL 语句中的 GROUP BY 子句,其格式为:GROUP BY <列名>, 列名即属性表中每一列的名称,列又可称为属性,在 SuperMap 中又称为字段。 对单个字段分组时,该字段的用法为 groupBy = “字段名”; 对多个字段分组时,字段之间以英文逗号进行分割,用法为 groupBy = “字段名1, 字段名2”。 例如,现有一个全球城市数据集,该数据集有两个字段分别为“Continent”和“Country”, 分别表示某个城市所属的洲和国家。 如果要按照国家对全球的城市进行分组, 可以设置 groupBy = “Country”; 如果以洲和国家对城市进行分组,设置 groupBy = “Continent, Country”。
fields{NSMutableArray(NSString)} 查询字段数组,如果不设置则使用系统返回的所有字段。

Properties

attributeFilter

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

name

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

joinItems

{NSMutableArray(JoinItem)} 与外部表的连接信息 JoinItem 数组。

linkItems

{NSMutableArray(LinkItem)} 与外部表的关联信息 LinkItem 数组。

ids

{NSMutableArray(NSString)} 查询 id 数组,即属性表中的 SmID 值。

orderBy

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

groupBy

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

fields

{NSMutableArray(NSString)} 查询字段数组,如果不设置则使用系统返回的所有字段。

@interface FilterParameter : NSObject
查询过滤条件参数类。 该类用于设置查询数据集的查询过滤参数。
@interface JoinItem : NSObject
连接信息类。 该类用于定义矢量数据集与外部表的连接信息。 外部表可以为另一个矢量数据集(其中纯属性数据集中没有空间几何信息) 所对应的 DBMS(Database Management System,数据库管理系统)表, 也可以是用户自建的业务表。需要注意的是,矢量数据集与外部表必须属于同一数据源。 用于连接两个表的字段的名称不一定相同,但类型必须一致。
@interface LinkItem : NSObject
关联信息类。 该类用于定义矢量数据集与外部表之间的关联信息。 外部表可以为另一个矢量数据集(其中纯属性数据集中没有空间几何信息)所对应的 DBMS 表,也可以是用户自建的业务表。 表之间的联系的建立有两种方式,一种是连接(join),一种是关联(link)。连接的相关设置是通过JoinItem类实现的, 关联的相关设置是通过LinkItem类实现的,另外,用于建立连接的两个表必须在同一个数据源下, 而用于建立关联关系的两个表可以不在同一个数据源下。矢量数据集与外部表可以属于不同的数据源。 使用 LinkItem 的约束条件:空间数据和属性数据必须有关联条件,即主空间数据集与外部属性表之间存在关联字段。 主空间数据集:用来与外部表进行关联的数据集。 外部属性表:用户通过 Oracle 或者 SQL Server 创建的数据表, 或者是另一个矢量数据集所对应的 DBMS(Database Management System,数据库管理系统)表。
Close