最近在做一個SpringMVC+Spring+MyBatis的專案，突然想起以前自己要搭建一個Struts2+Spring+IBatis的框架，但是沒成功，正好看見培訓時候老師給的千里之行的開源專案。於是將這個專案提供的SQL加入到了自己的資料庫中（所以資料和專案名用的是qlzx），打算以後做練習的時候用這個資料庫。那麼接下來問題來了（不要說某翔或者不約，不是那個問題）：我有了資料庫和資料，想要搭建一個網站，該怎麼做？

1、環境

IDE	Eclipse Kepler(4.3.1)
Server	Tomcat 6.0
Struts	2.2.3.1
Spring	3.0.6
MyBatis	3.0.6
Database	Mysql 5.5
DB驅動	mysql-connector-java-5.1.27
測試工具	JUnit 4 (Eclipse自帶)

2、需要的包

3、開發步驟

專案結構：

路徑	功能	說明
action.base	包下的Action類為其他Action類的BaseAction，繼承ActionSupport。	這個類中提供一些其他Action中的通用的方法。如果有這個類存在，那麼其他Action類應該繼承此包下的BaseAction。
action	存放所有Action類的包	如果沒有寫BaseAction的話則應該繼承ActionSupport，否則此包下的所有類都應該繼承BaseAction。 bean包為存放Java實體類的包。
dao.basedao	規定其他所有dao類的方法。	此包下的類應該為介面。
dao	dao的介面	因為使用MyBatis，所以不提供實現類。此包中的介面應該繼承BaseDao。其中的方法名必須要和MyBatisMapper檔案中的id大小寫一致
service	服務層的介面。
service.impl	服務層的實現類。
utils	工具包。
conf	資料夾，存放基本配置。
comf.mapper	資料夾，存放mybatis的配置檔案。

配置檔案：

db.properties:

spy.properties

module.log=com.p6spy.engine.logging.P6LogFactory
#module.outage=com.p6spy.engine.outage.P6OutageFactory

# the mysql open source driver
#realdriver=com.mysql.jdbc.Driver
realdriver= com.mysql.jdbc.Driver

#the DriverManager class sequentially tries every driver that is
#registered to find the right driver.  In some instances, it's possible to
#load up the realdriver before the p6spy driver, in which case your connections
#will not get wrapped as the realdriver will "steal" the connection before
#p6spy sees it.  Set the following property to "true" to cause p6spy to
#explicitily deregister the realdrivers
deregisterdrivers=true

# outagedetection=true|false
# outagedetectioninterval=integer time (seconds)
#
outagedetection=false

# filter what is logged
filter=false

# turn on tracing
autoflush   = true

# sets the date format using Java's SimpleDateFormat routine
dateformat=yyyy-MM-dd HH:mm:ss:SS

#list of categories to explicitly include 
includecategories=error,statement

#list of categories to exclude: error, info, batch, debug, statement,
#commit, rollback and result are valid values
excludecategories=info,debug,result,batch,resultset,commit

# prints a stack trace for every statement logged
stacktrace=false
# if stacktrace=true, specifies the stack trace to print
stacktraceclass=

# determines if property file should be reloaded
reloadproperties=false
# determines how often should be reloaded in seconds
reloadpropertiesinterval=60

#if=true then url must be prefixed with p6spy:
useprefix=false

#specifies the appender to use for logging
appender=com.p6spy.engine.logging.appender.StdoutLogger

append=true

#The following are for log4j logging only
log4j.appender.STDOUT=org.apache.log4j.ConsoleAppender
log4j.appender.STDOUT.layout=org.apache.log4j.PatternLayout
log4j.appender.STDOUT.layout.ConversionPattern=p6spy - %m%n

log4j.logger.p6spy=INFO,STDOUT

這裡使用到了一個包，叫p6spy.jar。

P6Spy 是針對資料庫訪問操作的動態監測框架（為開源專案，專案首頁：www.p6spy.com）它使得資料庫資料可無縫擷取和操縱，而不必對現有應用程式的程式碼作任何修改。P6Spy 分發包包括P6Log，它是一個可記錄任何 Java 應用程式的所有JDBC事務的應用程式。其配置完成使用時，可以進行資料訪問效能的監測。

我們最需要的功能，檢視sql語句，不是預編譯的帶問號的哦，而是真正的資料庫執行的sql，更直觀，更簡單。

這個包主要用於除錯sql，很方便。

web.xml:

<?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_2_5.xsd" id="WebApp_ID" version="2.5">
  <display-name>qlzx</display-name>
  <welcome-file-list>
    <welcome-file>index.jsp</welcome-file>
  </welcome-file-list>
  <filter>
	<filter-name>struts2</filter-name>
  	<filter-class>
		org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter
	</filter-class>
  	<init-param>
		<param-name>config</param-name>
		<param-value>struts-default.xml,struts-plugin.xml,struts.xml</param-value>
	</init-param>
