知识整理:Mybatis(1)

计算机技术的学习快到尾声了,前面的学习的有点多,一多起来就乱起来了。于是打算边梳理学过的知识边找工作。

mybatis:dao层接口的实现对象是自动生成的,提供每个dao层方法应该执行的sql语句

什么是Mybatis?
MyBatis是一个简化和实现了 Java 数据持久化层(persistence layer)的开源框架,它抽象了大量的JDBC冗余代码,并提供了一个简单易用的API和数据库交互方式。
MyBatis的前身是iBATIS,iBATIS于2002年由ClintonBegin创建。MyBatis3是iBATIS的全新设计,支持注解和Mapper(映射器)。
MyBatis流行的主要原因在于它的简单性和易使用性。在Java应用程序中,数据持久化层涉及到的工作有:将从数据库查询到的数据生成所需要的Java对象;将Java对象中的数据通SQL持久化到数据库中。
Mybatis还抽象化底层的JDBC代码,自动化SQL结果集产生JAVA对象,Java对象的数据持久化数据库中的过程使用得对SQL的使用变得容易。

怎么用:
mybatis框架中一般需要俩种文件:
第一种:mybatis的配置文件: mybatis-config.xml,其中包括数据库连接信息,类型别名,映射文件路径等等
第二种:mybatis的映射文件:XxxxMapper.xml,这个xml文件中包括Xxxx类所对应的数据库表的各种增删改查sql语句
例如:StudentMapper.xml文件中是Student类对应的表的各种select insert update delete
项目中引入mybatis的核心包以及可选的依赖包
必须的包 mybatis-3.3.0.jar ojdbc14.jar
可选的包 junit-4.7.jar log4j-1.2.17.jar

1.配置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="application.properties">
			<property name="username" value="db_user" />
			<property name="password" value="verysecurepwd" />
		  </properties>
		  <settings>
			<setting name="cacheEnabled" value="true" />
		  </settings>
		  <typeAliases>
			<typeAlias alias="Student" type="com.briup.pojo.Student" />
			<package name="com.briup.pojo" />
		  </typeAliases>
		  <typeHandlers>
			<typeHandler handler="com.mybatis3.typehandlers.PhoneTypeHandler" />
			<package name="com.briup.typehandlers" />
		  </typeHandlers>
		  <environments default="development">
			<environment id="development">
			  <transactionManager type="JDBC" />
			  <dataSource type="POOLED">
				<property name="driver" value="${jdbc.driverClassName}" />
				<property name="url" value="${jdbc.url}" />
				<property name="username" value="${jdbc.username}" />
				<property name="password" value="${jdbc.password}" />
			  </dataSource>
			</environment>
			<environment id="production">
			  <transactionManager type="MANAGED" />
			  <dataSource type="JNDI">
				<property name="data_source" value="java:comp/jdbc/MyBatisDemoDS" />
			  </dataSource>
			</environment>
		  </environments>
		  <mappers>
			<mapper resource="com/briup/mappers/StudentMapper.xml" />
			<mapper url="file:///D:/mybatisdemo/mappers/StudentMapper.xml" />
			<mapper class="com.briup.mappers.StudentMapper" />
		  </mappers>
		</configuration>

下面来解析下各个元素
environments元素:配置mybatis当前工作的数据库环境的地方,MyBatis支持配置多个dataSource环境,可以将应用部署到不同的环境上,如DEV(开发环境),TEST(测试换将),QA(质量评估环境),UAT(用户验收环境),PRODUCTION(生产环境),可以通过将默认environments值设置成想要的environment的id值。
dataSource元素:dataSource表示的是数据源:至少会包括该连接数据库的各种信息
transactionManager元素 :事务管理器
MyBatis支持两种类型的事务管理器:JDBCMANAGED.
JDBC事务管理器的使用,是在【jdbc程序】负责管理数据库连接的生命周期(提交、回退等等)的时候。如果将TransactionManager 属性设置成JDBC,MyBatis内部将使用JdbcTransactionFactory类创建TransactionManager。例如,部署到ApacheTomcat的应用程序,需要应用程序自己管理事务。
MANAGED 事务管理器的使用,是在【应用服务器】负责管理数据库连接生命周期的时候。如果将TransactionManager属性设置成MANAGED时,MyBatis内部使用ManagedTransactionFactory 类创建事务管理器TransactionManager。例如,当一个Java EE的应用程序部署在类似JBoss,WebLogic,GlassFish应用服务器上时,它们会使用EJB进行应用服务器的事务管理能力。在这些管理环境中,你可以使用MANAGED事务管理器。
注:Managed 是托管的意思,即我们编写的应用程序本身不去管理事务,而是把事务管理交给应用所在的服务器进行管理。
properties元素:
属性配置元素properties可以将配置值写死到mybatis-config.xml中,也可以具体到一个属性文件中,并且使用属性文件的key名作为占位符.
typeAliases元素: 类型别名
在SQLMapper配置文件中,对于resultType和parameterType属性值,我们需要使用JavaBean 的完全限定名。
我们可以为完全限定名取一个别名(alias),然后就可以在需要使用完全限定名的地方使用别名,而不是到处使用完全限定名。
你可以不用为每一个JavaBean单独定义别名,你可以为配置出需要取别名的类的所在的包(package),
MyBatis会自动扫描包内定义的类,然后分别为每个类注册一个小写字母开头[大小写均可]的简单类名形式的别名。
如下所示:

 <type Aliases>
    		  <package name="com.briup.pojo" />
 </type Aliases>

