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过段时间写吧,目前还时间。。
目前为止项目结构:
原标题:Maven整合Springmvc + Mybatis + Spring项目搭建流程,含代码及遇到的各类问题。
关键词:Spring