Mybatis基础入门 I

作为ORM的重要框架，MyBatis是iBatis的升级版。Mybatis完全将SQL语句交给编程人员掌控，这点和Hibernate的设计理念不同（至于Hibernate的理念，待我先学习学习）。

下面的教程，是一个基于STS（也可以是eclipse，需要事先安装好maven）的一个入门级教程。下文分为两个部分，第一部门为简单版教程，第二部分是step-by-step教程。

Part one

简单教程：

新建maven工程。
添加mybatis和mysql包，以及log4j的包。
新建或者使用现存的数据库，并准备好若干语句。例如使用mysql的默认数据库world。
新建mybatis-config.xml配置文件，作为mybaits的基础配置。
新建POJO，City。
新建mapper文件：city.xml，进行配置。
新建Interface，CityMapper，对应city.xml的方法。
新建Class: CityService，并implemente CityMapper，实现各种方法。
新建Class：MyBatisSqlSessionFactory，用户获取mybatis的session
新建测试文件，进行测试。

--完--

Part two

这部分对第一部分进行细化，并配以图片说明：

详细教程：

新建maven工程。
- 选择新建工程，选择maven项目
- 选择quickStart类型的maven：
- 输入Group Id和Artifact Id并完成工程：
添加mybatis和mysql包，以及log4j的包。
- 编辑pom.xml文件，添加以下包：
  
  其中红框内的为必选，其余随意。
其pom.xml文件如下：

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">

  <modelVersion>4.0.0</modelVersion>

  <groupId>jacob</groupId>

  <artifactId>mybatisdemo</artifactId>

  <version>0.0.1-SNAPSHOT</version>

  <packaging>jar</packaging>

  <name>mybatisdemo</name>

  <url>http://maven.apache.org</url>

  <properties>

    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>

  </properties>

  <dependencies>

    <dependency>

      <groupId>junit</groupId>

      <artifactId>junit</artifactId>

      <version>3.8.1</version>

      <scope>test</scope>

    </dependency>

    <dependency>

        <groupId>org.mybatis</groupId>

        <artifactId>mybatis</artifactId>

        <version>3.2.3</version>

    </dependency>

    <dependency>

        <groupId>mysql</groupId>

        <artifactId>mysql-connector-java</artifactId>

        <version>5.1.27</version>

    </dependency>

    <dependency>

        <groupId>org.slf4j</groupId>

        <artifactId>slf4j-api</artifactId>

        <version>1.7.5</version>

    </dependency>

    <dependency>

        <groupId>org.slf4j</groupId>

        <artifactId>slf4j-log4j12</artifactId>

        <version>1.7.5</version>

    </dependency>

    <dependency>

        <groupId>log4j</groupId>

        <artifactId>log4j</artifactId>

        <version>1.2.17</version>

        <scope>runtime</scope>

    </dependency>

  </dependencies>

</project>

- 　　整个工程的目录如下：
　　新建或者使用现存的数据库，并准备好若干语句。例如使用mysql的默认数据库world。
这是个现成的数据库（懒得新建一个），本教程只用到其中的一张表，表结构如下：

新建mybatis-config.xml配置文件，作为mybaits的基础配置。

在src/main/resources中新建文件：mybatis-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 alias="City" type="jacob.domain.City" />

    </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://localhost:3306/world" />

                <property name="username" value="root" />

                <property name="password" value="111111" />

            </dataSource>

        </environment>

    </environments>

    <mappers>

        <mapper resource="jacob/mapper/city.xml" />

    </mappers>

</configuration>

逐一解释：

新建POJO，City。

POJO的意思是：Plain Old Java Object，简单的说，就是一个普通的Java Bean。

该Bean的内容对应于city表。

文件如下：

 package jacob.domain;

 public class City {

     int id;

     String name;

     String countryCode;

     String district;

     int population;

     public int getId() {

         return id;

     }

     public void setId(int id) {

         this.id = id;

     }

     public String getName() {

         return name;

     }

     public void setName(String name) {

         this.name = name;

     }

     public String getCountryCode() {

         return countryCode;

     }

     public void setCountryCode(String countryCode) {

         this.countryCode = countryCode;

     }

     public String getDistrict() {

         return district;

     }

     public void setDistrict(String district) {

         this.district = district;

     }

     public int getPopulation() {

         return population;

     }

     public void setPopulation(int population) {

         this.population = population;

     }

 }

