MyBatis是Apache下的一个开源框架,主要支持Sql语句的查询、数据的存储和高级映射,下面界面它的基本使用:
首先你需要在Apache的官网上下载MyBatis的jar包,将其引入我们的工程中,当然要引入数据库相关的jar包,这里我引入的是mysql-connector-java-bin.jar,接下来就是配置XML文件了,首先要配置的是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>
<properties resource="com/xujianguo/config/mysql.properties"></properties>
<typeAliases>
<typeAlias alias="Admin" type="com.xujianguo.model.Admin"/>
<typeAlias alias="GroupInfo" type="com.xujianguo.model.GroupInfo"/>
</typeAliases>
<environments default="mysql">
<environment id="mysql">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="${mysql-driver}"/>
<property name="url" value="${mysql-url}"/>
<property name="username" value="${mysql-username}"/>
<property name="password" value="${mysql-password}"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/xujianguo/config/Admin-Config.xml"/>
<mapper resource="com/xujianguo/config/GroupInfo-Config.xml"/>
</mappers>
</configuration>
首先我们来看看properties标签,它的resource属性是指向了一个properties文件,里面写的是我的MySql基本配置,即是:
mysql-driver = com.mysql.jdbc.Driver
mysql-url = jdbc:mysql://localhost:3306/mydata
mysql-username = root
mysql-password =root
这样我们就可以通过外部文件的配置信息加载进数据库,看看中间的property标签,用的就是properties文件的值,typeAliases标签是定义类的别名,如果你不定义的话,就要在文件中类的完全限定名,alias写的是你想取的短名字,type就是类的全名,这样定义后就可以在XML文件中使用类的别名了,datasource标签定义的是数据源的相关信息,例如连接池的最大连接数、空闲时间等信息都可以在这里定义,mappers标签就是连接到另外一个XML文件中了,那里写的就是Sql语句,也就MyBatis的魅力所在了。
下面是我定义的一个Admin类,我们拿它来做例子讲解:
public class Admin {
private int id;
private String name;
private String sex;
private int groupId;
public Admin() {
}
public Admin(int id , String name , String sex) {
this.id = id;
this.name = name;
this.sex = sex;
}
public GroupInfo getGroup() {
return group;
}
public void setGroup(GroupInfo group) {
this.group = group;
}
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 String getSex() {
return sex;
}
public void setSex(String sex) {
this.sex = sex;
}
public int getGroupId() {
return groupId;
}
public void setGroupId(int groupId) {
this.groupId = groupId;
}
有了Admin类了,我们需要写一个Admin-Config.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="AdminMapper">
<select id="selectAllAdmin" resultType="Admin">
select * from admin
</select>
<select id="selectAdminById" parameterType="_int" resultType="Admin">
select * from admin where groupId = #{id}
</select>
<select id="selectOneAdmin" parameterType="string" resultType="Admin">
select * from admin where name = #{name}
</select>
<insert id="insertAdmin" parameterType="Admin">
insert into admin(id , name , sex) values( #{id} , #{name} , #{sex} )
</insert>
<delete id="deleteAdmin" parameterType="_int">
delete from admin where id = #{id}
</delete>
<update id="updateAdmin" parameterType="_int">
update admin set id = id + 1 where id = #{id}
</update>
<select id="findAll" resultMap="findAllMap">
select * from admin
</select>
</mapper>
看到admin不要奇怪,这里我们数据库的表名字,当然也就我们要操作的那个表了,看到这个表的内容,相信大家都很熟悉了,mapper标签的namespace相当于这个mapper的名字一样,可以自己定义。如果我们要调用select语句的话,当然就用select标签了,delete语句对应的是delete标签,我们先来看看第一个select标签,里面有个id属性,定义的是你这个select标签的身份,是别人怎么区分你跟别人不同的地方,也是后来我们调用的唯一标示符。resultType定于的是你这个select语句执行后的返回值类型,我这个是Admin,如果你没配置typeAlias的话就要用全类名了。然后标签里面的内容就是你要执行的Sql语句,若你的Sql语句有参数怎么办,那我们来看看那第二条语句,也是select语句的,通过id来查找,那么我们就要看另外一个属性了,就是parameterType了,这里定义的是参数类型,若是int的类型的话,就写_int,若是String类型,就是string。当然你会问,如果有很多个参数怎么办,我们的参数类型就可以写一个JavaBean类,我这里是Admin,底层会通过反射查找出各个成员变量的类型,然后帮你传进去,如果这个Mapper你搞定后,你就可以开始写java文件了。
接着我们要写一个工具类,通过这个工具类去创建一个Session,建立起我们跟数据库的连接:
public class MyBatisUtil {
private static final SqlSessionFactory sqlSessionFactory = buildSqlSessionFactory();
private static final String RESOURCE = "com/xujianguo/config/MyBatis-Config.xml";
public static SqlSessionFactory buildSqlSessionFactory() {
try {
return new SqlSessionFactoryBuilder().build(Resources.getResourceAsStream(RESOURCE));
} catch (IOException e) {
e.printStackTrace();
}
return null;
}
public static SqlSessionFactory getSqlSessionFactory() {
return sqlSessionFactory;
}
public static SqlSession openSqlSession() {
return sqlSessionFactory.openSession();
}
public static SqlSession openSqlSession(boolean autoCommit) {
return sqlSessionFactory.openSession(autoCommit);
}
}
MyBatis为我们提供了一个创建SqlSession的工厂,我们通过这个工厂的build方法,得到SqlSessionFactory,然后有个Factory后我们就可以调用它的openSession方法,返回值是一个SqlSession类型的,也就是我们想要的SqlSession,当然在创建工厂的时候我们要告诉对方我们的资源文件在哪里,也就是我们之前类型的XML文件,这里我通过了定义RESOURCE常量将值设进去。
上述步骤搞定后我们就可以进去实际的操作了,往数据库里拿我们想要的数据,这里我演示一个例子:
public List<Admin> selectAllAdmin() {
SqlSession sqlSession = MyBatisUtil.openSqlSession();
List<Admin> list = sqlSession.selectList("selectAllAdmin");
sqlSession.close();
return list;
}
这是一个拿出所有数据的例子,我通过前面的MyBatis工具类的openSqlSession方法得到一个sqlSession,然后就可以调用它的方法了,select语句当然就对应select方法,如果是拿出全部的话我们就调用selectList方法,如果是单个就调用selectOne,里面放置的参数是你select的Id属性,还有如果你select语句带参数的话,也要传进你的参数值进入,不然别人怎么知道呢,对不对!如果你是事务事件的话,完成后要commit,最后都要调用sqlSession的close方法。