如果Student.java和 Teacher.java 定义在com.briup.pojo包中,则 com.briup.pojo.Student的别名会被注册为student。而com.briup.pojo.Teacher别名将会被注册为teacher
还有另外一种方式为JavaBeans起别名,使用注解 @Alias:

@Alias("stu")
public class Student{
		....
}

配合< package name=“com.briup.pojo”/>使用,优先级更高
@Alias注解将会覆盖配置文件中的< typeAliases >定义。

typeHandlers元素: 类型处理器
当MyBatis将一个Java对象作为输入参数执行INSERT语句操作时,它会创建一个PreparedStatement对象,并且使用setXXX()方法对占位符设置相应的参数值 。这里,XXX可以是Int,String,Date 等 Java对象属性类型的任意一个。

settings元素: 全局参数设置
注意:大多数情况下,【这些参数使用它们的默认值即可】
为满足应用特定的需求,MyBatis默认的全局参数设置可以被覆盖掉,如下所示:

<settings>
		  <!-- 这个配置使全局的映射器启用或禁用缓存 -->
		  <setting name="cacheEnabled" value="true" />

		  <!-- 全局启用或禁用延迟加载。当禁用时,所有关联对象都会即时加载 -->
		  <setting name="lazyLoadingEnabled" value="true" />

		  <!-- 允许或不允许多种结果集从一个单独的语句中返回(需要适合的驱动) -->
		  <setting name="multipleResultSetsEnabled" value="true" />

		  <!-- 使用列标签代替列名。不同的驱动在这方便表现不同。参考驱动文档或充分测试两种方法来决定所使用的驱动 -->
		  <setting name="useColumnLabel" value="true" />

		  <!-- 允许JDBC支持生成的键。需要适合的驱动。 -->
		  <setting name="useGeneratedKeys" value="false" />

		  <!-- 指定MyBatis如何自动映射列到字段/属性。PARTIAL只会自动映射简单、没有嵌套的结果。FULL会自动映射任意复杂的结果(嵌套的或其他情况) -->
		  <setting name="autoMappingBehavior" value="PARTIAL" />

		  <!-- 配置默认的执行器。SIMPLE执行器没有什么特别之处。REUSE执行器重用预处理语句。BATCH执行器重用语句和批量更新 -->
		  <setting name="defaultExecutorType" value="SIMPLE" />

		  !-- 设置超时时间,它决定驱动等待一个数据库响应的时间 -->
		  <setting name="defaultStatementTimeout" value="25000" />

		  <!-- 允许在嵌套语句中使用分页(RowBounds)默认false -->
		  <setting name="safeRowBoundsEnabled" value="false" />

		  <!-- 是否开启自动驼峰命名规则(camel case)映射,即从经典数据库列名 A_COLUMN 到经典 Java 属性名 aColumn 的类似映射。默认false -->
		  <setting name="mapUnderscoreToCamelCase" value="false" />

		  <!-- MyBatis 利用本地缓存机制(Local Cache)防止循环引用(circular references)和加速重复嵌套查询。 默认值为 SESSION,这种情况下会缓存一个会话中执行的所有查询。 若设置值为 STATEMENT,本地会话仅用在语句执行上,对相同 SqlSession 的不同调用将不会共享数据。 -->
		  <setting name="localCacheScope" value="SESSION" />

		  <!-- 当没有为参数提供特定的 JDBC 类型时,为空值指定 JDBC 类型。 某些驱动需要指定列的 JDBC 类型,多数情况直接用一般类型即可,比如 NULL、VARCHAR 或 OTHER。 -->
		  <setting name="jdbcTypeForNull" value="OTHER" />

		  <!-- 指定对象的哪个方法触发一次延迟加载。 -->
		  <setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode ,toString" />

		  <!-- CGLIB | JAVASSIST 默认JAVASSIST(MyBatis 3.3 or above)  -->
		  <!-- 指定 Mybatis 创建具有延迟加载能力的对象所用到的代理工具。 -->
		  <setting name="proxyFactory" value="JAVASSIST" />
		  <!-- 当启用时,对任意延迟属性的调用会使带有延迟加载属性的对象完整加载;反之,每种属性将会按需加载。 -->
		  <setting name="aggressiveLazyLoading" value="true" />

		  <!-- 指定 MyBatis 所用日志的具体实现,未指定时将自动查找。 -->
		  <setting name="logImpl" value="LOG4J " />

		  <!-- 指定 MyBatis 增加到日志名称的前缀。值可以是任意字符串 -->
		  <setting name="logPrefix" value="LOG4J " />

		  <!-- 指定当结果集中值为 null 的时候是否调用映射对象的 setter(map 对象时为 put)方法,这对于有 Map.keySet() 依赖或 null 值初始化的时候是有用的。注意基本类型(int、boolean等)是不能设置成 null 的。 默认false-->
		  <setting name="callSettersOnNulls" value="false " />
		</settings>