</filter>
<filter-mapping>
  	<filter-name>struts2</filter-name>
  	<url-pattern>/*</url-pattern>
</filter-mapping>
 <context-param>
    <param-name>contextConfigLocation</param-name>
    <param-value>classpath:applicationContext.xml</param-value>
  </context-param>
 <filter>
      <filter-name>encodingFilter</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-mapping>
      <filter-name>encodingFilter</filter-name>
      <url-pattern>/*</url-pattern>
   </filter-mapping>
<!-- 配置監聽 -->
  <listener>
    <listener-class>org.springframework.web.util.IntrospectorCleanupListener</listener-class>
  </listener>
  <listener>
    <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
  </listener>


  <!-- 配置錯誤頁面 -->
  <error-page>
    <error-code>500</error-code>
    <location>/commons/error.jsp</location>
  </error-page>
  <error-page>
    <error-code>404</error-code>
    <location>/commons/404.jsp</location>
  </error-page>
  <error-page>
    <error-code>403</error-code>
    <location>/commons/403.jsp</location>
  </error-page>

</web-app>

applicationContext.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:context="http://www.springframework.org/schema/context"
	xsi:schemaLocation="http://www.springframework.org/schema/beans
    http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
    http://www.springframework.org/schema/context
    http://www.springframework.org/schema/context/spring-context-3.0.xsd">

	<import resource="datasource.xml" />

	<context:annotation-config/>
	<context:component-scan base-package="com.qlzx"></context:component-scan>

	<!-- 配置mybatis的sqlsessionFactory -->
	<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
		<property name="dataSource" ref="dataSource" />
		<property name="configLocation" value="classpath:conf/MapperConfig.xml" />
	</bean>

	<!--配置 mybatis的對映器 方式一 -->
	<!-- <bean id="userMapper" class="org.mybatis.spring.mapper.MapperFactoryBean"> 
		<property name="sqlSessionFactory" ref="sqlSessionFactory"/> <property name="mapperInterface" 
		value="org.ko.webservice.dao.UserMapper"/> </bean> -->

	<!-- 配置 mybatis的對映器 方式二：也可不指定特定mapper，而使用自動掃描包的方式來註冊各種Mapper ，配置如下： -->
	<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
		<property name="basePackage" value="com.qlzx" />
		<property name="sqlSessionFactory" ref="sqlSessionFactory" />
		<property name="annotationClass" value="org.springframework.stereotype.Component" />
	</bean>

	<!-- bean class="org.mybatis.spring.annotation.MapperScannerPostProcessor"> 
		<property name="basePackage" value="org.ko.webservice.dao" /> </bean -->


	<!-- 配置事務管理 -->
	<bean id="transactionManager"
		class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
		<property name="dataSource">
			<ref bean="dataSource" />
		</property>
	</bean>
<!-- tx:annotation-driven transaction-manager="transactionManager" / -->

	<!-- 配置事務代理攔截器 -->
	<bean id="transactionInterceptor"
		class="org.springframework.transaction.interceptor.TransactionInterceptor">
		<property name="transactionManager" ref="transactionManager" />
		<property name="transactionAttributes">
			<props>
				<prop key="add*">PROPAGATION_REQUIRED,-Exception</prop>
				<prop key="insert*">PROPAGATION_REQUIRED,-Exception</prop>
				<prop key="save*">PROPAGATION_REQUIRED,-Exception</prop>
				<prop key="modify*">PROPAGATION_REQUIRED,-Exception</prop>
				<prop key="update*">PROPAGATION_REQUIRED,-Exception</prop>
				<prop key="del*">PROPAGATION_REQUIRED,-Exception</prop>
				<prop key="delete*">PROPAGATION_REQUIRED,-Exception</prop>
				<prop key="remove*">PROPAGATION_REQUIRED,-Exception</prop>
				<prop key="query*">PROPAGATION_REQUIRED, readOnly,-Exception</prop>
				<prop key="search*">PROPAGATION_REQUIRED, readOnly,-Exception</prop>
				<prop key="select*">PROPAGATION_REQUIRED, readOnly,-Exception</prop>
				<prop key="get*">PROPAGATION_REQUIRED, readOnly,-Exception</prop>
				<prop key="load*">PROPAGATION_REQUIRED, -Exception</prop>
				<prop key="*">readOnly</prop>
			</props>
		</property>
	</bean>

	<!-- 配置要攔截哪些方法 -->
	<bean id="trasactionMethodPointcutAdvisor"
		class="org.springframework.aop.support.NameMatchMethodPointcutAdvisor">
		<property name="mappedNames">
			<list>
				<value>*</value> <!-- 所有方法 -->
			</list>
		</property>
		<property name="advice">
			<ref local="transactionInterceptor" />
		</property>
	</bean>

	<!-- 配置要攔截哪些類，並使用那些攔截器 -->
	<bean id="ServiceAutoProxyCreator"
		class="org.springframework.aop.framework.autoproxy.BeanNameAutoProxyCreator">
		<property name="proxyTargetClass" value="true"></property>
		<property name="beanNames">
			<list>
				<value>*Service*</value>
			</list>
		</property>
		<property name="interceptorNames">
			<list>
				<value>trasactionMethodPointcutAdvisor</value>
			</list>
		</property>
	</bean>
</beans>

其中最開始的兩段：

<context:annotation-config/>

      <context:component-scanbase-package="com.qlzx"></context:component-scan>

這兩段是告訴Spring使用註解配置，掃描哪個包下的類中的註解。我這裡的專案使用到了註解，所以必須要寫這兩句。同時，如果需要Struts2和MyBaties支援的話，那麼就必須用到兩個包：mybaties-spring-1.0.0.jar和struts2-spring-plugin.jar。

mybatis-spring-1.x.x.jar用於將mybatis無縫整合到Spring中。使用這個包需要用到java5+以及Spring3.0+的版本。版本的對應關係如下圖：

根據這張表，因為我的MyBatis版本為3.0.6，所以使用mybatis-spring-1.0.2.jar

至於struts2-spring-plugin.jar不多說了，這個是用於整個Struts2和Spring的，這個包在Struts2的包中應該是有的，沒有的話那就隨便去網上下一個吧。

datasource.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:context="http://www.springframework.org/schema/context"
	xsi:schemaLocation="http://www.springframework.org/schema/beans
    http://www.springframework.org/schema/beans/spring-beans-3.0.xsd">



	<bean id="configurer"
		class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">
		<property name="location">
			<value>classpath:conf/db.properties</value>
		</property>
	</bean>

	<!-- 配置資料來源 -->
	<bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource"
		destroy-method="close">

		<property name="driverClass">
			<value>com.p6spy.engine.spy.P6SpyDriver</value>
		</property>
		<property name="jdbcUrl">
			<value>${jdbc.url}</value>
		</property>
		<property name="user">
			<value>${jdbc.username}</value>
		</property>
		<property name="password">
			<value>${jdbc.password}</value>
		</property>


		<!--連線池中保留的最小連線數。 -->
		<property name="minPoolSize">
			<value>2</value>
		</property>

		<!--連線池中保留的最大連線數。Default: 15 -->
		<property name="maxPoolSize">
			<value>15</value>
		</property>

		<!--初始化時獲取的連線數，取值應在minPoolSize與maxPoolSize之間。Default: 3 -->
		<property name="initialPoolSize">
			<value>2</value>
		</property>

		<!--最大空閒時間,60秒內未使用則連線被丟棄。若為0則永不丟棄。Default: 0 -->
		<property name="maxIdleTime">
			<value>1800</value>
		</property>

		<!--當連線池中的連線耗盡的時候c3p0一次同時獲取的連線數。Default: 3 -->
		<property name="acquireIncrement">
			<value>2</value>
		</property>

		<!--JDBC的標準引數，用以控制資料來源內載入的PreparedStatements數量。但由於預快取的statements 屬於單個connection而不是整個連線池。所以設定這個引數需要考慮到多方面的因素。 
			如果maxStatements與maxStatementsPerConnection均為0，則快取被關閉。Default: 0 -->
		<property name="maxStatements">
			<value>0</value>
		</property>

		<!--每60秒檢查所有連線池中的空閒連線。Default: 0 -->
		<property name="idleConnectionTestPeriod">
			<value>0</value>
		</property>

		<!--定義在從資料庫獲取新連線失敗後重復嘗試的次數。Default: 30 -->
		<property name="acquireRetryAttempts">
			<value>30</value>
		</property>

		<!--獲取連線失敗將會引起所有等待連線池來獲取連線的執行緒丟擲異常。但是資料來源仍有效 保留，並在下次呼叫getConnection()的時候繼續嘗試獲取連線。如果設為true，那麼在嘗試 
			獲取連線失敗後該資料來源將申明已斷開並永久關閉。Default: false -->
		<property name="breakAfterAcquireFailure">
			<value>false</value>
		</property>

		<!--因效能消耗大請只在需要的時候使用它。如果設為true那麼在每個connection提交的 時候都將校驗其有效性。建議使用idleConnectionTestPeriod或automaticTestTable 
			等方法來提升連線測試的效能。Default: false -->
		<property name="testConnectionOnCheckout">
			<value>false</value>
		</property>

		<property name="debugUnreturnedConnectionStackTraces">
			<value>false</value>
		</property>

		<property name="acquireRetryDelay">
			<value>100</value>
		</property>
	</bean>

</beans>

這個xml因為有註釋，一看即明，不再贅述。使用到了c3p0連線池，所以記得引入c3p0.jar

datasource.xml和applicationContext.xml兩個XML中有一個需要注意的細節就是：其中所有標籤的屬性，鍵和值之間不能有空格或者換行存在。如以下三種情況是錯誤的:

<value>false </value>

<value>false
</value>

<property name = "acquireRetryDelay">

空格不容易被發現，但是卻影響程式執行，所以平時要養成良好的習慣。

struts.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">
<struts>
	<!-- 請求引數的編碼方式 -->

	<constant name="struts.i18n.encoding" value="UTF-8" />

	<!-- 指定被struts2處理的請求字尾型別。多個用逗號隔開 -->

	<constant name="struts.action.extension" value="action,do,htm" />

	<!-- 當struts.xml改動後，是否重新載入。預設值為false(生產環境下使用),開發階段最好開啟 -->

	<constant name="struts.configuration.xml.reload" value="true" />

	<!-- 是否使用struts的開發模式。開發模式會有更多的除錯資訊。預設值為false(生產環境下使用),開發階段最好開啟 -->

	<constant name="struts.devMode" value="true" />

	<!-- 設定瀏覽器是否快取靜態內容。預設值為true(生產環境下使用),開發階段最好關閉 -->

	<constant name="struts.serve.static.browserCache" value="false" />

	<!-- 指定由spring負責action物件的建立 -->

	<constant name="struts.objectFactory" value="spring" />

	<!-- 是否開啟動態方法呼叫 -->
	<constant name="struts.enable.DynamicMethodInvocation" value="false" />

</struts>  

這個唯一要說的就是，因為專案使用註解配置Action，所以這裡就不再配置Action。

MapperConfig.xml

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd" >
<configuration>
	<mappers>
		<mapper resource="conf/mapper/PublicMapper.xml" />
	</mappers>
</configuration>

這個檔案的作用就是引入其他的Mabits的xml配置檔案，如果寫多個的話在這裡新增即可。

PublicMapper.xml

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd" >
<mapper namespace="com.qlzx.dao.UserDao">
	<resultMap id="userlist" type="com.qlzx.bean.Users">
			<id column="id" property="id" />
			<result column="USERNAME" property="userName" />
			<result column="USERPWD" property="userPwd" />
	</resultMap>

	<!-- 公共查詢 記錄數 -->
	<select id="selectUsers" parameterType="java.util.Map"
		resultMap="userlist">
		select ID,USERNAME,USERPWD from USERINFO where 1=1
		<if test="action == 'login'">
			<if test="userName != null and userPwd != ''">
				and USERNAME = #{userName}
				and USERPWD = #{password}
			</if>
		</if>
	</select>

	<!-- 公共 查詢 記錄集合 -->
	<select id="selectByMap" resultType="java.util.HashMap"
		parameterType="java.util.Map">

	</select>

</mapper>

這個檔案也沒什麼好說的。mapper標籤裡的namespace是指向Dao的。resultMap是告訴MyBatis查出來的結果和bean的對應關係。具體用法在網上有一大堆，不再贅述。

我在這裡接收的引數全都是HashMap。因為這樣可以比較靈活。在select中的if中的判斷條件，其中acton是存在引數集合中的key，意思是如果傳來的引數中有一個action的key並且其value為login的話，那麼sql中就新增if中的那些，如果沒有的話那麼就只執行外面那個。這樣做的好處是，如果是登陸的話，那麼在引數map中可以放三個鍵值對，分別是action、userName、password。如果我需要查詢所有使用者的集合的話，那麼只需要穿一個空的引數集合即可（能不能穿null還未測試）。

另外還有一點要說的就是，resultMap。這裡的resultMap是上面定義好的resultMap,值和上面定義的resultMap的id對應。如果是具體的型別的話，那麼需要將resultMap改成resultType。使用resultMap的結果自動為集合，哪怕只有一個前臺也可以使用List來接收。

程式碼：

DAO層：

BaseDao:因為我這裡有一個basedao，所以這裡先貼出basedao的程式碼。

package com.qlzx.dao.basedao;
import java.io.Serializable;
import java.util.List;

import org.apache.ibatis.annotations.Param;

public abstract interface BaseDao<T, E, PK extends Serializable>
{
  public abstract int countByExample(E paramE);

  public abstract List<T> query();

  public abstract int deleteByExample(E paramE);

  public abstract int deleteByPrimaryKey(PK paramPK);

  public abstract int insert(T paramT);

  public abstract int insertSelective(T paramT);

  public abstract List<T> selectByExample(E paramE);

  public abstract T selectByPrimaryKey(PK paramPK);

  public abstract int updateByExampleSelective(@Param("record") T paramT, @Param("example") E paramE);

  public abstract int updateByExample(@Param("record") T paramT, @Param("example") E paramE);

  public abstract int updateByPrimaryKeySelective(T paramT);

  public abstract int updateByPrimaryKey(T paramT);

  public abstract List<T> selectByExampleWithBLOBs(E paramE);

  public abstract int updateByPrimaryKeyWithBLOBs(T paramT);
}

UserDao

package com.qlzx.dao;

import java.math.BigDecimal;
import java.util.List;
import java.util.Map;

import org.springframework.stereotype.Repository;

import com.qlzx.bean.Users;
import com.qlzx.dao.basedao.BaseDao;
@Repository
public interface UserDao extends BaseDao<Users, Map<String,?>, BigDecimal> {
	public abstract List<Users> selectUsers(Map<String ,?> paramMap);
	public abstract int insert (Map<String,?>paramMap);
	public abstract int delete(Map<String,?> paramMap);
	public abstract int updateByMap(Map<String,?> paramMap);
}

注意這個Dao只是一個介面。前面說過，因為具體的查詢已經在xml中配置了，所以這個介面不需要寫實現類，直接呼叫方法即可。這個dao的包名和xml中的namespace對應，方法名和對應xml中的id對應，包括大小寫。

Service：

UserService

package com.qlzx.service;

import java.util.List;
import java.util.Map;

import com.qlzx.bean.Users;

public abstract class UserService {
	public abstract List<Users> selectUsers(Map<String ,?> paramMap);
	public abstract int insert (Map<String,?>paramMap);
	public abstract int delete(Map<String,?> paramMap);
	public abstract int updateByMap(Map<String,?> paramMap);
}

Service介面，不需要多講。

UserServiceImpl:

package com.qlzx.service.impl;

import java.util.List;
import java.util.Map;

import javax.annotation.Resource;

import org.springframework.stereotype.Service;

import com.qlzx.bean.Users;
import com.qlzx.dao.UserDao;
import com.qlzx.service.UserService;

@Service
public class UserServiceImpl extends UserService {

	@Resource
	public UserDao dao;

	public void setDao(UserDao dao) {
		this.dao = dao;
	}

	@Override
	public List<Users> selectUsers(Map<String, ?> paramMap) {
		return dao.selectUsers(paramMap);
	}

	@Override
	public int insert(Map<String, ?> paramMap) {
		return 0;
	}

	@Override
	public int delete(Map<String, ?> paramMap) {
		return 0;
	}

	@Override
	public int updateByMap(Map<String, ?> paramMap) {
		return 0;
	}

}

Service實現類，同樣不需要多講。

BaseAction

package com.qlzx.action.base;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.apache.struts2.interceptor.ServletRequestAware;
import org.apache.struts2.interceptor.ServletResponseAware;

import com.opensymphony.xwork2.ActionSupport;

public class BaseAction extends ActionSupport implements ServletRequestAware,
		ServletResponseAware {
	private static final long serialVersionUID = 7079198825973108720L;
	protected HttpServletRequest request;
	protected HttpServletResponse response;
	@Override
	public void setServletResponse(HttpServletResponse response) {
		this.response = response;
	}

	@Override
	public void setServletRequest(HttpServletRequest request) {
		this.request = request;
	}
}

這個類要說明的是除了繼承ActionSupport以外，還實現了兩個介面：ServletRequestAware,ServletResponseAware 。這兩個介面用於IOC自動注入HttpServletRequest和HttpServletResponse。因為Action中可能對Session、Response和Request進行操作，所以在BaseAction中實現了這兩個介面。獲取Session、Request和Response除了這個方法以外還可以通過ActionContext獲得。

PublicController：

package com.qlzx.action;

import java.awt.image.BufferedImage;
import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.io.IOException;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

import javax.annotation.Resource;
import javax.servlet.http.HttpServletResponse;
import javax.servlet.http.HttpSession;

import net.sf.json.JSONArray;

import org.apache.struts2.convention.annotation.Action;
import org.apache.struts2.convention.annotation.ParentPackage;
import org.apache.struts2.convention.annotation.Result;
import org.springframework.stereotype.Controller;

import com.opensymphony.xwork2.ActionContext;
import com.qlzx.action.base.BaseAction;
import com.qlzx.bean.Users;
import com.qlzx.service.UserService;
import com.qlzx.utils.RandomPic;
import com.qlzx.utils.Util;
import com.sun.image.codec.jpeg.ImageFormatException;
import com.sun.image.codec.jpeg.JPEGCodec;
import com.sun.image.codec.jpeg.JPEGImageEncoder;

@Controller
@ParentPackage(value="json-default")
public class PublicController extends BaseAction {

	private static final long serialVersionUID = -1941557452311902440L;
	@Resource
	UserService userService;
	private String userName;
	private String password;
	private String formid;
	private String resultJson;
	private String code;
	private ByteArrayInputStream imageStream;
	
	@Action(value = "login", results = { 
			@Result(name = "success", location = "/message.jsp") ,
			@Result(name = "failed",type="json",params={"root","resultJson"})
	}) 
	public String login() {
		Map<String,Object> paramMap = new HashMap<String,Object>();
		Map<String, ?> session = (Map<String, ?>) ActionContext.getContext()
				.getSession();
		String formid = (String) session.get("formid");
		if (null != formid && this.formid.equals(formid)) {
			resultJson="請勿重複提交";
			return "failed";
		}
		if(!session.get("code").toString().equals(this.code)){
			resultJson = "驗證碼錯誤";
			return "failed";
		}
		paramMap.put("action", "login");
		paramMap.put("userName", userName);
		paramMap.put("password", password);
		List<Users> user = userService.selectUsers(paramMap);
		if (user != null && user.size()>0) {
			String sessionid = Util.getToken();
			resultJson = "登陸成功";
			HttpSession cession = request.getSession(true);
			cession.setAttribute("user", user.get(0));
			cession.setAttribute("sessionId",sessionid);
			return "success";
		} else {
			resultJson = "使用者名稱或密碼錯誤";
			return "failed";
		}
	}
	@Action(value = "alluser", results = { 
			@Result(name = "success",type="json",params={"root","resultJson"})
	}) 
	public String allUsers() throws IOException {
		Map<String, String> paramMap = new HashMap<String, String>();
		List<Users> userList = userService.selectUsers(paramMap);
		// 將要被返回到客戶端的物件
		// 如果是List型別則使用JsonArray，如果是其他物件型別則使用jsonObject
		JSONArray array = new JSONArray();
		array.addAll(userList);
		this.resultJson = array.toString();
		return "success";
	}
	@Action(value = "logout", results = { @Result(name = "success", location = "/index.jsp") }) 
	public String logout(){
		Map<String, ?> session = (Map<String, ?>) ActionContext.getContext()
				.getSession();
		session.clear();
		return "success";
	}
	@Action(value = "validateCode", results = { 
			@Result(name = "success",type="stream",params={"contentType","image/jpeg","inputName","imageStream"})
	}) 
	public String validateCode() {
		RandomPic pic = new RandomPic();
		BufferedImage image = pic.validatePic();
		String code = pic.getCode();
		System.out.println(code);
		ActionContext.getContext().getSession().put("code", code);
		imageStream = convertImageToStream(image);
		return "success";
	}

	/**
	 * 將BufferedImage轉換成ByteArrayInputStream
	 * @param image 圖片
	 * @return ByteArrayInputStream 流
	 */
	private static ByteArrayInputStream convertImageToStream(BufferedImage image) {

		ByteArrayInputStream inputStream = null;
		ByteArrayOutputStream bos = new ByteArrayOutputStream();
		JPEGImageEncoder jpeg = JPEGCodec.createJPEGEncoder(bos);
		try {
			jpeg.encode(image);
			byte[] bts = bos.toByteArray();
			inputStream = new ByteArrayInputStream(bts);
		} catch (ImageFormatException e) {
			e.printStackTrace();
		} catch (IOException e) {
			e.printStackTrace();
		}
		return inputStream;
	}
	@Action(value = "formid", results = { 
			@Result(name = "success",type="json",params={"root","resultJson"})
	}) 
	public String formid() {
		resultJson = Util.getToken();
		return "success";
	}

	public void setService(UserService service) {
		this.userService = service;
	}


	public void setResponse(HttpServletResponse response) {
		this.response = response;
	}

	public void setUserName(String userName) {
		this.userName = userName;
	}

	public void setPassword(String password) {
		this.password = password;
	}

	public void setFormid(String formid) {
		this.formid = formid;
	}

	public String getResultJson() {
		return resultJson;
	}

	public ByteArrayInputStream getImageStream() {
		return imageStream;
	}

	public void setCode(String code) {
		this.code = code;
	}

}

