Mybatis【1】-- 第一个Mybatis程序

2022-02-15 14:22:20 浏览数 (1)

1.框架是什么

  • 框架(Framework)是整个或部分系统的可重用设计,表现为一组抽象构件及构件实例间交互的方法;另一种定义认为,框架是可被应用开发者定制的应用骨架。前者是从应用方面而后者是从目的方面给出的定义。
  • 一个框架是一个可复用的设计构件,它规定了应用的体系结构,阐明了整个设计、协作构件之间的依赖关系、责任分配和控制流程,表现为一组抽象类以及其实例之间协作的方法,它为构件复用提供了上下文(Context)关系。因此构件库的大规模重用也需要框架。
  • 个人理解:框架最重要的是把我们常用的,可以重复使用的功能抽象出来,不需要我们去重复写,我们只需要调用,或者按照规定配置,按照规则使用就可以了。这样的缺点是很多时候我们不知道为什么可以这样子使用,里面实现的细节被屏蔽掉了,这也是很多初学者很懵逼的地方,这时候追根问底就有一定必要性了。

2.Mybatis的介绍

Mybatis本来是Apache的一个开源项目iBatis,这个项目2010年由Apache迁移到了Google,更名为Mybatis,2013年正式迁移到Github

Mybatis是一个java中一个持久层的框架,在里面封装了jdbc操作,如果还不了解java如何使用jdbc访问数据库,那么可以查看这篇文章,封装使开发者只需要把精力放在开发sql语句上,不用去注册驱动,创建Connection,配置Statement,自己写代码管理事务等等。

Mybatis通过xml或者注解的方式将需要执行的statement配置好,通过映射将java对象与sql中的动态参数一起生成最终的sql语句,执行完之后返回对象,其中也是映射的结果。

3.Mybatis和Hibernate对比

1.Hibernate是全自动的ORM框架,也就是完全实现了POJO和数据库表之间的映射,会自动生成SQL。但是Mybatis不会自动生成,SQL还是需要自己写,但是映射关系框架会自动处理,这样一个好处就是可以看得到SQL,很多时候系统自动生成SQL并不是高效的,我们有时候需要优化SQL,或者一些复杂的查询可能自动化的很难做到,缺点就是需要花时间写。

2.使用XML文件进行配置,分离了了sql与代码,这样比较容易维护。3.Mybatis是一个轻量级的框架。学习成本比Hibernate低很多,jar包依赖也很少,上手比较快。

4.Mybatis的结构图:

Mybatis的运行机制:我们通过配置Mybatis.xml(里面配置好数据库,需要扫描的mapper.xml文件等),程序会自动扫描配置好的mapper文件,当我们请求一个接口(请求数据库),接口会直接映射到对应的sql标签,同时将我们所写的配置文件读取并将数据库字段与对象属性匹配(这也是映射,如果不一致,需要自己手写映射关系),将sql参数传进去,然后执行相关的sql,返回时又做了一次映射,把对象返回给我们。当然,这么描述是很表面的,因为mybatis还有事务,缓存等方面,以上只是大概。

5.IDEA创建第一个程序

这里我们会使用idea创建项目,如果maven没有配置好,请参考:https://blog.csdn.net/aphysia/article/details/80363684

5.1创建mysql数据库

使用以下的命令行:

代码语言:javascript复制
CREATE DATABASE `test` DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE TABLE `student` ( `id` INT NOT NULL AUTO_INCREMENT , `name` VARCHAR(20) NOT NULL , 
`age` INT NOT NULL , `score` DOUBLE NOT NULL , PRIMARY KEY (`id`)) ENGINE = MyISAM;

5.2 使用idea创建项目(Maven)

项目结构图(bean下面放的类对应我们的数据库里面的student表,也就是它的一个实体类,dao包下面放着我们的数据库的操作,resources下面放着我们的xml或者各种资源):

new --> Project -->点击Maven

点击next,GroupId,ArtifactId可以自己指定,点击下一步

自己指定project name(项目名),点击finish

pom.xml里面添加依赖,每一个之间都是一种依赖包,选中项目右键--> Maven --> Reimport,这样就可以下载我们所需要的依赖了:

代码语言:javascript复制
    <dependencies>
        <!-- mybatis核心包 -->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.3.0</version>
        </dependency>
        <!-- mysql驱动包 -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.29</version>
        </dependency>
        <!-- junit测试包 -->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.11</version>
            <scope>test</scope>
        </dependency>
        <!-- 日志文件管理包 -->
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.17</version> 
        </dependency>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
            <version>1.7.12</version>
        </dependency>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-log4j12</artifactId>
            <version>1.7.12</version>
        </dependency>
    </dependencies>

