JEECMS + FreeMarker学习

来源：互联网发布：张根学厉害吗知乎编辑：程序博客网时间：2024/05/18 01:52

JEECMS系统白皮书

http://wenku.baidu.com/view/5161ed4ff7ec4afe04a1dfac.html

JEECMS使用目前java主流技术架构： spring3+springMVC3+ hibernate3+freemarker+AJAX+jQuery。使用Freemarker是因为其有强大的模板机制，前台页面可以通过模板生成，通过在线调整模板可以改变页面的显示，模板的技术有HMTL语法+JEECMS标签组成。

标签有两种（1）一种风格的标签封装了大量互联网上常见的显示样式，通过调整参数就可实现文章列表、图文混排、图文滚动、跑马灯、焦点图等效果。这种标签的优势在于页面制作简单、效率高，对js、css、html不够精通和希望快速建站的用户非常适用（2）另一种风格的标签只负责读取数据，由用户自己控制显示内容和显示方式，想到什么就能做到什么，对于技术能力高和追求个性化的用户，可谓如鱼得水。

伪静态页面技术

模板以文件形式存储，自由导出导入

首页，栏目页的缓存处理提高系统反应速度，降低系统资源损耗

很诡异的是，之前的技术说明方面没有提到Structs，这里竟然提到了展现层用了struts

web页面制作遵循w3c标准制作，使用div+css布局，所有标签生成的html代码都经过跨浏览器测试。

现在来看看栏目页模板，栏目页是一个栏目的封面，其中最基本的一个需求就是，能够显示这个栏目的新闻列表；否则浏览者无法看到这个栏目的实际内容。

JEECMS的标签教程非常混乱，从2011年第一版到2012最新版的教程都放在一起，并且只看2012最新版的教程完全不行，必须从头开始看，我想一方面可以透出该公司非常的不负责，一方面该公司为了迫使广大使用者向其购买服务，故意讲的云里雾里，造成难度。

宣传的很好，可惜问题太多！下面我将整理出个头绪

http://www.jeecms.com/bqsy/index_3.jhtml

首先JEECMS至少有三个大版本V1.X, V3.X和V2012，这三个版本，对于不分版本的技术来说，标签的技术都是使用freeMaker+Ajax来实现的，故我的真正想要学习的是每个具体标签的作用和每个标签参数的具体含义，而模板，栏目，的含义究竟怎样体现到具体的实现？我还没有想法。

想学习JEECMS的标签，必须首先学学HTML和FreeMaker技术，关于HTML就不用说了，CSS和简单的HTML标签是必须掌握的。

FreeMarker技术

FreeMarker是一个模板引擎，一个基于模板生成文本输出的通用工具，使用纯Java编写
FreeMarker被设计用来生成HTML Web页面，特别是基于MVC模式的应用程序
虽然FreeMarker具有一些编程的能力，但通常由Java程序准备要显示的数据，由FreeMarker生成页面，通过模板显示准备的数据
FreeMarker不是一个Web应用框架，而适合作为Web应用框架一个组件，更适合作为Model2框架（如Struts）的视图组件，可以在模板中使用JSP标记库
FreeMarker与容器无关，因为它并不知道HTTP或Servlet；FreeMarker同样可以应用于非Web应用程序环境
FreeMarker是免费的

http://www.blogjava.net/freeman1984/archive/2010/11/04/337239.html 一篇比较好的FreeMaker教程

http://www.oschina.net/p/freemarker/ 关于FreeMaker的开源项目介绍

对于理解JEECMS标签，要知道的FreeMaker技术有：

1、快速入门
（1）模板 + 数据模型 = 输出
         FreeMarker基于设计者和程序员是具有不同专业技能的不同个体的观念，他们是分工劳动的：设计者专注于表示——创建HTML文件、图片、Web页面的其它可视化方面；程序员创建系统，生成设计页面要显示的数据
         经常会遇到的问题是：在Web页面（或其它类型的文档）中显示的信息在设计页面时是无效的，是基于动态数据的
         在这里，你可以在HTML（或其它要输出的文本）中加入一些特定指令，FreeMarker会在输出页面给最终用户时，用适当的数据替代这些代码

