Java框架之Mybatis（一）

一、Mybatis 简介

Mybatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code，并且改名为Mybatis  , 2013年11月迁移到Github , iBATIS一词来源于“internet”和“abatis”的组合，是一个基于Java的持久层框架。iBATIS提供的持久层框架包括SQL Maps和Data Access Objects（DAO）Mybatis 是支持普通 SQL查询，存储过程和高级映射的优秀持久层框架。Mybatis 消除了几乎所有的JDBC代码和参数的手工设置以及结果集的检索。Mybatis 使用简单的 XML或注解用于配置和原始映射，将接口和 Java 的POJOs（Plain Old Java Objects，普通的 Java对象）映射成数据库中的记录。

二、Mybatis 的执行框架

1) SqlMapConfig.xml 文件 //名称不一定是这个名称 类似hibernate中的主配置文件

主配置文件 配置数据源,事务等运行环境,配置映射文件 (xxXmapper.xml... 多个)

2) SessionFactory

会话工厂,它是根据配置文件创建的,用来创建  SqlSession

3) SqlSession

会话 ,是一个接口,面向用户的接口,主要用来进行数据库操作

4) Executor

执行器,是底层封装的一个对象,是一个接口(底层有两个实现,基本执行器,缓存执行器)事实上 SqlSession 的内部就是通过该接口来执行sql语句的

5) MappedStatement 底层封装的对象,封装sql ,输入参数,输出结果类型等

三、第一个hello world 程序

1) 导包

asm-3.3.1.jar

cglib-2.2.2.jar

commons-logging-1.1.1.jar

javassist-3.17.1-GA.jar

log4j-1.2.17.jar

log4j-api-2.0-rc1.jar

log4j-core-2.0-rc1.jar

Mybatis-3.2.6.jar

slf4j-api-1.7.5.jar

slf4j-log4j12-1.7.5.jar

2) 在config里建一个配置文件(数据库相关的) mydbconfig.properties , 内容如下

db.driver=com.mysql.jdbc.Driver
db.url=jdbc:mysql://localhost:3306/shop
db.username=admin
db.password=root

3) 建立 SqlMapConfig.xml

<?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>
                <properties resource="mydbconfig.properties" />
                
                <environments default="development">
                    <environment id="development">
                        <transactionManager type="JDBC" />
                        <dataSource type="POOLED">  //POOLED指的是org.apache.ibatis.datasource.pooled.PooledDataSource, 一个数据源的实现类  
                            <property name="driver" value="${db.driver}" />
                            <property name="url" value="${db.url}" />
                            <property name="username" value="${db.username}" />
                            <property name="password" value="${db.password}" />
                        </dataSource>
                    </environment>
                </environments>
            
                 <mappers>
                    <mapper resource="sqlmap/UserInfo.xml" />
                </mappers>
            </configuration>   

4) 编写映射文件 (其实就是bean 对应的映射文件 相当于 hibernate 中的 UsesrInfo.hbm.xml 之类的 )

命名规则 :

== UserInfo.xml  //过去的ibatis中

== 如果使用了mapper 代理  命名规则变为  UserInfoMapper.xml

 //UserInfo.xml
<?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="test">
                    <select id="getuser_byid"  parameterType="int" resultType="cat.beans.UserInfo" >
                        select * from userInfo where id=#{id}  //如是简单类型,id可以写成任意名字
                    </select>
</mapper>

说明: namespace 是命名空间,用来对sql进行隔离 ,注意,如果使用mapper代理的方式开发,它就有特殊的作用

-- <select id="getuser_byid" ... > 这个id 就是sql的标识,其实将来要封装到 MappedStatement 中

-- #{ } 代表占位

--  如是参数是简单类型,{} 中的名字可以任意

--  resultType 表示返回的java对象的类型,表示要将查询结果映射成什么样的java对象

5) 在主配置文件中引入这个映射文件

主配置文件中加入

<mappers>
         <mapper resource="sqlmap/UserInfo.xml" />
</mappers>
//上面的主配置文件中其实已经加入了

6）测试

