smlFile

URI

smlInfos/smlFile[.<format>]

支持的方法

GET、POST、DELETE、HEAD

父资源

smlInfos

介绍

smlFile资源用于对态势图文件进行操作，包括获取态势图信息、上传态势图文件以及删除指定态势图文件。

支持的方法：

• GET：获取态势图文件信息。
• POST：在请求体里将态势图内容传给服务器，存成一个文件，即将态势图文件上传至服务器。
• DELETE：删除指定的态势图文件。
• HEAD：检查 smlInfos 资源是否存在，或权限是否可以访问 smlInfos 资源。

支持的表述格式：RJSON、JSON、HTML、XML。

资源层次

HTTP 请求方法

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

http://supermapiserver:8090/iserver/services/plot-TY/rest/plot/smlInfos/{smlFileName}.json

GET 请求

获取态势图文件信息。

响应结构

对smlFile资源执行 GET 请求，返回的态势图文件信息结构如下：

响应示例

对 smlFile 资源：http://supermapiserver:8090/iserver/services/plot-JY/rest/plot/smlInfos/situationMap.rjson，执行GET请求，则返回的rjson格式表述如下：

{ "smlInfo": { "SMLName": "", "SMLSeclevel": "", "SMLDesc": "", "SMLAuthor": "", "SMLTime": "", "SMLDepat": "" }, "layerDatas": [{ "features": [ ...... { "scaleByMap": false, "algoMaxEditPts": 1, "surroundLineWidth": 1, "code": "80800", "libID": "421", "anchorPoint": { "x": 0, "y": 0 }, "symbolIsCanFill": false, "middleMarkBounds": { "top": 0, "left": 0, "bottom": 0, "leftBottom": { "x": 0, "y": 0 }, "right": 0, "rightTop": { "x": 0, "y": 0 } }, "localePoints": [{ "x": "117.0297923050529", "y": "25.11111687487508", "z": 0 }], "annotationPosition": 4, "algoMinEditPts": 1, "type": "GRAPHICOBJECT", "surroundLineColor": { "red": 255, "green": 255, "blue": 0, "alpha": 255 }, "symbolRanks": [], "surroundLineType": 0, "symbolName": "目的地", "innerCells": [ { "positionPoints": [ { "x": 0, "y": 100, "z": 0 }, { "x": 80, "y": "60", "z": 0 }, { "x": 0, "y": "60", "z": 0 } ], "surroundLineWidth": 1, "fontColorLimit": false, "textContent": "", "type": 32, "surroundLineColor": { "red": 255, "green": 255, "blue": 0, "alpha": 255 }, "lineWidthLimit": false, "surroundLineFlag": false, "surroundLineLimit": false, "fillColorLimit": false, "lineColorLimit": false, "fillLimit": false, "lineTypeLimit": false, "surroundLineType": 0, "style": { "markerSize": 2.4, "fillGradientOffsetRatioX": 0, "fillForeColor": { "red": 255, "green": 0, "blue": 0, "alpha": 255 }, "fillGradientOffsetRatioY": 0, "markerWidth": 2.4, "markerAngle": 0, "lineColor": { "red": 255, "green": 0, "blue": 0, "alpha": 255 }, "fillSymbolID": 1, "markerSymbolID": 0, "lineWidth": 0.5, "markerHeight": 2.4, "fillOpaqueRate": 100, "fillBackOpaque": true, "fillBackColor": { "red": 255, "green": 0, "blue": 0, "alpha": 255 }, "fillGradientMode": 0, "lineSymbolID": 0, "fillGradientAngle": 0 }, "textStyle2D": { "shadow": false, "italicAngle": 0, "sizeFixed": false, "underline": false, "rotation": 0, "backOpaque": false, "bold": false, "align": 0, "italic": false, "foreColor": { "red": 0, "green": 0, "blue": 0, "alpha": 255 }, "strikeout": false, "fontName": "Microsoft YaHei", "outline": false, "backColor": { "red": 0, "green": 0, "blue": 0, "alpha": 255 }, "fontWidth": 0, "fontHeight": 7, "opaqueRate": 100, "stringAlignment": 0, "fontScale": 1, "fontWeight": 0 } }, { "positionPoints": [ { "x": 0, "y": 0, "z": 0 }, { "x": 0, "y": "60", "z": 0 } ], "surroundLineWidth": 1, "fontColorLimit": false, "textContent": "", "type": 24, "surroundLineColor": { "red": 255, "green": 255, "blue": 0, "alpha": 255 }, "lineWidthLimit": false, "surroundLineFlag": false, "surroundLineLimit": false, "fillColorLimit": false, "lineColorLimit": false, "fillLimit": false, "lineTypeLimit": false, "surroundLineType": 0, "style": { "markerSize": 2.4, "fillGradientOffsetRatioX": 0, "fillForeColor": { "red": 255, "green": 0, "blue": 0, "alpha": 255 }, "fillGradientOffsetRatioY": 0, "markerWidth": 2.4, "markerAngle": 0, "lineColor": { "red": 255, "green": 0, "blue": 0, "alpha": 255 }, "fillSymbolID": 1, "markerSymbolID": 0, "lineWidth": 0.5, "markerHeight": 2.4, "fillOpaqueRate": 100, "fillBackOpaque": true, "fillBackColor": { "red": 255, "green": 0, "blue": 0, "alpha": 255 }, "fillGradientMode": 0, "lineSymbolID": 0, "fillGradientAngle": 0 }, "textStyle2D": { "shadow": false, "italicAngle": 0, "sizeFixed": false, "underline": false, "rotation": 0, "backOpaque": false, "bold": false, "align": 0, "italic": false, "foreColor": { "red": 0, "green": 0, "blue": 0, "alpha": 255 }, "strikeout": false, "fontName": "Microsoft YaHei", "outline": false, "backColor": { "red": 0, "green": 0, "blue": 0, "alpha": 255 }, "fontWidth": 0, "fontHeight": 7, "opaqueRate": 100, "stringAlignment": 0, "fontScale": 1, "fontWeight": 0 } } ], "middleMarkExist": false, "scaleValues": "", "symbolSize": { "x": 80, "y": 100 }, "center": { "x": 0, "y": 0 }, "limitWidthHeight": true, "textContent": "", "symbolType": 1, "negativeImage": false, "rotate2D": { "x": 0, "y": 0, "z": 0 }, "scale2D": { "x": 1, "y": 1, "z": 0 }, "style": { "markerSize": 2.4, "fillGradientOffsetRatioX": 0, "fillForeColor": { "red": 255, "green": 0, "blue": 0, "alpha": 80 }, "fillGradientOffsetRatioY": 0, "markerWidth": 2.4, "markerAngle": 0, "lineColor": { "red": 255, "green": 0, "blue": 255, "alpha": 255 }, "fillSymbolID": 1, "markerSymbolID": 0, "lineWidth": 0.5, "markerHeight": 2.4, "fillOpaqueRate": 100, "fillBackOpaque": true, "fillBackColor": { "red": 255, "green": 0, "blue": 0, "alpha": 255 }, "fillGradientMode": 0, "lineSymbolID": 0, "fillGradientAngle": 0 }, "scalePoints": "", "textStyle2D": { "shadow": false, "italicAngle": 0, "sizeFixed": false, "underline": false, "rotation": 0, "backOpaque": false, "bold": false, "align": 0, "italic": false, "foreColor": { "red": 0, "green": 0, "blue": 0, "alpha": 255 }, "strikeout": false, "fontName": "Microsoft YaHei", "outline": false, "backColor": { "red": 0, "green": 0, "blue": 0, "alpha": 255 }, "fontWidth": 0, "fontHeight": 7, "opaqueRate": 100, "stringAlignment": 0, "fontScale": 1, "fontWeight": 0 }, "subSymbols": "", "symbolRank": 0 } ], "layerName": "PlotService" }] }