新建mapper文件：city.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="jacob.mapper.CityMapper">

     <resultMap type="City" id="CityResult">

         <id property="id" column="ID" />

         <result property="name" column="name" />

         <result property="countryCode" column="CountryCode" />

         <result property="district" column="District" />

         <result property="population" column="Population" />

     </resultMap>

     <select id="selectCity" parameterType="int" resultMap="CityResult">

         select *

         from city where id = #{id}

     </select>

     <select id="selectAll" resultType="City">

         select * from city;

     </select>

 </mapper>

解释如下：

新建Interface，CityMapper，对应city.xml的方法。

代码如下：

 package jacob.mapper;

 import java.util.List;

 import jacob.domain.City;

 public interface CityMapper {

     City selectCity(int id);

     List<City> selectAll();

 }

新建Class: CityService，并implemente CityMapper，实现各种方法。

代码如下：

 package jacob.services;

 import java.util.List;

 import jacob.domain.City;

 import jacob.mapper.CityMapper;

 import jacob.mybatisdemo.MyBatisSqlSessionFactory;

 import org.apache.ibatis.session.SqlSession;

 import org.slf4j.Logger;

 import org.slf4j.LoggerFactory;

 public class CityService implements CityMapper {

     private Logger logger = LoggerFactory.getLogger(getClass());

     public City selectCity(int id) {

         SqlSession sqlSession = MyBatisSqlSessionFactory.openSession();

         try {

             CityMapper cityMapper = sqlSession.getMapper(CityMapper.class);

             return cityMapper.selectCity(id);

         } finally {

             sqlSession.close();

         }

     }

     public List<City> selectAll() {

         SqlSession sqlSession = MyBatisSqlSessionFactory.openSession();

         try {

             CityMapper cityMapper = sqlSession.getMapper(CityMapper.class);

             return cityMapper.selectAll();

         } finally {

             sqlSession.close();

         }

     }

 }

新建Class：MyBatisSqlSessionFactory，用户获取mybatis的session

 package jacob.mybatisdemo;

 import java.io.IOException;

 import java.io.InputStream;

 import org.apache.ibatis.io.Resources;

 import org.apache.ibatis.session.SqlSession;

 import org.apache.ibatis.session.SqlSessionFactory;

 import org.apache.ibatis.session.SqlSessionFactoryBuilder;

 public class MyBatisSqlSessionFactory {

     private static SqlSessionFactory sqlSessionFactory;

     public static SqlSessionFactory getSqlSessionFactory() {

         if (sqlSessionFactory == null) {

             InputStream inputStream;

             try {

                 inputStream = Resources

                         .getResourceAsStream("mybatis-config.xml");

                 sqlSessionFactory = new SqlSessionFactoryBuilder()

                         .build(inputStream);

             } catch (IOException e) {

                 e.printStackTrace();

             }

         }

         return sqlSessionFactory;

     }

     public static SqlSession openSession(){

         return getSqlSessionFactory().openSession();

     }

     public static void main(String[] args) {

         // TODO Auto-generated method stub

     }

 }

新建测试文件，进行测试。

 package jacob.mybatisdemo;

 import java.util.List;

 import jacob.domain.City;

 import jacob.services.CityService;

 public class App {

     public static void main(String[] args) {

         CityService cityService = new CityService();

         City result = cityService.selectCity(2);

         System.out.println(result.getName());

         List<City> list = cityService.selectAll();

         for (City c : list) {

             System.out.println(c.getName());

         }

     }

 }

输出结果：

文章以贴代码为主。工程下载地址：https://www.dropbox.com/s/w3j5jhy3lc12hzt/mybatisdemo.zip，请继续关注。

后续将整合spring，使用mybatis-generator来生成绝大多数的代码。