学习笔记_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 数据库中表的更新