- 创建 mybatis-config.xml 文件并将 mybatis 文档中的内容复制过来,并将数据库配置信息换成自己的:
mybatis-config.xml 是总控制文件,EmployeeMapper.xml 是MyBatis的 sql映射文件,在里面也 sql 语句
所有的 sql映射文件都会写到总控文件中
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
|
<!DOCTYPE configuration PUBLIC
"-//mybatis.org//DTD Config 3.0//EN"
<br>
"http://mybatis.org/dtd/mybatis-3-config.dtd"
>
<configuration>
<properties resource=
"jdbc.properties"
/>
<environments
default
=
"development"
>
<environment id=
"development"
>
<transactionManager type=
"JDBC"
/>
<dataSource type=
"POOLED"
>
<property name=
"driver"
value=
"${jdbc.driver}"
/>
<property name=
"url"
value=
"${jdbc.url}"
/>
<property name=
"username"
value=
"${jdbc.username}"
/>
<property name=
"password"
value=
"${jdbc.password}"
/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource=
"com/neuedu/mapper/EmployeeMapper.xml"
/>
</mappers>
</configuration>
|
- 创建测试用例,.复制mybatis官方文档代码,代码如下:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
|
public
class
TestMyBatis {
@Test
public
void
test() {
String resource =
"mybatis-config.xml"
;
InputStream inputStream =
null
;
try
{
inputStream = Resources.getResourceAsStream(resource);
//从配置文件中读取一个流
}
catch
(IOException e) {
e.printStackTrace();
}
//利用这个流创建一个sqlSessionFactory对象,也就是总控文件创建了这个对象
SqlSessionFactory sqlSessionFactory =
new
SqlSessionFactoryBuilder().build(inputStream);
//和数据库建立的一次会话,通过openSession,创建一个sqlsession对象
SqlSession sqlsession = sqlSessionFactory.openSession();
try
{
//selectOne查询一条记录,第一个参数时sql语句的唯一标识,第二个参数时sql要用的参数
//为了确保唯一标识唯一,所以在前面写上namespace,因为namesapce唯一
//如果第二个参数"4"在数据库中找不到的话,不会报错,返回null
Object selectOne = sqlsession.selectOne(
"com.neuedu.MyBatis.EmployeeMapper.selectStudentById"
,
4
);
System.out.println(selectOne);
}
finally
{
sqlsession.close();
}
}
}
|
- 创建sql语句的映射文件EmployeeMapper.xml;
1
2
3
4
5
6
7
8
9
10
11
|
<mapper namespace=
"com.neuedu.MyBatis.EmployeeMapper"
>
<!--
namespace:名称空间,随便起一个名,但是要唯一
id:sql 语句的唯一标识
#{id}:接收参数传递过来的id值
resultType:将 sql语句返回成什么对象
-->
<select id=
"selectStudentById"
resultType=
"com.neuedu.entity.Employee"
>
select * from student where id = #{id}
</select>
</mapper>
|
总结:
– 创建一张测试表
– 创建对应的javaBean
– 创建mybatis配置文件,sql映射文件
– 测试
/**
* 1.根据xml配置文件(全局配置文件)创建一个SqlSessionFactory对象
* 有数据源的一些运行环境信息
* 2.sql映射文件,配置了每一个sql,以及sql的封装规则等。
* 3.将sql映射文件注册在全局配置文件中
* 4.写代码:
* 1)根据全局配置文件得到SqlSessionFactory
* 2)使用sqlSession工厂,获取到sqlSession对象使用它来执行增删改查!
* sqlSession就是代表和数据库的一次会话!用完要关闭!
* 3)使用sql的唯一标识告诉MyBatis执行哪个sql。而sql都是保存
* 在sql映射文件中的。
*/
上面这种开发方式是老版本的Mybatis使用者的开发方式!而新一批的Mybatis使用者都是使用接口的方法
HelloWorld----接口式编程
- 新创建一个 mapper包,里面包含 mapper接口,与 mapper.xml文件相对应
1
2
3
4
5
6
7
|
public
interface
EmployeeMapper {
/*
* 增删改查方法
* */
public
Employee getEmployeeById(Integer id);
}
|
- 通过mapper.xml的 namespace 相关联
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
<mapper namespace=
"com.neuedu.mapper.EmployeeMapper"
>
<!--
namespace:将sql映射文件和Mapper接口进行关联
id:要和相对应的mapper接口的方法名保持一致
#{id}:从参数中获取id
resultType:将 sql语句返回成什么对象
-->
<!--
public
Employee getEmployeeById(Integer id); -->
<select id=
"getEmployeeById"
resultType=
"com.neuedu.entity.Employee"
>
select * from student where id = #{id}
</select>
</mapper>
|
- sqlSession 对象表示服务器和数据库的一次会话,是一个非线程安全的,所以不能定义在类中,定义在类中,多线程的情况下会有多个线程共用,一次使用获取一次 ,保证时线程安全的
1
2
3
4
5
6
7
8
9
10
11
12
13
|
private
SqlSessionFactory getSqlSessionFactory(){
String resource =
"mybatis-config.xml"
;
InputStream inputStream =
null
;
try
{
inputStream = Resources.getResourceAsStream(resource);
//从配置文件中读取一个流
}
catch
(IOException e) {
e.printStackTrace();
}
//利用这个流创建一个sqlSessionFactory对象
SqlSessionFactory sqlSessionFactory =
new
SqlSessionFactoryBuilder().build(inputStream);
return
sqlSessionFactory;
}
|
- 测试
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
@Test
public
void
test01(){
//1.获取sqlSessionFactory对象
SqlSessionFactory sqlSessionFactory = getSqlSessionFactory();
//2.利用sqlSessionFactory创建一个session对象,表示和数据库的一次会话
SqlSession session = sqlSessionFactory.openSession();
//3.用session对象获取mapper接口的代理对象
//因为sql映射文件给相应的接口创建了一个代理对象,所以mapper接口类不需要实现类
EmployeeMapper mapper = session.getMapper(EmployeeMapper.
class
);
//通过mapper接口的代理对象就可以对数据库进行增删改查操作
Employee employee = mapper.getEmployeeById(
4
);
System.out.println(employee);
session.close();
}
|
以前都是需要为接口写一个实现类,但是此时,mybatis提供了接口可以与sql配置文件动态绑定!
如何将两者进行绑定?以前sql配置文件的namespace可以随便写,现在就不能随便写了,需要指定为接口的全限定名!
此时接口和sql配置文件做了绑定,还要将select标签的id和方法名进行绑定
总结:
1.接口式编程
原生: Dao ==================> DaoImpl
mybatis: xxMapper ================> xxMapper.xml
2.SqlSession代表和数据库的一次会话,用完必须关闭。
3.SqlSession和Connection一样,都是非线程安全的,每次使用都是应该去获取新的对象,不要将这个对象定义在类变量中使用!
4.mapper接口没有实现类,但是mybatis这个接口生成一个代理对象
1
2
|
<!--将接口与xml文件进行绑定 -->
EmployeeMapper employeeMapper = sqlSession.getMapper(EmployeeMapper.
class
);
|
5.两个重要的配置文件
- mybatis的全局配置文件(
mybatis-config.xml):包含数据库连接池信息,事务管理器信息等..系统运行环境信息。
- sql映射文件(
EmployeeMapper.xml):保存了每一个sql语句的映射信息。
Mybatis的全局配置文件
MyBatis 的配置文件包含了影响 MyBatis 行为甚深的设置(settings)和属性(properties)信息。文档的顶层结构顺序如下:
- configuration 配置
- properties 属性:加载properties文件
- settings 设置
- typeAliases 类型命名
- typeHandlers 类型处理器
- objectFactory 对象工厂
- plugins 插件
- environments 环境
- environment 环境变量
- transactionManager 事务管理器
- dataSource 数据源
- databaseIdProvider 数据库厂商标识
- mappers 映射器
dtd文档规定了以上顺序不能变
具体介绍:
1.configuration 为全局配置文件绑定dtd约束:
1)联网会自动绑定
2)没网的时候【/org/apache/ibatis/builder/xml/mybatis-3-config.dtd】:解压mybatis 的jar包然后在eclipse中绑定
Window-->Preference-->XML-->XML Catalog
2. properties属性
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
|
<configuration>
<!--
mybatis可以使用properties来引入外部properties配置文件的内容
resource:引入类路径下的资源
url:引入网络路径或者磁盘路径下的资源
-->
<properties resource=
"jdbc.properties"
></properties>
<environments
default
=
"development"
>
<environment id=
"development"
>
<transactionManager type=
"JDBC"
/>
<dataSource type=
"POOLED"
>
<property name=
"driver"
value=
"${jdbc.driver}"
/>
<property name=
"url"
value=
"${jdbc.url}"
/>
<property name=
"username"
value=
"${jdbc.user}"
/>
<property name=
"password"
value=
"${jdbc.passowrd}"
/>
</dataSource>
</environment>
</environments>
<!-- 将我们写好的sql映射文件一定要注册到全局配置文件中,文件用/,类用.,也就是如果是
class
就用.分隔 -->
<mappers>
<mapper resource=
"EmployeeMapper.xml"
/>
</mappers>
</configuration>
|
3.settings包含很多重要的设置项
setting:用来设置每一个设置
- name:设置属性名
- value:设置属性值
1
2
3
4
5
|
<!-- settings标签可以设置多个属性值 -->
<settings>
<!-- setting标签负责每一个属性的设置 -->
<setting name=
"mapUnderscoreToCamelCase"
value=
"true"
/>
</settings>
|
- mapUnderscoreToCamelCase 可以将数据库中带下划线的名称,与类中驼峰式命名的名称对应起来
比如,在数据库中名称为 user_name,在实体类中名称为userName,value值是true的话,也可以对应上
4.typeAliases:起别名
1
2
3
4
5
6
7
8
9
10
|
<!-- typeAliases可以为多个类起别名 -->
<typeAliases>
<!-- 别名处理器,可以为某个java类型设置别名
默认是该类名的首字母小写,别名不区分大小写
alias:可以通过该属性单独指定别名-->
<!-- <typeAlias type=
"com.neuedu.entity.Employee"
alias=
"asd"
/> -->
<!-- 用
package
可以批量为类起别名 -->
<!-- 批量起别名的情况下,使用
@Alias
注解为某个实体类指定新的别名 -->
<
package
name=
"com.neuedu.entity"
/>
</typeAliases>
|
虽然有这么多的别名可以使用:但是建议还是使用全类名,看SQL语句是怎么被封装为JAVA 对象的时候简单!
5.typeHandlers:类型处理器
类型处理器:负责如何将数据库的类型和java对象类型之间转换的工具类
6.environments:环境们
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
|
<!--
environments:环境们,mybatis可以配置多种环境,
default
指定使用某种环境。可以达到快速切换环境。
environment:配置一个具体的环境信息;必须有两个标签;id代表当前环境的唯一标识
transactionManager:事务管理器
type:事务管理器的类型;type=
"[JDBC|MANAGED]"
),这两个都是别名,在Configuration类中可以查看具体类!但是Spring对事务的控制才是最终的管理方案!
当然也可以自定义事务管理器:只需要和人家一样实现TransactionFactory接口,type指定为全类名。
dataSource:数据源
type:type=
"[UNPOOLED|POOLED|JNDI]"
自定义数据源:实现DataSourceFactory接口,type也是全类名
但是我们也说了,无论是事务管理器的配置还是数据源的配置我们都会使用spring来做,这里只需要了解一下即可!
-->
<environments
default
=
"development"
>
<environment id=
"test"
>
<transactionManager type=
"JDBC"
/>
<dataSource type=
"POOLED"
>
<property name=
"driver"
value=
"${jdbc.driver}"
/>
<property name=
"url"
value=
"${jdbc.url}"
/>
<property name=
"username"
value=
"${jdbc.user}"
/>
<property name=
"password"
value=
"${jdbc.passowrd}"
/>
</dataSource>
</environment>
<environment id=
"development"
>
<transactionManager type=
"JDBC"
/>
<dataSource type=
"POOLED"
>
<property name=
"driver"
value=
"${jdbc.driver}"
/>
<property name=
"url"
value=
"${jdbc.url}"
/>
<property name=
"username"
value=
"${jdbc.user}"
/>
<property name=
"password"
value=
"${jdbc.passowrd}"
/>
</dataSource>
</environment>
</environments>
|
7.databaseIdProvider环境
MyBatis 可以根据不同的数据库厂商执行不同的语句
1
2
3
4
5
6
|
<databaseIdProvider type=
"DB_VENDOR"
>
<property name=
"SQL Server"
value=
"sqlserver"
/>
<property name=
"DB2"
value=
"db2"
/>
<property name=
"Oracle"
value=
"oracle"
/>
<property name=
"MySQL"
value=
"mysql"
/>
</databaseIdProvider>
|
Type: DB_VENDOR
– 使用MyBatis提供的VendorDatabaseIdProvider解析数据库 厂商标识。也可以实现DatabaseIdProvider接口来自定义。
Property-name:数据库厂商标识
Property-value:为标识起一个别名,方便SQL语句使用
在mybatis的全局配置文件配置了这个之后,我们只需要在sql映射文件中通过在执行语句的标签上加一个属性
databaseId即可!
databaseId 与 value 值对应
1
2
3
4
5
6
7
8
9
|
<select id=
"getEmployeeById"
resultType=
"emp"
>
select * from tbl_employee where id = #{id}
</select>
<select id=
"getEmployeeById"
resultType=
"emp"
databaseId=
"mysql"
>
select * from tbl_employee where id = #{id}
</select>
<select id=
"getEmployeeById"
resultType=
"emp"
databaseId=
"oracle"
>
select * from tbl_employee where id = #{id}
</select>
|
这样在执行不同数据库的时候,就会执行不同数据库的语句了
当然如上所示:当有指定了databaseId属性的和没有指定databaseId属性的,都有的情况下那就按着有指定databaseId属性的sql语句执行!
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|
<environments
default
=
"development"
>
<environment id=
"development"
>
<transactionManager type=
"JDBC"
/>
<dataSource type=
"POOLED"
>
<property name=
"driver"
value=
"${jdbc.driver}"
/>
<property name=
"url"
value=
"${jdbc.url}"
/>
<property name=
"username"
value=
"${jdbc.username}"
/>
<property name=
"password"
value=
"${jdbc.password}"
/>
</dataSource>
</environment>
<environment id=
"dev_oracle"
>
<transactionManager type=
"JDBC"
/>
<dataSource type=
"POOLED"
>
<property name=
"driver"
value=
"${jdbc.driver}"
/>
<property name=
"url"
value=
"${jdbc.url}"
/>
<property name=
"username"
value=
"${jdbc.username}"
/>
<property name=
"password"
value=
"${jdbc.password}"
/>
</dataSource>
</environment>
</environments>
|
8.mapper映射
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|
<!-- mappers:将sql映射注册到全局配置中 -->
<mappers>
<!-- mapper:注册一个sql映射
注册配置文件:
resource:引用类路径下的sql映射文件 mybatis/mapper/EmployeeMapper.xml
url:引用网络路径下或者磁盘路径下的sql映射文件 url=
"file:///var/mappers/AuthorMapper.xml"
注册接口
class
:引用(注册)接口:
1
.有sql映射文件,映射文件名必须和接口同名,并且放在与接口同一个目录下(可以在conf下见一个同名的包,放在里面);
2
.没有sql映射文件,所有的sql都是利用注解写在接口方法上;
推荐:
比较重要的,复杂的Dao接口我们来写sql映射文件
不重要,见到的Dao接口为了开发快速可以使用注解
-->
<!-- <mapper
class
=
"com.neuedu.mapper.EmployeeMapper"
/> -->
<mapper resource=
"com/neuedu/mapper/EmployeeMapper.xml"
/>
<!-- 批量注册:
对于sql 映射文件和接口需要保证在同一个包下,且名字必须相同 -->
<
package
name=
"com.neuedu.mapper"
/>
</mappers>
|
class:当映射文件和接口文件不在同一目录下时,用注解
但是不建议使用注解,建议使用sql映射文件
1
2
3
4
5
6
7
8
|
public
interface
EmployeeMapper {
/*
* 增删改查方法
* */
@Select
(
"select * from student where id = #{id}"
)
public
Employee getEmployeeById(Integer id);
}
|
9.最后就是全局配置文件中标签实际上是有顺序的!
使用自定义的数据源
- 导包:C3P0
- 新建类继承 UnpooledDataSourceFactory
- 提供无参构造器,并将 dataSource属性设置成想要连接的数据库连接池
1
2
3
4
5
6
|
public
class
C3P0DateSource
extends
UnpooledDataSourceFactory{
public
C3P0DateSource() {
this
.dataSource =
new
ComboPooledDataSource();
}
}
|
- 在总控文件 mybatis-config.xml 中修改 dataSource 路径
将 property 中的 name 换做 C3P0 中的写法
1
2
3
4
5
6
7
8
9
10
11
|
<environments
default
=
"development"
>
<environment id=
"development"
>
<transactionManager type=
"JDBC"
/>
<dataSource type=
"com.neuedu.datasource.C3P0DateSource"
>
<property name=
"driverClass"
value=
"${jdbc.driver}"
/>
<property name=
"jdbcUrl"
value=
"${jdbc.url}"
/>
<property name=
"user"
value=
"${jdbc.username}"
/>
<property name=
"password"
value=
"${jdbc.password}"
/>
</dataSource>
</environment>
</environments>
|