首先要說的是，因為要返回Json，所以我使用了JsonObject。要使用這個傢伙除了代表他自己的json-lib外，還有6個包是必須的，列表如下：

JsonObject可以很方便的將Java物件轉換為Json字串。使用過程中有一點需要注意，那就是如果這個java物件是個集合，那麼就要使用JsonArray類，簡單的使用方法在allusers這個方法裡已經有寫。如果是java非集合物件的話，那麼就使用JsonOject類。

另外，不要因為使用註解配置Action就以為那些屬性可以使用通過@Autoware或者@Resource註解自動注入。經過我親測這種方法是不行的。我想因為前臺頁面無法溝通到Spring的原因吧。所以這些屬性必須要手動寫setter和getter。

關於配置Action，因為使用到註解配置，所以一會兒說到註解的時候一起記錄。

工具類

Util

package com.qlzx.utils;

import java.security.MessageDigest;
import java.util.Random;

import sun.misc.BASE64Encoder;

public class Util {
	public static String getToken(){
		String token = System.currentTimeMillis()+new Random().nextInt()+"";
		try {
			MessageDigest md = MessageDigest.getInstance("MD5");
			byte[] md5 = md.digest(token.getBytes());
			BASE64Encoder encoder = new BASE64Encoder();
			return encoder.encode(md5);
		} catch (Exception e) {
			throw new RuntimeException(e);
		}
	}
	
}

