第一章——认识mybatis

来源：互联网发布：覆盖cookie变量php 编辑：程序博客网时间：2024/06/06 03:35

第一章、认识MyBATIS

1.1、mybatis的运行框架图：

1、首先我们需要配置MyBATIS的配置信息，它可以有两种方法进行提供。里面可以配置数据源，Mapper加载信息，缓存，类的别名还有其他资源的配置。

2、有了配置信息，我们将通过配置信息生成我们需要的SqlSessionFactory这个工厂类，然后我们就可以通过它生成我们MyBATIS的核心接口SqlSession对象。

3、在SqlSession对象里，我们既可以获取Mapper通过Mapper去执行接口方法，也可以直接在SqlSession里面直接通过字符串去调度Mapper注册的SQL。

上面论述的可能对于初学者不是很明白，但是这个不重要，我们只需要有初步的概念即可，下面我们会详细逐个论述。当然这里只是一个简单的图，我们并没有讨论MyBATIS后台的现实。

1.2、实例：

1.2.1 使用文件简介

我们先看看文件分布图：

介绍一下文件的作用，如下表：

文件

作用

备注

configuration-chapter1.xml

MyBATIS的配置文件

配置基本信息。

log4j.properties

配置log4j日志文件输出

配置MyBATIS采用log4j日志输出。

userMaper.xml

使用xml文件配置映射器

UserPO.java

POJO对象类文件

符合Java Bean规范

MainCh1.java

测试类文件。

程序入口

UserMapper.java

映射器接口（使用xml方式）

好了，这里只是简单的介绍了MyBATIS的基本构成文件，大家有个概念即可。

所需jar包：关于mybatis相关的包可以到 http://mybatis.github.io/ 下载，这里我使用了log4j作为日志，所以使用了log4j相关的包。

这里我使用的是MySQL数据库，简易启动也快，不怎么耗资源，所以推荐使用。我们只需要建一张表即可，在mysql中执行下面sql即可。

[sql] view plaincopy
DROP TABLE IF EXISTS `t_user`;  
  
CREATE TABLE `t_user` (  
  `ID` int(11) NOT NULL,  
  `USERNAME` varchar(60) NOT NULL,  
  `PASSWORD` varchar(60) NOT NULL,  
  `BIRTHDAY` date NOT NULL,  
  `MOBILE` varchar(20) NOT NULL,  
  `TEL` varchar(20) DEFAULT NULL,  
  `EMAIL` varchar(100) DEFAULT NULL,  
  `NOTE` text,  
  PRIMARY KEY (`ID`)  
) ;  
  
INSERT  INTO `t_user`(`ID`,`USERNAME`,`PASSWORD`,`BIRTHDAY`,`MOBILE`,`TEL`,`EMAIL`,`NOTE`) VALUES (1,'ykzhen','12345','2015-02-18','13533666666','0756-6666666','ykz@163.com','数据文件');  
commit;  

1.2.2 文件详解

我们从程序入口介绍，让我们先看看文件。

MainCh1.java

[java] view plaincopy
package com.ykzhen.ch1.test;  
  
import com.ykzhen.ch1.mapper.UserMapper;  
import com.ykzhen.ch1.po.UserPO;  
import java.io.IOException;  
import org.apache.log4j.Logger;  
import org.apache.ibatis.io.Resources;  
import org.apache.ibatis.session.SqlSession;  
import org.apache.ibatis.session.SqlSessionFactory;  
import org.apache.ibatis.session.SqlSessionFactoryBuilder;  
  
/** 
 * 
 * @author ykzhen. 
 */  
public class MainCh1 {  
  
    public static void main(String[] args) {  
        //定义 SqlSessionFactory  
        SqlSessionFactory sqlSessionFactory = null;  
        try {  
            //使用配置文件创建 SqlSessionFactory  
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(  
                    Resources.getResourceAsReader("configuration-chapter1.xml"));  
        } catch (IOException ex) {  
            //打印异常.  
            Logger.getLogger(MainCh1.class.getName()).fatal("创建 SqlSessionFactory失败", ex);  
            return;  
        }  
        //定义 sqlSession  
        SqlSession sqlSession = null;  
        try {  
            //用sqlSessionFactory创建sqlSession  
            sqlSession = sqlSessionFactory.openSession();  
            //获取Mapper  
            UserMapper userMapper = sqlSession.getMapper(UserMapper.class);  
            //执行Mapper接口方法.  
            UserPO user = userMapper.findUser(1);  
            //打印信息  
            System.err.println(user.getUsername());  
        } finally {  
            //使用完后要记得关闭sqlSession资源  
            if (sqlSession != null) {  
                sqlSession.close();  
            }  
        }  
    }  
}  

