如何在Struts框架中应用FreeMarker模板技术实例

ccwgpt 2024-10-03 18:27 23 浏览 0 评论

软件项目实训及课程设计指导——如何在Struts框架中应用FreeMarker模板技术的实例

1、Struts应用框架全面地支持FreeMarker模板技术

（1）Struts应用框架也同样提供对FreeMarker模板技术的支持

而在Struts应用框架中应用FreeMarker模板技术，开发人员只需要在Web应用系统的部署描述文件web.xml中配置出与FreeMarker模板相关的FreemarkerServlet组件（参看如下示例图所示），然后由该FreemarkerServlet组件将项目中的相关Action类中所保存的模型数据和模板文件相互集成组装成最终的HTML页面文件、并向Web浏览器输出。

（2）在项目的web.xml文件中配置定义FreemarkerServlet组件的代码示例

作者在下文为读者介绍在J2EE Struts应用框架的应用系统环境中如何应用FreeMarker模板技术。

2、在基于Struts应用框架的Web项目中添加与FreeMarker有关的*.jar包文件

在Web项目中添加与FreeMarker有关的*.jar包文件，操作的主要过程可以参看如下示图所示。

3、在基于Struts应用框架的Web项目中添加一个请求页面fmtUserLogin.jsp

（1）在Web项目中添加一个请求的JSP页面，该页面的文件名称为fmtUserLogin.jsp文件，在MyEclipse开发工具中选择文件新建菜单项目，然后创建出一个JSP类型的页面文件，操作的主要过程可以参看如下示图所示。

（2）fmtUserLogin.jsp文件的代码内容参看如下的示例

<%@ page language="java" pageEncoding="gb2312"%>
<%@ taglib uri="http://struts.apache.org/tags-html" prefix="html" %>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html:html lang="true">
    <head><html:base /><title>fmtUserLogin.jsp</title></head>
    <body>
        <html:form action="/userInfoURL.do?action=goFMTUserLogin" method="post" >
              <html:hidden property="formType" value="1"/>
              <table border="0">
                  <tr> <td>您的名称：</td><td><html:text property="userName" /></td></tr>
                  <tr> <td>您的密码：</td><td><html:password property="userPassWord" /></td></tr>
                  <tr> <td colspan="2" align="center">
                  <html:submit value="提交" property="submitButton" onclick="this.value='正在提交请求，请稍候'"/>
                  <html:reset value="取消" property="resetButton" />
                  </td></tr>
              </table>
        </html:form>
    </body>
</html:html>

fmtUserLogin.jsp页面文件在静态状态下预览的效果示图请参看如下示例图所示。

4、在Web项目中再设计一个处理的Action类，该类名称为UserInfoAction

（1）本示例将采用Struts应用框架中的DispatchAction技术，并提供一个goFMTUserLogin方法

在Web项目中添加一个Action程序类，该Action程序类的文件名称为UserInfoAction.java文件，在MyEclipse开发工具中选择文件新建类项目，然后创建出一个Java程序类文件，并在该UserInfoAction类中添加一个goFMTUserLogin方法。该goFMTUserLogin方法的程序代码参看如下示例，并注意其中黑体标识的语句。

public ActionForward goFMTUserLogin(ActionMapping mapping, ActionForm form,
HttpServletRequest request, HttpServletResponse response){
      String resultMessage=null; //这是DynaActionForm的实现代码
      UserInfoActionForm userLoginForm = (UserInfoActionForm) form;
      String userName = (String)userLoginForm.get("userName");
      String userPassWord = (String)userLoginForm.get("userPassWord");
      boolean returnResult=userName.equals("yang") &&userPassWord.equals("1234");
      if(returnResult){
     				 resultMessage =userName+"您登录成功!";
      }
      else{
      			resultMessage =userName+"您的身份信息无效!";
      }
      request.setAttribute("showResultInfo", resultMessage);
      return (mapping.findForward("showFMTLoginInfo"));
}

在Action类中只需要将数据保存在request对象中，然后跳转到模板文件中就可以了。

（2）配置出该Action及跳转的目标，并请注意其中黑体标识的语句

<action path="/userInfoURL" name="userInfoActionForm" roles="user"
type="com.px1987.sshproject.action.UserInfoAction" scope="request" parameter="action">
      <forward name="loginSuccess" path="/loginSuccess.jsp" />
      <forward name="loginFailure" path="/loginFailure.jsp" />
      <forward name="registerFailure" path="/userManage/registerFailure.jsp" />
      <forward name="registerSuccess" path="/userManage/registerSuccess.jsp" />
      <forward name="showFMTLoginInfo" path="/userManage/showInfoFMTTemplate.ftl" />
</action>

5、在基于Struts应用框架的Web项目中添加一个模板文件

（1）showInfoFMTTemplate.ftl模板文件

在Web项目中添加一个模板文件，该模板文件的文件名称为showInfoFMTTemplate.ftl。在MyEclipse开发工具中选择文件新建菜单项目，然后创建出一个模板文件，操作的主要过程可以参看如下示图所示。

