学习笔记_J2EE_Mybatis_02_mybatis注解配置入门

---

mybatis入门示例 声明式

---

1.概述

　　mybatis的注解配置版，为了偷懒，直接在之前xml版本的文件上修改的；同样为了偷懒，今天只写示例V1.0版基础配置版 ，后面再更新细节。    一个不偷懒的程序员，不是好厨子。

　　1.1 测试环境说明

　　　　

名称	版本	备注
操作系统	windows 10 专业版 1809_X64
JDK	jdk1.8.0_121 WIN_X64
数据库	mysql5.7  WIN_X64

　　

---

2.入门示例

　　2.1.1 示例流程简述

 

　　　　　　第一步：导入包（任何框架需要的事情）：mybatis的支撑包和数据库的JDBC支撑包

　　　　　　第二步：创建总配置文件，文件名随便写，（如果使用properties文件作为数据库对象的信息文件，则先建立一个对应的db.properties文件）

　　　　　　第三步：创建一个MybatisUtils工具类，（获得操作对象）

　　　　　　第四步：创建一个映射接口

　　　　　　第五步：在映射接口上声明映射关系

　　　　　　第六步：在总配置文件加载映射类。

　　　　　　第七步：编写测试代码

　　　2.1.2 目录架构

　　　　　　特别说明：XML版的目录有感叹号，因为加入了两个mysql架包，其中有一个是缓存文件，是因为这个无效所以另外加了一个有效的，所以存在两个，删掉了就好了。

　　　　　　

　　　2.1.3 操作示例

　　　　

　　　　　　2.1.3.1 导入包 /MybatisDemo/lib

　　　　　　　　　　（A） mybatis框架支撑包   mybatis-3.4.1.jar

　　　　　　　　　　　　　　下载地址：http://www.mybatis.cn/82.html

　　　　　　　　　　（B） MYSQL数据库JDBC支撑包   mysql-connector-java-5.1.47.jar

　　　　　　　　　　　　　　下载地址：http://dev.mysql.com/downloads/connector/   >> Connector/J  >>  选择对应版本  >>到这就不需要我说了吧

　　　　　　　　　　我这里使用的是mysql数据库，所以导入的是mysql的JDBC支撑包

　　　　　　　

　　　　　　2.1.3.2 创建db.properties数据库链接信息文件/MybatisDemo/src/db.properties

　

1 2 3 4

db.driver=org.gjt.mm.mysql.Driver db.url=jdbc:mysql://localhost:3306/mybatisdb db.username=root db.password=123456

　　　　　　2.1.3.3 创建mybatis主配置文件xxx.XML，并加载数据库配置    文件名自便，示例：/MybatisDemo/src/mybatis.xml

　　　　

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "mybatis-3-config.dtd" >
<configuration>
  <!-- 指定properties配置文件的路径 -->
  <properties resource="db.properties"></properties>
  <!-- 配置数据库连接 -->
  <environments default="mysql">
     <environment id="mysql">

       <transactionManager type="JDBC"></transactionManager>

       <dataSource type="POOLED">
          <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>
</configuration>

　　

　　　　　　2.1.3.4 创建一个MybatisUtils工具类/MybatisDemo/src/cn/slm/util/MybatisUtils.java

　　　　　　　　

package cn.slm.util;

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;

public class MybatisUtils {
	// 注意：基于如果出现多个会话工厂，可能导致事务不同步的问题，所以我们一个项目只使用一个会话工厂
		public static final SqlSessionFactory SSF = createSqlSessionFactory();
		// 需求：实现同一条线程，使用的session是相同的。线程绑定,
		// 创建一个线程绑定变量，将变量放在该对象里面，表示对象同一条线程共享
		private static final ThreadLocal<SqlSession> threadLocal = new ThreadLocal<SqlSession>();

		// 1.获得会话工厂
		private static SqlSessionFactory createSqlSessionFactory() {
			try {
				// 1.返回一个Reader对象
				Reader reader = Resources.getResourceAsReader("mybatis.xml");
				SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
				SqlSessionFactory sessionFactory = builder.build(reader);
				return sessionFactory;

			} catch (IOException e) {
				// TODO Auto-generated catch block
				e.printStackTrace();
			}
			return null;
		}

		// 2.获得操作对象，SqlSession对象

		public static SqlSession getSqlSession() {
			//1.判断线程变量里面是否已经有值
			if (threadLocal.get() == null) {
				//2.如果没有值，那么创建一个session对象设置在线程变量里面
				SqlSession session = SSF.openSession();
				threadLocal.set(session);
			}
			//3.返回线程变量里面的session对象
			return threadLocal.get();
		}

		public static void main(String[] args) {
			//同一条线程。对象一样
			//注意事项：如果对象是一个静态的属性的碎屑，意味着，整个系统共用一个对象
			//如果放在ThreadLocal对象里面，仅仅是当前线程共用该对象
			System.out.println(MybatisUtils.getSqlSession());
			System.out.println(MybatisUtils.getSqlSession());
		}

}

　　

　　　　　　2.1.3.5 创建一个映射接口/MybatisDemo/src/cn/slm/mapper/StudentMapper.java

　　　　　　　　

package cn.slm.mapper;

import org.apache.ibatis.annotations.Update;

import cn.slm.pojo.Student;

public interface StudentMapper {
// 需求：实现插入数据到student表
// 注意：如果是增删改操作，返回的类型必须是int类型
// 返回的是操作影响的行数。
int insert(Student student);

int update(Student student);
}

　　

　　

　　　　　　2.1.3.6 在映射接口上声明映射关系及设置接口对应sql语句

　　　　　　

package cn.slm.mapper;