很显然，上述代码要构建SqlSessionFactory是依赖于configuration-chapter1.xml文件的。

它的内容如下：

configuration-chapter1.xml

[html] view plaincopy
<?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>    
        <!--给实体类起一个别名 UserPO -->    
        <typeAlias type="com.ykzhen.ch1.po.UserPO" alias="UserPO" />    
    </typeAliases>    
    <!--数据源配置  这块用 mysql数据库 -->    
    <environments default="development">    
        <environment id="development">    
            <transactionManager type="jdbc" />    
            <dataSource type="POOLED">    
                <property name="driver" value="com.mysql.jdbc.Driver" />    
                <property name="url" value="jdbc:mysql://localhost:3306/oa" />    
                <property name="username" value="root" />    
                <property name="password" value="ykzhen" />    
            </dataSource>    
        </environment>    
    </environments>    
    <mappers>    
        <!--userMapper.xml装载进来  同等于把“dao”的实现装载进来 -->    
        <mapper resource="com\ykzhen\ch1\po\userMapper.xml" />    
    </mappers>    
</configuration>   

这里我们定义了一个UserPO的别名，它指代了类 com.ykzhen.ch1.po.UserPO，这样MyBATIS上下文就可以使用它。

跟着我们定义了数据源，这些有经验的程序员就很容易理解，好了，让我们先给出UserPO.java的代码。很简单的POJO文件。

UserPO.java

[java] view plaincopy
package com.ykzhen.ch1.po;  
  
import java.util.Date;  
  
/** 
 * 
 * @author ykzhen. 
 */  
public class UserPO {  
  
    private Integer id = null;  
    private String username = null;  
    private String password = null;  
    private Date birthday = null;  
    private String mobile = null;  
    private String tel = null;  
    private String email = null;  
    private String note = null;  
  
    /** 
     * @return the id 
     */  
    public Integer getId() {  
        return id;  
    }  
  
    /** 
     * @param id the id to set 
     */  
    public void setId(Integer id) {  
        this.id = id;  
    }  
  
    /** 
     * @return the username 
     */  
    public String getUsername() {  
        return username;  
    }  
  
    /** 
     * @param username the username to set 
     */  
    public void setUsername(String username) {  
        this.username = username;  
    }  
  
    /** 
     * @return the password 
     */  
    public String getPassword() {  
        return password;  
    }  
  
    /** 
     * @param password the password to set 
     */  
    public void setPassword(String password) {  
        this.password = password;  
    }  
  
    /** 
     * @return the birthday 
     */  
    public Date getBirthday() {  
        return birthday;  
    }  
  
    /** 
     * @param birthday the birthday to set 
     */  
    public void setBirthday(Date birthday) {  
        this.birthday = birthday;  
    }  
  
    /** 
     * @return the mobile 
     */  
    public String getMobile() {  
        return mobile;  
    }  
  
    /** 
     * @param mobile the mobile to set 
     */  
    public void setMobile(String mobile) {  
        this.mobile = mobile;  
    }  
  
    /** 
     * @return the tel 
     */  
    public String getTel() {  
        return tel;  
    }  
  
    /** 
     * @param tel the tel to set 
     */  
    public void setTel(String tel) {  
        this.tel = tel;  
    }  
  
    /** 
     * @return the email 
     */  
    public String getEmail() {  
        return email;  
    }  
  
    /** 
     * @param email the email to set 
     */  
    public void setEmail(String email) {  
        this.email = email;  
    }  
  
    /** 
     * @return the note 
     */  
    public String getNote() {  
        return note;  
    }  
  
    /** 
     * @param note the note to set 
     */  
    public void setNote(String note) {  
        this.note = note;  
    }  
  
}  

我们在配置文件中还定义了一个Mapper——UserMapper，它是以文件的形式定义的，那么它来自于配置文件.

userMapper.xml

[html] view plaincopy
<?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">     
<!--和接口路径和名称保持一致，MyBATIS会自动帮我们找到这个 Mapper-->  
<mapper namespace="com.ykzhen.ch1.mapper.UserMapper">  
    <!--查找用户，我们和接口方法保持一致，并且配置传入参数为整数，  
    返回结果为UserPO，UserPO已经在配置文件中配置了上下文。-->  
    <select id="findUser" parameterType="int" resultType="UserPO">    
            <!--#{id}是MyBATIS的参数写法-->  
            <![CDATA[  
            select id, username, password, birthday, mobile, tel, email, note from t_user  where id = #{id} 
            ]]>    
    </select>    