static void test(){
//加载主配置文件
            InputStream in=Test.class.getClassLoader().getResourceAsStream("SqlMapConfig.xml");
            //InputStream in= Resources.getResourceAsStream("SqlMapConfig.xml");    //Resources是mhybatis 提供的
                
            SqlSessionFactory factor=new SqlSessionFactoryBuilder().build(in);
            SqlSession session =factor.openSession();
                
                                                   //第一个参数,是sql的id (是映射文件中的statement的id) = 名称空间+sql的id名称 ,
            UserInfo user=session.selectOne("test.getuser_byid",1); //注意,这里的1 不能定成 "1"
            System.out.println(user);
            session.close();        
            }

在上例的基础上,再添一个模糊查询的例子 

在 UserInfo.xml 中 加入

<select id="getuser_biname" parameterType="string" resultType="cat.beans.UserInfo">
//select * from userInfo where userName  like #{value}   //不行,  它会拼成like '张三'
select * from userInfo where userName like  '%${value}%'  // ${value} 表示会把传过来的值,直接拼到串上,有可能有sql注入问题,而且
// 如果parameterType 是简单类型,则${ } 中间的必须写成 value
</select>

static void test() throws IOException{
                    InputStream in= Resources.getResourceAsStream("SqlMapConfig.xml");
                    SqlSessionFactory factor=new SqlSessionFactoryBuilder().build(in);
                    SqlSession session =factor.openSession();
                    
                    UserInfo user=session.selectOne("test.getuser_byid",1); //注意,这里的1 不能定成 "1"
                    System.out.println(user);
                    
                    session.close();
                    
                }

总结：

#{} Mybatis 将  #{} 解释为jdbc PreparedStatement  的一个参数标记  // 就是 select * from t where id= ? 中的 ?

${} 将它直接解释为字符串

理解这两者的区别是很有用的, 因为在某些SQL语句中并不能使用参数标记(parameter markers)。

那如果有like查询要怎么办呢? 可以这样sql写成第一种 #{} ,传参的时候如下   

"%张三%"
selectOne   //返回一个对象
selectList  //返回一组对象 两者 resultType="cat.beans.UserInfo" 都正常

在上例的基础上,再增加一个添加用户的功能

