tileStorages

URI

<managerRoot uri>/storages[.<format>]

支持的方法

GET、POST、HEAD

父资源

managerRoot

子资源

tileStorage

介绍

切片存储资源列表。通过发送 POST 请求，可以创建一个新的切片存储资源。

支持的方法：

支持的表述格式：（rjson、json、html、xml）。

资源层次

HTTP 请求方法

对如下 URI 执行 HTTP 请求，以 rjson 输出格式为例加以说明，其中，supermapiserver 是服务器名。

http://supermapiserver:8090/iserver/manager/storages.rjson

GET 请求

获取当前所有的切片存储配置信息列表。

响应结构

对 tileStorages 资源执行 GET 请求，返回的是一个切片存储配置信息列表，其中单个切片存储配置信息的表述的结构如下：  

字段 类型 说明
id String 切片存储 id。
tileSourceInfo tileSourceInfo 切片存储配置信息。

响应示例

对 tileStorages 资源：http://localhost:8090/iserver/manager/storages.rjson 执行 GET 请求，返回的 rjson 格式的表述如下：

[

    {

        "id": "aa",

        "tileSourceInfo": {

            "fdfsTrackers": ["192.168.122.44:22122"],

            "fdhtGroups": [["192.168.122.44:11411"]],

            "type": "FastDFS"

        }

    },

    {

        "id": "bb",

        "tileSourceInfo": {

            "fdfsTrackers": ["192.168.122.44:22122"],

            "fdhtGroups": [["192.168.122.44:11411"]],

            "type": "FastDFS"

        }

    }

]

POST 请求

创建一个新的切片存储资源。

请求参数

对 tileStorages 资源执行 POST 请求，添加一个新的切片存储资源，需要在请求体中包含以下参数：

名称 类型 含义
id String 切片存储 id。
tileSourceInfo tileSourceInfo 切片存储配置信息。

响应结构

对 tileStorages 资源执行 POST 请求，返回的操作结果表述的结构如下（表述在响应消息的实体主体里）：   

字段 类型 说明
newResourceID String 添加新存储资源的 ID。
newResourceLocation String 添加切片存储成功后，新存储资源在服务器上的地址。
postResultType enum POST 请求的结果类型。"CreateChild"类型指的是创建子资源。
succeed boolean 添加切片存储操作是否成功。true 表示添加切片存储操作成功。

示例

对 tileStorages 资源：http://localhost:8090/iserver/manager/storages.rjson 执行请求体如下的 POST 请求，添加新的切片存储资源：

{

    "id": "aa",

    "tileSourceInfo": {

        "fdfsTrackers": ["192.168.122.44:22122"],

        "fdhtGroups": [

            ["192.168.122.44:11411"]

        ],

        "type": "FastDFS"

    }

}

则返回 rjson 格式的响应结果如下：

{

    "newResourceID": "aa",

    "newResourceLocation": "http://localhost:8090/iserver/manager/storages/aa.rjson",

    "postResultType": "CreateChild",

    "succeed": true

}

HEAD 请求

返回跟 GET 请求一样的 HTTP 响应头，但是没有响应实体。可以在不必传输整个响应内容的情况下，获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型，字符编码，压缩编码，实体内容长度等。

HEAD 请求可以用来判断 tileStorages 资源是否存在，或者客户端是否有权限访问 tileStorages 资源。通过对加.<format>的 URI 执行 HEAD 请求，还可以快速判断 tileStorages 资源是否支持<format>格式的表述。

请参见