<html><head>  <title>Welcome!</title></head><body>  <h1>Welcome ${user}!</h1>  <p>Our latest product:  <a href="${latestProduct.url}">${latestProduct.name}</a>!</body></html>

这个例子是在简单的HTML中加入了一些由${…}包围的特定代码，这些特定代码是FreeMarker的指令，而包含FreeMarker的指令的文件就称为模板（Template），这也是为什么JEECMS中大量使用模板的概念！
         至于user、latestProduct.url和latestProduct.name来自于数据模型（data model）
         数据模型由程序员编程来创建，向模板提供变化的信息，这些信息来自于数据库、文件，甚至于在程序中直接生成
         模板设计者不关心数据从那儿来，只知道使用已经建立的数据模型
下面是一个可能的数据模型：
(root)
|
+- user = "Big Joe"
|
+- latestProduct
      |
      +- url = "products/greenmouse.html"
      |
      +- name = "green mouse"
         数据模型类似于计算机的文件系统，latestProduct可以看作是目录，而user、url和name看作是文件，url和name文件位于latestProduct目录中（这只是一个比喻，实际并不存在）
         当FreeMarker将上面的数据模型合并到模板中，就创建了下面的输出：

<html><head>  <title>Welcome!</title></head><body>  <h1>Welcome Big Joe!</h1>  <p>Our latest product:  <a href="products/greenmouse.html">green mouse</a>!</body></html>

（2）数据模型：典型的数据模型是树型结构，可以任意复杂和深层次，如上面的数据模型

   类似于目录的变量称为hashes，包含保存下级变量的唯一的查询名字
   类似于文件的变量称为scalars，保存单值， scalars保存的值有两种类型：字符串（用引号括起，可以是单引号或双引号）和数字（不要用引号将数字括起，这会作为字符串处理）对scalars的访问从root开始，各部分用“.”分隔，如animals.mouse.price
   另外一种变量是sequences，和hashes类似，只是不使用变量名字，而使用数字索引，如下：

(root)
|

+- (1st)

  |    |
  |   +- user = "Big Joe"
  +- (2nd)

这种对scalars的访问使用索引，如[0].user

（3）模板

         在FreeMarker模板中可以包括下面三种特定部分：
Ø         ${…}：称为interpolations，由${和}或#{和}来限定，FreeMarker会在输出时用实际值进行替代
Ø         FTL标记（FreeMarker模板语言标记）或指令：类似于HTML标记，为了与HTML标记区分，用#开始（有些以@开始）
Ø         注释：包含在<#--和-->（而不是）之间
   下面是一些使用指令的例子：
Ø         if指令

<#if animals.python.price < animals.elephant.price>  Pythons are cheaper than elephants today.<#else>  Pythons are not cheaper than elephants today.</#if>

Ø list指令

<p>We have these animals:<table border=1>  <tr><th>Name<th>Price  <#list animals as being>  <tr><td>${being.name}<td>${being.price} Euros  </#list></table>

输出为：

<p>We have these animals:<table border=1>  <tr><th>Name<th>Price  <tr><td>mouse<td>50 Euros  <tr><td>elephant<td>5000 Euros  <tr><td>python<td>4999 Euros</table>

Ø include指令

<html><head>  <title>Test page</title></head><body>  <h1>Test page</h1>  <p>Blah blah...<#include "/copyright_footer.html"></body></html>

Ø 一起使用指令

<p>We have these animals:<table border=1>  <tr><th>Name<th>Price  <#list animals as being>  <tr>    <td>      <#if being.size = "large"><b></#if>      ${being.name}      <#if being.size = "large"></b></#if>    <td>${being.price} Euros  </#list></table>

注意事项：

