整合struts2.1.8.1+sitemesh2.4.2+freemarker2.3.15+spring2.5+hibernate3.3.1

整合struts2.1.8.1+sitemesh2.4.2+freemarker2.3.15+spring2.5+hibernate3.3.1

博客分类：
系统架构

JSPServletStrutsCSSfreemarker

由struts2.1.6升级，整合struts2.1.8.1+sitemesh2.4.2+freemarker2.3.15+spring2.5+hibernate3.3.1

由于struts2.1.8.1 sitemesh和freemarker的配置方式改变了，查遍了官方文档和百度 google都没有找到解决问题的办法，自己尝试了N种方法后才找到解决办法，在此分享下。



web.xml
Xml代码 收藏代码

<?xml version="1.0" encoding="utf-8"?>
<web-app version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
<display-name>iemis base system</display-name>
<context-param>
<param-name>log4jConfigLocation</param-name>
<param-value>classpath:log4j.properties</param-value>
</context-param>

<filter>
<filter-name>SetCharacterEncoding</filter-name>
<filter-class>com.iemis.base.util.SetCharacterEncodingFilter</filter-class>
<init-param>
<param-name>encoding</param-name>
<param-value>UTF-8</param-value>
</init-param>
<init-param>
<param-name>ignore</param-name>
<param-value>true</param-value>
</init-param>
</filter>

<filter>
<filter-name>encoding</filter-name>
<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
<init-param>
<param-name>encoding</param-name>
<param-value>UTF-8</param-value>
</init-param>
</filter>

<filter>
<filter-name>springSecurityFilterChain</filter-name>
<filter-class>org.springframework.web.filter.DelegatingFilterProxy</filter-class>
</filter>

<filter>
<filter-name>openSessionInViewFilter</filter-name>
<filter-class>org.springframework.orm.hibernate3.support.OpenSessionInViewFilter</filter-class>
</filter>

<strong><filter>
<filter-name>struts-prepare</filter-name>
<filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareFilter</filter-class>
</filter>

<filter>
<filter-name>sitemesh</filter-name>
<filter-class>org.apache.struts2.sitemesh.FreeMarkerPageFilter</filter-class>
</filter>

<filter>
<filter-name>struts-execute</filter-name>
<filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsExecuteFilter</filter-class>
</filter></strong>

<!--
<filter>
<filter-name>struts-cleanup</filter-name>
<filter-class>org.apache.struts2.dispatcher.ActionContextCleanUp</filter-class>
</filter>
<filter>
<filter-name>sitemesh</filter-name>
<filter-class>org.apache.struts2.sitemesh.FreeMarkerPageFilter</filter-class>
</filter>
<filter>
<filter-name>struts</filter-name>
<filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class>
</filter>
-->
<filter-mapping>
<filter-name>SetCharacterEncoding</filter-name>
<servlet-name>action</servlet-name>
</filter-mapping>

<filter-mapping>
<filter-name>openSessionInViewFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>

<filter-mapping>
<filter-name>encoding</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>

<filter-mapping>
<filter-name>springSecurityFilterChain</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>

<filter-mapping>
<filter-name>struts-prepare</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>

<filter-mapping>
<filter-name>sitemesh</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>

<filter-mapping>
<filter-name>struts-execute</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>

<!--
<filter-mapping>
<filter-name>struts-cleanup</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
<filter-mapping>
<filter-name>sitemesh</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
<filter-mapping>
<filter-name>struts</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
-->
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>

<servlet>
<servlet-name>jspSupportServlet</servlet-name>
<servlet-class>org.apache.struts2.views.JspSupportServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>

<servlet>
<servlet-name>sitemesh-freemarker</servlet-name>
<servlet-class>com.opensymphony.module.sitemesh.freemarker.FreemarkerDecoratorServlet</servlet-class>
<init-param>
<param-name>TemplatePath</param-name>
<param-value>/</param-value>
</init-param>
<init-param>
<param-name>default_encoding</param-name>
<param-value>UTF-8</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>

<strong><servlet-mapping>
<servlet-name>sitemesh-freemarker</servlet-name>
<url-pattern>*.action</url-pattern>
</servlet-mapping>

<servlet-mapping>
<servlet-name>sitemesh-freemarker</servlet-name>
<url-pattern>*.ftl</url-pattern>
</servlet-mapping></strong>

<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
<error-page>
<error-code>403</error-code>
<location>/error403.jsp</location>
</error-page>
<!-- error-page>
<error-code>404</error-code>
<location>/error.jsp</location>
</error-page>
<error-page>
<exception-type>java.lang.Exception</exception-type>
<location>/error.jsp</location>
</error-page-->
</web-app>