這個類只有一個方法，就是生成一個唯一的Token，這個Token可以用在表單號、sessionid等地方、甚至改寫一下可以為密碼加密。

RandomPic

package com.qlzx.utils;

import java.awt.Color;
import java.awt.Font;
import java.awt.Graphics;
import java.awt.Graphics2D;
import java.awt.image.BufferedImage;
import java.util.Random;
/**
 * 產生隨機圖片
 * @author Administrator
 *
 */
public class RandomPic{
	private static final long serialVersionUID = 1L;
	public static final  int WIDTH = 120;	//圖片的寬
	public static final  int HEIGHT = 45;		//圖片高
	private String code = "";
	public BufferedImage validatePic() {
		//建立一個影象
		BufferedImage image = new BufferedImage(WIDTH,HEIGHT,BufferedImage.TYPE_INT_RGB);
		//獲取影象
		Graphics g = image.getGraphics();
		//1.設定背景色
		setBackground(g);
		//2.設定邊框
		setBorder(g);
		//3.畫干擾線
		drawRandomLine(g);
		//4、生成並畫隨機驗證碼
		drawRandomNum((Graphics2D)g);
		return image;
	}
	private void drawRandomLine(Graphics g) {
		g.setColor(Color.GREEN);
		//畫至少6條幹擾線
		int k = 0;
		while (k < 1){
			k = new Random().nextInt(6);
		}
		for (int i = 0; i < k; i++) {
			//生成干擾線隨機起始座標
			int x1 = new Random().nextInt(WIDTH);
			int y1 = new Random().nextInt(HEIGHT);
			//生成干擾線隨機結束座標
			int x2 = new Random().nextInt(WIDTH);
			int y2 = new Random().nextInt(HEIGHT);
			//畫干擾線
			g.drawLine(x1, y1, x2, y2);
			
			
		}
		
	}
	/**
	 * 寫隨機漢字。因為 <code> Graphics</code> 沒有旋轉的方法。但預設生成的 <code>Graphics2D</code> 中有旋轉的方法
	 * 所以在傳參時將引數型別強轉成 <code>Graphics2D</code> 
	 * (<code>BufferedImage.getGraphics()</code>方法返回的其實就是<code>Graphics2DGraphics2D</code>)。
	 * @param g
	 */
	private void drawRandomNum(Graphics2D g) {
		code = "";
		g.setColor(Color.RED);
		g.setFont(new Font("微軟雅黑",Font.BOLD,20));
		//常用漢字
		String base = "\u96d5\u864e\u7684\u4e00\u4e86\u662f\u6211\u4e0d\u5728\u4eba\u4eec\u6709\u6765\u4ed6\u8fd9\u4e0a\u7740\u4e2a\u5730\u5230\u5927\u91cc\u8bf4\u5c31\u53bb\u5b50\u5f97\u4e5f\u548c\u90a3\u8981\u4e0b\u770b\u5929\u65f6\u8fc7\u51fa\u5c0f\u4e48\u8d77\u4f60\u90fd\u628a\u597d\u8fd8\u591a\u6ca1\u4e3a\u53c8\u53ef\u5bb6\u5b66\u53ea\u4ee5\u4e3b\u4f1a\u6837\u5e74\u60f3\u751f\u540c\u8001\u4e2d\u5341\u4ece\u81ea\u9762\u524d\u5934\u9053\u5b83\u540e\u7136\u8d70\u5f88\u50cf\u89c1\u4e24\u7528\u5979\u56fd\u52a8\u8fdb\u6210\u56de\u4ec0\u8fb9\u4f5c\u5bf9\u5f00\u800c\u5df1\u4e9b\u73b0\u5c71\u6c11\u5019\u7ecf\u53d1\u5de5\u5411\u4e8b\u547d\u7ed9\u957f\u6c34\u51e0\u4e49\u4e09\u58f0\u4e8e\u9ad8\u624b\u77e5\u7406\u773c\u5fd7\u70b9\u5fc3\u6218\u4e8c\u95ee\u4f46\u8eab\u65b9\u5b9e\u5403\u505a\u53eb\u5f53\u4f4f\u542c\u9769\u6253\u5462\u771f\u5168\u624d\u56db\u5df2\u6240\u654c\u4e4b\u6700\u5149\u4ea7\u60c5\u8def\u5206\u603b\u6761\u767d\u8bdd\u4e1c\u5e2d\u6b21\u4eb2\u5982\u88ab\u82b1\u53e3\u653e\u513f\u5e38\u6c14\u9ec4\u4e94\u7b2c\u4f7f\u5199\u519b\u6728\u73cd\u5427\u6587\u8fd0\u518d\u679c\u600e\u5b9a\u8bb8\u5feb\u660e\u884c\u56e0\u522b\u98de\u5916\u6811\u7269\u6d3b\u90e8\u95e8\u65e0\u5f80\u8239\u671b\u65b0\u5e26\u961f\u5148\u529b\u5b8c\u5374\u7ad9\u4ee3\u5458\u673a\u66f4\u4e5d\u60a8\u6bcf\u98ce\u7ea7\u8ddf\u7b11\u554a\u5b69\u4e07\u5c11\u76f4\u610f\u591c\u6bd4\u9636\u8fde\u8f66\u91cd\u4fbf\u6597\u9a6c\u54ea\u5316\u592a\u6307\u53d8\u793e\u4f3c\u58eb\u8005\u5e72\u77f3\u6ee1\u6885\u65e5\u51b3\u767e\u539f\u62ff\u7fa4\u7a76\u5404\u516d\u672c\u601d\u89e3\u7acb\u6cb3\u6751\u516b\u96be\u65e9\u8bba\u5417\u6839\u5171\u8ba9\u76f8\u7814\u4eca\u5176\u4e66\u5750\u63a5\u5e94\u5173\u4fe1\u89c9\u6b65\u53cd\u5904\u8bb0\u5c06\u5343\u627e\u4e89\u9886\u6216\u5e08\u7ed3\u5757\u8dd1\u8c01\u8349\u8d8a\u5b57\u52a0\u811a\u7d27\u7231\u7b49\u4e60\u9635\u6015\u6708\u9752\u534a\u706b\u6cd5\u9898\u5efa\u8d76\u4f4d\u5531\u6d77\u4e03\u5973\u4efb\u4ef6\u611f\u51c6\u5f20\u56e2\u5c4b\u79bb\u8272\u8138\u7247\u79d1\u5012\u775b\u5229\u4e16\u521a\u4e14\u7531\u9001\u5207\u661f\u5bfc\u665a\u8868\u591f\u6574\u8ba4\u54cd\u96ea\u6d41\u672a\u573a\u8be5\u5e76\u5e95\u6df1\u523b\u5e73\u4f1f\u5fd9\u63d0\u786e\u8fd1\u4eae\u8f7b\u8bb2\u519c\u53e4\u9ed1\u544a\u754c\u62c9\u540d\u5440\u571f\u6e05\u9633\u7167\u529e\u53f2\u6539\u5386\u8f6c\u753b\u9020\u5634\u6b64\u6cbb\u5317\u5fc5\u670d\u96e8\u7a7f\u5185\u8bc6\u9a8c\u4f20\u4e1a\u83dc\u722c\u7761\u5174\u5f62\u91cf\u54b1\u89c2\u82e6\u4f53\u4f17\u901a\u51b2\u5408\u7834\u53cb\u5ea6\u672f\u996d\u516c\u65c1\u623f\u6781\u5357\u67aa\u8bfb\u6c99\u5c81\u7ebf\u91ce\u575a\u7a7a\u6536\u7b97\u81f3\u653f\u57ce\u52b3\u843d\u94b1\u7279\u56f4\u5f1f\u80dc\u6559\u70ed\u5c55\u5305\u6b4c\u7c7b\u6e10\u5f3a\u6570\u4e61\u547c\u97f3\u7b54\u54e5\u9645\u65e7\u795e\u5ea7\u7ae0\u5e2e\u5566\u53d7\u7cfb\u4ee4\u8df3\u975e\u4f55\u725b\u53d6\u5165\u5cb8\u6562\u6389\u5ffd\u79cd\u88c5\u9876\u6025\u6234\u6797\u505c\u606f\u53e5\u533a\u8863\u822c\u62a5\u53f6\u538b\u6162\u53d4\u80cc\u7ec6\u8273\u4f50";
		//寫四個漢字
		for (int i = 0; i < 4; i++) {
			//在字串範圍內取一個漢字
			String ch = base.charAt(new Random().nextInt(base.length()))+"";
			//將生成的漢字新增到變數中
			code = code+ch;
			//寫字的X座標
			int x = i*30+3;
			//旋轉30度以內
			//因為也要向左旋轉，所以先生成一個隨機數後再模30即可
			int degree = new Random().nextInt() % 30;
			//旋轉的弧度
			double theta = degree*Math.PI/180;
			//旋轉
			g.rotate(theta, x, 30);
			//寫字
			g.drawString(ch, x, 30);
			//將弧度轉回去
			g.rotate(-theta, x, 30);
		}
		
	}
	private void setBorder(Graphics g) {
		g.setColor(Color.BLUE);
		g.drawRect(0, 0, WIDTH - 2, HEIGHT - 2);
		
	}
	private void setBackground(Graphics g) {
		g.setColor(Color.WHITE);
		g.fillRect(0, 0, WIDTH, HEIGHT);
	}
	public String getCode() {
		return code;
	}
}

