连接信息类。 该类用于矢量数据集与外部表的连接。外部表可以为另一个矢量数据集（其中纯属性数据集中 没有空间几何信息）所对应的 DBMS 表，也可以是用户自建的业务表。需要注意的是，矢 量数据集与外部表必须属于同一数据源。表之间的联系的建立有两种方式，一种是连接 （join），一种是关联（link）。连接，实际上是依据相同的字段将一个外部表追加到指定的表； 而关联是基于一个相同的字段定义了两个表格之间的联系，但不是实际的追加。用于连接两个表 的字段的名称不一定相同，但类型必须一致。当两个表格之间建立了连接，通过对主表进行操作， 可以对外部表进行查询，制作专题图以及分析等。当两个表格之间是一对一或多对一的关系时， 可以使用 join 连接。当为多对一的关系时，允许指定多个字段之间的关联。
(注意： JoinItem 目前支持左连接和内连接，不支持全连接和右连接，UDB 引擎不支持内连接。 并且用于建立连接的两个表必须在同一个数据源下。 )
| SuperMap. |
连接信息类。 该类用于矢量数据集与外部表的连接。外部表可以为另一个矢量数据集（其中纯属性数据集中 没有空间几何信息）所对应的 DBMS 表，也可以是用户自建的业务表。需要注意的是，矢 量数据集与外部表必须属于同一数据源。表之间的联系的建立有两种方式，一种是连接 （join），一种是关联（link）。连接，实际上是依据相同的字段将一个外部表追加到指定的表； 而关联是基于一个相同的字段定义了两个表格之间的联系，但不是实际的追加。用于连接两个表 的字段的名称不一定相同，但类型必须一致。当两个表格之间建立了连接，通过对主表进行操作， 可以对外部表进行查询，制作专题图以及分析等。当两个表格之间是一对一或多对一的关系时， 可以使用 join 连接。当为多对一的关系时，允许指定多个字段之间的关联。 |
| Properties | |
| foreignTableName | {String} 外部表的名称。 如果外部表的名称是以“表名@数据源名”命名方式，则该属性只需赋值表名。 例如：外部表 Name@changchun，Name 为表名，changchun 为数据源名称，则该属性的赋值应为：Name。 |
| joinFilter | {String} 矢量数据集与外部表之间的连接表达式，即设定两个表之间关联的字段。 例如，将房屋面数据集（Building）的 district 字段与房屋拥有者的纯属性数据集（Owner）的 region 字段相连接， 两个数据集对应的表名称分别为 Table_Building 和 Table_Owner， 则连接表达式为 Table_Building.district = Table_Owner.region。 当有多个字段相连接时，用 AND 将多个表达式相连。 |
| joinType | {SuperMap.REST.JoinType} 两个表之间连接类型。 连接类型决定了对两个表进行连接查询后返回的记录的情况。 |
| Constructor | |
| SuperMap. |
连接信息类构造函数。 |
| Functions | |
| destroy | 释放资源，将引用资源的属性置空。 |
{SuperMap.REST.JoinType} 两个表之间连接类型。 连接类型决定了对两个表进行连接查询后返回的记录的情况。
连接信息类构造函数。
设置将TableB连接TableA的连接信息，即建立JoinItem 类并设置其属性， 当执行TableA的查询操作时，系统将根据连接条件及查询条件，将满足条件 的TableA中的内容与满足条件的TableB中的内容构成一个查询结果表，并 这个查询表保存在内存中，需要获取结果时，再从内存中取出相应的内容。
下面以SQL查询说明joinItem的使用方法：
function queryBySQL() {
// 设置与外部表的连接信息
var joinItem = new SuperMap.REST.JoinItem({
foreignTableName: "foreignTable",
joinFilter: "foreignTable.CONTINENT = Countries.CONTINENT",
joinType: "LEFTJOIN"
})
var queryParam, queryBySQLParams, queryBySQLService;
// 设置查询参数，在查询参数中添加joinItem关联条件信息
queryParam = new SuperMap.REST.FilterParameter({
name: "Countries@World",
joinItems: [joinItem]
}),
queryBySQLParams = new SuperMap.REST.QueryBySQLParameters({
queryParams: [queryParam]
}),
queryBySQLService = new SuperMap.REST.QueryBySQLService(url, {
eventListeners: { "processCompleted": processCompleted, "processFailed": processFailed}
});
queryBySQLService.processAsync(queryBySQLParams);
}
function processCompleted(queryEventArgs) {//todo}
function processFailed(e) {//todo}
| options | {Object} 参数。 |
| foreignTableName | {String} 外部表的名称。 |
| joinFilter | {String} 矢量数据集与外部表之间的连接表达式，即设定两个表之间关联的字段。 |
| joinType | {SuperMap.REST.JoinType} 两个表之间连接类型。 |
释放资源，将引用资源的属性置空。
destroy: function()