import org.apache.ibatis.annotations.Insert;
import org.apache.ibatis.annotations.Options;
import org.apache.ibatis.annotations.Update;

import cn.slm.pojo.Student;

public interface StudentMapper {
	/**
	 * 新增学生
	 * Options 设置附加选项   设置自动回填字段  studentId
	 * 		可选的常用用操作有：@Insert 添加@Update 修改@Delete 删除@Select  查询
	 * @param student
	 * @return
	 */
	@Insert("INSERT INTO tb_student(STUDENT_NAME, STUDENT_PWD, STUDENT_STATUS, CREATE_DATE, STUDENT_ACCOUNT)	VALUES (#{studentName}, #{studentPwd}, #{studentStatus}, #{createDate}, #{studentAccount})")
	@Options(useGeneratedKeys = true, keyProperty = "studentId")
	int insert(Student student);

	/**
	 * 修改学生信息
	 * 		#{stuName}  属性名    与Student类的属性名保持一致       #{属性名} 自动从student中映射类属性的值
	 * 		stu_name	字段名	与数据库库表中的字段名保持一致
	 * 		tb_student  表名		与所操作的数据库表表名保持一致
	 * @param student
	 * @return
	 */
	@Update("update tb_student set stu_name =#{stuName},stu_age=#{stuAge},stu_password=#{stuPassword} where stu_id=#{stuId}")
	int update(Student student);
}

　　

　　　　　　2.1.3.7 在总配置文件加载映射文件 /MybatisDemo/src/mybatis.xml

　　　　

<!-- 加载映射关系 -->
<mappers>
<!-- 映射类 适用于注解配置 -->
　　<mapper class="cn.slm.mapper.StudentMapper"/>
<!-- 映射文件 适用于xml配置 -->
<!-- <mapper resource="cn/slm/mapper/xml/StudentMapper.xml"/> -->
</mappers>

　　

　　　　　　　　　　完整xml文件：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "mybatis-3-config.dtd" >
<configuration>
  <!-- 指定properties配置文件的路径 -->
  <properties resource="db.properties"></properties>
  <!-- 配置数据库连接 -->
  <!--
    environments:环境集，可以在里面配置多个environment，一个environment对应一个数据库连接
    mybatis支持配置多个数据库连接，但是只能执行一个
    default属性：作用就是指定默认执行的数据库连接environment标签的id属性

   -->
  <environments default="mysql">
     <environment id="mysql">
       <transactionManager type="JDBC"></transactionManager>
       <!-- dataSource：配置数据源 

            typeAliasRegistry.registerAlias("JNDI", JndiDataSourceFactory.class);
    		typeAliasRegistry.registerAlias("POOLED", PooledDataSourceFactory.class);
    		typeAliasRegistry.registerAlias("UNPOOLED", UnpooledDataSourceFactory.class);
    		JNDI：使用JNDI的数据源，就是在WEB服务器配置一个数据库连接池，如再TOMCAT里面配置一个数据源。就是JNDI数据源
    		POOLED：使用数据库连接池，Mybatis内置默认有一个简单的内置连接池
    		UNPOOLED：不使用数据库连接，直接使用数据库JDBC直连

       -->

       <dataSource type="POOLED">
          <!-- 静态属性都在三个地方
            1.属性名
            2.属性值
            3.Set方法
           -->
          <!-- 驱动 -->
          <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 class="cn.slm.mapper.StudentMapper"/>
    <!-- 映射文件 适用于xml配置 -->
    <!-- <mapper resource="cn/slm/mapper/xml/StudentMapper.xml"/> -->
  </mappers>

</configuration>

　　

　　　　　　2.1.3.8 编写测试代码 cn.slm.test.MybatisTest.update()

　　　　　　　　

package cn.slm.test;

import org.apache.ibatis.session.SqlSession;
import org.junit.Test;

import cn.slm.mapper.StudentMapper;
import cn.slm.pojo.Student;
import cn.slm.util.MybatisUtils;

public class MybatisTest {
	@Test
	public void insert(){
		//1.获得操作对象，session
		SqlSession session = MybatisUtils.getSqlSession();
		//2.获得操作接口的动态对象
		StudentMapper studentMapper = session.getMapper(StudentMapper.class);
		Student student=new Student();
		student.setStuName("陈七");
	    //3.插入对象
		int count = studentMapper.insert(student);
		//4.提交事务
		session.commit();
		//5.关闭
		session.close();
		System.out.println("数据库库受影响记录数："+count);
		//需求：实现ID回填，就是插入数据后要将数据库的ID设置在实体类对象里面
		System.out.println("ID："+student.getStuId());
	}

	@Test
	public void update(){
		//1.获得操作对象，session
		SqlSession session = MybatisUtils.getSqlSession();
		//2.获得操作接口的动态对象
		StudentMapper studentMapper = session.getMapper(StudentMapper.class);
		Student student=new Student();
		student.setStuId("1");
		student.setStuName("周六");
		student.setStuAge("19");
		student.setStuPassword("123456");
	    //3.更新对象
		int count = studentMapper.update(student);
		//4.提交事务
		session.commit();
		//5.关闭
		session.close();
		System.out.println("数据库库受影响记录数："+count);
		//需求：实现ID回填，就是插入数据后要将数据库的ID设置在实体类对象里面
		System.out.println("ID："+student.getStuId()+student.toString());
	}

}

　　

　　　　　　2.1.3.9 测试结果 

　　　　　　　　测试update函数

　　　　　　　　2.1.3.9.1 junit执行情况：

　　　　　　　　　　

　　　　　　　　2.1.3.9.2 控制台打印的返回值

　　　　　　　　　　

　　　　　　　　2.1.3.9.3 数据库中表的更新