spring 3.2.x + struts2 + mybatis 3.x + logback 整合配置

与前面的一篇mybatis 3.2.7 与 spring mvc 3.x、logback整合 相比，只是web层的MVC前端框架，从spring mvc转换成struts 2.x系列，变化并不大

一、pom.xml 配置

 <?xml version="1.0" encoding="UTF-8"?>
 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
     <modelVersion>4.0.0</modelVersion>
     <groupId>infosky</groupId>
     <artifactId>struts2-helloworld</artifactId>
     <packaging>war</packaging>
     <version>1.0</version>
     <properties>
         <java-version>1.6</java-version>
         <struts2.version>2.3.16.3</struts2.version>
         <spring.version>3.2.8.RELEASE</spring.version>
     </properties>
     <dependencies>

         <!-- db driver -->
         <dependency>
             <groupId>commons-dbcp</groupId>
             <artifactId>commons-dbcp</artifactId>
             <version>1.4</version>
         </dependency>

         <!-- log -->
         <dependency>
             <groupId>org.slf4j</groupId>
             <artifactId>slf4j-api</artifactId>
             <version>1.7.7</version>
         </dependency>

         <dependency>
             <groupId>ch.qos.logback</groupId>
             <artifactId>logback-core</artifactId>
             <version>1.1.2</version>
         </dependency>

         <dependency>
             <groupId>ch.qos.logback</groupId>
             <artifactId>logback-classic</artifactId>
             <version>1.1.2</version>
         </dependency>

         <!-- spring -->
         <dependency>
             <groupId>org.apache.struts</groupId>
             <artifactId>struts2-spring-plugin</artifactId>
             <version>2.3.16.3</version>
         </dependency>

         <dependency>
             <groupId>org.springframework</groupId>
             <artifactId>spring-context</artifactId>
             <version>${spring.version}</version>
         </dependency>

         <dependency>
             <groupId>org.springframework</groupId>
             <artifactId>spring-beans</artifactId>
             <version>${spring.version}</version>
         </dependency>

         <dependency>
             <groupId>org.springframework</groupId>
             <artifactId>spring-core</artifactId>
             <version>${spring.version}</version>
         </dependency>

         <dependency>
             <groupId>org.springframework</groupId>
             <artifactId>spring-web</artifactId>
             <version>${spring.version}</version>
         </dependency>

         <dependency>
             <groupId>org.springframework</groupId>
             <artifactId>spring-context</artifactId>
             <version>${spring.version}</version>
         </dependency>

         <dependency>
             <groupId>org.springframework</groupId>
             <artifactId>spring-context-support</artifactId>
             <version>${spring.version}</version>
         </dependency>

         <dependency>
             <groupId>org.springframework</groupId>
             <artifactId>spring-expression</artifactId>
             <version>${spring.version}</version>
         </dependency>

         <dependency>
             <groupId>org.springframework</groupId>
             <artifactId>spring-jdbc</artifactId>
             <version>${spring.version}</version>
         </dependency>

         <dependency>
             <groupId>org.springframework</groupId>
             <artifactId>spring-tx</artifactId>
             <version>${spring.version}</version>
         </dependency>

         <dependency>
             <groupId>org.springframework</groupId>
             <artifactId>spring-aop</artifactId>
             <version>${spring.version}</version>
         </dependency>

         <dependency>
             <groupId>org.aspectj</groupId>
             <artifactId>aspectjweaver</artifactId>
             <version>1.7.3</version>
         </dependency>

         <dependency>
             <groupId>aopalliance</groupId>
             <artifactId>aopalliance</artifactId>
             <version>1.0</version>
         </dependency>

         <!-- oracle -->
         <dependency>
             <groupId>com.oracle</groupId>
             <artifactId>ojdbc6</artifactId>
             <version>11.2.0.3</version>
         </dependency>

         <!-- mybatis -->
         <dependency>
             <groupId>org.mybatis</groupId>
             <artifactId>mybatis-spring</artifactId>
             <version>1.2.2</version>
         </dependency>

         <dependency>
             <groupId>org.mybatis</groupId>
             <artifactId>mybatis</artifactId>
             <version>3.2.7</version>
         </dependency>

         <dependency>
             <groupId>com.github.miemiedev</groupId>
             <artifactId>mybatis-paginator</artifactId>
             <version>1.2.15</version>
         </dependency>

         <!-- struts -->
         <dependency>
             <groupId>org.freemarker</groupId>
             <artifactId>freemarker</artifactId>
             <version>2.3.19</version>
         </dependency>

         <dependency>
             <groupId>org.apache.struts</groupId>
             <artifactId>struts2-core</artifactId>
             <version>2.3.16.3</version>
         </dependency>

         <dependency>
             <groupId>org.apache.struts.xwork</groupId>
             <artifactId>xwork-core</artifactId>
             <version>2.3.16.3</version>
         </dependency>

         <dependency>
             <groupId>ognl</groupId>
             <artifactId>ognl</artifactId>
             <version>3.0.6</version>
         </dependency>

         <dependency>
             <groupId>commons-beanutils</groupId>
             <artifactId>commons-beanutils</artifactId>
             <version>1.8.3</version>
         </dependency>

         <dependency>
             <groupId>commons-collections</groupId>
             <artifactId>commons-collections</artifactId>
             <version>3.2.1</version>
         </dependency>

         <dependency>
             <groupId>commons-fileupload</groupId>
             <artifactId>commons-fileupload</artifactId>
             <version>1.3</version>
         </dependency>

         <dependency>
             <groupId>commons-io</groupId>
             <artifactId>commons-io</artifactId>
             <version>2.2</version>
         </dependency>

         <dependency>
             <groupId>org.apache.commons</groupId>
             <artifactId>commons-lang3</artifactId>
             <version>3.1</version>
         </dependency>

         <dependency>
             <groupId>javassist</groupId>
             <artifactId>javassist</artifactId>
             <version>3.12.1.GA</version>
         </dependency>

         <!-- Servlet -->
         <dependency>
             <groupId>javax.servlet</groupId>
             <artifactId>servlet-api</artifactId>
             <version>2.5</version>
             <scope>provided</scope>
         </dependency>

     </dependencies>

     <profiles>
         <profile>
             <!-- 开发环境 -->
             <id>dev</id>
             <properties>
                 <db-url>jdbc:oracle:thin:@172.21.129.51:1521:orcl</db-url>
                 <db-username>ckg_rpt</db-username>
                 <db-password>ckg_rpt</db-password>
             </properties>
             <!-- 默认激活本环境 -->
             <activation>
                 <activeByDefault>true</activeByDefault>
             </activation>
         </profile>
         <profile>
             <!-- 测试环境 -->
             <id>test</id>
             <properties>
                 <db-url>jdbc:oracle:thin:@172.21.129.51:1521:orcl</db-url>
                 <db-username>ckg_rpt</db-username>
                 <db-password>ckg_rpt</db-password>
             </properties>
         </profile>
     </profiles>

     <build>
         <resources>
             <resource>
                 <directory>src/main/resources</directory>
                 <filtering>true</filtering>
             </resource>
         </resources>
         <plugins>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-compiler-plugin</artifactId>
                 <version>2.5.1</version>
                 <configuration>
                     <source>1.6</source>
                     <target>1.6</target>
                     <encoding>utf-8</encoding>
                 </configuration>
             </plugin>
         </plugins>
     </build>
     <organization>
         <name>infosky</name>
         <url>www.infosky.com.cn</url>
     </organization>

 </project>

