【mybatis】1mybatis下载、配置与初步使用
一、mybatis历史:
额,学习一门新事物时了解一下它的历史能在脑中形成一个大致的轮廓...进入正题...
mybatis以前叫做ibatis,ibatis是Apache旗下的产品,在2010年时google将其接管并更名为mybatis。(你可以发现它的包结构还是org.apache.ibatis)。
二、mybatis介绍:
mybatis运行在三层架构中的Dao层,它的主要功能是简化jdbc操作,并且能够降低耦合(sql语句和java代码分离),便于维护。mybatis是ORM(Object Ralational Mapping 对象关系映射)的产品。ORM框架将数据库中的表和JavaBean二者观念起来。但是,ORM框架只是一个理念,mybatis才是它的实现,比较著名的ORM框架还有hibernate,JPA等。
三、下载及配置:
1、下载
当我们大致了解了mybatis的概念与用处之后,我们就可以开始下载它啦,外网有时候不稳定,建议在中文官网下载,网址:http://www.mybatis.cn/82.html,下载完成你会得到一个压缩包,将其解压缩将得到文件结构如下:
好的~我们把注意力放在lib目录和mybatis-3.4.6.jar、mybatis-3.4.6.pdf上面来~其中lib是你在使用mybatis进行开发的过程中,可能会用到的一些jar包,而mybatis-3.4.6.jar是mybatis的核心jar包,剩下的mybatis-3.4.6.pdf很明显是官方文档啦~至于剩下的咱们装作没看见就好~
2、使用mybatis
好的,当我们下载了mybatis之后,就可以使用它啦~前面虽然说它是一个作用于Dao层的框架,但它的实质是完成数据库表与JavaBean之间的关联,所以我们创建一个J2SE项目(普通的Java项目)即可,以eclipse为例就是new->java project,然后选中咱们的src目录,ctrl+n输入package,然后创建一个entity包和一个mapper包还有一个test包,额,咱们做测试就不用那么规范了额。其中entity包用于存放实体类,也就是JavaBean(为了防止可能有的童鞋不知道JavaBean是啥,这里简单交代一下:JavaBean的规范有三,类的访问权限为public、构造方法的访问权限为public且必须提供无参构造、所有属性的访问权限必须是private,嗯,最重要的是它与表是映射关系);mapper包用于存放接口和xml文件,具体存放啥接口和啥xml文件先别着急,也别乱想,博主在下文会交代明白;最后的test包用于存放咱们的Test类,嗯,就是做测试的。
建完后的项目结构如图:然后咱们将刚刚下完的mybatis核心jar包复制粘贴到src目录下,并右键build path->add to build path加入环境~
接下来在src目录下创建一个xml文件(选中src ctrl+n 输入xml file),该xml文件是mybatis的配置文件,其中最核心的配置信息是数据库的信息(驱动路径、url、账号密码之类的)和需要加载的映射文件路径(就是上文中提到的mapper包下面的xml文件),该配置文件的名字可以随便起,在这里我们就命名为mybatis-config.xml吧!
关于配置文件的文件格式,我们可以查看mybatis的官方文档——mybatis-3.4.6.pdf。
找到目录我们先点击getting started:
然后我们往下翻到第3页,将这个模板直接复制到mybatis-config.xml文件中去:
ctrl+shift+f整理文件格式之后我们开始配置。
<?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值与id值进行制定,这里我制定的就是mysql数据库环境 --> <environments default="devMysql"> <!-- 配置开发环境,可以指定多个开发环境 --> <environment id="devMysql"> <!-- 事务提交方式,这里设置JDBC是手动提交,一般都是手动提交哦 --> <transactionManager type="JDBC" /> <!-- 数据源类型,POOLED是使用mybatis默认的数据源, 也可以选择UNPOOLED不使用数据源, 以及JNDI使用tomcat内置数据源, 不过一般推荐使用POOLED哦 --> <dataSource type="POOLED"> <property name="driver" value="com.mysql.jdbc.Driver" /> <property name="url" value="jdbc:mysql://127.0.0.1:3306/testdb" /> <property name="username" value="root" /> <property name="password" value="abc" /> </dataSource> </environment> <environment id="devOracle"> <transactionManager type="JDBC" /> <dataSource type="POOLED"> <property name="driver" value="oracle.jdbc.OracleDriver" /> <property name="url" value="jdbc:oracle:thin:@127.0.0.1:1521:orcl" /> <property name="username" value="scott" /> <property name="password" value="abc" /> </dataSource> </environment> </environments> <mappers> </mappers> </configuration>
额,排版好大...咳咳,ok,我们这里配置了两个开发环境,分别对应于mysql数据库以及oracle数据库,我们将对应的数据库驱动jar包粘贴到src目录下并add build path加入环境~
接下来,我们在数据库中创建一个person表,我使用的是mysql数据库,建表语句如下:
create table person( id int primary key, name varchar(30), age int, gender int)
上文中提到,entity包下存放的是数据库表对应的实体类,那么是怎么个对应法呢?简单来说就是表名与JavaBean的类名关联,表中的字段与JavaBean中的属性关联(这个不关联也可以用别的手段解决,但是最好关联),与person表对应的实体类代码如下:
package pers.tz.mapper; /** * @author tangze * @create 2019-10-11 0:07 */ public class person { private int id; private String name; private int age; private int gender; 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 int getAge() { return age; } public void setAge(int age) { this.age = age; } public int getGender() { return gender; } public void setGender(int gender) { this.gender = gender; } public person(int id, String name, int age, int gender) { this.id = id; this.name = name; this.age = age; this.gender = gender; } public person() { } @Override public String toString() { return "person{" + "id=" + id + ", name='" + name + '\'' + ", age=" + age + ", gender=" + gender + '}'; } }
接下来我们就可以开始写sql语句啦~我们之前说过,mybatis的一个作用在于解耦合,它将sql语句以及java代码分离,在以往,我们的sql语句是以字符串的形式与java语言混杂在一起的,这样的结构不利于维护,因此,现在咱们写在一个单独的文件中,这个文件就是上文中提到的mapper包下的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="命名空间"> </mapper>
上方的代码就是mapper包下的xml文件的大致结构,一个xml文件与一个表相关联,负责该表的dml操作,也就是说sql语句都存放于该xml文件中。又由于xml文件与表相关联,所以我们不妨将该文件命名为personMapper.xml。我们在personMapper.xml中写入一条sql语句,即插入一个person记录:
<?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="命名空间"> <insert id="insertPerson" parameterType="pers.tz.entity.Person"> insert into person values(#{id},#{name},#{age},#{gender}) </insert> </mapper>
id属性是该标签的唯一标识符,parameterType属性是传入参数的类型,这里接下来传入的是一个JavaBean,要写全类名,因为这是insert语句所以使用的是insert节点,与之相应的还有delete update select节点。接下来我们在mybatis-config.xml文件中关联personMapper.xml文件(我先讲步骤,你们也先会用,原理等流程完成之后我会说明):
<mappers> <mapper resource="mapper/personMapper.xml"/> </mappers>
然后...我们创建一个上文所说的mapper包下的接口,该接口用于与personMapper.xml文件关联,我们不妨起名为PersonMapper,然后将PersonMapper的全类名复制,作为personMapper.xml映射文件的命名空间...然后在该接口中创建一个insertPerson方法:
<?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="mapper.PersonMapper"> <insert id="insertPerson" parameterType="pers.tz.entity.Person"> insert into person values(#{id},#{name},#{age},#{gender}) </insert> </mapper>
public interface PersonMapper { int insertPerson(Person person); }
这样,personMapper.xml和PersonMapper.java就关联起来了,接口中的方法名对应xml映射文件中的id值,接口中的方法形参对应xml映射文件中的parameterType值,接口的全类名对应xml映射文件中的命名空间。实际上mybatis先通过它的配置文件(即mybatis-config.xml)找到映射文件(即personMapper.xml),然后通过映射文件找到接口(PersonMapper.java)
走到这里我们的步骤差不多就走完了,就剩下测试类了。那么我们开始整一个测试类,在test包下创建一个类,我创建的是Test类:
public class Test { public static void demo1(Person person) throws Exception { //读入mybatis-config.xml文件 Reader reader = Resources.getResourceAsReader("mybatis-config.xml"); //工厂模式...嘤嘤嘤说错了别喷我 SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(reader); //获取一个session,你可以将它近似的理解为connection对象 SqlSession session = sqlSessionFactory.openSession(); //反射获取该接口的实现类,mybatis帮你生成的实现类 PersonMapper mapper = session.getMapper(PersonMapper.class); int count = mapper.insertPerson(person); //手动提交 session.commit(); } public static void main(String[] args) { demo1(new Person(1,"张三",17,1)); } }
执行完后..你就能看到在你的数据库表中多出一条记录啦...
原理
最后来简单说一下它的原理...它的底层是对映射文件(personMapper.xml)进行解析,从而得到该文件中的sql节点(上文中的insert),这样就能得到它的id值,parameterType值,以及其中的sql语句,那么它要得到这些值干嘛呢?看上方我们有这么一行代码:
PersonMapper mapper = session.getMapper(PersonMapper.class);
这里的mapper对象的类型不知道你发现了没有,它的类型是一个接口!那么显然这个对象是该接口的实现类,但是这个实现类我们并没有写啊!难道这个对象就是该接口的实例?!这显然是不合理的,java的接口连构造方法都没有!那么真相就只有一个,有一个家伙偷偷的帮我们写了实现类...这个家伙就是mybatis。
实际上,mybatis通过mybatis-config.xml配置文件找到personMapper.xml映射文件,然后通过该映射文件找到对应的接口,mybatis底层会解析这个映射文件,解析sql节点的属性值和其中的sql语句然后在底层帮你生成该接口的实现类,然后父类引用指向子类实例,就能调用子类的方法啦...
额,第一部分就先到这里,如果我没有漏掉什么的话....完。
如有不对请及时指正,感激不尽