通过 REST 管理视图针对 ArcGIS Spatial Data Server for Java Platform 建立数据源映射
在配置数据源并部署了 Web 应用程序之后,您必须为客户端应用程序(例如 ArcGIS for Desktop)提供一种与所配置的数据源进行通信的方式。为此,请创建包含下列信息的数据源映射:
服务器名称 | 服务器的名称 |
数据库名称 | 数据库的名称 |
用户名 | 数据库用户名称 |
数据源名称 | 所配置数据源的名称 |
在通过 ArcGIS for Desktop 发布要素服务之前,您可以通过空间数据服务器 REST 管理视图创建此数据源映射。
在 REST 管理视图中除了可以创建数据源映射之外,还可以验证和删除数据源映射,以及获取数据源映射列表。
ArcGIS Spatial Data Server REST 管理端点 URL 遵循以下形式:
http://<服务器>:<端口>/<webapp-context>/admin/datasources/<管理功能>
其中:
- <服务器> 是安装了空间数据服务器的计算机。
- <端口> 是应用程序服务器或 Web 服务器通信时所使用的端口号。
- <webapp-context> 是应用程序名称上下文根目录。
- <管理功能> 是您正在执行的具体调用。
例如,要在名为 strata 的服务器上使用默认的应用程序名称上下文根目录 (arcgis) 创建数据源映射(通信端口为 50000),则 URL 应为:
http://strata:50000/arcgis/admin/datasources/createDatasourceMapping
此形式适用于本主题中介绍的所有数据源映射 REST 管理功能。响应格式可选择 HTML 或 JSON。
创建数据源映射
使用 createDatasourceMapping 创建从 ArcGIS for Desktop 中使用的数据库连接到所配置数据源名称的映射。
请转到 http://<服务器>:<端口>/<webapp-context>/admin/datasources/createDatasourceMapping。将 <服务器>、<端口> 和 <webapp-context> 替换为您网站的相应信息。
在此位置,您要提供下列信息:
参数 | 描述 | 是否必需? |
---|---|---|
服务器名称 | 一个字符串,用于表示安装了数据库管理系统的服务器的名称 该服务器必须与指定给所配置数据源的服务器相同。 | 是 |
数据库名称 | 用于表示数据库的字符串 对于 Oracle,请指定 Oracle 实例的名称。对于 DB2,请指定数据库名称或别名。对于 PostgreSQL,请指定数据库名称。 该数据库必须与指定给所配置数据源的数据库相同。 | 是 |
用户名 | 一个字符串,用于表示连接到此数据源所引用的数据库帐户时需提供的用户名 该用户必须与指定给所配置数据源的用户相同。 | 是 |
数据源名称 | 用于引用预配置数据源的字符串 | 是 |
您可以选择响应返回时采用的格式,即 HTML 或 JSON。
JSON 响应格式
Success: {"success" : true} Failure: { "success": false, "error": {"description": "error description" }
删除数据源映射
使用 deleteDatasourceMapping 删除现有数据源映射。
请转到 http://<服务器>:<端口>/<webapp-context>/admin/datasources/deleteDatasourceMapping。将 <服务器>、<端口> 和 <webapp-context> 替换为您网站的相应信息。
在此位置,您要提供下列信息:
参数 | 描述 | 是否必需? |
---|---|---|
服务器名称 | 一个字符串,用于表示安装了数据库管理系统的服务器的名称 | 是 |
数据库名称 | 用于表示数据库的字符串 对于 Oracle,这是 Oracle 实例名称。对于 DB2,这是数据库名称或别名。对于 PostgreSQL,这是数据库名称。 | 是 |
用户名 | 一个字符串,用于表示连接到此数据源所引用的数据库帐户时需提供的用户名 | 是 |
您可以选择响应返回时采用的格式,即 HTML 或 JSON。
JSON 响应格式
Success: {"success" : true} Failure: { "success": false, "error": {"description": "error description" }
验证数据源映射
使用 validateDatasourceMapping 来确保使用 createDatasourceMapping 调用成功地创建了一个具有指定连接属性的数据源。
请转到 http://<服务器>:<端口>/<webapp-context>/admin/datasources/validateDatasourceMapping。将 <服务器>、<端口> 和 <webapp-context> 替换为您网站的相应信息。
参数 | 描述 | 是否必需? |
---|---|---|
服务器名称 | 一个字符串,用于表示安装了数据库管理系统的服务器的名称 | 是 |
数据库名称 | 用于表示数据库的字符串 对于 Oracle,这是 Oracle 实例名称。对于 DB2,这是数据库名称或别名。对于 PostgreSQL,这是数据库名称。 | 是 |
用户名 | 一个字符串,用于表示连接到此数据源所引用的数据库帐户时需提供的用户名 | 是 |
您可以选择响应返回时采用的格式,即 HTML 或 JSON。
JSON 响应格式
{"datasourceName" : "<datasourceName>"}
列出数据源映射
使用 listDatasourceMappings 返回指定服务器和端口中适用于某个应用程序名称上下文根目录的所有数据源映射的列表。
请转到 http://<服务器>:<端口>/<webapp-context>/admin/datasources/listDatasourceMappings。将 <服务器>、<端口> 和 <webapp-context> 替换为您网站的相应信息。
默认响应格式为 HTML 形式的表格,其中列出了连接属性和数据源名称。您可以选择 JSON 代替默认的 HTML 响应。
JSON 响应格式
{ "serverName1:databaseName1:userName1": "<datasourceName1>", "serverName2:databaseName2:userName2": "<datasourceName2>", . . . }