mybatis入门之Helloworld

r囧r小猫 2022-06-09 01:07 214阅读 0赞

Mybatis是一款优秀的持久层框架，支持定制化SQL、存储过程以及高级映射。

特点：

1、简单易学：只有一个jar包（很小），无任何第三方依赖，

2、灵活：sql语句写在xml配置文件里，便于统一管理和优化，

3、解除sql与代码的耦合：提高了可维护性。

首先从github上下载mybatis，下载地址：[https://github.com/mybatis/mybatis-3][https_github.com_mybatis_mybatis-3]

从浏览器上打开上面的地址后，看到下图，

![Center][]

点击 图中红框框，进入到下一页，如图：

![Center 1][]

一个是开发包mybatis.zip ,一个是源码包source code，下载下来以后，解压后如下图：

![Center 2][]

我们发现已有mybatis只有一个jar包，果然是小巧。

下面我们开始搭建我们的mybatis

新建一个java项目，项目结构如图：

![Center 3][]

导入mybatis-3.4.4.jar、mysql-connector-java-5.1.42-bin.jar、log4j-1.2.17.jar包

导入log4j-1.2.17.jar包是为了看日志使用。

Employee代码如：

package com.mybatis.model;
    
    public class Employee {
    	
    	private Integer id ;
    	private String lastName ;
    	private String email ;
    	private String gender ;
    	public Integer getId() {
    		return id;
    	}
    	public void setId(Integer id) {
    		this.id = id;
    	}
    	public String getLastName() {
    		return lastName;
    	}
    	public void setLastName(String lastName) {
    		this.lastName = lastName;
    	}
    	public String getEmail() {
    		return email;
    	}
    	public void setEmail(String email) {
    		this.email = email;
    	}
    	public String getGender() {
    		return gender;
    	}
    	public void setGender(String gender) {
    		this.gender = gender;
    	}
    	@Override
    	public String toString() {
    		return "Employee [id=" + id + ", lastName=" + lastName + ", email="
    				+ email + ", gender=" + gender + "]";
    	}
    	
    	
    }

我使用的是mysql数据库，新建一个mybatis名称的数据库，执行下面的代码，创建数据库表和添加数据：

DROP TABLE IF EXISTS `tb1_employee`;
    CREATE TABLE `tb1_employee` (
      `id` int(11) NOT NULL auto_increment,
      `last_name` varchar(255) default NULL,
      `gender` varchar(20) default NULL,
      `email` varchar(255) default NULL,
      PRIMARY KEY  (`id`)
    ) ENGINE=InnoDB AUTO_INCREMENT=2 DEFAULT CHARSET=utf8;
    
    INSERT INTO `tb1_employee` VALUES ('1','tom','0','123@qq.com');

log4j.xml代码：

<?xml version="1.0" encoding="UTF-8" ?>
    <!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
     
    <log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
     
     <appender name="STDOUT" class="org.apache.log4j.ConsoleAppender">
       <param name="Encoding" value="UTF-8" />
       <layout class="org.apache.log4j.PatternLayout">
        <param name="ConversionPattern" value="%-5p %d{MM-dd HH:mm:ss,SSS} %m  (%F:%L) \n" />
       </layout>
     </appender>
     <logger name="java.sql">
       <level value="debug" />
     </logger>
     <logger name="org.apache.ibatis">
       <level value="info" />
     </logger>
     <root>
       <level value="debug" />
       <appender-ref ref="STDOUT" />
     </root>
    </log4j:configuration>

EmployeeMapper.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="com.mybatis.model.Employee">
    	<select id="selectEmp" resultType="com.mybatis.model.Employee">
    		select id , last_name lastName , email , gender from tb1_employee where id = #{id}
    	</select>
    </mapper>

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>
    	<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/mybatis" />
    				<property name="username" value="root" />
    				<property name="password" value="input your passowrd" />
    			</dataSource>
    		</environment>
    	</environments>
    	
    	
    	<mappers>
    		<mapper resource="./conf/EmployeeMapper.xml" />
    	</mappers>
    </configuration>

MybatisTest.java代码：

package com.mybatis.test;
    
    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;
    import org.junit.Test;
    
    import com.mybatis.model.Employee;
    
    public class MybatisTest {
    
    	/**
    	 * 1、根据xml配置文件常见SqlSessionFactory
    	 * 2、
    	 * @throws IOException
    	 */
    	@Test
    	public void test() throws IOException {
    		String resource = "conf/mybatis-config.xml";
    		InputStream inputStream = Resources.getResourceAsStream(resource);
    		SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
    		//2、获取sqlSession实例，能直接执行已经映射的sql语句
    		SqlSession session = sqlSessionFactory.openSession() ;
    		/**
    		 * sql的唯一标识：EmployeeMapper.xml中的 namespace+id
    		 * 执行sql要调用的参数：
    		 */
    		try{
    			Employee e = session.selectOne("com.mybatis.model.Employee.selectEmp", 1) ;
    			System.out.println(e);
    		}finally {
    			session.close();
    		}
    	}
    
    }

需要说明的是MybatisTest.java是一个Junit Test Case，如图：

![Center 4][]

运行test测试代码，控制台打印如图：

![Center 5][]

到此为止，说明mybatis已经搭建成功了。

[https_github.com_mybatis_mybatis-3]: https://github.com/mybatis/mybatis-3
[Center]: /images/20220609/222b177e38ee4d548b9f4c9b7df7b149.png
[Center 1]: /images/20220609/ad1526d0a0d44bc7b08d5a6bfd00109d.png
[Center 2]: /images/20220609/8a48ace0dd33422f99cf1440d0f811a1.png
[Center 3]: /images/20220609/51b4803a10274e4da0d17c1f14684ed1.png
[Center 4]: /images/20220609/4ae3aa44e6364a35a5a37da1a9353d16.png
[Center 5]: /images/20220609/0853292ff7dc49929d42e1f561dc4ba8.png