为了能实现日志的打印功能,我们在pom.xml文件中已经引入了日志dependency,在这里还需要在resources文件夹下新建配置log4j.properties文件,具体配置代表什么意思,可以参考log4j 与log4j2详解

log4j.properties

代码语言:javascript复制
log4j.rootLogger=DEBUG, stdout

log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=[service] %d - %c -%-4r [%t] %-5p %c %x - %m%n

#log4j.appender.R=org.apache.log4j.DailyRollingFileAppender    
#log4j.appender.R.File=../logs/service.log    
#log4j.appender.R.layout=org.apache.log4j.PatternLayout    
#log4j.appender.R.layout.ConversionPattern=[service] %d - %c -%-4r [%t] %-5p %c %x - %m%n    

#log4j.logger.com.ibatis = debug    
#log4j.logger.com.ibatis.common.jdbc.SimpleDataSource = debug    
#log4j.logger.com.ibatis.common.jdbc.ScriptRunner = debug    
#log4j.logger.com.ibatis.sqlmap.engine.impl.SqlMapClientDelegate = debug    
#log4j.logger.java.sql.Connection = debug    
log4j.logger.java.sql.Statement = debug
log4j.logger.java.sql.PreparedStatement = debug
log4j.logger.java.sql.ResultSet =debug

配置好这些之后,前面结构图上面写到有一个mybatis.xml文件,里面配置了运行的环境(关于数据库的连接),连接的数据库可以配置多个,但是必须指定使用哪一个,这样做的原因的世界在xml文件进行修改不需要重新编译,更换数据库比较简单,除此之外,里面还需要配置mapper.xml,也就是映射文件,我们要告诉它,我们将sql配置写在哪个文件。

mybatis.xml

代码语言:javascript复制
<?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>
    <!-- 配置运行环境 -->
    <!-- default 表示默认使用哪一个环境,可以配置多个,比如开发时的测试环境,上线后的正式环境等 -->
    <environments default="mysqlEM">    
     <environment id="mysqlEM">
      <transactionManager type="JDBC">  
      </transactionManager>
      <dataSource type="POOLED">
       <property name="driver" value="com.mysql.jdbc.Driver"/>
       <property name="url" value="jdbc:mysql://127.0.0.1:3306/test"/>
       <property name="username" value="root"/>
       <property name="password" value="123456"/>
      </dataSource>
     </environment>
     <environment id="testEM">
      <transactionManager type="JDBC">
      </transactionManager>
      <dataSource type="POOLED">
       <property name="driver" value="com.mysql.jdbc.Driver"/>
       <property name="url" value="jdbc:mysql://127.0.0.1:3306/test"/>
       <property name="username" value="root"/>
       <property name="password" value="123456"/>
      </dataSource>
     </environment>
    </environments>
    <!-- 注册映射文件 -->
    <mappers>
     <mapper resource="mapper.xml"/>
    </mappers>
  </configuration>

配置好mybatis.xml文件我们就需要写sql语句,根据上面的mybatis.xml,我们需要写mapper.xml文件,下面的namespace现在可以随意命名,因为只有一个mapper.xml文件,sql标签的id没有重复,执行时就是根据id来查找的,同时这里parameterType对应的是参数类型,类型要写带完整路径名的类:

mapper.xml

代码语言:javascript复制
<?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="abc">
 <insert id="insertStudent" parameterType="bean.Student">
  insert into student(name,age,score) values(#{name},#{age},#{score})
 </insert>
</mapper>

在bean包下面创建与数据库对应的Student类【在bean包下】(这里先把属性名字和数据库的字段名一致,如果不一致需要自己写映射),注意里面的方法我们需要实现set和get方法,这个在IDEA里面,打开当前类,右键--> Gernarate -->setter and getter全选就可以生成。

Student.class

代码语言:javascript复制
package bean;
public class Student {
    // id属性
 private Integer id;
 // 名字属性
 private String name;
 // 年龄属性
 private int age;
 //分数属性
 private double score;
 // 构造方法,除了id,因为我们的id在数据库中是自增的
 public Student( String name, int age, double score) {
  super();
  this.name = name;
  this.age = age;
  this.score = score;
 }
 public Integer getId() {
  return id;
 }
 public void setId(Integer id) {
  this.id = id;
 }
 public String getName() {
  return name;
 }
 public void setName(String name) {
  this.name = name;
 }
 public int getAge() {
  return age;
 }
 public void setAge(int age) {
  this.age = age;
 }
 public double getScore() {
  return score;
 }
 public void setScore(double score) {
  this.score = score;
 }
 @Override
 public String toString() {
  return "Student [id="   id   ", name="   name   ", age="   age
      ", score="   score   "]";
 }
 
}

在这里我们需要写一个接口,来表示操作学生信息,先写一个插入学生信息的接口,那么肯定是传一个学生对象进去。

IStduent.class

代码语言:javascript复制
package dao;
import bean.Student;
public interface IStudentDao {
 public void insertStu(Student student);
}

下面就是接口的实现类(重点):

StudentDaoImpl.class

代码语言:javascript复制
package dao;
import java.io.IOException;
import java.io.InputStream;
import bean.Student;
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 StudentDaoImpl implements IStudentDao {
    // 实现插入的接口方法
 public void insertStu(Student student) {
  try {
   InputStream inputStream;
      // 读取配置信息的文件
   inputStream = Resources.getResourceAsStream("mybatis.xml");
   // 由于这个文件里面配置了mapper.xml,框架会帮我们扫描这些mapper.xml,下面是初始化一个SqlSessionFactory对象
   SqlSessionFactory sqlSessionFactory=new SqlSessionFactoryBuilder().build(inputStream);
   // 工厂会获取一个SqlSession对象
   SqlSession sqlSession=sqlSessionFactory.openSession();
   // 通过这个对象可以查找之前mapper.xml里面配置好的sql的id与 `insertStudent`相等的,执行对应的sql
   sqlSession.insert("insertStudent",student);
  } catch (IOException e) {

   e.printStackTrace();
  }

 }
 
}

测试方法,如果不了解Junit测试请参考Junit测试详解:

MyTest.class

代码语言:javascript复制
import bean.Student;
import dao.IStudentDao;
import dao.StudentDaoImpl;
import org.junit.Before;
import org.junit.Test;
public class MyTest {
 private IStudentDao dao;
 @Before
 public void Before(){
  dao=new StudentDaoImpl();
 }
 @Test
 public void testInsert(){
  Student student=new Student("1ADAS",23,94.6);
  dao.insertStu(student);
 }
}

测试的结果,从最后三行我们可以看到执行的sql语句,以及参数等:

5.3 使用Eclipse,MyEclipse创建项目(Maven)

区别不大,直接创建java Project,如果下面没有lib这个文件,就要新建一个,然后把需要的包导(复制粘贴)进去,选中lib下面所有的包,右键-->Build Path--> Add to Path

下面是myEclipse下面的结构图,代码没有改变,需要自己下载相关的包

声明:这样的写法不是最好的,但是这是初学者最容易接受的写法,后面会慢慢的精简,我们到时候不需要写接口的实现类,同时会把关于sqlSessionFactory相关的操作抽取出来成为一个工具类,就不用写那么多相同的代码了。

6.总结

最后总结一下上面写法的思路:

1.先读取mybatis.xml文件流inputStream,这是最重要的配置文件,里面的内容配置的是数据库环境,比如连接哪一个数据库链接,除此之外,还有注册映射文件,比如扫描哪一个文件,我们配置的是/mapper.xml。 2.通过inputStream创建sqlSessionFactory,也就是sql会话工厂,所谓工厂,肯定是用来创造或者制造sqlSession的。 3.sqlSessionFactory.openSession()可以打开一个sqlSession,也就是sql会话,获得这个操作数据库的会话窗口。 4.通过sqlSession提供的方法去操作数据库,提供方法名,和参数即可。比如sqlSession.insert("insertStudent", student);,这个insertStudent从哪里冒出来的?当然是前面扫描mapper.xml的时候,mapper.xml里面配置的,insertStudent是id,需要是唯一的,就能通过这个找到对应的sql来执行。 5.提交会话,commit,不一定需要,具体看数据库的类型. 6.关闭会话,sqlSession.close();

代码已经放在:https://github.com/Damaer/Mybatis-Learning此文章仅代表自己(本菜鸟)学习积累记录,或者学习笔记,如有侵权,请联系作者删除。人无完人,文章也一样,文笔稚嫩,在下不才,勿喷,如果有错误之处,还望指出,感激不尽~

技术之路不在一时,山高水长,纵使缓慢,驰而不息。 - END -

0 人点赞