一、MyBatis简介与配置MyBatis+Spring+MySql

 

1.1MyBatis简介

      MyBatis 是一个可以自定义SQL、存储过程和高级映射的持久层框架。MyBatis 摒除了大部分的JDBC代码、手工设置参数和结果集重获。MyBatis 只使用简单的XML 和注解来配置和映射基本数据类型、Map 接口和POJO 到数据库记录。相对Hibernate和Apache OJB等“一站式”ORM解决方案而言，Mybatis 是一种“半自动化”的ORM实现。
需要使用的Jar包：mybatis-3.0.2.jar（mybatis核心包）。mybatis-spring-1.0.0.jar(与Spring结合包)。

下载地址：
http://ibatis.apache.org/tools/ibator
http://code.google.com/p/mybatis/

 

1.2MyBatis+Spring+MySql简单配置

1.2.1搭建Spring环境

1,建立maven的web项目；
2,加入Spring框架、配置文件；
3,在pom.xml中加入所需要的jar包（spring框架的、mybatis、mybatis-spring、junit等）；
4,更改web.xml和spring的配置文件；
5,添加一个jsp页面和对应的Controller；
6,测试。

可参照：http://limingnihao.iteye.com/blog/830409。使用Eclipse的Maven构建SpringMVC项目

1.2.2建立MySql数据库

建立一个学生选课管理数据库。
表：学生表、班级表、教师表、课程表、学生选课表。
逻辑关系：每个学生有一个班级；每个班级对应一个班主任教师；每个教师只能当一个班的班主任；

使用下面的sql进行建数据库，先建立学生表，插入数据（2条以上）。

更多sql请下载项目源文件，在resource/sql中。

Sql代码  

1. /* 建立数据库 */   
2. CREATE DATABASE STUDENT_MANAGER;   
3. USE STUDENT_MANAGER;   
4.   
5. /***** 建立student表 *****/   
6. CREATE TABLE STUDENT_TBL   
7. (   
8.    STUDENT_ID         VARCHAR(255) PRIMARY KEY,   
9.    STUDENT_NAME       VARCHAR(10) NOT NULL,   
10.    STUDENT_SEX        VARCHAR(10),   
11.    STUDENT_BIRTHDAY   DATE,   
12.    CLASS_ID           VARCHAR(255)   
13. );   
14.   
15. /*插入学生数据*/   
16. INSERT INTO STUDENT_TBL (STUDENT_ID,   
17.                          STUDENT_NAME,   
18.                          STUDENT_SEX,   
19.                          STUDENT_BIRTHDAY,   
20.                          CLASS_ID)   
21.   VALUES   (123456,   
22.             '某某某',   
23.             '女',   
24.             '1980-08-01',   
25.             121546   
26.             )  

/* 建立数据库 */
CREATE DATABASE STUDENT_MANAGER;
USE STUDENT_MANAGER;

/***** 建立student表 *****/
CREATE TABLE STUDENT_TBL
(
   STUDENT_ID         VARCHAR(255) PRIMARY KEY,
   STUDENT_NAME       VARCHAR(10) NOT NULL,
   STUDENT_SEX        VARCHAR(10),
   STUDENT_BIRTHDAY   DATE,
   CLASS_ID           VARCHAR(255)
);

/*插入学生数据*/
INSERT INTO STUDENT_TBL (STUDENT_ID,
                         STUDENT_NAME,
                         STUDENT_SEX,
                         STUDENT_BIRTHDAY,
                         CLASS_ID)
  VALUES   (123456,
            '某某某',
            '女',
            '1980-08-01',
            121546
            )

 

创建连接MySql使用的配置文件mysql.properties。

Mysql.properties代码  

1. jdbc.driverClassName=com.mysql.jdbc.Driver   
2. jdbc.url=jdbc:mysql://localhost:3306/student_manager?user=root&password=limingnihao&useUnicode=true&characterEncoding=UTF-8  

jdbc.driverClassName=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/student_manager?user=root&password=limingnihao&useUnicode=true&characterEncoding=UTF-8

 

 

