<portalStatistics_uri>/resource/list[.<format>]
resourceList 资源是 iPortal 所有资源的概览列表信息。通过发送 GET 请求,可以获取 iPortal 所有资源的概览列表信息。
支持的方法:
支持的表述格式:RJSON、JSON、HTML、XML。
对如下 URI 执行 HTTP 请求,以 rjson 输出格式为例加以说明,其中,supermapiportal 是服务器名。
http://supermapiportal:8190/iportal/manager/portalstatistics/resource/list.rjson
获取 iPortal 所有资源的概览列表信息。
参数未设置,默认返回 iPortal 的所有资源中的前10个资源的概览列表信息,参数设置后,可根据设置的参数返回指定的资源概览列表信息, 请求参数必须包含在 URI 中。
名称 | 类型 | 含义 |
createStart | Long | 按资源创建的起始时间查询。如果不为正数则从最早保存的历史记录开始查询。值为自 1970 年 1 月 1 日 00:00:00 GMT 以来此日期表示的毫秒数。 |
createEnd | Long | 按资源创建的截止时间查询。如果不为正数或不传此参数,则以服务器当前时间作为终止时间。值为自 1970 年 1 月 1 日 00:00:00 GMT 以来此日期表示的毫秒数。 |
orderBy | ResOverviewInfoOrderBy | 按排序字段查询。 |
userNames | String[] | 根据资源贡献者名称查询。 |
orderType | OrderType | 按排序时升序/降序查询。 |
currentPage | int | 分页页码。 |
pageSize | int | 分页中每页大小。 |
对 resourceList 资源执行 GET 请求,返回资源概览列表信息。由以下字段组成:
字段 | 类型 | 说明 |
content | List<ResOverviewEntity> | 页面内容。 |
currentPage | int | 当前第几页。 |
pageSize | int | 每页大小。 |
searchParameter | SearchParameter | 当前页搜索参数。 |
total | int | 总记录数。 |
totalPage | int | 总页数。 |
对 resourceList 资源:http://localhost:8190/iportal/manager/portalstatistics/resource/list.rjson 执行 GET 请求,返回 rjson 格式的资源表述如下:
{
"content": [
{
"createTime": 1489980029153,
"resourceId": 4,
"resourceName": "GB4X0000_52000",
"resourceType": "MAP",
"userName": "admin",
"visitCount": 31
},
{
"createTime": 1489980049267,
"resourceId": 5,
"resourceName": "ChongQing1",
"resourceType": "MAP",
"userName": "admin",
"visitCount": 26
},
{
"createTime": 1489980049283,
"resourceId": 6,
"resourceName": "ChongQing2",
"resourceType": "MAP",
"userName": "admin",
"visitCount": 7
},
{
"createTime": 1489980063496,
"resourceId": 7,
"resourceName": "DEM_25W",
"resourceType": "MAP",
"userName": "admin",
"visitCount": 7
},
{
"createTime": 1489980077554,
"resourceId": 8,
"resourceName": "DOM_BeiJingjin_5W",
"resourceType": "MAP",
"userName": "admin",
"visitCount": 16
},
{
"createTime": 1489980089090,
"resourceId": 9,
"resourceName": "DRG",
"resourceType": "MAP",
"userName": "admin",
"visitCount": 5
},
{
"createTime": 1489980100425,
"resourceId": 10,
"resourceName": "LandUseMap1",
"resourceType": "MAP",
"userName": "admin",
"visitCount": 17
},
{
"createTime": 1489980100440,
"resourceId": 11,
"resourceName": "LandUseMap2",
"resourceType": "MAP",
"userName": "admin",
"visitCount": 16
},
{
"createTime": 1489980112731,
"resourceId": 12,
"resourceName": "全国PM2.5分布图1",
"resourceType": "MAP",
"userName": "admin",
"visitCount": 28
},
{
"createTime": 1489980112785,
"resourceId": 13,
"resourceName": "全国PM2.5分布图2",
"resourceType": "MAP",
"userName": "admin",
"visitCount": 8
}
],
"currentPage": 1,
"pageSize": 10,
"searchParameter": {
"createEnd": 1498015650983,
"createStart": 1489741200000,
"currentPage": 1,
"keywords": null,
"orderBy": null,
"orderType": "ASC",
"pageSize": 10,
"userNames": null
},
"total": 201,
"totalPage": 21
}
如果希望获取指定的资源概览列表信息,如获取某个用户贡献的资源概览列表信息,则需设置 userNames=['admin']。即对 resourceList 资源:http://localhost:8190/iportal/manager/portalstatistics/resource/list.rjson?userNames=['admin'] 执行 GET 请求,则返回的 rjson 资源表述如下:
{
"content": [
{
"createTime": 1489980029153,
"resourceId": 4,
"resourceName": "GB4X0000_52000",
"resourceType": "MAP",
"userName": "admin",
"visitCount": 31
},
{
"createTime": 1489980049267,
"resourceId": 5,
"resourceName": "ChongQing1",
"resourceType": "MAP",
"userName": "admin",
"visitCount": 26
},
{
"createTime": 1489980049283,
"resourceId": 6,
"resourceName": "ChongQing2",
"resourceType": "MAP",
"userName": "admin",
"visitCount": 7
},
{
"createTime": 1489980063496,
"resourceId": 7,
"resourceName": "DEM_25W",
"resourceType": "MAP",
"userName": "admin",
"visitCount": 7
},
{
"createTime": 1489980077554,
"resourceId": 8,
"resourceName": "DOM_BeiJingjin_5W",
"resourceType": "MAP",
"userName": "admin",
"visitCount": 16
},
{
"createTime": 1489980089090,
"resourceId": 9,
"resourceName": "DRG",
"resourceType": "MAP",
"userName": "admin",
"visitCount": 5
},
{
"createTime": 1489980100425,
"resourceId": 10,
"resourceName": "LandUseMap1",
"resourceType": "MAP",
"userName": "admin",
"visitCount": 17
},
{
"createTime": 1489980100440,
"resourceId": 11,
"resourceName": "LandUseMap2",
"resourceType": "MAP",
"userName": "admin",
"visitCount": 16
},
{
"createTime": 1489980112731,
"resourceId": 12,
"resourceName": "全国PM2.5分布图1",
"resourceType": "MAP",
"userName": "admin",
"visitCount": 28
},
{
"createTime": 1489980112785,
"resourceId": 13,
"resourceName": "全国PM2.5分布图2",
"resourceType": "MAP",
"userName": "admin",
"visitCount": 8
}
],
"currentPage": 1,
"pageSize": 10,
"searchParameter": {
"createEnd": 1498028623241,
"createStart": 1489741200000,
"currentPage": 1,
"keywords": null,
"orderBy": null,
"orderType": "ASC",
"pageSize": 10,
"userNames": [
"admin"
]
},
"total": 192,
"totalPage": 20
}
返回跟 GET 请求一样的 HTTP 响应头,但是没有响应实体。可以在不必传输整个响应内容的情况下,获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型,字符编码,压缩编码,实体内容长度等。
HEAD 请求可以用来判断 resourceList 资源是否存在,或者客户端是否有权限访问 resourceList 资源。通过对加.<format>的 URI 执行 HEAD 请求,还可以快速判断 resourceList 资源是否支持<format>格式的表述。