</mapper>    

让我们看看我们UserMapper，它是一个接口，而不是一个类。（一个没有实现类的接口如何运行的？大家是否需要思考一下。）

UserMapper.java

[java] view plaincopy
package com.ykzhen.ch1.mapper;  
import com.ykzhen.ch1.po.UserPO;  
/** 
 * 
 * @author ykzhen. 
 */  
//这里只需要接口，而不需要类  
public interface UserMapper {  
    //方法和userMapper.xml中的保持名称一致.   
    public UserPO findUser(Integer id);  
}  

最后，我想我们需要一些日志记录我们的程序运行过程，所以配置了log4j。

log4j.properties

[plain] view plaincopy
log4j.rootLogger=DEBUG , stdout  
log4j.logger.org.mybatis=DEBUG   
log4j.appender.stdout=org.apache.log4j.ConsoleAppender   
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout   
log4j.appender.stdout.layout.ConversionPattern=%5p %d %C: %m%n  

好了，让我们运行MainCh1.java文件，看看运行的结果如何。

[plain] view plaincopy
DEBUG 2015-03-25 23:35:38,484 org.apache.ibatis.logging.LogFactory: Logging initialized using 'class org.apache.ibatis.logging.slf4j.Slf4jImpl' adapter.  
DEBUG 2015-03-25 23:35:38,515 org.apache.ibatis.datasource.pooled.PooledDataSource: PooledDataSource forcefully closed/removed all connections.  
DEBUG 2015-03-25 23:35:38,515 org.apache.ibatis.datasource.pooled.PooledDataSource: PooledDataSource forcefully closed/removed all connections.  
DEBUG 2015-03-25 23:35:38,515 org.apache.ibatis.datasource.pooled.PooledDataSource: PooledDataSource forcefully closed/removed all connections.  
DEBUG 2015-03-25 23:35:38,515 org.apache.ibatis.datasource.pooled.PooledDataSource: PooledDataSource forcefully closed/removed all connections.  
DEBUG 2015-03-25 23:35:38,640 org.apache.ibatis.transaction.jdbc.JdbcTransaction: Opening JDBC Connection  
DEBUG 2015-03-25 23:35:38,953 org.apache.ibatis.datasource.pooled.PooledDataSource: Created connection 1414521932.  
DEBUG 2015-03-25 23:35:38,953 org.apache.ibatis.transaction.jdbc.JdbcTransaction: Setting autocommit to false on JDBC Connection [com.mysql.jdbc.JDBC4Connection@544fe44c]  
DEBUG 2015-03-25 23:35:38,953 org.apache.ibatis.logging.jdbc.BaseJdbcLogger: ==>  Preparing: select id, username, password, birthday, mobile, tel, email, note from t_user where id = ?   
DEBUG 2015-03-25 23:35:39,000 org.apache.ibatis.logging.jdbc.BaseJdbcLogger: ==> Parameters: 1(Integer)  
DEBUG 2015-03-25 23:35:39,046 org.apache.ibatis.logging.jdbc.BaseJdbcLogger: <==      Total: 1  
ykzhen  
DEBUG 2015-03-25 23:35:39,046 org.apache.ibatis.transaction.jdbc.JdbcTransaction: Resetting autocommit to true on JDBC Connection [com.mysql.jdbc.JDBC4Connection@544fe44c]  
DEBUG 2015-03-25 23:35:39,046 org.apache.ibatis.transaction.jdbc.JdbcTransaction: Closing JDBC Connection [com.mysql.jdbc.JDBC4Connection@544fe44c]  
DEBUG 2015-03-25 23:35:39,046 org.apache.ibatis.datasource.pooled.PooledDataSource: Returned connection 1414521932 to pool.  

好的结果很好，我们打出了MyBATIS的运行轨迹和我们想要的结果，更关键的是成功打印出了运行的SQL和相关参数，为我们调试提供了便利。

1.3、总结

笔者通过一个简单的图介绍了最为基本的MyBATIS的运行过程，同时提供了一个简单的例子并运行成功，让读者对MyBATIS有初步的认识，当然这是远远不够的，我们还需要进一步的认识MyBATIS才能更进一步的使用好这个框架，上述的应用还过于简易根本达不到在应用中使用mybatis的程度，不过千里之行始于足下，让我们走进MyBATIS的世界...

顶1踩

0 0