//对于添加这类方法,是没有resultType的
<insert id="add_user" parameterType="cat.beans.UserInfo"  >
        insert into userInfo (userName,password,note) values (#{userName},#{password}, #{note} ) //后面不要写上分号
</insert>
        tatic void test3() throws IOException{
                        
                        InputStream in= Resources.getResourceAsStream("SqlMapConfig.xml");
                        SqlSessionFactory factor=new SqlSessionFactoryBuilder().build(in);
                        SqlSession session =factor.openSession();
                        
                        UserInfo user=new UserInfo();
                        user.setUserName("陈鹏飞");
                        user.setPassword("admin");
                        user.setNote("这是备注");
                        
                        int result=session.insert("test.add_user",user); 
     
                        // 对于inser,虽然没有为sql声明反回类型,但也能正确的取到反回值的,它是整型
                        
                        session.commit(); //不要忘了提交事务
                        System.out.println(result); //能得到正确的值  1
                        
                        session.close();
                    }

在上面的基础上,再添加删除的和修改的功能

<delete id="deluser_byid" parameterType="int" > 
                    delete from userInfo where id=#{id}
                </delete>
                
                <update id="update_user" parameterType="cat.beans.UserInfo" > <!-- 传过来的userInfo对象中要有id -->
                   update userInfo set userName= #{userName},password= #{password}, note =#{note} where id= #{id}
                </update>

//修改
                    static void test4() throws IOException{
    
                        InputStream in= Resources.getResourceAsStream("SqlMapConfig.xml");
                        SqlSessionFactory factor=new SqlSessionFactoryBuilder().build(in);
                        SqlSession session =factor.openSession();
                        
                        UserInfo user=session.selectOne("test.getuser_byid",1);
                        user.setUserName("english"); 
                        user.setPassword("englishxxx");
                        user.setNote("englishxxx");
                      int result= session.update("test.update_user",user);
                      session.commit();
                      System.out.println("修改成功: " + result);
                        
                        session.close();
                    }
                    
                 //删除
                    static void test5() throws IOException{
                        InputStream in= Resources.getResourceAsStream("SqlMapConfig.xml");
                        SqlSessionFactory factor=new SqlSessionFactoryBuilder().build(in);
                        SqlSession session =factor.openSession();
                        int result= session.delete("test.deluser_byid",10);
                        session.commit();
                        System.out.println("删除成功: " + result);
                        session.close();
                    }

四、返回自增主键

mysql 有一个函数 last_insert_id() 可以调用它得到最后一条插入语句生成的自增主键。

在上面的用户添加的例子上

<insert id="add_user" parameterType="cat.beans.UserInfo"  >
        <selectKey order="AFTER" keyProperty="id" resultType="int">   //resultType 必填 keyProperty的id 就是userInfo.id
                      select  last_insert_id()
                     //elect new uuid();  //这是mysql生成uui的写法 (32位数字或字母,4位是 -)  如果这样,上面的AFTER要改成before
                     //select 序列名.nextval 这是oracle中的写法
       </selectKey>
                insert into userInfo (userName,password,note) values (#{userName},#{password}, #{note} ) 
</insert>

说明：

order="AFTER" 指的是 要在这条语句执行之后取得生成的主键,它还有另一个取值 BEFORE

非自增主键，想取得,要用BEFORE,但生成主键的方式应该是上面的红色的注起来的方式。

注意，如果用的是后面的方式,则下面的sql要写上id

例子：生成 uuid型的主键

 <insert id="add_user_new" parameterType="cat.beans.UserInfo"  >
                <selectKey order="BEFORE" keyProperty="id" resultType="string">   //注意返回类型,注意前面要写成 BEFORE
                    select  uuid()
                </selectKey>
                insert into userInfo (id,userName,password,note) values (#{id},#{userName},#{password}, #{note} ) 
                //注意要把id这列也写上
            </insert>
            
                UserInfo user=new UserInfo();
            //user.setId() 不用写了,因为主键由Mybatis生成
                
                user.setUserName("郑某某");
                user.setPassword("admin");
                user.setNote("这是备注");
                
                session.insert("test.add_user_new",user);
                session.commit(); 
    
                System.out.println(user.getId());  //可以取到主键 369010c6-e631-1033-b927-e281dfdaa6b0

五、dao层的开发

SessionFactory 可以做成单例 (未来会交给Spring管理)

SqlSession  是线程不安全的, 用的时候,要在方法体内 , 这样它就是一个局部变量,千万不要把它写成类成员

Mybatis 开发DAO 有两种方式

原始的方式 ,手写dao 和实现类

//接口 :
public interface IUserDao {
                    int addUser(UserInfo user);
                    UserInfo getUserById(int id);
                }
                
//实现类
public class UserDaoImplTest {
                    private IUserDao _dao ;
                    @Before
                    public void setUp() throws Exception {
                        InputStream in= Resources.getResourceAsStream("SqlMapConfig.xml");
                        SqlSessionFactory factor=new SqlSessionFactoryBuilder().build(in);
                        _dao=new UserDaoImpl(factor);
                    }
                
                    @Test
                    public void testAddUser() {
                        UserInfo user=new UserInfo();
                        user.setUserName("周周");
                        user.setPassword("admin");
                        
                        int result=_dao.addUser(user);
                        System.out.println("ok"+result);
                    }
                
                    @Test
                    public void testGetUserById() {
                        UserInfo user=_dao.getUserById(2);
                        System.out.println(user);
                    }
                
                }

测试用例

使用 mapper 代理的方式  ,只需要mapper接口 (相当于dao接口)

public class UserDaoImpl implements IUserDao {
                private SqlSessionFactory _factory;
                
                public UserDaoImpl(SqlSessionFactory factory){
                    this._factory=factory;  //由外界注入 SqlSessionFactory
                }
                
                //添加用户
                public int addUser(UserInfo user) {
                    SqlSession s =_factory.openSession();
                    int result=s.insert("test.add_user",user);
                    s.commit();
                    return result;
                }
            
                //查询用户
                public UserInfo getUserById(int id) {
                    SqlSession s =_factory.openSession();
                    UserInfo user=s.selectOne("test.getuser_byid",id);
                    s.commit();
                    return user;
                }
            
            }

配置文件

<mapper namespace="test">
                <select id="getuser_byid"  parameterType="int" resultType="cat.beans.UserInfo" >
                    select * from userInfo where id=#{id} 
                </select>
                
                <insert id="add_user" parameterType="cat.beans.UserInfo"  >
                    <selectKey order="AFTER" keyProperty="id" resultType="int">  
                        select  last_insert_id()
                    </selectKey>
                    insert into userInfo (userName,password,note) values (#{userName},#{password}, #{note} ) 
                </insert>
                
                 ... 其他的略
                 
            </mapper>