SuperMap 提供的 FreeMarker 变量

发送反馈


FreeMarker 是基于模板生成文本输出的通用工具。在 SuperMap 服务器软件中,使用 FreeMarker 模板文件“*.ftl”生成资源的 HTML 表述。其中,基于 Restlet 进行开发时,约定*.ftl 文件与资源配置项 ID 同名,且存放在 WEB-INF\lib\*.jar\templates 或 WEB-INF\classes\templates 目录下。而基于 JAX-RS 进行开发时,对 ftl 文件的文件名没有限制,路径同上,使用 ftl 文件时需通过@Template 标注进行指定。

SuperMap 提供了一些变量供用户在制作*.ftl 模板时使用,从而获取资源信息。

 SuperMap 为*.ftl 模板提供的系统变量

名称 含义
${resource.rootPath}

资源的根路径,从”http ://”算。

${resource.url}

资源的 URI,从”http ://”算起,不带后缀的全路径。

${resource.method}

当前请求的 HTTP 方法。

${resource.supportedPostfixs}

资源支持的表述格式对应的后缀。

${resource.supportedOperations}

 资源支持的 HTTP 请求方法。

${resource.customVariables}

资源中的自定义参数。

${resource.content.*.*}

资源响应结果中的各项值。如在 image 资源结果中,resource.content.imageUrl 表示图片 URI 地址,而 resource.content. mapParam. center.x 表示图片中心点的 x 坐标。