返回值调用说明
说明 示例
布局类型为'默认页'或'更多'的返回值可以直接调用
布局类型为'更多'的返回值和'默认页'更多的返回值相同
'布局 -- 版块'的调用方式为'引用代码'时,版块代码块必须由<@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保持一致