freeMarker语法

2. EG.一个对象BOOK   
3.  
4.  
5. 1.输出 ${book.name}  
6.  
7. 空值判断：${book.name?if_exists },  
8.  
9. ${book.name?default(‘xxx’)}//默认值xxx  
10. ${ book.name!"xxx"}//默认值xxx  
11.  
12. 日期格式：${book.date?string('yyyy-MM-dd')}  
13.  
14. 数字格式：${book?string.number}--20  
15. ${book?string.currency}--<#-- $20.00 -->  
16. ${book?string.percent}—<#-- 20% -->  
17.  
18. 插入布尔值：  
19. <#assign foo=ture />  
20. ${foo?string("yes","no")} <#-- yes -->  
21.  
22.  
23. 2．逻辑判断  
24. a:  
25. <#if condition>...  
26. <#elseif condition2>...  
27. <#elseif condition3>......  
28. <#else>...  
29. 其中空值判断可以写成<#if book.name?? >  
30.  
31. </#if>  
32.  
33.  
34. b:  
35. <#switch value>  
36. <#case refValue1>  
37.     ...  
38.     <#break>  
39. <#case refValue2>  
40.     ...  
41.     <#break>  
42. ...  
43. <#case refValueN>  
44.     ...  
45.     <#break>  
46. <#default>  
47.     ...  
48. </#switch>  
49.  
50. 3．循环读取  
51. <#list sequence as item>  
52. ...  
53. </#list>  
54. 空值判断<#if bookList?size = 0></#list>  
55.  
56.  
57. e.g.  
58. <#list employees as e>  
59. ${e_index}. ${e.name}  
60. </#list>  
61. 输出:  
62. 1. Readonly  
63. 2. Robbin  
64.  
65.  
66. 4.FreeMarker  
67.  
68.  
69. 3 宏/模板  
70.  
71. 宏Macro  
72.  
73. 宏是在模板中使用macro指令定义  
74. l.1 基本用法  
75. 宏是和某个变量关联的模板片断，以便在模板中通过用户定义指令使用该变量，下面是一个例子：  
76.  
77. <#macro greet>  
78. <font size="+2">Hello Joe!</font>  
79. </#macro>  
80.  
81. 调用宏时，与使用FreeMarker的其他指令类似，  
82. 只是使用@替代FTL标记中的#。  
83.  
84. <@greet></@greet >  
85.  
86. <#--<@greet/>-->  
87.  
88.  
89. 在macro指令中可以在宏变量之后定义参数，如：  
90.  
91. <#macro greet person>  
92. <font size="+2">Hello ${person}!</font>  
93. </#macro>  
94. 可以这样使用这个宏变量：  
95.    <@greet person="Fred"/>  
96. 但是下面的代码具有不同的意思：  
97.    <@greet person=Fred/>  
98. 这意味着将Fred变量的值传给person参数，该值不仅是字符串，还可以是其它类型，甚至是复杂的表达式。  
99.  
100.  
101. 宏可以有多参数，下面是一个例子：  
102. <#macro greet person color>  
103. <font size="+2" color="${color}">Hello ${person}!</font>  
104. </#macro>  
105.  
106. 可以这样使用该宏变量，其中参数的次序是无关的：  
107. <@greet person="Fred" color="black"/>  
108.  
109. 可以在定义参数时指定缺省值，否则，在调用宏的时候，必须对所有参数赋值：  
110. <#macro greet person color="black">  
111. <font size="+2" color="${color}">Hello ${person}!</font>  
112. </#macro>  
113.  
114. 注意：宏的参数是局部变量，只能在宏定义中有效。  
115.  
116.    
117.  
118.  
119. 在宏里嵌套内容  
120. FreeMarker的宏可以有嵌套内容，  
121. <#nested>指令会执行宏调用指令开始和结束标记之间的模板片断，举一个简单的例子：  
122.  
123. <#macro border>  
124. <table border=4 cellspacing=0 cellpadding=4><tr><td>  
125.     <#nested>  
126. </tr></td></table>  
127. </#macro>  
128.  
129. 执行宏调用：  
130. <@border>The bordered text</@border >  
131. 输出结果：  
132. <table border=4 cellspacing=0 cellpadding=4>  
133. <tr><td>  
134.        The bordered text  
135. </tr></td>  
136. </table>  
137.  
138. <#nested>指令可以被多次调用，每次都会执行相同的内容。  
139. <#macro do_thrice>  
140. <#nested>  
141. <#nested>  
142. <#nested>  
143. </#macro>  
144.  
145.  
146. <@do_thrice>  
147. Anything.  
148. </@do_thrice >  
149.  
150. FMPP 输出结果：  
151. Anything.  
152. Anything.  
153. Anything.  
154.  
155. 嵌套内容可以是有效的FTL，下面是一个有些复杂的例子，我们将上面三个宏组合起来：  
156. <@border>  
157. <ul>  
158. <@do_thrice>  
159.     <li><@greet person="Joe"/>  
160. </@do_thrice >  
161. </ul>  
162. </@border >  
163. 输出结果：  
164. <table border=4 cellspacing=0 cellpadding=4><tr><td>  
165. <ul>  
166.     <li><font size="+2">Hello Joe!</font>  
167.     <li><font size="+2">Hello Joe!</font>  
168.     <li><font size="+2">Hello Joe!</font>  
169. </ul>  
170. </tr></td></table>  
171.  
172. 宏定义中的局部变量对嵌套内容是不可见的，例如：  
173. <#macro repeat count>  
174. <#local y = "test">  
175. <#list 1..count as x>  
176.     ${y} ${count}/${x}: <#nested>  
177. </#list>  
178. </#macro>  
179.  
180. <@repeat count=3>${y?default("?")} ${x?default("?")} ${count?default("?")}</@repeat >  
181.  
182. 输出结果：  
183. test 3/1: ? ? ?  
184. test 3/2: ? ? ?  
185. test 3/3: ? ? ?  
186.  
187.  
188. 在宏定义中使用循环变量  
189. nestted指令也可以有循环变量（循环变量的含义见下节），调用宏的时候在宏指令的参数后面依次列出循环变量的名字，格式如下：  
190.  
191. <@ macro_name paramter list; loop variable list[,]>  
192.  
193. 例如：  
194. <#macro repeat count>  
195. <#list 1..count as x>  
196.     <#nested x, x/2, x==count>  
197. </#list>  
198. </#macro>  
199.  
200. <@repeat count=4 ; c, halfc, last>  
201. ${c}. ${halfc}<#if last> Last!</#if>  
202. </@repeat >  
203.  
204. 这里count是宏的参数，c, halfc,last则为循环变量，输出结果：  
205. 1. 0.5  
206. 2. 1  
207. 3. 1.5  
208. 4. 2 Last!  
209. 循环变量和宏标记指定的不同不会有问题，如果调用时少指定了循环变量，那么多余的值不可见。调用时多指定了循环变量，多余的循环变量  
210.  
211. 不会被创建：  
212. <@repeat count=4 ; c, halfc, last>  
213. ${c}. ${halfc}<#if last> Last!</#if>  
214. </@repeat >  
215.  
216. <@repeat count=4 ; c, halfc>  
217. ${c}. ${halfc}  
218. </@repeat >  
219.  
220. <@repeat count=4>  
221. Just repeat it...  
222. </@repeat >  
223.  
224. 在模板中定义变量  
225. 在模板中定义的变量有三种类型：  
226. plain变量：可以在模板的任何地方访问，包括使用include指令插入的模板，使用assign指令创建和替换。  
227. 局部变量：在宏定义体中有效，使用local指令创建和替换。  
228. 循环变量：只能存在于指令的嵌套内容，由指令（如list）自动创建；宏的参数是局部变量，而不是循环变量  
229. 局部变量隐藏（而不是覆盖）同名的plain变量；循环变量隐藏同名的局部变量和plain变量，下面是一个例子：  
230.  
231. <#assign x = "plain">  
232.  
233. ${x} <#-- we see the plain var. here -->  
234.  
235. <@test/>  
236. 6. ${x} <#-- the value of plain var. was not changed -->  
237. <#list ["loop"] as x>  
238. 7. ${x} <#-- now the loop var. hides the plain var. -->  
239.     <#assign x = "plain2"> <#-- replace the plain var, hiding does not mater here -->  
240. 8. ${x} <#-- it still hides the plain var. -->  
241. </#list>  
242. 9. ${x} <#-- the new value of plain var. -->  
243. <#macro test>  
244. 2. ${x} <#-- we still see the plain var. here -->  
245. <#local x = "local">  
246. 3. ${x} <#-- now the local var. hides it -->  
247. <#list ["loop"] as x>  
248.     4. ${x} <#-- now the loop var. hides the local var. -->  
249. </#list>  
250. 5. ${x} <#-- now we see the local var. again -->  
251. </#macro>  
252. 输出结果：  
253. 1. plain  
254. 2. plain  
255. 3. local 
256. 4. loop  
257. 5. local 
258. 6. plain  
259. 7. loop  
260. 8. loop  
261. 9. plain2  
262. 内部循环变量隐藏同名的外部循环变量，如：  
263. <#list ["loop 1"] as x>  
264. ${x}  
265. <#list ["loop 2"] as x>  
266.     ${x}  
267.     <#list ["loop 3"] as x>  
268.       ${x}  
269.     </#list>  
270.     ${x}  
271. </#list>  
272. ${x}  
273. </#list>  
274. 输出结果：  
275. loop 1  
276.     loop 2  
277.       loop 3  
278.     loop 2  
279. loop 1  
280. 模板中的变量会隐藏（而不是覆盖）数据模型中同名变量，如果需要访问数据模型中的同名变量，使用特殊变量global，下面的例子假设数据  
281.  
282. 模型中的user的值是Big Joe：  
283. <#assign user = "Joe Hider">  
284. ${user}          <#-- prints: Joe Hider -->  
285. ${.globals.user} <#-- prints: Big Joe -->  
286. 名字空间  
287. 通常情况，只使用一个名字空间，称为主名字空间，但为了创建可重用的宏、变换器或其它变量的集合（通常称库），必须使用多名字空间，  
288.  
289. 其目的是防止同名冲突  
290. 创建库  
291. 下面是一个创建库的例子（假设保存在lib/my_test.ftl中）：  
292. <#macro copyright date>  
293. <p>Copyright (C) ${date} Julia Smith. All rights reserved.  
294. <br>Email: ${mail}</p>  
295. </#macro>   
296. <#assign mail = "[e-mail] ">  
297. 使用import指令导入库到模板中，Freemarker会为导入的库创建新的名字空间，并可以通过import指令中指定的散列变量访问库中的变量：  
298. <#import "/lib/my_test.ftl" as my>  
299. <#assign mail="[e-mail] ">  
300. <@my.copyright date="1999-2002"/>  
301. ${my.mail}  
302. ${mail}  
303. 输出结果：  
304. <p>Copyright (C) 1999-2002 Julia Smith. All rights reserved.  
305. <br>Email: [e-mail]</p >  
306. [e-mail]   
307. [e-mail]   
308. 可以看到例子中使用的两个同名变量并没有冲突，因为它们位于不同的名字空间。还可以使用assign指令在导入的名字空间中创建或替代变量  
309.  
310. ，下面是一个例子：  
311. <#import "/lib/my_test.ftl" as my>  
312. ${my.mail}  
313. <#assign mail="[e-mail] " in my>  
314. ${my.mail}  
315. 输出结果：  
316. [e-mail]   
317. [e-mail]   
318. 数据模型中的变量任何地方都可见，也包括不同的名字空间，下面是修改的库：  
319. <#macro copyright date>  
320. <p>Copyright (C) ${date} ${user}. All rights reserved.</p>  
321. </#macro>  
322. <#assign mail = "${user}@acme.com ">  
323. 假设数据模型中的user变量的值是Fred，则下面的代码：  
324. <#import "/lib/my_test.ftl" as my>  
325. <@my.copyright date="1999-2002"/>  
326. ${my.mail}  
327. 输出结果：  
328. <p>Copyright (C) 1999-2002 Fred. All rights reserved.</p>[e-mail]  
329.  
330.    
331.  
332.  
333. 四．Freemarker与Struts结合  
334.  
335. 1.输出文件换成以ftl格式的文件  
336.  
337. E.G.  
338.  
339. <action name="bookActionForm" parameter="method" path="/bookAction" scope="request" type="example.BookAction" 
340.  
341. validate="true">  
342.  
343. <forward name="list" path="/index.ftl"/>  
344.  
345. </action>  
346.  
347. 2.使用struts，jstl等标签  
348.  
349. a.导入à<#global html=JspTaglibs["/WEB-INF/tags/struts-html.tld"]>  
350.  
351. 或<#assign html=JspTaglibs["/WEB-INF/struts-html.tld"]>  
352. <#assign bean=JspTaglibs["/WEB-INF/struts-bean.tld"]>  
353. <#assign logic=JspTaglibs["/WEB-INF/struts-logic.tld"]>  
354.  
355. b.使用à<@bean.page id="request" property="request"/>,  
356. <@html.text property="vo.newsTitle" styleClass="input1"/>  
357.  
358. 五．用Freemarker生成Html页面  
359.  
360.    例子：MakeFileManager.java  
361.  
362.    
363.  
364. package example;  
365.  
366. import freemarker.template.Configuration;  
367. import java.text.SimpleDateFormat;  
368. import java.io.File;  
369. import freemarker.template.DefaultObjectWrapper;  
370. import java.util.Map;  
371. import java.util.HashMap;  
372. import java.io.Writer;  
373. import java.io.OutputStreamWriter;  
374. import java.io.FileOutputStream;  
375. import freemarker.template.TemplateException;  
376. import java.io.IOException;  
377. import freemarker.template.Template;  
378.  
379. public class MakeFileManager {  
380.     public String make(Book book, BookFtl bookFtl) {  
381.         Configuration cfg = new Configuration();//配制  
382.  
383.         String realPath = bookFtl.getRealPath();  
384.         String templatePath = realPath + "/WEB-INF/templates/book";  
385.         String cDateStr = "book/" +  
386.                           new SimpleDateFormat("yyyyMMdd").format(new java.util.  
387.                 Date());  
388.         String filePostfix = ".html";  
389.         String path = realPath + "/" + cDateStr;  
390.         String fileTimeName = new SimpleDateFormat("yyyyMMddhhmmss").format(new  
391.                 java.util.Date());  
392.         String returnFileName = cDateStr + "/" + fileTimeName + filePostfix;  
393.         String fileName = "";  
394.         File bookDir = new File(path);  
395.         if (bookDir.exists()) {  
396.             fileName = path + "/" + fileTimeName + filePostfix;  
397.         } else {  
398.             bookDir.mkdirs();  
399.             fileName = path + "/" + fileTimeName + filePostfix;  
400.         }  
401.         try {  
402.             //设置freemarker的参数  
403.             cfg.setNumberFormat("0.##########");//生成html文件时web.xml配制无效  
404.             //cfg.setEncoding();  
405.             cfg.setDirectoryForTemplateLoading(new File(templatePath));  
406.             cfg.setObjectWrapper(new DefaultObjectWrapper());  
407.             Template bookTemplate = cfg.getTemplate(bookFtl.getTemplateName());//模板对象  
408.             Map root = new HashMap();  
409.             root.put("book", book);  
410.             root.put("book2",book);  
411.             Writer out = new OutputStreamWriter(new FileOutputStream(fileName));  
412.             try {  
413.                 bookTemplate.process(root, out);  
414.             } catch (TemplateException e) {  
415.                 e.printStackTrace();  
416.             }  
417.             out.flush();  
418.         } catch (IOException e) {  
419.             e.printStackTrace();  
420.         }  
421.         return returnFileName;  
422.     }  
423. }