這個類用於生成一個漢字驗證碼。程式碼很簡單，一看就懂，要說明的是，因為每次生成的驗證碼不一樣，所以沒有將此類中的變數寫成static，因此對應的方法也就不是static的。使用此類生成驗證碼的時候需要先建立物件。另外，漢字列表可以寫在properties檔案中，使用靜態程式碼塊載入後使用。

註解。

首先，要使用註解，必須在spring的配置檔案中寫上這兩句：

<context:annotation-config/>
<context:component-scan base-package="com.qlzx"></context:component-scan>

這兩句第一句的意思是使用註解配置。有了這句Spring註解才有用。第二句的意思是自動掃描，掃描的內容自然是註解了。裡面有一個屬性：base-package，這個屬性用來告訴Spring掃描哪個包下的類。比如我的程式碼就是掃描com.qlzx包下的所有類，包括其中的子包。

然後就是Struts對註解的支援了，Struts2要實現對註解的支援，那就必須要使用到struts2-convention-plugin-2.x.x.jar。有了這個包，才能使Struts2支援註解。

對於註解，MVC三層有四種註解，分別是：@Component/@Repository/@Service/@Controller。

如果某個類的頭上帶有以上註解，就會將這個物件作為Bean註冊進Spring容器。以上的4個註解，用法完全一摸一樣，只有語義上的區別。

