返回值调用说明 | |
---|---|
说明 | 示例 |
布局类型为'默认页'或'更多'的返回值可以直接调用 | |
布局类型为'更多'的返回值和'默认页'更多的返回值相同 | |
'布局 -- 版块'的调用方式为'引用代码'时,版块代码块必须由<@function></@function>标签包裹 | |
'布局 -- 版块'的调用方式为'调用对象'时,对象代码块必须由<@object action=""></@object>标签包裹 | |
'布局 -- 版块'的调用方式为'引用代码'时,引入本代码块的标签为<@include action=""/> |
公共对象 | ||
---|---|---|
变量 | 类型 | 说明 |
baseURL | String | 系统路径 |
commonPath | String | 资源路径 |
contextPath | String | 系统虚拟目录 |
suffix | String | 站点后缀名 |
templateDir | String | 模板目录名称 |
title | String | 站点名称 |
keywords | String | 站点关键词 |
description | String | 站点描述 |
systemUser | AccessUser | 登录用户 |
baseURI | String | 系统资源标识符 |
token | String | 令牌 |
identificationNumber | String | 识别号:用来区别每次请求 |
用户 AccessUser | |||
---|---|---|---|
变量 | 类型 | 说明 | |
id | long | Id | |
userName | String | 会员用户名 | |
nickname | String | 呢称 | |
avatarPath | String | 头像路径 | 页面上显示200*200头像示例${accessUser.avatarPath}${accessUser.avatarName} 显示100*100头像示例${accessUser.avatarPath}100x100/${accessUser.avatarName} |
avatarName | String | 头像名称 |
模板引擎内置函数 | ||
---|---|---|
参数 | 说明 | |
List集合 |
<#list sequence as item>
</#list> |
遍历集合 |
${item_index} |
当前迭代项在所有迭代项中的位置 | |
${item_has_next} |
用于判断当前迭代项是否是所有迭代项中的最后一项 | |
sequence?first | 获取集合第一个元素 | |
sequence?last | 获取集合最后一个元素 | |
sequence?size | 获取队列长度 | |
Map集合 |
<#list hash as key, value>
</#list> |
遍历集合 |
${key} |
获取集合的键 | |
${value} |
获取集合的值 |
模板引擎比较符号 | ||
---|---|---|
参数 | 说明 | |
lt | 小于( < ) | |
gt | 大于( > ) | |
lte | 小于或等于( <= ) | |
gte | 大于或等于( >= ) |
模板引擎判断空值 | ||
---|---|---|
参数 | 说明 | 示例 |
?? | 空值判断 |
当服务器返回Map变量时不能先定义变量再判断,例如 <#assign error = returnValue['error']> <#if error?? && error?size gt 0> <#list returnValue['error'] as key, value> ${value} </#list> <#else> 没有可以领取的优惠券 </#if> 以上的写法会抛出错误 |
?size | 集合大小判断 |
Ajax方式请求/返回 处理 | ||
---|---|---|
参数 | 说明 | |
请求 | 自定义请求头 协议头:X-Requested-With 值:XMLHttpRequest |
zepto.js和jquery.js等前端框架默认包含此参数
|
返回 | 400状态码 | 表示请求错误 |
403状态码 |
权限不足 | |
508状态码 |
服务器处理请求时检测到一个无限循环。当用户未登陆时在登录页面/login使用Ajax请求/user/开头的URL,会出现此错误 | |
响应头jumpPath |
值为登录页路径。未登录时访问登录页面会返回此参数值
|
移动端统计访问量 | ||
---|---|---|
请求路径 | statistic/add.htm | |
请求方式 | GET | |
请求参数 | 当前访问页面URL |
变量:url 类型:String 是否必填:是 |
上一访问页面URL |
变量:referrer 类型:String 是否必填:否 |
|
提交返回 | 空字符串 |
注意事项 | ||
---|---|---|
JavaScript提交参数除密码框值外建议都用encodeURIComponent()函数进行编码 | ||
因为JavaScript中的数字类型不能包含所有的java long值,所以JSON返回值中含有Long都转为String类型 | ||
Freemarker模板不支持直接输出布尔类型(boolean),布尔类型对象输出要使用内建函数c将布尔值转换为字符串;例如布尔类型${formCaptcha.showCaptcha}要写成${formCaptcha.showCaptcha?c}才能正确显示;比较${formCaptcha.showCaptcha?c == 'true'} | ||
因为手机版采用单页应用设计,框架不支持加上网页后缀,建议电脑版网页链接不要加上后缀(.htm),让手机版和网页版URL保持一致 |