主要是maven的关键依赖项，不要漏掉就行

二、web.xml

 <?xml version="1.0" encoding="UTF-8"?>
 <web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">

     <display-name>struts2-helloworld</display-name>

     <context-param>
         <param-name>logbackConfigLocation</param-name>
         <param-value>classpath:logback.xml</param-value>
     </context-param>
     <listener>
         <listener-class>com.cnblogs.yjmyzz.util.LogbackConfigListener</listener-class>
     </listener>

     <context-param>
         <param-name>contextConfigLocation</param-name>
         <param-value>classpath:spring.xml</param-value>
     </context-param>
     <listener>
         <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
     </listener>

     <filter>
         <filter-name>struts2</filter-name>
         <filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class>
         <!-- <init-param>
             <param-name>loggerFactory</param-name>
             <param-value>com.opensymphony.xwork2.util.logging.slf4j.Slf4jLoggerFactory</param-value>
         </init-param> -->
     </filter>

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

     <welcome-file-list>
         <welcome-file>index.html</welcome-file>
     </welcome-file-list>

 </web-app>

注意上面被注释的一段：虽然xwork提供了com.opensymphony.xwork2.util.logging.slf4j.Slf4jLoggerFactory这个类用于整合SLF4J兼容的各种log实现（比如：logback），但我在实际中发现，logback.xml配置文件始终不起作用，运行时一直加载的是logback的默认配置，所以建议改用自已开发的LogbackConfigListener（代码已经在上一篇2.2中给出）

