初建FreeMarker工程

初建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 
相关文章
相关标签/搜索