mappers元素: SQL映射
SQLMapper文件中包含的SQL映射语句将会被应用通过使用其标签中的id值来执行。我们需要在mybatis-config.xml文件中配置SQLMapper文件的位置。

<mappers>
		  <mapper resource="com/briup/mappers/StudentMapper.xml" />
		  <mapper url="file:///D:/mybatisdemo/app/mappers/StudentMapper.xml" />
		  <mapper class="com.briup.mappers.StudentMapper" />
		  <package name="com.briup.mappers" />
		</mappers>

以上每一个< mapper> 标签都可以从不同类型的资源中加载映射mapper:
resource属性用来指定在classpath中的mapper文件。
url属性用来通过完全文件系统路径或者web URL地址来指向mapper文件
class属性用来指向一个mapper接口
package属性用来指向可以找到Mapper接口的包名

自定义类型处理器:
java代码:
PhoneNumber 类定义类型的 phoneNumber 属性。

public class PhoneNumber{
	private String countryCode;
	private String stateCode;
	private String number;
	public PhoneNumber(){
	}
	public PhoneNumber(String countryCode, String stateCode, String number) {
		this.countryCode = countryCode;
		this.stateCode = stateCode;
		this.number = number;
	}
	public String getAsString() {
		return countryCode + "-" + stateCode + "-" + number;
	}
	// Setters and getters
}

public class Student{
	private Integer id;
	private String name;
	private String email;
	private PhoneNumber phone;
	// Setters and getters
}