POST 请求

上传由文件名 smlFileName 指定的态势图文件，请求体为文本数据流。

请求参数

发送请求时，需同时上传态势图文件，请求体中对应的参数如下：

响应结构

返回的资源表述结构如下：

响应示例

对 smlFile 资源：http://supermapiserver:8090/iserver/services/plot-JY/rest/plot/smlInfos/situationMap.json，执行POST请求，上传指定态势图文件，发送的请求体如下：

{"smlInfo":{"SMLName":"","SMLDesc":"","SMLSeclevel":"","SMLDepat":"","SMLAuthor":"","SMLTime":""}, "layerDatas":[{"layerName":"PlotService", "features": ...... { "algoMaxEditPts": 1, "algoMinEditPts": 1, "anchorPoint": { "x": 0, "y": 0 }, "annotationPosition": 4, "center": { "x": 0, "y": 0 }, "annotationPosition": 4, "center": { "x": 0, "y": 0 }, "code": "80800", "libID": "421", "innerCells": [ { "textContent": "", "type": 32, "surroundLineColor": { "red": 255, "blue": 0, "green": 255, "alpha": 255 }, "surroundLineType": 0, "surroundLineWidth": 1, "surroundLineLimit": false, "surroundLineFlag": false, "positionPoints": [ { "x": 0, "y": 100, "z": 0 }, { "x": 80, "y": "60", "z": 0 }, { "x": 0, "y": "60", "z": 0 } ], "fillLimit": false, "fontColorLimit": false, "lineWidthLimit": false, "fillColorLimit": false, "lineColorLimit": false, "lineTypeLimit": false, "style": { "fillBackOpaque": true, "lineWidth": 0.5, "fillBackColor": { "red": 255, "blue": 0, "green": 0, "alpha": 255 }, "markerWidth": 2.4, "markerAngle": 0, "fillForeColor": { "red": 255, "blue": 0, "green": 0, "alpha": 255 }, "markerSize": 2.4, "fillGradientOffsetRatioX": 0, "fillGradientOffsetRatioY": 0, "lineColor": { "red": 255, "blue": 0, "green": 0, "alpha": 255 }, "fillOpaqueRate": 100, "markerHeight": 2.4, "fillGradientMode": 0, "fillSymbolID": 1, "fillGradientAngle": 0, "markerSymbolID": 0, "lineSymbolID": 0 }, "textStyle2D": { "fontName": "Microsoft YaHei", "fontWidth": 0, "align": 0, "backOpaque": false, "fontHeight": 7, "fontScale": 1, "italic": false, "outline": false, "opaqueRate": 100, "sizeFixed": false, "fontWeight": 0, "bold": false, "rotation": 0, "shadow": false, "italicAngle": 0, "underline": false, "stringAlignment": 0, "strikeout": false, "backColor": { "red": 0, "blue": 0, "green": 0, "alpha": 255 }, "foreColor": { "red": 0, "blue": 0, "green": 0, "alpha": 255 } } }, { "textContent": "", "type": 24, "surroundLineColor": { "red": 255, "blue": 0, "green": 255, "alpha": 255 }, "surroundLineType": 0, "surroundLineWidth": 1, "surroundLineLimit": false, "surroundLineFlag": false, "positionPoints": [ { "x": 0, "y": 0, "z": 0 }, { "x": 0, "y": "60", "z": 0 } ], "fillLimit": false, "fontColorLimit": false, "lineWidthLimit": false, "fillColorLimit": false, "lineColorLimit": false, "lineTypeLimit": false, "style": { "fillBackOpaque": true, "lineWidth": 0.5, "fillBackColor": { "red": 255, "blue": 0, "green": 0, "alpha": 255 }, "markerWidth": 2.4, "markerAngle": 0, "fillForeColor": { "red": 255, "blue": 0, "green": 0, "alpha": 255 }, "markerSize": 2.4, "fillGradientOffsetRatioX": 0, "fillGradientOffsetRatioY": 0, "lineColor": { "red": 255, "blue": 0, "green": 0, "alpha": 255 }, "fillOpaqueRate": 100, "markerHeight": 2.4, "fillGradientMode": 0, "fillSymbolID": 1, "fillGradientAngle": 0, "markerSymbolID": 0, "lineSymbolID": 0 }, "textStyle2D": { "fontName": "Microsoft YaHei", "fontWidth": 0, "align": 0, "backOpaque": false, "fontHeight": 7, "fontScale": 1, "italic": false, "outline": false, "opaqueRate": 100, "sizeFixed": false, "fontWeight": 0, "bold": false, "rotation": 0, "shadow": false, "italicAngle": 0, "underline": false, "stringAlignment": 0, "strikeout": false, "backColor": { "red": 0, "blue": 0, "green": 0, "alpha": 255 }, "foreColor": { "red": 0, "blue": 0, "green": 0, "alpha": 255 } } } ], "limitWidthHeight": true, "localePoints": [ { "x": "117.0297923050529", "y": "25.11111687487508", "z": 0 } ], "middleMarkBounds": { "rightTop": { "x": 0, "y": 0 }, "leftBottom": { "x": 0, "y": 0 }, "left": 0, "bottom": 0, "right": 0, "top": 0 }, "middleMarkExist": false, "negativeImage": false, "rotate2D": { "x": 0, "y": 0, "z": 0 }, "scale2D": { "x": 1, "y": 1, "z": 0 }, "scaleByMap": false, "scalePoints": "", "scaleValues": "", "style": { "fillBackOpaque": true, "lineWidth": 0.5, "fillBackColor": { "red": 255, "blue": 0, "green": 0, "alpha": 255 }, "markerWidth": 2.4, "markerAngle": 0, "fillForeColor": { "red": 255, "blue": 0, "green": 0, "alpha": 80 }, "markerSize": 2.4, "fillGradientOffsetRatioX": 0, "fillGradientOffsetRatioY": 0, "lineColor": { "red": 255, "blue": 255, "green": 0, "alpha": 255 }, "fillOpaqueRate": 100, "markerHeight": 2.4, "fillGradientMode": 0, "fillSymbolID": 1, "fillGradientAngle": 0, "markerSymbolID": 0, "lineSymbolID": 0 }, "subSymbols": "", "surroundLineColor": { "red": 255, "blue": 0, "green": 255, "alpha": 255 }, "surroundLineType": 0, "surroundLineWidth": 1, "symbolIsCanFill": false, "symbolName": "\u76EE\u7684\u5730", "symbolRank": 0,"symbolRanks":[], "symbolSize": { "x": 80, "y": 100 }, "symbolType": 1, "textContent": "", "textStyle2D": { "fontName": "Microsoft YaHei", "fontWidth": 0, "align": 0, "backOpaque": false, "fontHeight": 7, "fontScale": 1, "italic": false, "outline": false, "opaqueRate": 100, "sizeFixed": false, "fontWeight": 0, "bold": false, "rotation": 0, "shadow": false, "italicAngle": 0, "underline": false, "stringAlignment": 0, "strikeout": false, "backColor": { "red": 0, "blue": 0, "green": 0, "alpha": 255 }, "foreColor": { "red": 0, "blue": 0, "green": 0, "alpha": 255 } }, "type": "GRAPHICOBJECT" }, ] }]}

则返回的json格式表述如下：

{

"customResult"=true

"postResultType"=CreateChild

"succeed"=true

}

DELETE 请求

删除指定的态势图文件。

响应结构

返回的资源表述结构如下：

响应示例

对 smlFile 资源：http://supermapiserver:8090/iserver/services/plot-JY/rest/plot/smlInfos/situationMap.json，执行DELETE请求，则返回的json格式表述如下：

{"succeed"=true}

HEAD 请求

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

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

请参见

• smlInfos
• 客户端构建 REST 请求
• 状态码列表及说明
• SuperMap iServer REST API 表述格式介绍
• 资源层次结构