注意：sitemesh-freemarker这个servlet要同时匹配action和ftl两个才可以，不能用/*匹配所有的，否则图片样式等也会给装饰。官方文档的访问后缀名就是.ftl不是action，但只配置了action ftl文件他就无法解析了，必须两个都配置了才行。

struts和sitemesh的配置也要用新的方式，否则freemarker里面action变量不能使用。



decorators.xml
Xml代码 收藏代码

<?xml version="1.0" encoding="UTF-8"?>
<!--
定义构成复合视图的所有页面构件的描述
(主要结构页面，header,footer...)，如下例：
-->
<decorators defaultdir="/decorators">
<!-- 在excludes元素下指定的页面将不会由SiteMesh来装饰 -->
<excludes>
<pattern>/index.jsp</pattern>
<pattern>/scripts/*.*</pattern>
<pattern>/images/*.*</pattern>
<pattern>/styles/*.*</pattern>
<pattern>/jasperreport/*.*</pattern>
</excludes>

<!-- iframe里面内容页面装饰器 -->
<decorator name="simple" page="simple.ftl">
<pattern>/browser/*/*/*.action</pattern>
<pattern>/editor/*/*/*.action</pattern>
<pattern>/admin/*/*/*.action</pattern>
<pattern>/browser/home/*.action</pattern>
<pattern>/editor/home/*.action</pattern>
<pattern>/admin/*/*.action</pattern>
<pattern>*.action</pattern>
</decorator>