解释：web.xml中主要干了3件事：监听logback配置文件、监听Spring配置文件、注册Struts2的入口Filter

三、weblogic.xml与jboss-deployment-structure.xml

在weblogic下以war包部署时，由于war是一个压缩包，不会自动展开，所以一些依赖于物理文件路径的代码，可能会有问题，比如报一些：

java.lang.IllegalStateException: Cannot set web app root system property when WAR file is not expanded

之类的错误，解决办法：在WEB-INF下放置一个名为weblogic.xml的文件

 <?xml version="1.0" encoding="UTF-8"?>
 <weblogic-web-app xmlns="http://www.bea.com/ns/weblogic/90">
     <session-descriptor>
         <cookie-path>/</cookie-path>
     </session-descriptor>
     <container-descriptor>
         <prefer-web-inf-classes>true</prefer-web-inf-classes>
         <show-archived-real-path-enabled>true</show-archived-real-path-enabled>
     </container-descriptor>
     <context-root>struts2-helloworld</context-root>
     <!-- <library-ref> <library-name>acmlibrary</library-name> </library-ref> -->
 </weblogic-web-app>

注意：第8行<show-archived-real-path-enabled>true</show-archived-real-path-enabled>，这里告诉weblogic显示war包的真实路径，以便相关代码在取文件路径时能拿到物理路径。

同样，如果部署在jboss下时，由于jboss默认提供的SLF4J的实现与logback有冲突，需要在WEB-INF下放置jboss-deployment-structure.xml，排除jboss自带的jar包

 <?xml version="1.0" encoding="UTF-8"?>
 <jboss-deployment-structure>
     <deployment>
         <exclusions>
             <module name="org.slf4j" />
             <module name="org.slf4j.impl" />
             <module name="org.slf4j.jcl-over-slf4j" />
             <module name="org.slf4j.ext" />
         </exclusions>
     </deployment>
 </jboss-deployment-structure>

三、struts2中的Action处理及相关配置

先来一个Action的基类

 package com.cnblogs.yjmyzz.action;

 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;

 import com.opensymphony.xwork2.ActionSupport;

 public class BaseAction extends ActionSupport {

     private static final long serialVersionUID = -4320398837758540242L;
     protected Logger logger = LoggerFactory.getLogger(this.getClass());

 }

虽然ActionSupport中有一个LOG的实例变量，但经实践，发现用LOG对象记录的日志，不受logback.xml配置文件控制，所以这里定义一个logger，以便其子类都可以正常使用logback。

