Maven整合Springmvc + Mybatis + Spring項目搭建流程，含代碼及遇到的各類問題。，mavenspringmvc

Maven整合Springmvc + Mybatis + Spring項目搭建流程，含代碼及遇到的各類問題。，mavenspringmvc

LZ最近換工作新公司項目使用了Mybatis，為了熟悉Mybatis准備自己基於Maven搭建一個Springmvc + Mybatis +Spring的項目，中間遇到很多問題，調試很多次才通，才想起來建個博客記錄搭建過程以及各種問題，說來慚愧，有不對的地方歡迎讀者提出，大家一起進步。

項目中依賴的jar包都是到2016年6月1日最新版本，所以我使用的JDK也是最新的1.8，開始使用的是1.6、1.7，運行測試的時候會報"Unsupported major.minor version 52.0",52.0對應jdk版本是1.8，所以使用最新的jdk。

 ------------------------------------------------------------------------------------------------------------------------------------

下面我們就開始建立項目。

首先我們先建立一個Maven項目

下面選擇maven-archetype-webapp

這裡Group ID是整個大項目的名稱如org.springframework或者公司如com.alibaba，Artifact ID是大項目下面子工程名稱（也就是新建好後左側顯示的項目名）

最後點Finish新建項目。

這裡項目建好之後目錄結構會有問題，需要在項目的Properties中的Java Build Path和Java Compiler修改依賴的jdk，這裡我修改為jdk 1.8

此時目錄結構應該已經正確，如圖：

還是Properties窗口，再到Project Facets中查看

一般剛建好的Maven web項目並不是圖中Dynamic Web Module所選擇的3.0版本而是默認的2.3，在這裡直接修改成Web3.0會提示"can not change dynamic web module 3.0",在這裡我們到工程目錄中的.setting文件夾下找到org.eclipse.wst.common.project.facet.core.xml這個文件並編輯它，在這裡將版本設成3.0，jdk也設置為項目對應的版本1.8。

修改完成後保存並退出，這時候會出現新的錯誤"can not change dynamic web module 2.3"。這是什麼原因呢，原來我們web.xml的文件頭中還定義的是web 2.3的規范，將它改為web 3.0

<?xml version="1.0" encoding="UTF-8"?> 
<web-app  
        version="3.0"  
        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_3_0.xsd">  
   
   <display-name>Archetype Created Web Application</display-name>
</web-app> 

這時index.jsp還會報錯，因為還沒有javaee的jar依賴，打開pom.xml，添加此項目需要引入的jar包。

<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>demo</groupId>
  <artifactId>MavenProject</artifactId>
  <packaging>war</packaging>
  <version>0.0.1-SNAPSHOT</version>
  <name>MavenProject Maven Webapp</name>
  <url>http://maven.apache.org</url>
  <properties>
      <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
      <spring.version>4.2.5.RELEASE</spring.version>
      <jackson.version>2.7.4</jackson.version>
      <mybatis.version>3.4.0</mybatis.version>
      <mybatis-spring.version>1.3.0</mybatis-spring.version> 
  </properties>
  
  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>3.8.1</version>
      <scope>test</scope>
    </dependency>
    
    <!-- spring -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-context</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-aspects</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-tx</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-webmvc</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-test</artifactId>
            <version>${spring.version}</version>
            <scope>test</scope>
        </dependency>
        
        <!-- mybatis core -->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>${mybatis.version}</version>
        </dependency>
        
        <!-- mybatis-spring -->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis-spring</artifactId>
            <version>${mybatis-spring.version}</version>
        </dependency>
        
        <!-- mysql-connector-java -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.6</version>
        </dependency>
        
        <!-- dataSource -->
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>druid</artifactId>
            <version>1.0.20</version>
        </dependency>
        
        <!-- log4j -->
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.17</version>
        </dependency>
        
        <!-- aspectJ -->
        <dependency>
            <groupId>org.aspectj</groupId>
            <artifactId>aspectjweaver</artifactId>
            <version>1.8.9</version>
        </dependency>
        
        <!-- json -->
        <dependency>
            <groupId>org.codehaus.jackson</groupId>
            <artifactId>jackson-mapper-asl</artifactId>
            <version>1.9.13</version>
        </dependency>

        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>fastjson</artifactId>
            <version>1.2.12</version>
        </dependency>

        <dependency>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-annotations</artifactId>
            <version>${jackson.version}</version>
        </dependency>

        <dependency>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-core</artifactId>
            <version>${jackson.version}</version>
        </dependency>

        <dependency>  
            <groupId>javax</groupId>  
            <artifactId>javaee-api</artifactId>  
            <version>7.0</version>  
        </dependency>
  </dependencies>
  <build>
      <plugins>  
          <plugin>  
              <groupId>org.apache.maven.plugins</groupId>  
              <artifactId>maven-compiler-plugin</artifactId>  
              <version>3.5.1</version>  
              <configuration>  
                  <source>1.8</source>  
                  <target>1.8</target>  
              </configuration>  
          </plugin>  
      </plugins>
    <finalName>MavenProject</finalName>
  </build>
