你的位置:首页 > Java教程

[Java教程]Maven整合Springmvc + Mybatis + Spring项目搭建流程,含代码及遇到的各类问题。


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.

 

修改完成后保存并退出,这时候会出现新的错误"can not change dynamic web module 2.3"。这是什么原因呢,原来我们web.

<??> <web-app     version="3.0"     ="http://java.sun.com/     ="http://www.w3.org/2001/     xsi:schemaLocation="http://java.sun.com/>    <display-name>Archetype Created Web Application</display-name></web-app> 

这时index.jsp还会报错,因为还没有javaee的jar依赖,打开pom.

<project ="http://maven.apache.org/POM/4.0.0" ="http://www.w3.org/2001/ 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.faster</groupId>      <artifactId>jackson-annotations</artifactId>      <version>${jackson.version}</version>    </dependency>    <dependency>      <groupId>com.faster</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.

jdbc.properties

jdbc.username=rootjdbc.password=rootjdbc.url=jdbc:mysql://localhost/mydatabase?characterEncoding=utf8&useSSL=truejdbc.driverClassName=com.mysql.jdbc.Driverjdbc.initialSize=5jdbc.maxActive=15

这里我安全证书设置为true,高版本的mysql必须要指定安全证书。

 

applicationContext.

<??><beans ="http://www.springframework.org/schema/beans"   ="http://www.w3.org/2001/   ="http://www.springframework.org/schema/aop"   ="http://www.springframework.org/schema/tx"   ="http://www.springframework.org/schema/jdbc"   ="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/*.></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下面的所有

typeAliasesPackage属性用来指定实体类所在的包,它会扫描这个包,并且以类的简单类名作为别名,我们就不用再*-mapper.

 

mapperScannerConfigurer用于自动扫描和注册mapper接口,我们项目里命名为DAO。

base-package属性必须配置,value为需要扫描的包,mybatis-spring会扫描基包及其子包下面的所有mapper接口,多个包用逗号或分号隔开; sqlSeesionFactoryBeanName用于指定定义好的sqlSessionFacotry的名称。

 

最后我们来建立Dao对应的mapper

UserMapper.

<??> <!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.})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.ClassPathimport com.chit.mvn.bean.User;import com.chit.mvn.service.IUserService;public class TestAgain {  public static void main(String[] args) {    ApplicationContext ctx = new ClassPath);    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过段时间写吧,目前还时间。。

 

目前为止项目结构: