Mybatis最入门---HelloWorld

上文中，我们已经演示了MySQL的安装配置，以及图形化管理工具的安装配置。本文，我们正式开始介绍当下流行Mybatis的使用方法，关于Mybatis的介绍，请进入传送门：Mybatis百度百科。下面开始我们的干货部分吧！

惯例，先来看看我们的准备工作有：

a.操作系统 ：win7 x64

b.基本软件：MySQL，Mybatis，spring，SQLyog，Tomcat，web基础

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

1.使用上文我们提供给大家的管理工具，快速创建一个我们使用到的Mybatis数据库。命名为db_mybatis。

2.在第一步的基础之上，创建一张user表，具体内容如下图：

3.使用Maven创建第一个mybatis工程：mybatis01，工程结构图如下：

4.修改pom文件，具体内容如下：

[html] view plain copy

 

1. <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
2.     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">  
3.     <modelVersion>4.0.0</modelVersion>  
4.     <groupId>com.csdn,ingo</groupId>  
5.     <artifactId>mybatis01</artifactId>  
6.     <version>0.0.1-SNAPSHOT</version>  
7.     <packaging>jar</packaging>  
8.     <name>mybatis01</name>  
9.     <url>http://maven.apache.org</url>  
10.     <properties>  
11.         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>  
12.     </properties>  
13.     <dependencies>  
14.         <dependency>  
15.             <groupId>junit</groupId>  
16.             <artifactId>junit</artifactId>  
17.             <version>4.12</version>  
18.             <scope>test</scope>  
19.         </dependency>  
20.         <dependency>  
21.             <groupId>org.mybatis</groupId>  
22.             <artifactId>mybatis</artifactId>  
23.             <version>3.3.1</version>  
24.         </dependency>  
25.         <dependency>  
26.             <groupId>mysql</groupId>  
27.             <artifactId>mysql-connector-java</artifactId>  
28.             <version>5.1.26</version>  
29.         </dependency>  
30.     </dependencies>  
31. </project>  

5.创建数据库连接文件：jdbc.properties，具体内容如下：

[plain] view plain copy

 

1. jdbc.driverClassName=com.mysql.jdbc.Driver  
2. jdbc.url=jdbc:mysql://localhost:3306/mybatis  
3. jdbc.username=root  
4. jdbc.password=1234  

6.创建mybatis-config.xml，具体内容如下：

[html] view plain copy

 

1. <?xml version="1.0" encoding="UTF-8" ?>  
2. <!DOCTYPE configuration  
3. PUBLIC "-//mybatis.org//DTD Config 3.0//EN"  
4. "http://mybatis.org/dtd/mybatis-3-config.dtd">  
5. <configuration>  
6.     <properties resource="jdbc.properties"/>  
7.     <typeAliases>  
8.         <typeAlias alias="Message" type="com.java.mybatis.mybatis01.entity.Message"/>  
9.     </typeAliases>  
10.     <environments default="development">  
11.         <environment id="development">  
12.             <transactionManager type="JDBC" />  
13.             <dataSource type="POOLED">  
14.                 <property name="driver" value="${jdbc.driverClassName}" />  
15.                 <property name="url" value="${jdbc.url}" />  
16.                 <property name="username" value="${jdbc.username}" />  
17.                 <property name="password" value="${jdbc.password}" />  
18.             </dataSource>  
19.         </environment>  
20.     </environments>  
21.     <mappers>  
22.         <mapper resource="mappers/UserMapper.xml" />  
23.     </mappers>  
24. </configuration>  

【配置内容解释如下：】

<typeAliases>：表示别名定义，即我们在程序中使用alias的定义，即可代表type中对应的实体对象。具体见下文中mapper文件的使用方法。

<mappers>：配置我们数据库语句文件的存放位置，这里我们只用到了一个文件，因此只配置了一个，更多用法将在后文中进行介绍。

其他配置项为通用配置，这里不再赘述。

7.创建SqlSessionFactoryUtil文件，用来连接数据库。具体内容如下：

[java] view plain copy

 

1. package com.csdn.ingo.util;  
2.   
3. import java.io.InputStream;  
4.   
5. import org.apache.ibatis.io.Resources;  
6. import org.apache.ibatis.session.SqlSession;  
7. import org.apache.ibatis.session.SqlSessionFactory;  
8. import org.apache.ibatis.session.SqlSessionFactoryBuilder;  
9.   
10. public class SqlSessionFactoryUtil {  
11.   
12.     private static SqlSessionFactory sqlSessionFactory;  
13.       
14.     public static SqlSessionFactory getSqlSessionFactory(){  
15.         if(sqlSessionFactory==null){  
16.             InputStream inputStream=null;  
17.             try{  
18.                 inputStream=Resources.getResourceAsStream("mybatis-config.xml");  
19.                 sqlSessionFactory=new SqlSessionFactoryBuilder().build(inputStream);  
20.             }catch(Exception e){  
21.                 e.printStackTrace();  
22.             }  
23.         }  
24.         return sqlSessionFactory;  
25.     }  
26.       
27.     public static SqlSession openSession(){  
28.         return getSqlSessionFactory().openSession();  
29.     }  
30. }  

8.创建User实体类，具体内容如下：

[java] view plain copy

 

1. package com.csdn.ingo.entity;  
2.   
3. import java.io.Serializable;  
4.   
5. /** 
6. *@author 作者 E-mail：ingo 
7. *@version 创建时间：2016年4月17日下午6:25:27 
8. *类说明 
9. */  
10. @SuppressWarnings("serial")  
11. public class User implements Serializable{  
12.       
13.     private String id;  
14.     private String password;  
15.     public String getId() {  
16.         return id;  
17.     }  
18.     public void setId(String id) {  
19.         this.id = id;  
20.     }  
21.     public String getPassword() {  
22.         return password;  
23.     }  
24.     public void setPassword(String password) {  
25.         this.password = password;  
26.     }  
27.     public User(String id, String password) {  
28.         super();  
29.         this.id = id;  
30.         this.password = password;  
31.     }  
32.     public User() {  
33.         super();  
34.         // TODO Auto-generated constructor stub  
35.     }  
36. }  

9.创建UserDao文件，具体内容如下：

[java] view plain copy

 

1. package com.csdn.ingo.dao;  
2.   
3. import com.csdn.ingo.entity.User;  
4.   
5. /** 
6. *@author 作者 E-mail：ingo 
7. *@version 创建时间：2016年4月17日下午6:26:40 
8. *类说明 
9. */  
10. public interface UserDao {  
11.     User findUserById(String id);  
12. }  

10.创建main文件，具体内容如下：

[java] view plain copy

 

1. package com.csdn.ingo.main;  
2. import org.apache.ibatis.session.SqlSession;  
3.   
4. import com.csdn.ingo.dao.UserDao;  
5. import com.csdn.ingo.entity.User;  
6. import com.csdn.ingo.util.SqlSessionFactoryUtil;  
7.   
8. public class main {  
9.     public static void main(String[] args) {  
10.         SqlSession sqlSession=SqlSessionFactoryUtil.openSession();  
11.         UserDao userDao = sqlSession.getMapper(UserDao.class);  
12.         String id = "admin";  
13.         User curUser = userDao.findUserById(id);  
14.         if(curUser!=null){  
15.             System.out.println("HelloWorld:"+curUser.getId());  
16.         }  
17.     }  
18. }  

11.创建UserMapper.xml文件，具体内容如下：

[html] view plain copy

 

1. <?xml version="1.0" encoding="UTF-8" ?>  
2. <!DOCTYPE mapper  
3. PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"  
4. "http://mybatis.org/dtd/mybatis-3-mapper.dtd">  
5. <mapper namespace="com.csdn.ingo.dao.UserDao">  
6.     <select id="findUserById" parameterType="String" resultType="User">  
7.         select * from sysuser where id=#{id}  
8.     </select>  
9. </mapper>   

【解释】

namespace：必须与UserDao的全路径想匹配，这样才能使的接口与sql文件一一对应。

id：现在必须与接口中的方法名称一致。后续我们将介绍高级用法，是mapper文件更加规范化。届时将介绍id的另一种实现方式，敬请期待。

parameterType：传入参数类型，对于基本类型，可以使用Integer，String等封装类型直接使用。复杂类型，多参数还需要将数据封装成对象才能使用，具体用法见后文中的介绍。

resultType：结果返回值的类型，本例返回的结果是一个User对象，这个对象使用了我们前文介绍的别名。如果未使用别名配置，或者上下文中存在多个User实体类，最好使用全路径的方式进行配置，方式发生错误。

12.测试方法：运行main方法即可。观察控制台输出。

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

至此，Mybatis最入门---HelloWorld结束

参考资料：

官方文档：http://www.mybatis.org/mybatis-3/