其它Action都继承它

 package com.cnblogs.yjmyzz.action;

 import org.springframework.stereotype.Component;

 @Component("HelloWorldAction")
 public class HelloWorldAction extends BaseAction {

     private static final long serialVersionUID = -8827776224243873974L;

     private String message;

     public String execute() throws Exception {

         //log sample
         for (int i = 0; i < 1000; i++) {
             logger.trace("logback->trace" + i);
             logger.debug("logback->debug" + i);
             logger.info("logback->info" + i);
             logger.warn("logback->warn" + i);
             logger.error("logback->error" + i);
         }

         return SUCCESS;
     }

     public String sayHi() throws Exception {
         message = "welcome to SSH!";
         return SUCCESS;
     }

     public String getMessage() {
         return message;
     }

     public void setMessage(String message) {
         this.message = message;
     }

 }

注：类上面加上@Component注解，配合这个注释，Spring.xml主配置文件里，配置自动扫描，就不用手动一个一个bean的写配置了

 <?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:aop="http://www.springframework.org/schema/aop"
     xmlns:tx="http://www.springframework.org/schema/tx" xmlns:jdbc="http://www.springframework.org/schema/jdbc"
     xmlns:context="http://www.springframework.org/schema/context"
     xsi:schemaLocation="
      http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.0.xsd
      http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
      http://www.springframework.org/schema/jdbc http://www.springframework.org/schema/jdbc/spring-jdbc-3.0.xsd
      http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-3.0.xsd
      http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-3.0.xsd"
     default-autowire="byName">

     <context:component-scan base-package="com.cnblogs.yjmyzz">
     </context:component-scan>

     <import resource="spring-datasource.xml" />
 </beans>

Spring.xml

运行时Spring会自动注入所有Action的实例，这样在配置struts.xml时，就可以用@Component后面name值来代替完整Action类名，简化配置

 <?xml version="1.0" encoding="UTF-8" ?>
 <!DOCTYPE struts PUBLIC
         "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
         "http://struts.apache.org/dtds/struts-2.0.dtd">
 <struts>

     <package name="home" namespace="/home" extends="default">

         <action name="HelloWorld_*" method="{1}" class="HelloWorldAction">
             <result>/WEB-INF/views/home/HelloWorld.jsp</result>
         </action>

     </package>
 </struts>

注：第9行<action name="HelloWorld_*" method="{1}" class="HelloWorldAction">的class，如果没有Spring，应该写完整路径com.cnblogs.yjmyzz.action.HelloWorldAction，但现在只需要写HelloWorldAction就行了.

四、MyBatis配置

这跟上一篇完全相同，就不再重复了

五、logback.xml配置

 <?xml version="1.0" encoding="UTF-8" ?>
 <configuration scan="true" scanPeriod="1800 seconds"
     debug="false">

     <property name="USER_HOME" value="logs" />
     <property scope="context" name="FILE_NAME" value="test-logback" />

     <timestamp key="byDay" datePattern="yyyy-MM-dd" />

     <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
         <encoder>
             <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n
             </pattern>
         </encoder>
     </appender>

     <appender name="file"
         class="ch.qos.logback.core.rolling.RollingFileAppender">
         <file>${USER_HOME}/${FILE_NAME}.log</file>

         <rollingPolicy class="ch.qos.logback.core.rolling.FixedWindowRollingPolicy">
             <fileNamePattern>${USER_HOME}/${byDay}/${FILE_NAME}-${byDay}-%i.log.zip
             </fileNamePattern>
             <minIndex>1</minIndex>
             <maxIndex>10</maxIndex>
         </rollingPolicy>

         <triggeringPolicy
             class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">
             <maxFileSize>5MB</maxFileSize>
         </triggeringPolicy>
         <encoder>
             <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} %-4relative [%thread] %-5level %logger{150} - %msg%n
             </pattern>
         </encoder>
     </appender>

     <logger name="com.cnblogs.yjmyzz" level="debug" additivity="true">
         <appender-ref ref="file" />
     </logger>

     <root level="debug">
         <appender-ref ref="STDOUT" />
     </root>
 </configuration>

示例源码： spring-struts2-mybatis-helloworld.zip