（2）showInfoFMTTemplate.ftl模板文件的代码内容，并注意其中的黑体标识的语句，该文件中的代码主要是获得用户登录后的状态信息。

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html> 
      <head> 
            <title>showInfoTemplate.ftl</title>
            <meta http-equiv="content-type" content="text/html; charset=gb2312">
      </head>
      <body>
            <h2>采用标准的方式获得参数值： ${showResultInfo}</h2 > <br>
      </body>
</html>

读者需要注意的是，由于showInfoFMTTemplate.ftl模板文件不是JSP类型的页面文件，而是普通的文本文件，该文件的内容不需要通过JSP引擎的解析和处理。如下示例图为showInfoFMTTemplate.ftl模板文件在MyEclipse开发工具中的显示状态图。

从上面的showInfoFMTTemplate.ftl模板页面文件示例中可以了解到FreeMarker的模板文件基本上就是静态的HTML页面，FreeMarker模板文件主要由如下4个部分组成：

1）文本:直接输出的部分

2）注释:<#-- ... -->格式部分,不会输出

3）插值:即${...}或#{...}格式的部分,将使用数据模型中的部分替代输出

4）FTL指令:由FreeMarker指定但和HTML标记基本类似，名字前加#予以区分,不会输出。

6、在Web项目的部署描述文件web.xml中配置出下面的内容

<!-- freemarker FreemarkerServlet 配置 -->
<servlet>
      <servlet-name>freemarker</servlet-name>
      <servlet-class>freemarker.ext.servlet.FreemarkerServlet</servlet-class>
      <init-param> <!-- 模板载入目录路径，本示例是相对于Context的根 -->
          <param-name>TemplatePath</param-name>
          <param-value>/</param-value>
      </init-param>
      <init-param> <!--是否对模板缓存-->
          <param-name>NoCache</param-name>
          <param-value>true</param-value>
      </init-param>
      <init-param>
          <param-name>ContentType</param-name>
          <param-value>text/html</param-value>
      </init-param>
      <init-param> <!--模板更新时间,0表示每次都更新，适合于开发时的配置-->
          <param-name>template_update_delay</param-name>
          <param-value>0</param-value>
      </init-param>
      <init-param>
          <param-name>default_encoding</param-name>
          <param-value>GBK</param-value>
      </init-param>
      <init-param>
          <param-name>locale</param-name>
          <param-value>en_US</param-value>
      </init-param>
      <init-param> <!--数字显示格式-->
          <param-name>number_format</param-name>
          <param-value>0.##########</param-value>
      </init-param>
      <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
      <servlet-name>freemarker</servlet-name>
      <url-pattern>*.ftl</url-pattern>
</servlet-mapping>

在描述文件web.xml中配置的最终结果如下示例图所示。

7、部署本Web示例项目和测试示例中的相关功能

（1）在浏览器中启动测试页面

一旦将本Web项目部署成功后，然后再启动服务器。在浏览器的URL地址栏中输入如下示例图中所示的URL地址将能够启动本示例中的测试页面。

在测试页面的表单中输入模拟系统登录相关的账户和密码（首先输入正确的登录参数），然后再点击其中的"提交"按钮，最终浏览的结果参看如下示例图所示。

（2）在表单中输入相关的参数后的提交输出结果，参看如下示例图所示

点击表单中的"提交"按钮后，前端页面将向后台服务器发送输入的登录信息。后台系统程序查询和比对以确认登录信息是否合法和有效。

（3）再测试非法登录状态是否能够识别

在测试页面的表单中输入模拟系统登录相关的账户和密码，但这次故意输入不正确的登录参数，最终浏览的结果参看如下示例图所示。

点击表单中的"提交"按钮后，前端页面将向后台服务器发送输入的登录信息。后台系统程序查询和比对以确认登录信息是否合法和有效。但由于本次是故意输入错误的登录参数，应该是无法正确登录系统的，观察示例程序的返回结果。

从示例程序返回的结果来看，本示例的功能实现是完全正确。因此，本示例正确地实现了将Struts应用框架和FreeMarker模板相互整合，并在Web页面中应用FreeMarker模板技术同样也能够获得从服务器返回的处理结果。

但由于showInfoFMTTemplate.ftl模板文件不是JSP类型的页面文件，而是普通的文本文件，该文件的内容不需要通过JSP引擎的解析和处理。因此页面的响应速度将会大大地提高，从而应用FreeMarker模板技术的Web页面可以是非JSP类型的Web页面——达到"动态内容静态化"的应用效果。

如何应用Web页面静态化技术以提高Web应用系统的响应性能

课程设计指导——应用AJAX技术提高Web应用的整体响应性能

如何在J2EE平台开发基于Velocity模板的Web应用

如何在Web应用系统表示层开发中应用Velocity模板技术

如何应用“XML+XSLT”技术分离Web表示层数据和样式

struts框架