xml配置:

	<insert id="insertStudent" parameter Type="Student">
			insert into students(name,email,phone)
			values(#{name},#{email},#{phone})
		</insert>

这里,参数对象中的属性phone的值需要传递给#{phone};而参数对象的属性phone是 PhoneNumber类型。但是,MyBatis 并不知道该怎样来处理这个类型的对象。
为了让MyBatis明白怎样处理这个自定义的Java对象类型,如PhoneNumber,我们可以创建一个自定义的类型处理器,MyBatis提供了抽象类BaseTypeHandler ,我们可以继承此类创建自定义类型处理器。
实现效果如下:

package com.briup.typehandlers;
import java.sql.CallableStatement;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.sql.SQLException;
import org.apache.ibatis.type.BaseTypeHandler;
import org.apache.ibatis.type.JdbcType;
import com.briup.pojo.PhoneNumber;

public class PhoneTypeHandler extends BaseTypeHandler<PhoneNumber>{
	//遇到PhoneNumber参数的时候应该如何在ps中设置值
	@Override
	public void setNonNullParameter(PreparedStatement ps, int i, PhoneNumber parameter, JdbcType jdbcType)
			throws SQLException {
		ps.setString(i, parameter.getAsString());
	}

	//查询中遇到PhoneNumber类型的应该如何封装(使用列名封装)
	@Override
	public PhoneNumber getNullableResult(ResultSet rs, String columnName) throws SQLException {
		return new PhoneNumber(rs.getString(columnName));
	}

	//查询中遇到PhoneNumber类型的应该如何封装(使用列的下标)
	@Override
	public PhoneNumber getNullableResult(ResultSet rs, int columnIndex) throws SQLException {
		return new PhoneNumber(rs.getString(columnIndex));
	}

	//CallableStatement使用中遇到了PhoneNumber类型的应该如何封装
	@Override
	public PhoneNumber getNullableResult(CallableStatement cs, int columnIndex) throws SQLException {
		return new PhoneNumber(cs.getString(columnIndex));
	}

}

注意:使用ps.setString()和rs.getString()方法是 :因为在数据库的表中phone列是VARCHAR类型。

最后一旦我们实现了自定义的类型处理器,我们需要在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="application.properties" />
  <typeHandlers>
	<typeHandler handler="com.briup.typehandlers.PhoneTypeHandler" />
  </typeHandlers>
</configuration>

注册PhoneTypeHandler后, MyBatis就能够将Phone类型的对象值存储到VARCHAR类型的列上。

写sql语句并且使用:
现在让我们看一下在com.briup.mappers包中的StudentMapper.xml 配置文件内,是如何配置id为”findStudentById”的SQL语句的,代码如下:

<?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="com.briup.mappers.StudentMapper">
  <select id="findStudentById" parameterType="int" resultType="Student">
	select stud_id as studId, name, email, dob
	from students where stud_id=#{studId}
  </select>
</mapper>

我们可以通过下列代码调用findStudentById映射的SQL语句:

	public Student findStudentById(Integer studId) {
		SqlSession sqlSession = MyBatisSqlSessionFactory.openSession();
		try{
			Student student = sqlSession.selectOne("com.briup.mappers.StudentMapper.findStudentById", studId);
			return student;
		}
		finally {
			sql Session.close();
		}
	}

【重点部分:】
MyBatis通过使用映射器Mapper接口提供了更好的调用映射语句的方法。一旦我们通过映射器配置文件配置了映射语句,我们可以创建一个完全对应的一个映射器接口,xml映射文件中的namespace属性值和映射接口的全限定名需要保持一致。映射器接口中的方法签名也跟映射器配置文件中完全对应:方法名和配置文件中id值一致;方法参数类型和parameterType属性值一种;方法返回值类型和returnType属性值一致。

上述的StudentMapper.xml文件,我们可以创建一个映射器接口StudentMapper.java如下:

package com.briup.mappers;
public interface StudentMapper{
	Student findStudentById(Integer id);
}

在StudentMapper.xml映射器配置文件中,其名空间namespace应该跟StudentMapper接口的全限定名保持一致。另外,StudentMapper.xml中语句id, parameterType,returnType 应该分别和StudentMapper接口中的方法名,参数类型,返回值相对应。

使用映射器接口我们可以以类型安全的形式调用映射语句。如下所示:

	public Student findStudentById(Integer studId){
		SqlSession sqlSession = MyBatisSqlSessionFactory.openSession();
		try {
			StudentMapper studentMapper = sqlSession.getMapper(StudentMapper.class);

			return studentMapper.findStudentById(studId);
		}
		finally {
			sqlSession.close();
		}
	}


		public void insertStudent(Student student);
		public void insertStudent_autoId(Student student);
		public void insertStudent_autoId2(Student student);
		public void updateStudent(Student student);
		public void deleteStudentById(Integer id);
		public Student findStudentById(Integer id);
		public List<Student> findAllStudents();
		public List<Student> findAllStudents_resultMap();
		public Map<String,Object> findStudentById_Map(Integer id);
		public List<Map<String,Object>> findAllStudents_Map();
		public Set<Student> findAllStudents_Set();
		public SortedSet<Student> findAllStudents_SortedSet();
		public List<String> findAllName_list();
		public int findCount_int();

暂时整理到这里,映射语句、结果集映射、一对一映射、一对多映射,多对一映射、多对多、动态SQL、 choose,when 和 otherwise 条件、Where 条件、条件、 foreach 循环、 set 条件、mybatis的一些特殊功能 special、MyBatis中的注解留到下次。

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值