其中後三個註解是第一個註解@Component的細化。@Component在三層中都可以使用，而細化後，Dao層使用@Repository，Service層使用@Service，而Action使用@Controller。

按照網上的資料，說其中的@Component不推薦使用，至於為什麼，還沒想出來，大概是因為@Component範圍太廣容易出問題吧。而這幾個註解都可以帶引數，如：@Service("exampleService")或者@Service(value="exampleService")。使用註解後相當於在spring配置檔案中添加了bean節點，而像上面這樣帶引數寫的話相當於給bean添加了name屬性。在我的程式碼中因為只有一個Action類、Service類、Dao類都各只有一個，所以沒有寫value。如果是有多個的話，必須在註解中寫上value以示區分。

在spring中生成bean之後，就要定義那些屬性需要自動注入了。使用自動注入有兩個註解：@Resource和@Autowired。這兩個註解作用一樣，只不過 @Autowired 按 byType 自動注入，面@Resource 預設按 byName 自動注入罷了。@Autowired是自動尋找匹配型別，然後注入。@Resource 有兩個屬性是比較重要的，分別是 name 和 type，Spring 將@Resource註釋的 name 屬性解析為 Bean 的名字，而 type 屬性則解析為 Bean 的型別。所以如果使用 name 屬性，則使用 byName 的自動注入策略，而使用 type 屬性時則使用 byType 自動注入策略。如果既不指定 name 也不指定 type 屬性，這時將通過反射機制使用 byName 自動注入策略。這裡的name就是上一段說的@Service(value="exampleService")中的exampleService部分。