<decorator name="complete" page="complete.ftl" webapp="/browser/">
<pattern>/browser/*.action</pattern>
<pattern>/editor/*.action</pattern>
<pattern>/admin/*.action</pattern>
</decorator>

</decorators>
<!--
<decorator name="blog_editor" page="blog.ftl" webapp="/editor/">
<pattern>/editor/*.action</pattern>
</decorator>

<decorator name="blog_browser" page="blog.ftl" webapp="/browser/">
<pattern>/browser/*.action</pattern>
<pattern>/login.action</pattern>
</decorator>

<decorator name="admin" page="admin.ftl" webapp="/admin/">
<pattern>/admin/*.action</pattern>
</decorator>

-->
<!--
<decorator name="panel" page="panel.jsp" />
<decorator name="printable" page="printable.jsp" />

<decorator name="printable" page="printable.jsp" role="customer"
webapp="aaa" />
-->
<!--
<decorator name="footer" page="headerfooter.jsp">
<pattern>/index.jsp</pattern>
</decorator>
-->
<!--
其实，重要的工作就是制作装饰器页面本身(也就是包含结构和规则的页面)，
然后把他们描述到decorators.xml中。
-->
<!--
defaultdir: 包含装饰器页面的目录
page : 页面文件名
name : 别名
role : 角色，用于安全
webapp : 可以另外指定此文件存放目录
Patterns : 匹配的路径，可以用*,那些被访问的页面需要被装饰。
-->



struts.xml
Xml代码 收藏代码

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.1//EN"
"http://struts.apache.org/dtds/struts-2.1.dtd">
<constant name="struts.custom.i18n.resources" value="message"/>
<!-- 当struts配置文件修改后，系统是否重新加载配文件，默认是false -->
<constant name="struts.configuration.xml.reload" value="true" />
<struts>
<package name="default" extends="struts-default">
<global-results>
<result name="error" type="freemarker">/common/action_error.ftl</result>
</global-results>

<action name="login" class="com.iemis.base.action.LoginAction">
<result name="input" type="freemarker">/common/login.ftl</result>
<result name="success" type="redirect">/index.jsp</result>
</action>
</package>

<!-- browser -->
<package name="browser" extends="struts-default" namespace="/browser">
<global-results>
<result name="error" type="freemarker">/common/action_error.ftl</result>
<result name="input" type="freemarker">/common/action_blank.ftl</result>
<result name="success" type="freemarker">/common/action_success.ftl</result>
</global-results>

<action name="home" class="com.iemis.base.action.BaseAction" method="complete">
<result name="success" type="freemarker">home.ftl</result>
</action>
</package>
<package name="browser_home" extends="struts-default" namespace="/browser/home">
<global-results>
<result name="error" type="freemarker">/common/action_error.ftl</result>
<result name="input" type="freemarker">/common/action_blank.ftl</result>
<result name="success" type="freemarker">/common/action_success.ftl</result>
</global-results>

<action name="show" class="com.iemis.base.action.BaseAction" method="show">
<result name="success" type="freemarker">show.ftl</result>
</action>
</package>

</struts>





complete.ftl
Html代码 收藏代码

<#assign page=JspTaglibs["/WEB-INF/tld/sitemesh-page.tld"]>
<#include "/common/util.ftl">
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title><@getText "page.title"/>--${title}</title>
<link href="${base}/styles/util.css" type="text/css" rel="stylesheet" />
<link href="${base}/styles/default.css" type="text/css" rel="stylesheet" />
<link href="${base}/styles/complete.css" type="text/css" rel="stylesheet" />
<link href="${base}/styles/coos/menu.css" type="text/css" rel="stylesheet" />
<script type="text/javascript" src="${base}/scripts/coos.js"></script>
<script type="text/javascript" src="${base}/scripts/coos.iemis.js"></script>
<script type="text/javascript" src="${base}/scripts/coos.ui.menu.js"></script>
<script type="text/javascript" src="${base}/scripts/coos.ui.dialogbox.js"></script>
${head}
</head>
<body>
<div id="page">
<#include "/common/head.ftl">
<#if actionErrors?size == 0>
<div id="headNav">
</div>
<script type="text/javascript">
coos.onloadEvent(function(){
//创建一个对象
var menu = new coosmenu("headNav");
<#list baseMenus as menu>
<#assign url><#t>
<#if menu.url?exists>${base}${menu.url}<#else>#this</#if><#t>
</#assign>
<#assign isVisiable><#t>
<#if menu.isVisiable==0>true<#else>false</#if><#t>
</#assign>

<#if !(menu.codeno?exists && ((!editor && menu.codeno=="userManage") || (!admin && menu.codeno=="systemconfig")))>
menu.add(${menu.id},${menu.pid},'${menu.name}','${url}','${menu.title?default("null")}','${menu.target?default("null")}','${menu.isLast?default("null")}','${menu.icon?default("null")}','${menu.iconopen?default("null")}',${isVisiable});
</#if>
</#list>
});

</script>
${body}
<#else>
<div class="page_width">
${body}
</div>
</#if>

<#include "/common/footer.ftl">
</div>
</body>
</html>



simple.ftl
Html代码 收藏代码

<#assign page=JspTaglibs["/WEB-INF/tld/sitemesh-page.tld"]>
<#include "/common/util.ftl">
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>${title}</title>
<link href="${base}/styles/util.css" type="text/css" rel="stylesheet" />
<link href="${base}/styles/default.css" type="text/css" rel="stylesheet" />
<link href="${base}/styles/simple.css" type="text/css" rel="stylesheet" />
<script type="text/javascript" src="${base}/scripts/coos.js"></script>
<script type="text/javascript" src="${base}/scripts/coos.iemis.js"></script>
${head}
</head>
<body>
<#if actionErrors?size == 0>
<#include "/common/action_message.ftl">
${body}
<#else>
${body}
</#if>
</body>
</html>

browser/home.ftl
Html代码 收藏代码

<#include "/common/util.ftl">
<#assign title><@getText "page.title"/><@getText "page.home"/></#assign>
<html>
<head>
<title>${title}</title>
</head>
<body>
<@box title "box_width">
<@iframe "browser_home" "${base}/browser/home/show.action" />
</@box>
</body>
</html>



browser/home/show.ftl
Html代码 收藏代码

<#include "/common/util.ftl">
<html>
<head>
<title><@getText "page.home"/></title>
</head>
<body>
<br /><br /><br /><br />
<div class="success">
${baseConfs["welcome"]?default("welcome")}
</div>
</body>
</html>

applicationContext.xml
Xml代码 收藏代码

<?xml version="1.0" encoding="UTF-8"?>

<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:p="http://www.springframework.org/schema/p"
xmlns:aop="http://www.springframework.org/schema/aop"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:jee="http://www.springframework.org/schema/jee"
xmlns:tx="http://www.springframework.org/schema/tx"
xsi:schemaLocation="
http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-2.5.xsd
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd
http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-2.5.xsd
http://www.springframework.org/schema/jee http://www.springframework.org/schema/jee/spring-jee-2.5.xsd
http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-2.5.xsd">

<context:property-placeholder location="classpath:application.properties" />
<import resource="classpath:application-dao.xml"/>
<import resource="classpath:application-service.xml"/>
<import resource="classpath:application-security.xml"/>
</beans>



注意：sitemesh-freemarker这个servlet要同时匹配action和ftl两个才可以，不能用/*匹配所有的，否则图片样式等也会给装饰。官方文档的访问后缀名就是.ftl不是action，但只配置了action ftl文件他就无法解析了，必须两个都配置了才行。如果你的模版不是以ftl为后缀的要改成对应的后缀，如.html .dec要改成对应的。
Xml代码 收藏代码

<servlet>
<servlet-name>sitemesh-freemarker</servlet-name>
<servlet-class>com.opensymphony.module.sitemesh.freemarker.FreemarkerDecoratorServlet</servlet-class>
<init-param>
<param-name>TemplatePath</param-name>
<param-value>/</param-value>
</init-param>
<init-param>
<param-name>default_encoding</param-name>
<param-value>UTF-8</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>

<servlet-mapping>
<servlet-name>sitemesh-freemarker</servlet-name>
<url-pattern>*.action</url-pattern>
</servlet-mapping>

<servlet-mapping>
<servlet-name>sitemesh-freemarker</servlet-name>
<url-pattern>*.ftl</url-pattern>
</servlet-mapping>



struts和sitemesh的配置也要用新的方式，否则freemarker里面action变量不能使用。
Xml代码 收藏代码

<filter>
<filter-name>struts-prepare</filter-name>
<filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareFilter</filter-class>
</filter>

<filter>
<filter-name>sitemesh</filter-name>
<filter-class>org.apache.struts2.sitemesh.FreeMarkerPageFilter</filter-class>
</filter>

<filter>
<filter-name>struts-execute</filter-name>
<filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsExecuteFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>struts-prepare</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>

<filter-mapping>
<filter-name>sitemesh</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>

<filter-mapping>
<filter-name>struts-execute</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>







spring2.5和hibernate3.3.1的配置和以前版本一致，除了更新插件包不需要改动其他的东西。