1.2.3搭建MyBatis环境

顺序随便，现在的顺序是因为可以尽量的少的修改写好的文件。

1.2.3.1创建实体类: StudentEntity

Java代码  

1. public class StudentEntity implements Serializable {   
2.   
3.     private static final long serialVersionUID = 3096154202413606831L;   
4.     private ClassEntity classEntity;   
5.     private Date studentBirthday;   
6.     private String studentID;   
7.     private String studentName;   
8.     private String studentSex;   
9.        
10.     public ClassEntity getClassEntity() {   
11.         return classEntity;   
12.     }   
13.   
14.     public Date getStudentBirthday() {   
15.         return studentBirthday;   
16.     }   
17.   
18.     public String getStudentID() {   
19.         return studentID;   
20.     }   
21.   
22.     public String getStudentName() {   
23.         return studentName;   
24.     }   
25.   
26.     public String getStudentSex() {   
27.         return studentSex;   
28.     }   
29.   
30.     public void setClassEntity(ClassEntity classEntity) {   
31.         this.classEntity = classEntity;   
32.     }   
33.   
34.     public void setStudentBirthday(Date studentBirthday) {   
35.         this.studentBirthday = studentBirthday;   
36.     }   
37.   
38.     public void setStudentID(String studentID) {   
39.         this.studentID = studentID;   
40.     }   
41.   
42.     public void setStudentName(String studentName) {   
43.         this.studentName = studentName;   
44.     }   
45.   
46.     public void setStudentSex(String studentSex) {   
47.         this.studentSex = studentSex;   
48.     }   
49. }  

public class StudentEntity implements Serializable {

	private static final long serialVersionUID = 3096154202413606831L;
	private ClassEntity classEntity;
	private Date studentBirthday;
	private String studentID;
	private String studentName;
	private String studentSex;
	
	public ClassEntity getClassEntity() {
		return classEntity;
	}

	public Date getStudentBirthday() {
		return studentBirthday;
	}

	public String getStudentID() {
		return studentID;
	}

	public String getStudentName() {
		return studentName;
	}

	public String getStudentSex() {
		return studentSex;
	}

	public void setClassEntity(ClassEntity classEntity) {
		this.classEntity = classEntity;
	}

	public void setStudentBirthday(Date studentBirthday) {
		this.studentBirthday = studentBirthday;
	}

	public void setStudentID(String studentID) {
		this.studentID = studentID;
	}

	public void setStudentName(String studentName) {
		this.studentName = studentName;
	}

	public void setStudentSex(String studentSex) {
		this.studentSex = studentSex;
	}
}

 

 

 

1.2.3.2创建数据访问接口

Student类对应的dao接口：StudentMapper。

Java代码  

1. public interface StudentMapper {   
2.        
3.     public StudentEntity getStudent(String studentID);   
4.        
5.     public StudentEntity getStudentAndClass(String studentID);   
6.        
7.     public List<StudentEntity> getStudentAll();   
8.        
9.     public void insertStudent(StudentEntity entity);   
10.        
11.     public void deleteStudent(StudentEntity entity);   
12.        
13.     public void updateStudent(StudentEntity entity);   
14. }  

public interface StudentMapper {
	
	public StudentEntity getStudent(String studentID);
	
	public StudentEntity getStudentAndClass(String studentID);
	
	public List<StudentEntity> getStudentAll();
	
	public void insertStudent(StudentEntity entity);
	
	public void deleteStudent(StudentEntity entity);
	
	public void updateStudent(StudentEntity entity);
}

 

1.2.3.3创建SQL映射语句文件

Student类的sql语句文件StudentMapper.xml
resultMap标签：表字段与属性的映射。
Select标签：查询sql。

Xml代码  

1. <?xml version="1.0" encoding="UTF-8" ?>  
2. <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">  
3. <mapper namespace="com.manager.data.StudentMapper">  
4.   
5.     <resultMap type="StudentEntity" id="studentResultMap">  
6.         <id property="studentID" column="STUDENT_ID"/>  
7.         <result property="studentName" column="STUDENT_NAME"/>  
8.         <result property="studentSex" column="STUDENT_SEX"/>  
9.         <result property="studentBirthday" column="STUDENT_BIRTHDAY"/>  
10.     </resultMap>  
11.        
12.     <!-- 查询学生，根据id -->  
13.     <select id="getStudent" parameterType="String" resultType="StudentEntity" resultMap="studentResultMap">  
14.         <![CDATA[ 
15.             SELECT * from STUDENT_TBL ST 
16.                 WHERE ST.STUDENT_ID = #{studentID}  
17.         ]]>    
18.     </select>  
19.        
20.     <!-- 查询学生列表 -->  
21.     <select id="getStudentAll"  resultType="com.manager.data.model.StudentEntity" resultMap="studentResultMap">  
22.         <![CDATA[ 
23.             SELECT * from STUDENT_TBL 
24.         ]]>    
25.     </select>  
26.        
27. </mapper>  

<?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.manager.data.StudentMapper">

	<resultMap type="StudentEntity" id="studentResultMap">
		<id property="studentID" column="STUDENT_ID"/>
		<result property="studentName" column="STUDENT_NAME"/>
		<result property="studentSex" column="STUDENT_SEX"/>
		<result property="studentBirthday" column="STUDENT_BIRTHDAY"/>
	</resultMap>
	
	<!-- 查询学生，根据id -->
	<select id="getStudent" parameterType="String" resultType="StudentEntity" resultMap="studentResultMap">
		<![CDATA[
			SELECT * from STUDENT_TBL ST
				WHERE ST.STUDENT_ID = #{studentID} 
		]]> 
	</select>
	
	<!-- 查询学生列表 -->
	<select id="getStudentAll"  resultType="com.manager.data.model.StudentEntity" resultMap="studentResultMap">
		<![CDATA[
			SELECT * from STUDENT_TBL
		]]> 
	</select>
	
</mapper>

 

 

1.2.3.4创建MyBatis的mapper配置文件

在src/main/resource中创建MyBatis配置文件：mybatis-config.xml。
typeAliases标签：给类起一个别名。com.manager.data.model.StudentEntity类，可以使用StudentEntity代替。
Mappers标签：加载MyBatis中实体类的SQL映射语句文件。

 

Xml代码  

1. <?xml version="1.0" encoding="UTF-8" ?>  
2. <!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd">  
3. <configuration>  
4.     <typeAliases>  
5.         <typeAlias alias="StudentEntity" type="com.manager.data.model.StudentEntity"/>  
6.     </typeAliases>  
7.     <mappers>  
8.         <mapper resource="com/manager/data/maps/StudentMapper.xml" />  
9.     </mappers>  
10. </configuration>    

<?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>
	<typeAliases>
		<typeAlias alias="StudentEntity" type="com.manager.data.model.StudentEntity"/>
	</typeAliases>
	<mappers>
		<mapper resource="com/manager/data/maps/StudentMapper.xml" />
	</mappers>
</configuration>	

 

 

 

1.2.3.5修改Spring 的配置文件

主要是添加SqlSession的制作工厂类的bean：SqlSessionFactoryBean，（在mybatis.spring包中）。需要指定配置文件位置和dataSource。
和数据访问接口对应的实现bean。通过MapperFactoryBean创建出来。需要执行接口类全称和SqlSession工厂bean的引用。

Xml代码  