</project>

PS: 注意我們在<build></build>節點中插入的<plugins></plugins>是用來指定maven默認的編譯環境，不然我們更新項目的時候jdk會變成默認的1.5，又會報很多錯誤，還有mysql-connector-java我並沒有用最新的，因為我本地mysql是5.5版本，mysql版本和驅動版本不一致的話會出現問題（後面會提到）。

等待jar包下載完成後，右鍵項目，Maven ---> Updata Project,到目前為止，工程初步建立完成，應該不會再報錯了。

--------------------------------------------------------------------------------------------------------------------

下面就是進入正題了，整合Mybatis和Spring

首先在src/main/java下建好dao、service、domain、controller層等等的package，如圖：

這裡我們使用Mybatis，不需要DAO的實現層。

1.建好User實體類User.java

package com.chit.mvn.bean;

public class User {
    private int id;
    private String name;
    private int salary;
    private String job;
    public int getId() {
        return id;
    }
    public void setId(int id) {
        this.id = id;
    }
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    public int getSalary() {
        return salary;
    }
    public void setSalary(int salary) {
        this.salary = salary;
    }
    public String getJob() {
        return job;
    }
    public void setJob(String job) {
        this.job = job;
    }
    @Override
    public String toString() {
        return "User [id=" + id + ", name=" + name + ", salary=" + salary + ", job=" + job + "]";
    }
    
}

2.提供UserDao接口，IUserDao.java

package com.chit.mvn.dao;

import com.chit.mvn.bean.User;

public interface IUserDao {
    void insertUser(User user);
    User selectUser(int id);
}

3.提供UserService接口，IUserService.java

package com.chit.mvn.service;

import com.chit.mvn.bean.User;

public interface IUserService {
    void addUser(User user);
    User findUser(int id);
}

4.IUserService的實現類，UserServiceImpl.java

package com.chit.mvn.service.impl;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import com.chit.mvn.bean.User;
import com.chit.mvn.dao.IUserDao;
import com.chit.mvn.service.IUserService;

@Service("userService")
public class UserServiceImpl implements IUserService {

@Autowired
private IUserDao userDao;

@Override
public void addUser(User user) {
userDao.insertUser(user);
}

@Override
public User findUser(int id) {
return userDao.selectUser(id);
}

}

 建好這些類之後，就開始寫Spring的配置文件啦，我們在src/main/resources下面建立jdbc.properties和applicationContex.xml。

jdbc.properties

jdbc.username=root
jdbc.password=root
jdbc.url=jdbc:mysql://localhost/mydatabase?characterEncoding=utf8&useSSL=true
jdbc.driverClassName=com.mysql.jdbc.Driver
jdbc.initialSize=5
jdbc.maxActive=15

這裡我安全證書設置為true，高版本的mysql必須要指定安全證書。

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: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/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">
     
     <!-- 引入jdbc配置文件 -->
     <context:property-placeholder location="classpath:jdbc.properties"/>
     
     <!-- 自動掃描 -->
     <context:component-scan base-package="com.chit.*"></context:component-scan>
     
     <!-- 啟用注解 -->
     <context:annotation-config></context:annotation-config>
     
     <!-- 配置Druid數據源 -->
     <bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy-method="close">
         <property name="username" value="${jdbc.username}"></property>
         <property name="password" value="${jdbc.password}"></property>
         <property name="url" value="${jdbc.url}"></property>
         <property name="driverClassName" value="${jdbc.driverClassName}"></property>
         <property name="initialSize" value="${jdbc.initialSize}"></property>
         <property name="maxActive" value="${jdbc.maxActive}"></property>
         
         <!-- 配置獲取連接等待超時的時間 -->
        <property name="maxWait" value="60000" />

        <!-- 配置間隔多久才進行一次檢測，檢測需要關閉的空閒連接，單位是毫秒 -->
        <property name="timeBetweenEvictionRunsMillis" value="60000" />

        <!-- 配置一個連接在池中最小生存的時間，單位是毫秒 -->
        <property name="minEvictableIdleTimeMillis" value="300000" />

        <property name="validationQuery" value="SELECT 'x'" />
        <property name="testWhileIdle" value="true" />
        <property name="testOnBorrow" value="false" />
        <property name="testOnReturn" value="false" />
     </bean>
     
     <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
         <property name="dataSource" ref="dataSource"></property>
         <property name="mapperLocations" value="classpath:com/chit/mvn/mapper/*.xml"></property>
         <property name="typeAliasesPackage" value="com.chit.mvn.bean"></property>
     </bean>
     
     
     <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
         <property name="basePackage" value="com.chit.mvn.dao"></property>
         <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"></property>  
     </bean>
     
     <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
         <property name="dataSource" ref="dataSource"></property>
     </bean>
     
     <tx:annotation-driven transaction-manager="transactionManager"/>
     
