MyBatis入门学习(一)
一、MyBatis入门简要介绍(百科)
MyBatis 是支持普通 SQL查询,存储过程和高级映射的优秀持久层框架。MyBatis 消除了几乎所有的JDBC代码和参数的手工设置以及结果集的检索。MyBatis 使用简单的 XML或注解用于配置和原始映射,将接口和 Java 的POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
每个MyBatis应用程序主要都是使用SqlSessionFactory实例的,一个SqlSessionFactory实例可以通过SqlSessionFactoryBuilder获得。SqlSessionFactoryBuilder可以从一个xml配置文件或者一个预定义的配置类的实例获得。
用xml文件构建SqlSessionFactory实例是非常简单的事情。推荐在这个配置中使用类路径资源(classpath resource),但你可以使用任何Reader实例,包括用文件路径或file://开头的url创建的实例。MyBatis有一个实用类----Resources,它有很多方法,可以方便地从类路径及其它位置加载资源。
二、MaBatis入门测试小项目
2.1、项目准备工作
1、因为该项目不需要与web相关,所以创建java项目即可,项目结构如下图所示:
2、引入项目响应的jar包(两个)
在myeclipse创建一个名为jar的Folder文件夹,下载jar包引入,不要忘记build path 将jar包引入到当前项目中来。
【mybatis】
mybatis-3.1.1.jar 下载地址(可能有变动):http://download.csdn.net/detail/dqsweet/4534353
【MYSQL驱动包】(连接mysql数据库驱动包)
mysql-connector-java-5.1.7-bin.jar 下载地址(可能有变动):http://download.csdn.net/detail/yangs_1235/5049404
3、建立相对应的数据库和表,使用的是MySQL数据库
create database mybatis; use mybatis; CREATE TABLE users(id INT PRIMARY KEY AUTO_INCREMENT, NAME VARCHAR(20), age INT); INSERT INTO users(NAME, age) VALUES('久伴1', 24); INSERT INTO users(NAME, age) VALUES('久伴2', 24);
2.2、通过MyBatis框架查询表中的数据
1、在src目录下创建一个conf.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> <environments default="development"> <environment id="development"> <transactionManager type="JDBC" /> <!-- 配置数据库连接信息 每个人可能不一样--> <dataSource type="POOLED"> <property name="driver" value="com.mysql.jdbc.Driver" /> <property name="url" value="jdbc:mysql://localhost:3306/mybatis" /> <property name="username" value="root" /> <property name="password" value="123456" /> </dataSource> </environment> </environments> <mappers> <!-- 注册userMapper.xml文件, userMapper.xml位于com.murong.mapping这个包下,所以resource写成com/murong/mapping/userMapper.xml--> <mapper resource="com/murong/mapping/userMapper.xml"/> </mappers> </configuration>
2、定义实体类User,如下:
package com.murong.domain; /** * 实体类User * @author yzy * */ public class User { //实体类的属性需与表字段对应 private int id; private String name; private int age; 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; } }
3、定义操作users表的sql映射文件userMapper.xml 创建一个com.murongl.mapping包,专门用于存放sql映射文件,在包中创建一个userMapper.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,不可重复,namespace的值习惯上设置成包名+映射文件名 例如namespace="com.murong.mapping.userMapper" 就是com.murong.mapping(包名)+userMapper(userMapper.xml文件去除后缀) --> <mapper namespace="com.murong.mapping.userMapper"> <!-- 在select标签中编写查询的SQL语句, 设置select标签的id属性为getUser,id属性值必须是唯一的,不能够重复 使用parameterType属性指明查询时使用的参数类型,resultType属性指明查询返回的结果集类型 resultType="com.murong.domain.User"表示将查询结果封装成一个User类的对象返回 User类就是数据库users表所对应的实体类 --> <!-- 根据id查询返回一个user对象 --> <select id="getUser" parameterType="int" resultType="com.murong.domain.User"> select * from users where id=#{id} </select> </mapper>
4、在conf.xml文件中注册userMapper.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> <environments default="development"> <environment id="development"> <transactionManager type="JDBC" /> <!-- 配置数据库连接信息 每个人可能不一样--> <dataSource type="POOLED"> <property name="driver" value="com.mysql.jdbc.Driver" /> <property name="url" value="jdbc:mysql://localhost:3306/mybatis" /> <property name="username" value="root" /> <property name="password" value="123456" /> </dataSource> </environment> </environments> <mappers> <!-- 注册userMapper.xml文件, userMapper.xml位于com.murong.mapping这个包下,所以resource写成com/murong/mapping/userMapper.xml--> <mapper resource="com/murong/mapping/userMapper.xml"/> </mappers> </configuration>
5、编写测试代码App类:执行定义的select语句,测试代码如下:
package com.murong.client; import com.murong.domain.User; import java.io.IOException; import java.io.InputStream; 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 App { public static void main(String[] args) throws IOException { //mybatis的配置文件,位于src路径下 String resource = "conf.xml"; //使用类加载器加载mybatis的配置文件(它也加载关联的映射文件)(获取方式一) //InputStream is = App.class.getClassLoader().getResourceAsStream(resource); //构建sqlSession的工厂 //SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(is); //使用MyBatis提供的Resources类加载mybatis的配置文件(它也加载关联的映射文件)(获取方式二) Reader reader = Resources.getResourceAsReader(resource); //构建sqlSession的工厂 SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(reader); //创建能执行映射文件中sql的sqlSession SqlSession session = sessionFactory.openSession(); /** * 映射sql的标识字符串, * com.murong.mapping.userMapper是userMapper.xml文件中mapper标签的namespace属性的值, * getUser是select标签的id属性值,通过select标签的id属性值就可以找到要执行的SQL */ String statement = "com.murong.mapping.userMapper.getUser";//映射sql的标识字符串 //执行查询返回一个唯一user对象的sql User user = session.selectOne(statement, 1); System.out.println(user); } }
6、执行结果如下所示: