SuperMap iClient for JavaScript查询过滤条件构建

作者：Lily

一、 前言
       查询是使用SuperMap iClient for JavaScript经常用到的一个功能，当然在使用过程中我们必须设置查询过滤参数，尤其是必设属性-过滤条件（attributeFilter），一般来说就相当于 SQL 语句中的 WHERE 子句，其格式为：WHERE <条件表达式>， attributeFilter 就是其中的“条件表达式”。 该字段的用法为 attributeFilter = “过滤条件”,其中过滤条件是需要我们自己构建的。需要注意的是，由于文件型数据源中的属性信息是以 Access 格式存储的，用SQL或 Oracle 数据库中查询语句进行查询可能会查询不成功，下面以World文件型数据源发布的地图服务和数据服务为例详细介绍一下文件型数据源过滤条件的构建方式。
二、不同类型查询过滤条件构建
1、数值的查询
       对数值的查询过滤条件中可以使用“字段名＝（ 或<>, >, <, <=, >=, Between…and等等）字段值 ”。
例如：查询World 数据集中SMID字段值为247的记录

getFeatureParam = new SuperMap.REST.FilterParameter({
                name: "World@world",
                fields:["SMID","CAPITAL","SMAREA","T_DATE"],
                attributeFilter: "SMID = 247"
            });

可以在浏览器中查看返回结果：

2、日期型字段的查询
       对于日期型字段的查询是我们需要特别注意的，尤其是对于文件型的数据源，经常会有人不知道对于文件型数据源的日期该如何查询，一般对文件型数据源查日期时，查询过滤条件是这样构建的：“字段名=to_date(YYYY-MM-DD HH:MM:SS) ”。（此处要特别注意）
例如: 查询的是 World 数据集中 T_date 字段为1867-07-01 0:00:00的记录

    getFeatureParam = new SuperMap.REST.FilterParameter({
                name: "World@world",
                fields:["SMID","CAPITAL","SMAREA","T_DATE"],
                attributeFilter:"T_Date = to_date(1867-07-01  0:00:00)" //此处写成1867/7/1 0:00:00、1867-7-1 0:00:00两种形式都可以 });

可以看到查询结果:

查询某个时间段的构建方式：“字段名 Between to_date(YYYY-MM-DD HH:MM:SS) and to_date(YYYY-MM-DD HH:MM:SS)” ”
例如：查询的是 World 数据集中2010年全年的记录

getFeatureParam = new SuperMap.REST.FilterParameter({
                name: "World@world",
                fields:["SMID","CAPITAL","SMAREA","T_DATE"],
                attributeFilter:"T_Date Between to_date(2010-01-01 0:0:0) and to_date(2010-12-31 0:0:0)"
 });

查询结果：

3、模糊查询
模糊查询使用 “like”，而且不同类型的数据源使用的匹配符不尽相同。
1）部分匹配，文件型数据源中的通配符为%，并且要使用单引号
例如：查询 World 数据集中 CAPITAL 字段中以“布”开头的那些国家。

getFeatureParam = new SuperMap.REST.FilterParameter({
                name: "World@world",
                fields:["SMID","CAPITAL","SMAREA","T_DATE"],
                attributeFilter:"CAPITAL like '布%'"
 }); 

查询结果有7个“布”字开头的国家：

2）完全匹配
查询过滤条件：“字段名  like ‘字段值’”（注意字段值必须用单引号）
例如：查询的是 World 数据集中 CAPITAL 字段值为“北京”的国家。

getFeatureParam = new SuperMap.REST.FilterParameter({
                name: "World@world",
                fields:["SMID","CAPITAL","SMAREA","T_DATE"],
              attributeFilter:"CAPITAL like '北京'" 
});

查询结果：

3）单字匹配，使用“_”
例如：查询的是 World 数据集中 CAPITAL 字段值为“达”后面仅加一个字符的国家。

getFeatureParam = new SuperMap.REST.FilterParameter({
                name: "World@world",
                fields:["SMID","CAPITAL","SMAREA","T_DATE"],
                attributeFilter:"CAPITAL like '达_'"
 });

查询结果：

4、比较运算符过滤条件中的应用
比较运算符，如>, <, >=, <=, <> 等等。
例如：查询的是 World 数据集中 Country 字段值的首字母在 F 到 Z 之间的那些国家

getFeatureParam = new SuperMap.REST.FilterParameter({
                name: "World@world",
                fields:["SMID","CAPITAL","SMAREA","T_DATE"],
               attributeFilter:"Country >= '芬兰'"
 });

5、查询特定值
使用 in，确定表达式的值是否等于指定列表内若干值中的任意一个值。
例如：查询的是 World 数据集中 CAPITAL 字段值为“北京”，“万象”的一个或几个国家。

getFeatureParam = new SuperMap.REST.FilterParameter({
                name: "World@world",
                fields:["SMID","CAPITAL","SMAREA","T_DATE"],
               attributeFilter:"CAPITAL in ('北京','伦敦')"  //字符型字段              
               //attributeFilter:"SmID in (1,247)"  //数值型字段 
 });

查询结果：

注意：对于字符型字段的查询需要将查询值使用单引号（’’）或者双引号（””）括起来，而数值型字段的查询不需要。
6、查询某个字段值是否为空
使用 is NULL 是查询字段值为空，is not NULL是不为空
例如：查询的是 World 数据集中 CAPITAL 字段值不为空的那些国家

getFeatureParam = new SuperMap.REST.FilterParameter({
                name: "World@world",
                fields:["SMID","CAPITAL","SMAREA","T_DATE"],
                attributeFilter:" CAPITAL is not  NULL "
 });

查询结果不为空的有20个国家：

7、布尔型字段查询
布尔型字段属性值为 True 或者 False，查询时用1表示True，0表示False。
例如：查询的是 City_R 数据集中沿海的城市。

getFeatureParam = new SuperMap.REST.FilterParameter({
                name: "World@world",
                fields:["SMID","CAPITAL","SMAREA","T_DATE"],
                attributeFilter:" City_R.Coastal = 1"
 });

8、构造组合语句
使用 and，将两个或者多个查询语句组合起来。
例如：查询的是国土面积大于500万平方公里并且1994年人口小于1亿的国家。

getFeatureParam = new SuperMap.REST.FilterParameter({
                name: "World@world",
                fields:["SMID","CAPITAL","SMAREA","T_DATE"],
                attributeFilter:"SmArea > 5000000000000 AND World.POP_1994 < 100000000"
 });

查询得到满足条件的3个结果：

       以上就是在查询过程中可能用到的过滤条件的构建方式，注意本文主要是针对文件型数据源的，至于数据库型数据源的查询条件其实就和在数据库中的查询条件一样，我这里就不再赘述了。

转载自：https://blog.csdn.net/supermapsupport/article/details/53910299