Ø         FTL区分大小写，所以list是正确的FTL指令，而List不是；${name}和${NAME}是不同的
Ø         Interpolation只能在文本中使用
Ø         FTL标记不能位于另一个FTL标记内部，例如：<#if <#include 'foo'>='bar'>...</if>
Ø         注释可以位于FTL标记和Interpolation内部，如下面的例子：

<h1>Welcome ${user <#-- The name of user -->}!</h1>[BR]<p>We have these animals:[BR]<ul>[BR]<#list <#-- some comment... --> animals as <#-- again... --> being>[BR]

Ø 多余的空白字符会在模板输出时移除

Ø 如果使用不存在的指令，FreeMarker不会使用模板输出，而是产生一个错误消息

Ø 有两种类型的指令：预定义指令和用户定义指令，后者要使用@替换#：<@mydirective>...</@mydirective>

Ø FreeMarker会忽略FTL标记中的空白字符，并且<、</和指令之间不允许有空白字符

（4）表达式

字符串

使用单引号或双引号限定，如果包含特殊字符需要转义，如下面的例子：

${"It's \"quoted\" and this is a backslash: \\"}
${'It\'s "quoted" and this is a backslash: \\'}
输出结果是：
It's "quoted" and this is a backslash: \
It's "quoted" and this is a backslash: \
下面是支持的转义序列：
转义序列   含义
\"   双引号(u0022)
\'   单引号(u0027)
\\   反斜杠(u005C)
\n   换行(u000A)
\r   Return (u000D)
\t   Tab (u0009)
\b   Backspace (u0008)
\f   Form feed (u000C)
\l   <
\g >
\a   &
\{   {
\xCode 4位16进制Unicode代码

有一类特殊的字符串称为raw字符串，被认为是纯文本，其中的\和{等不具有特殊含义，该类字符串在引号前面加r，下面是一个例子：${r"${foo}"} ${r"C:\foo\bar"} 输出的结果分别是： ${foo} C:\foo\bar

数字

直接输入，不需要引号
精度数字使用“.”分隔，不能使用分组符号
目前版本不支持科学计数法，所以“1E3”是错误的
不能省略小数点前面的0，所以“.5”是错误的
数字8、+8、08和8.00都是相同的

布尔值

true和false，不使用引号

序列：由逗号分隔的子变量列表，由方括号限定，下面是一个例子：

<#list ["winter", "spring", "summer", "autumn"] as x>
${x}
</#list>
输出的结果是：
winter
spring
summer
autumn

列表的项目是表达式，所以可以有下面的例子：

  [2 + 2, [1, 2, 3, 4], "whatnot"]
  可以使用数字范围定义数字序列，例如2..5等同于[2, 3, 4, 5]，但是更有效率，注意数字范围没有方括号
  可以定义反递增的数字范围，如5..2

散列（hash）由逗号分隔的键/值列表，由大括号限定，键和值之间用冒号分隔，下面是一个例子：

{"name":"green mouse", "price":150}
键和值都是表达式，但是键必须是字符串

获取变量

顶层变量： ${variable}，变量名只能是字母、数字、下划线、$、@和#的组合，且不能以数字开头
从散列中获取数据：可以使用点语法或方括号语法，假设有下面的数据模型：

(root)
|
+- book
|   |
|   +- title = "Breeding green mouses"
|   |
|   +- author
|       |
|       +- name = "Julia Smith"
|       |
|       +- info = "Biologist, 1923-1985, Canada"
|
+- test = "title"

下面都是等价的：
book.author.name
book["author"].name
book.author.["name"]
book["author"]["name"]

   使用点语法，变量名字有顶层变量一样的限制，但方括号语法没有该限制，因为名字是任意表达式的结果

   从序列获得数据：和散列的方括号语法语法一样，只是方括号中的表达式值必须是数字；注意：第一个项目的索引是0
     序列片断：使用[startIndex..endIndex]语法，从序列中获得序列片断（也是序列）；startIndex和endIndex是结果为数字的表达式
   特殊变量：FreeMarker内定义变量，使用.variablename语法访问

字符串操作

Interpolation（或连接操作）
可以使用${..}（或#{..}）在文本部分插入表达式的值，例如：

${"Hello ${user}!"}
${"${user}${user}${user}${user}"}

可以使用+操作符获得同样的结果

${"Hello " + user + "!"}
${user + user + user + user}

${..}只能用于文本部分，下面的代码是错误的：

<#if ${isBig}>Wow!</#if>
<#if "${isBig}">Wow!</#if>

应该写成：<#if isBig>Wow!</#if>

子串

例子（假设user的值为“Big Joe”）：
${user[0]}${user[4]}
${user[1..4]}
结果是（注意第一个字符的索引是0）：
BJ
ig J

序列连接操作：和字符串一样，使用+，下面是一个例子：

<#list ["Joe", "Fred"] + ["Julia", "Kate"] as user>
- ${user}
</#list>
输出结果是：
- Joe
- Fred
- Julia
- Kate

散列连接操作：和字符串一样，使用+，如果具有相同的key，右边的值替代左边的值，例如：

<#assign ages = {"Joe":23, "Fred":25} + {"Joe":30, "Julia":18}>
- Joe is ${ages.Joe}
- Fred is ${ages.Fred}
- Julia is ${ages.Julia}
输出结果是：
- Joe is 30
- Fred is 25
- Julia is 18

算术运算＋、－、×、／、％，下面是一个例子：

${x * x - 100}
${x / 2}
${12 % 10}
输出结果是（假设x为5）：
-75
2.5
2
操作符两边必须是数字，因此下面的代码是错误的：
${3 * "5"} <#-- WRONG! -->
使用+操作符时，如果一边是数字，一边是字符串，就会自动将数字转换为字符串，例如：
${3 + "5"}
输出结果是：
35
使用内建的int（后面讲述）获得整数部分，例如：
${(x/2)?int}
${1.1?int}
${1.999?int}
${-1.1?int}
${-1.999?int}
输出结果是（假设x为5）：
2
1
1
-1
-1

比较操作符

使用=（或==，完全相等）测试两个值是否相等，使用!= 测试两个值是否不相等
=和!=两边必须是相同类型的值，否则会产生错误，例如<#if 1 = "1">会引起错误
Freemarker是精确比较，所以对"x"、"x "和"X"是不相等的
对数字和日期可以使用<、<=、>和>=，但不能用于字符串
由于Freemarker会将>解释成FTL标记的结束字符，所以对于>和>=可以使用括号来避免这种情况，例如<#if (x > y)>
另一种替代的方法是，使用lt、lte、gt和gte来替代<、<=、>和>=

逻辑操作符 &&（and）、||（or）、!（not），只能用于布尔值，否则会产生错误，例子：

<#if x < 12 && color = "green">
   We have less than 12 things, and they are green.
</#if>
<#if !hot> <#-- here hot must be a boolean -->
   It's not hot.
</#if>

内建函数内建函数的用法类似访问散列的子变量，只是使用“?”替代“.”，下面列出常用的一些函数

字符串使用的：

html：对字符串进行HTML编码
cap_first：使字符串第一个字母大写
lower_case：将字符串转换成小写
upper_case：将字符串转换成大写
trim：去掉字符串前后的空白字符

序列使用的：

size：获得序列中元素的数目

数字使用的：

int：取得数字的整数部分（如-1.9?int的结果是-1）
例子（假设test保存字符串"Tom & Jerry"）：
${test?html}
${test?upper_case?html}
输出结果是：
Tom & Jerry
TOM & JERRY

操作符优先顺序
操作符组
后缀 [subvarName] [subStringRange] . (methodParams)
一元：+expr、-expr、!
内建： ?
乘法：*、 / 、%
加法：+、-
关系：<、>、<=、>=（lt、lte、gt、gte）
相等：==（=）、!=
逻辑：and &&
逻辑：or ||
数字范围： ..

其他较复杂的语法可以继续参考 http://www.blogjava.net/freeman1984/archive/2010/11/04/337239.html