如果在使用@Autowired註解注入的時候，需要特定的名稱，那麼可以使用@Qualifier註釋指定需要注入那個bean。如：

@Autowired
@Qualifier("userServiceImpl")
UserService userService;

這樣在使用的時候Spring就會自動尋找所有標記註解的類中的UserServiceImpl這個類去注入。

注意：因為@AutoWired是按型別注入，所以引數只能是型別名。而因為bean中的name預設型別名首字母小寫，所以這裡也是首字母小寫。

那麼如果這樣寫行不行呢？

@Resource
@Qualifier("userServiceImpl")
UserService userService;

行不行，我也不知道，我猜想應該是可以的，本人沒有親測。為什麼？因為Eclipse沒有報錯 : P (開玩笑的)。

這裡要提一下，@Resource註解需要使用到Spring中的common-annotations.jar，所以這個包記得引入。

需要了解以上幾個註解的更多知識，參看網址：

（感謝xyh820和原作者）

三層的類都註解好了，接下來就是使用註解配置Action了。

要使用註解配置Struts2的Action，那麼就必須引入一個包：struts2-convention-plugin.jar。我在這個專案中使用的是struts2-convention-plugin-2.2.3.1.jar

使用註解配置Action的時候，需要用到的最主要的註解為@Action。這個註解為配置Action時候必須用到的註解。