1. <!-- 导入属性配置文件 -->  
2. <context:property-placeholder location="classpath:mysql.properties" />  
3.   
4. <bean id="dataSource" class="org.springframework.jdbc.datasource.DriverManagerDataSource">  
5.     <property name="driverClassName" value="${jdbc.driverClassName}" />  
6.     <property name="url" value="${jdbc.url}" />  
7. </bean>  
8.   
9. <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">  
10.     <property name="dataSource" ref="dataSource" />  
11. </bean>  
12.   
13. <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">  
14.     <property name="configLocation" value="classpath:mybatis-config.xml" />  
15.     <property name="dataSource" ref="dataSource" />  
16. </bean>  
17.   
18. <!— mapper bean -->  
19. <bean id="studentMapper" class="org.mybatis.spring.MapperFactoryBean">  
20.     <property name="mapperInterface" value="com.manager.data.StudentMapper" />  
21.     <property name="sqlSessionFactory" ref="sqlSessionFactory" />  
22. </bean>  

<!-- 导入属性配置文件 -->
<context:property-placeholder location="classpath:mysql.properties" />

<bean id="dataSource" class="org.springframework.jdbc.datasource.DriverManagerDataSource">
	<property name="driverClassName" value="${jdbc.driverClassName}" />
	<property name="url" value="${jdbc.url}" />
</bean>

<bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
	<property name="dataSource" ref="dataSource" />
</bean>

<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
	<property name="configLocation" value="classpath:mybatis-config.xml" />
	<property name="dataSource" ref="dataSource" />
</bean>

<!— mapper bean -->
<bean id="studentMapper" class="org.mybatis.spring.MapperFactoryBean">
	<property name="mapperInterface" value="com.manager.data.StudentMapper" />
	<property name="sqlSessionFactory" ref="sqlSessionFactory" />
</bean>

 

 

也可以不定义mapper的bean，使用注解：

将StudentMapper加入注解

 

Java代码  

1. @Repository  
2. @Transactional  
3. public interface StudentMapper {   
4. }  

@Repository
@Transactional
public interface StudentMapper {
}

 

 

对应的需要在dispatcher-servlet.xml中加入扫描：

 

Xml代码  

1. <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">  
2.     <property name="annotationClass" value="org.springframework.stereotype.Repository"/>  
3.     <property name="basePackage" value="com.liming.manager"/>  
4.     <property name="sqlSessionFactory" ref="sqlSessionFactory"/>  
5. </bean>  

    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <property name="annotationClass" value="org.springframework.stereotype.Repository"/>
        <property name="basePackage" value="com.liming.manager"/>
        <property name="sqlSessionFactory" ref="sqlSessionFactory"/>
    </bean>

 

 

 

1.2.4测试StudentMapper

使用SpringMVC测试，创建一个TestController，配置tomcat，访问index.do页面进行测试：

Java代码  

1. @Controller  
2. public class TestController {   
3.   
4.     @Autowired  
5.     private StudentMapper studentMapper;   
6.        
7.     @RequestMapping(value = "index.do")   
8.     public void indexPage() {      
9.         StudentEntity entity = studentMapper.getStudent("10000013");   
10.         System.out.println("name：" + entity.getStudentName());   
11.     }      
12. }  

@Controller
public class TestController {

	@Autowired
	private StudentMapper studentMapper;
	
	@RequestMapping(value = "index.do")
	public void indexPage() {	
		StudentEntity entity = studentMapper.getStudent("10000013");
		System.out.println("name：" + entity.getStudentName());
	}	
}

 

 

使用Junit测试：

Java代码  

1. 使用Junit测试：   
2. Java代码   
3. @RunWith(value = SpringJUnit4ClassRunner.class)   
4. @ContextConfiguration(value = "test-servlet.xml")   
5. public class StudentMapperTest {   
6.        
7.     @Autowired  
8.     private ClassMapper classMapper;   
9.        
10.     @Autowired  
11.     private StudentMapper studentMapper;   
12.        
13.     @Transactional  
14.     public void getStudentTest(){   
15.         StudentEntity entity = studentMapper.getStudent("10000013");   
16.         System.out.println("" + entity.getStudentID() + entity.getStudentName());   
17.            
18.         List<StudentEntity> studentList = studentMapper.getStudentAll();   
19.         for( StudentEntity entityTemp : studentList){   
20.             System.out.println(entityTemp.getStudentName());   
21.         }   
22.            
23.     }   
24. }