</beans>

數據源我們使用的是阿裡的Druid，下面說明一下Mybatis相關的2個bean的配置sqlSessionFactory和MapperScannerConfigurer。

先說sqlSessionFactory，和Hibernate一樣，有個dataSource屬性，mapperLocations是用於掃描你的mapping映射文件的，這裡需要指定一個路徑，我這裡的配置它就會掃描com/chit/mvn/mapper下面的所有xml文件。

typeAliasesPackage屬性用來指定實體類所在的包，它會掃描這個包，並且以類的簡單類名作為別名，我們就不用再*-mapper.xml中的屬性中寫全類名啦，多個包用逗號或者分好隔開。

mapperScannerConfigurer用於自動掃描和注冊mapper接口，我們項目裡命名為DAO。

base-package屬性必須配置，value為需要掃描的包，mybatis-spring會掃描基包及其子包下面的所有mapper接口，多個包用逗號或分號隔開； sqlSeesionFactoryBeanName用於指定定義好的sqlSessionFacotry的名稱。

最後我們來建立Dao對應的mapper

UserMapper.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.chit.mvn.dao.IUserDao">
    <insert id="insertUser" parameterType="User">
        insert into s_user(id,name,salary,job) values(#{id},#{name},#{salary},#{job})
    </insert>
    
    <select id="selectUser" parameterType="int" resultType="User">
        select * from s_user where id=#{id}
    </select>
</mapper>

因為我們之前在SQLSessionFactory中設置了typeAliasesPackage屬性，我們parameterType就不用指定全類名了。

----------------------------------------------------------------------------------------------------------

至此Spring-Mybatis的配置基本完成，我們來寫個測試類跑一跑。

首先我們先創建一張User表。

CREATE TABLE `s_user` (
  `id` int(32) NOT NULL,
  `name` varchar(64) DEFAULT NULL,
  `salary` int(32) DEFAULT NULL,
  `job` varchar(32) DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

然後在src/test/java目錄下建一個測試類，這裡我建了一個Junit測試和一個普通的測試。

Junit測試類

MvnTest.java

package com.chit.mvn.test;

import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.test.context.ContextConfiguration;
import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;

import com.chit.mvn.bean.User;
import com.chit.mvn.service.IUserService;

@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration(locations={"classpath:applicationContext.xml"})
public class MvnTest {
    
    @Autowired
    private IUserService userService;
    
    @Test
    public void userTest() {
        User user = new User();
        user.setId(1);
        user.setJob("Teacher");
        user.setName("Jack");
        user.setSalary(10000);
        //userService.addUser(user);
        User user2 = userService.findUser(1);
        System.out.println(user2);
    }

}

先插入，再注釋掉插入語句，打開查詢語句。

右鍵方法run Junit Test

記錄成功插入，再試試查詢。

查詢成功！

下面是非Junit測試類

package com.chit.mvn.test;

import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;

import com.chit.mvn.bean.User;
import com.chit.mvn.service.IUserService;

public class TestAgain {
    public static void main(String[] args) {
        ApplicationContext ctx = new ClassPathXmlApplicationContext("applicationContext.xml");
        IUserService userService = (IUserService) ctx.getBean(IUserService.class);
        User user = new User();
        user.setId(3);
        user.setJob("Agent");
        user.setName("Jason");
        user.setSalary(100000);
        User user2 = userService.findUser(2);
        //userService.addUser(user);
        System.out.println(user2);
    }
}

運行結果也和JUnit結果一致，到此。

PS：之前用高版本mysql驅動會出現unknown system variable "tx read only"的錯誤，網上查了後發現是我5.5版本的mysql和最新的驅動不兼容，換了個低版本驅動就好啦！

Mybatis和Spring集成已經完成。下面就是Springmvc的配置了。

------------------------------------------------------------------------------------------------------------------------

Springmvc過段時間寫吧，目前還時間。。

目前為止項目結構：