@Action(value = "login", results = { 
			@Result(name = "success", location = "/message.jsp") ,
			@Result(name = "failed",type="json",params={"root","resultJson"})
	})
public String login() {}

以上這段程式碼是將login方法通過註解配置成一個名字叫login的action。如果這個方法返回的是success字串，那麼則跳轉到message.jsp，如果返回的事failed字串，則返回一個json。@Action是配置Action相關的資訊。而@Result這個註解是配置這個Action返回的資訊，其中的資訊的含義對照一下下面的xml程式碼就能看出來。特別要說明的是params這個屬性，他接受的是一個String型別的陣列，寫的形式是key、value、key、value這樣的，例如下面：

@Action(value = "validateCode", results = { 
			@Result(name = "success",type="stream",params={"contentType","image/jpeg","inputName","imageStream"})
	}) 

這個是返回一個流，它相當於在struts2的配置檔案中加入下面這段程式碼：

<action name="validateCode" class="com.qlzx.action.PublicController" method="validateCode">
			<result name="success" type="stream">
				<param name="contentType">image/jpeg</param>
				<param name="inputName">imageStream</param>
			</result>
</action>

當然，因為返回了Json，所以只有上面那個註解是不行的，還需要在這個方法的類中加一個註解：

@ParentPackage(value="json-default")
public class PublicController extends BaseAction {}

上面配置login的註解相當於在Struts中的配置檔案寫入瞭如下的程式碼：

<package name="User" namespace="/" extends="struts-default,json-default">
		<action name="login" class="com.qlzx.action.PublicController"
			method="login">
			<result name="success" type="redirect">/message.jsp</result>
			<result name="failed" type="json">
				<param name="root">resultJson</param>
			</result>
		</action>
</package>

其中@ParentPackage相當於配置中的extends這個屬性。不過經過測試這個註解的value不能是多個值。

常用的註解配置如下：

1) @ParentPackage 指定父包，（不寫預設 “struts-default”）

2) @Namespace 指定名稱空間(不寫預設為 “/”)

3) @Results 一組結果的陣列(在只有多個處理結果的時候使用)

4)@Result(name="success",location="/msg.jsp") 一個結果的對映

5)@Action(value="login") 指定某個請求處理方法的請求URL。注意，它不能新增在Action類上，要新增到方法上。

6) @ExceptionMappings一級宣告異常的陣列

7) @ExceptionMapping對映一個宣告異常

特別要說明的是：如果使用Struts的標註配置了Action後，那麼檢視層類上的@Controller這個標註可以不需要。

最後就是JSP頁面了，程式碼這裡省略。附上效果圖。

index.jsp

執行的sql：

message.jsp

寫在最後的話：

因為本人也是在學習過程當中，所以文章中難免出現什麼錯誤之處。如果對這個文章有什麼疑問或者某些地方有更好的方案或者錯誤的指正，歡迎留言一起討論。

本文為原創，如果轉載請註明出處：

http://blog.csdn.net/levelmini