初建FreeMarker工程html
背景:据说freemarker能够用来写页面的组件,热衷于编写可重用代码的我,火烧眉毛地研究了freemarker,不过,在写组件以前,仍是先研究一下freemarker的基本用法。html5
摘要:本文用了3种不一样的方式(main、servlet、action),将freemarker融入工程之中。java
1、经过main方法使用freemarkerweb
1.新建一个普通的Java工程,在工程引入freemarker.jar,(右键-BuildPath(构建路径)-ConfigureBuildPath(配置构建路径) )。apache
2.在工程的根目录下创建一个文件夹,命名为templates(命名随意),用来放freemarker的模板文件。tomcat
3.在templates下面新建一个模板文件,命名为sample(命名随意),后缀格式ftl(后缀随意,通常是ftl),文件内容就写一句简单的:app
你好${username}
(之后经过这个模板文件,就能够生成:你好张3、你好李4、你好王五。这个模板,看起来跟使用了struts2的JSP文件差很少,其实struts2原本就用了freemarker,struts2的基础jar包里就有freemarker.jar)ide
4.main方法以下:ui
public class Test { public static void main(String[] args) throws Exception { //读取模板文件的所在目录 Configuration configuration = new Configuration(); configuration.setDirectoryForTemplateLoading(new File("templates")); //读取模板文件 Template template = configuration.getTemplate("sample.ftl"); //数据 Map<String, Object> map = new HashMap<String, Object>(); map.put("username", "lwp"); //输出方式 Writer out = new OutputStreamWriter(System.out); //将模板转换并输出 template.process(map, out); //使用了流以后,记得要关掉 out.close(); } }
5.在控制台看输出结果为:this
你好lwp
(体验了简单的,接着就试试高级一点的)
6.在templates下面新建一个模板文件header.ftl,内容以下:
<#macro show age="50"> ${username}-${age} </#macro> <#macro show2 age="50"> <#nested>-${age} </#macro>
7.修改sample.ftl,内容以下:
1.你好,${username} 2.你好,<#if username=="lwp">程序猿<#else>${username}</#if> 3.你好,${user.name} <#include "header.ftl"> 4.你好,<@show /> 5.你好,<@show age="12" /> 6.你好,<@show2>${username}</@show2> 7.你好,<@show2 age="12">${username}</@show2> <#import "header.ftl" as lwp> 8.你好,<@lwp.show /> 9.你好,<@lwp.show age="12" />
8.新建一个User类:
public class User implements Serializable { private static final long serialVersionUID = 1L; private String name; public User(String name) { this.name = name; } public String getName() { return name; } public void setName(String name) { this.name = name; } }
9.main方法改成这样:(多了一句map.put("user", new User("userLWP"));)
public class Test { public static void main(String[] args) throws Exception { //读取模板文件的所在目录 Configuration configuration = new Configuration(); configuration.setDirectoryForTemplateLoading(new File("templates")); //读取模板文件 Template template = configuration.getTemplate("sample.ftl"); //数据 Map<String, Object> map = new HashMap<String, Object>(); map.put("username", "lwp"); map.put("user", new User("userLWP")); //输出方式 Writer out = new OutputStreamWriter(System.out); //将模板转换并输出 template.process(map, out); //使用了流以后,记得要关掉 out.close(); } }
10.在控制台看结果:
1.你好,lwp 2.你好,程序猿 3.你好,userLWP 4.你好,lwp-50 5.你好,lwp-12 6.你好,lwp-50 7.你好,lwp-12 8.你好,lwp-50 9.你好,lwp-12
(效果甚好,我打算之后就用macro来写组件了)
2、经过servlet使用freemarker
1.新建一个动态web工程,把freemarker.jar复制到WEB-INF的lib里面,(若是不起做用,就用上面的方式引入freemarker.jar吧)。
2.在WebRoot或WebContent下面,创建一个文件夹,命名为templates(命名随意),用来放freemarker的模板文件。
3.在templates下面新建一个模板文件,命名为sample(命名随意),后缀格式ftl(后缀随意,通常是ftl),文件内容以下:
(在servlet中,使用了response输出为网页,因此模板内容按照html5的规范来写,不能像上面那样随意了)
<!DOCTYPE html> <html> <head> <title>MyHtml.html</title> <meta charset="utf-8"> </head> <body> 1.你好,${username}<br> 2.你好,<#if username=="lwp">程序猿<#else>${username}</#if><br> 3.你好,${user.name}<br> <#include "header.ftl"> 4.你好,<@show /><br> 5.你好,<@show age="12" /><br> 6.你好,<@show2>${username}</@show2><br> 7.你好,<@show2 age="12">${username}</@show2><br> <#import "header.ftl" as lwp> 8.你好,<@lwp.show /><br> 9.你好,<@lwp.show age="12" /><br> </body> </html>
4.header.ftl专门被引用,跟以前的同样就行:
<#macro show age="50"> ${username}-${age} </#macro> <#macro show2 age="50"> <#nested>-${age} </#macro>
5.复制刚才的User类:
public class User implements Serializable { private static final long serialVersionUID = 1L; private String name; public User(String name) { this.name = name; } public String getName() { return name; } public void setName(String name) { this.name = name; } }
6.新建servlet类,内容以下:
public class TestServlet extends HttpServlet { private static final long serialVersionUID = 1L; @Override protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { try { this.execute(req, resp); } catch (Exception e) { e.printStackTrace(); } } @Override protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { try { this.execute(req, resp); } catch (Exception e) { e.printStackTrace(); } } public void execute(HttpServletRequest req, HttpServletResponse resp) throws Exception { //读取模板文件的所在目录 Configuration configuration = new Configuration(); configuration.setServletContextForTemplateLoading(super.getServletContext(), "templates"); configuration.setDefaultEncoding("utf-8"); //读取模板文件 Template template = configuration.getTemplate("sample.ftl"); //数据 Map<String, Object> map = new HashMap<String, Object>(); map.put("username", "lwp"); map.put("user", new User("userLWP")); //输出方式:response输出 resp.setCharacterEncoding("utf-8"); Writer out = resp.getWriter(); //将模板转换并输出 template.process(map, out); //使用了流以后,记得要关掉 out.close(); } }
7.在web.xml配置一下servlet:
<?xml version="1.0" encoding="UTF-8"?> <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" id="WebApp_ID" version="3.0"> <!-- 项目名称 --> <display-name>freemarker_servlet</display-name> <servlet> <!-- servlet的名称(随意) --> <servlet-name>TestServlet</servlet-name> <!-- servlet的所在路径(按实际填写) --> <servlet-class>lwp.TestServlet</servlet-class> </servlet> <servlet-mapping> <!-- servlet的名称(跟上面同样) --> <servlet-name>TestServlet</servlet-name> <!-- servlet的请求url --> <url-pattern>/TestServlet</url-pattern> </servlet-mapping> </web-app>
8.启动一下tomcat,在地址栏输入http://localhost:8080/freemarker_servlet/TestServlet
9.看到运行结果:
1.你好,lwp 2.你好,程序猿 3.你好,userLWP 4.你好,lwp-50 5.你好,lwp-12 6.你好,lwp-50 7.你好,lwp-12 8.你好,lwp-50 9.你好,lwp-12
(其实,自从接触struts2以后,我已经很久没用servlet了)
3、经过action使用freemarker
1.新建一个动态web工程,把struts2的基础包复制到WEB-INF的lib下面。
(基础包在struts-2.3.16.1\apps\struts2-blank.war,用解压软件打开以后,找到WEB-INF\lib,里面那些包就是基础包了,其中包括了freemarker-2.3.19.jar)。
2.在WebRoot或WebContent下面,创建一个文件夹,命名为templates(命名随意),用来放freemarker的模板文件。
3.在templates下面新建一个模板文件,命名为sample(命名随意),后缀格式ftl(后缀随意,通常是ftl),文件内容以下:
(由于要输出为网页,因此模板内容按照html5的规范来写)
<!DOCTYPE html> <html> <head> <title>MyHtml.html</title> <meta charset="utf-8"> </head> <body> <#if user ?? || username ??> 1.你好,${username}<br> 2.你好,<#if username=="lwp">程序猿<#else>${username}</#if><br> 3.你好,${user.name}<br> <#include "header.ftl"> 4.你好,<@show /><br> 5.你好,<@show age="12" /><br> 6.你好,<@show2>${username}</@show2><br> 7.你好,<@show2 age="12">${username}</@show2><br> <#import "header.ftl" as lwp> 8.你好,<@lwp.show /><br> 9.你好,<@lwp.show age="12" /><br> </#if> </body> </html>
4.header.ftl专门被引用,跟以前的同样就行:
<#macro show age="50"> ${username}-${age} </#macro> <#macro show2 age="50"> <#nested>-${age} </#macro>
5.复制以前的User类:
public class User implements Serializable { private static final long serialVersionUID = 1L; private String name; public User(String name) { this.name = name; } public String getName() { return name; } public void setName(String name) { this.name = name; } }
6.新建action,内容以下:
public class TestAction extends ActionSupport { private static final long serialVersionUID = 1L; private String username; private User user; @Override public String execute() throws Exception { //数据 this.username = "lwp"; this.user = new User("userLWP"); //返回 return ActionSupport.SUCCESS; } public String getUsername() { return username; } public void setUsername(String username) { this.username = username; } public User getUser() { return user; } public void setUser(User user) { this.user = user; } }
7.在struts.xml配置action:
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.3//EN" "http://struts.apache.org/dtds/struts-2.3.dtd"> <struts> <package name="default" extends="struts-default"> <!-- action的请求名字 --> <action name="test" class="lwp.TestAction"> <result name="success" type="freemarker">/templates/sample.ftl</result> </action> <!-- ftl模板文件是不能直接输出的,通过action以后才能转化页面显示。如下这个配置是通过action的直接返回 --> <action name="*"> <result type="freemarker">/templates/{1}.ftl</result> </action> </package> </struts>
8.在web.xml配置struts:
<?xml version="1.0" encoding="UTF-8"?> <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" id="WebApp_ID" version="3.0"> <!-- 项目名称 --> <display-name>freemarker_struts</display-name> <!-- struts2的配置 --> <filter> <filter-name>struts2</filter-name> <filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class> </filter> <filter-mapping> <filter-name>struts2</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> </web-app>
9.启动一下tomcat,在地址栏输入http://localhost:8080/freemarker_struts/test.action
10.看到运行结果:
1.你好,lwp 2.你好,程序猿 3.你好,userLWP 4.你好,lwp-50 5.你好,lwp-12 6.你好,lwp-50 7.你好,lwp-12 8.你好,lwp-50 9.你好,lwp-12