MyBatis 实战-使用 maven 构建（1）- 面向字符串编程

MyBatis 实战-使用 maven 构建（1）- 面向字符串编程

说明：今天我使用 maven 项目重新做了一个 MyBatis 的 HelloWorld 练习。主要练习使用字符串编程的方式调用 MyBatis 的配置文件。
项目结构如下：

下面是简要的步骤：
1、pom 文件引入依赖

<dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.12</version>
      <scope>test</scope>
    </dependency>
    <dependency>
      <groupId>org.mybatis</groupId>
      <artifactId>mybatis</artifactId>
      <version>3.3.0</version>
    </dependency>
    <dependency>
      <groupId>mysql</groupId>
      <artifactId>mysql-connector-java</artifactId>
      <version>5.1.36</version>
    </dependency>
  </dependencies>

2、mybaitsi-config.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>

    <typeAliases>
        <typeAlias type="com.liwei.mybatis.model.User" alias="User"></typeAlias>
    </typeAliases>

    <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://127.0.0.1:3306/mybatisinaction"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>

    <mappers>
        <mapper resource="com/liwei/mybatis/model/User.xml"/>
    </mappers>
</configuration>

3、实体类

public class User {

    private int id;
    private String userName;
    private String userAge;
    private String userAddress;


    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getUserName() {
        return userName;
    }

    public void setUserName(String userName) {
        this.userName = userName;
    }

    public String getUserAge() {
        return userAge;
    }

    public void setUserAge(String userAge) {
        this.userAge = userAge;
    }

    public String getUserAddress() {
        return userAddress;
    }

    public void setUserAddress(String userAddress) {
        this.userAddress = userAddress;
    }


    @Override
    public String toString() {
        return "User{" +
                "id=" + id +
                ", userName='" + userName + '\'' +
                ", userAge='" + userAge + '\'' +
                ", userAddress='" + userAddress + '\'' +
                '}';
    }
}

4、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.liwei.mybatis.hello">

    <select id="selectUserByID" parameterType="int" resultType="User">
        select * from `user` where id = #{id}
    </select>


</mapper>

5、测试代码

package com.liwei.mybatis;


import com.liwei.mybatis.model.User;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.junit.Test;


import java.io.IOException;
import java.io.Reader;

/**
 * Unit test for simple App.
 */
public class Test01 {

    private static SqlSessionFactory sqlSessionFactory;
    private static Reader reader;


    static{
        try {
            reader = Resources.getResourceAsReader("mybaitsi-config.xml");
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(reader);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    /**
     * 以字符串的方式编程
     */
    @Test
    public void test01(){

        SqlSession session = sqlSessionFactory.openSession();
        try {
            User user =  session.selectOne("com.liwei.mybatis.hello.selectUserByID",1);
            System.out.println("user => " + user);
        } finally {
            session.close();
        }

    }



}

以下是原博客内容：

---

写在前面的话：
昨天下午回公司，在网上闲逛的时候，发现了这个系列文章。现在先给出出处。
mybatis实战教程(mybatis in action),mybatis入门到精通 - 一号门-程序员的工作,程序员的生活(java,python,delphi实战)
http://www.yihaomen.com/article/java/302.htm
在这里特别说明一下，我只是一个搬运工、编辑。我按照上面给出的文章，自己敲打了一遍，对于原文的内容作了一点点调整。在此特别感谢这个系列文章的原创作者。

Mybatis实战教程（mybatis in action）之一：开发环境搭建

Mybatis 的开发环境搭建，选择： eclipse j2ee 版本、mysql 5.1 、jdk 1.7、mybatis3.2.0.jar包。这些软件工具均可以到各自的官方网站上下载。
首先建立一个名字为 MyBaits 的 dynamic web project 。
1、 现阶段，你可以直接建立 Java 工程，但一般都是开发 web 项目，这个系列教程最后也是 web 的，所以一开始就建立web工程；
2、将 mybatis-3.2.0-SNAPSHOT.jar，mysql-connector-java-5.1.22-bin.jar 拷贝到 web工程的lib目录；
3、创建 mysql 测试数据库和用户表，注意，这里采用的是 utf-8 编码。

创建用户表，并插入一条测试数据。

# 1、初始化、建立数据库，插入数据表
create table `user` (
  `id` int(11) not null auto_increment,
  `username` varchar(50) default null,
  `userage` int(11) default null,
  `useraddress` varchar(200) default null,
  primary key (`id`)
) engine=innodb auto_increment=2 default charset=utf8;


insert into `user` values ('1', 'summer', '100', 'shanghai,pudong');

到此为止，前期准备工作就完成了，下面开始真正配置mybatis项目了。
1、在 MyBatis 里面创建两个源码目录，分别为 src（默认就有）、test, 用如下方式建立，鼠标右键点击 Source Folder；
2、设置 Mybatis 配置文件：Configuration.xml，在 src 目录下建立此文件，内容如下:
3、建立 User 类和对应的 xml 映射文件，具体代码：

package com.liwei.mybatis.model;

public class User {
    private int id;
    private String userName;
    private String userAge;
    private String userAddress;
    public int getId() {
        return id;
    }
    public void setId(int id) {
        this.id = id;
    }
    public String getUserName() {
        return userName;
    }
    public void setUserName(String userName) {
        this.userName = userName;
    }
    public String getUserAge() {
        return userAge;
    }
    public void setUserAge(String userAge) {
        this.userAge = userAge;
    }
    public String getUserAddress() {
        return userAddress;
    }
    public void setUserAddress(String userAddress) {
        this.userAddress = userAddress;
    }

}

<?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.liwei.mybatis.models.UserMapper">
    <select id="selectUserByID" parameterType="int" resultType="User">
        select * from `user` where id = #{id}
    </select>
</mapper>

下面对这几个配置文件解释下：
1、Configuration.xml文件的重要作用
Mybatis 用来建立 SessionFactory 用的，里面主要包含了数据库连接相关东西，还有 Java 类所对应的别名，比如

<typeAlias alias="User" type="com.liwei.mybatis.model.User"/> 

这个别名非常重要，你在具体的类的映射中，比如 User.xml 中 resultType 就是对应这里的。要保持一致，当然这里的 resultType 还有另外单独的定义方式，后面再说。
2、Configuration.xml
里面的<mapper resource="com/liwei/mybatis/model/User.xml"/>是包含要映射的类的 xml 配置文件；
3、在 User.xml 文件里面主要是定义各种 SQL 语句，以及这些语句的参数，以及要返回的类型等。

下面开始测试，在 test 源码目录下建立 com.liwei.test 这个 package ，并建立测试类 Test：

package com.liwei.test;

import java.io.IOException;
import java.io.Reader;

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

import com.liwei.mybatis.model.User;

public class Test {

    private static SqlSessionFactory sqlSessionFactory;
    private static Reader reader;

    static {
        try {
            reader = Resources.getResourceAsReader("Configuration.xml");
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(reader);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }


    public static void main(String[] args) {
        SqlSession session = sqlSessionFactory.openSession();
        try {
            User user = (User) session.selectOne(
                    "com.liwei.mybatis.models.UserMapper.selectUserByID", 1);
            System.out.println(user.getUserAddress());
            System.out.println(user.getUserName());
        } finally {
            session.close();
        }

    }
}

现在运行这个程序，得到查询结果了。至此环境搭建配置成功，接下来第二章，将讲述基于接口的操作方式，增删改查。
整个工程目录结构如下：