2.2 select
一个select 元素非常简单。例如:
- <!--?查询学生,根据id?-->??
- <select?id="getStudent"?parameterType="String"?resultMap="studentResultMap">??
- ????SELECT?ST.STUDENT_ID,??
- ???????????????ST.STUDENT_NAME,??
- ???????????????ST.STUDENT_SEX,??
- ???????????????ST.STUDENT_BIRTHDAY,??
- ???????????????ST.CLASS_ID??
- ??????????FROM?STUDENT_TBL?ST??
- ?????????WHERE?ST.STUDENT_ID?=?#{studentID}??
- </select>??
?
这条语句就叫做‘getStudent,有一个String参数,并返回一个StudentEntity类型的对象。
注意参数的标识是:#{studentID}。
?
select 语句属性配置细节:?
属性 | 描述 | 取值 | 默认 |
id | 在这个模式下唯一的标识符,可被其它语句引用 | ? | ? |
parameterType | 传给此语句的参数的完整类名或别名 | ? | ? |
resultType | 语句返回值类型的整类名或别名。注意,如果是集合,那么这里填写的是集合的项的整类名或别名,而不是集合本身的类名。(resultType 与resultMap 不能并用) | ? | ? |
resultMap | 引用的外部resultMap 名。结果集映射是MyBatis 中最强大的特性。许多复杂的映射都可以轻松解决。(resultType 与resultMap 不能并用) | ? | ? |
flushCache | 如果设为true,则会在每次语句调用的时候就会清空缓存。select 语句默认设为false | true|false | false |
useCache | 如果设为true,则语句的结果集将被缓存。select 语句默认设为false?true|false?false timeout?设置驱动器在抛出异常前等待回应的最长时间,默认为不设值,由驱动器自己决定 | true|false | false |
timeout? | 设置驱动器在抛出异常前等待回应的最长时间,默认为不设值,由驱动器自己决定 | 正整数 | 未设置 |
fetchSize | 设置一个值后,驱动器会在结果集数目达到此数值后,激发返回,默认为不设值,由驱动器自己决定 | 正整数 | 驱动器决定 |
statementType | statement,preparedstatement,callablestatement。 预准备语句、可调用语句 | STATEMENT PREPARED CALLABLE | PREPARED |
resultSetType | forward_only,scroll_sensitive,scroll_insensitive 只转发,滚动敏感,不区分大小写的滚动 | FORWARD_ONLY SCROLL_SENSITIVE SCROLL_INSENSITIVE | 驱动器决定 |
?
?
2.3 insert
?一个简单的insert语句:
- <!--?插入学生?-->??
- <insert?id="insertStudent"?parameterType="StudentEntity">??
- ????????INSERT?INTO?STUDENT_TBL?(STUDENT_ID,??
- ??????????????????????????????????????????STUDENT_NAME,??
- ??????????????????????????????????????????STUDENT_SEX,??
- ??????????????????????????????????????????STUDENT_BIRTHDAY,??
- ??????????????????????????????????????????CLASS_ID)??
- ??????????????VALUES???(#{studentID},??
- ??????????????????????????#{studentName},??
- ??????????????????????????#{studentSex},??
- ??????????????????????????#{studentBirthday},??
- ??????????????????????????#{classEntity.classID})??
- </insert>??
?
?
?
?insert可以使用数据库支持的自动生成主键策略,设置useGeneratedKeys=”true”,然后把keyProperty 设成对应的列,就搞定了。比如说上面的StudentEntity 使用auto-generated 为id 列生成主键.
?还可以使用selectKey元素。下面例子,使用mysql数据库nextval('student')为自定义函数,用来生成一个key。
- <!--?插入学生?自动主键-->??
- <insert?id="insertStudentAutoKey"?parameterType="StudentEntity">??
- ????<selectKey?keyProperty="studentID"?resultType="String"?order="BEFORE">??
- ????????????select?nextval('student')??
- ????</selectKey>??
- ????????INSERT?INTO?STUDENT_TBL?(STUDENT_ID,??
- ?????????????????????????????????STUDENT_NAME,??
- ?????????????????????????????????STUDENT_SEX,??
- ?????????????????????????????????STUDENT_BIRTHDAY,??
- ?????????????????????????????????CLASS_ID)??
- ??????????????VALUES???(#{studentID},??
- ????????????????????????#{studentName},??
- ????????????????????????#{studentSex},??
- ????????????????????????#{studentBirthday},??
- ????????????????????????#{classEntity.classID})??????
- </insert>??
?
?
insert语句属性配置细节:
属性 | 描述 | 取值 | 默认 |
id | 在这个模式下唯一的标识符,可被其它语句引用 | ? | ? |
parameterType | 传给此语句的参数的完整类名或别名 | ? | ? |
flushCache | 如果设为true,则会在每次语句调用的时候就会清空缓存。select 语句默认设为false | true|false | false |
useCache | 如果设为true,则语句的结果集将被缓存。select 语句默认设为false?true|false?false timeout?设置驱动器在抛出异常前等待回应的最长时间,默认为不设值,由驱动器自己决定 | true|false | false |
timeout? | 设置驱动器在抛出异常前等待回应的最长时间,默认为不设值,由驱动器自己决定 | 正整数 | 未设置 |
fetchSize | 设置一个值后,驱动器会在结果集数目达到此数值后,激发返回,默认为不设值,由驱动器自己决定 | 正整数 | 驱动器决定 |
statementType | statement,preparedstatement,callablestatement。 预准备语句、可调用语句 | STATEMENT PREPARED CALLABLE | PREPARED |
useGeneratedKeys | 告诉MyBatis 使用JDBC 的getGeneratedKeys 方法来获取数据库自己生成的主键(MySQL、SQLSERVER 等 关系型数据库会有自动生成的字段)。默认:false | true|false | false |
keyProperty | 标识一个将要被MyBatis 设置进getGeneratedKeys 的key 所返回的值,或者为insert 语句使用一个selectKey 子元素。 | ? | ? |
?
?
selectKey语句属性配置细节:
?
属性 | 描述 | 取值 |
keyProperty | selectKey 语句生成结果需要设置的属性。 | ? |
resultType | 生成结果类型,MyBatis 允许使用基本的数据类型,包括String 、int类型。 | ? |
order | 可以设成BEFORE 或者AFTER,如果设为BEFORE,那它会先选择主键,然后设置keyProperty,再执行insert语句;如果设为AFTER,它就先运行insert 语句再运行selectKey 语句,通常是insert 语句中内部调用数据库(像Oracle)内嵌的序列机制。? | BEFORE AFTER |
statementType | 像上面的那样, MyBatis 支持STATEMENT,PREPARED和CALLABLE 的语句形式, 对应Statement ,PreparedStatement 和CallableStatement 响应 | STATEMENT PREPARED CALLABLE |
?
?
2.4 update、delete
一个简单的update:
- <!--?更新学生信息?-->??
- <update?id="updateStudent"?parameterType="StudentEntity">??
- ????????UPDATE?STUDENT_TBL??
- ????????????SET?STUDENT_TBL.STUDENT_NAME?=?#{studentName},???
- ????????????????STUDENT_TBL.STUDENT_SEX?=?#{studentSex},??
- ????????????????STUDENT_TBL.STUDENT_BIRTHDAY?=?#{studentBirthday},??
- ????????????????STUDENT_TBL.CLASS_ID?=?#{classEntity.classID}??
- ?????????WHERE?STUDENT_TBL.STUDENT_ID?=?#{studentID};?????
- </update>??
?
一个简单的delete:
- <!--?删除学生?-->??
- <delete?id="deleteStudent"?parameterType="StudentEntity">??
- ????????DELETE?FROM?STUDENT_TBL?WHERE?STUDENT_ID?=?#{studentID}??
- </delete>??
?
?update、delete语句属性配置细节:
?
属性 | 描述 | 取值 | 默认 |
id | 在这个模式下唯一的标识符,可被其它语句引用 | ? | ? |
parameterType | 传给此语句的参数的完整类名或别名 | ? | ? |
flushCache | 如果设为true,则会在每次语句调用的时候就会清空缓存。select 语句默认设为false | true|false | false |
useCache | 如果设为true,则语句的结果集将被缓存。select 语句默认设为false?true|false?false timeout?设置驱动器在抛出异常前等待回应的最长时间,默认为不设值,由驱动器自己决定 | true|false | false |
timeout? | 设置驱动器在抛出异常前等待回应的最长时间,默认为不设值,由驱动器自己决定 | 正整数 | 未设置 |
fetchSize | 设置一个值后,驱动器会在结果集数目达到此数值后,激发返回,默认为不设值,由驱动器自己决定 | 正整数 | 驱动器决定 |
statementType | statement,preparedstatement,callablestatement。 预准备语句、可调用语句 | STATEMENT PREPARED CALLABLE | PREPARED |
?
2.5 sql
Sql元素用来定义一个可以复用的SQL 语句段,供其它语句调用。比如:
- <!--?复用sql语句??查询student表所有字段?-->??
- <sql?id="selectStudentAll">??
- ????????SELECT?ST.STUDENT_ID,??
- ???????????????????ST.STUDENT_NAME,??
- ???????????????????ST.STUDENT_SEX,??
- ???????????????????ST.STUDENT_BIRTHDAY,??
- ???????????????????ST.CLASS_ID??
- ??????????????FROM?STUDENT_TBL?ST??
- </sql>??
?
???这样,在select的语句中就可以直接引用使用了,将上面select语句改成:
- <!--?查询学生,根据id?-->??
- <select?id="getStudent"?parameterType="String"?resultMap="studentResultMap">??
- ????<include?refid="selectStudentAll"/>??
- ????????????WHERE?ST.STUDENT_ID?=?#{studentID}???
- </select>??
?
?2.6parameters
??????? 上面很多地方已经用到了参数,比如查询、修改、删除的条件,插入,修改的数据等,MyBatis可以使用的基本数据类型和Java的复杂数据类型。
????? ? 基本数据类型,String,int,date等。
??????? 但是使用基本数据类型,只能提供一个参数,所以需要使用Java实体类,或Map类型做参数类型。通过#{}可以直接得到其属性。
2.6.1基本类型参数
?根据入学时间,检索学生列表:
- <!--?查询学生list,根据入学时间??-->??
- <select?id="getStudentListByDate"??parameterType="Date"?resultMap="studentResultMap">??
- ????SELECT?*??
- ??????FROM?STUDENT_TBL?ST?LEFT?JOIN?CLASS_TBL?CT?ON?ST.CLASS_ID?=?CT.CLASS_ID??
- ?????WHERE?CT.CLASS_YEAR?=?#{classYear};??????
- </select>??
?
- List<StudentEntity>?studentList?=?studentMapper.getStudentListByClassYear(StringUtil.parse("2007-9-1"));??
- for?(StudentEntity?entityTemp?:?studentList)?{??
- ????System.out.println(entityTemp.toString());??
- }??
?
2.6.2Java实体类型参数
?根据姓名和性别,检索学生列表。使用实体类做参数:
- <!--?查询学生list,like姓名、=性别,参数entity类型?-->??
- <select?id="getStudentListWhereEntity"?parameterType="StudentEntity"?resultMap="studentResultMap">??
- ????SELECT?*?from?STUDENT_TBL?ST??
- ????????WHERE?ST.STUDENT_NAME?LIKE?CONCAT(CONCAT('%',?#{studentName}),'%')??
- ??????????AND?ST.STUDENT_SEX?=?#{studentSex}??
- </select>??
?
- StudentEntity?entity?=?new?StudentEntity();??
- entity.setStudentName("李");??
- entity.setStudentSex("男");??
- List<StudentEntity>?studentList?=?studentMapper.getStudentListWhereEntity(entity);??
- for?(StudentEntity?entityTemp?:?studentList)?{??
- ????System.out.println(entityTemp.toString());??
- }??
?
2.6.3Map参数
根据姓名和性别,检索学生列表。使用Map做参数:
- <!--?查询学生list,=性别,参数map类型?-->??
- <select?id="getStudentListWhereMap"?parameterType="Map"?resultMap="studentResultMap">??
- ????SELECT?*?from?STUDENT_TBL?ST??
- ?????WHERE?ST.STUDENT_SEX?=?#{sex}??
- ??????????AND?ST.STUDENT_SEX?=?#{sex}??
- </select>??
?
- Map<String,?String>?map?=?new?HashMap<String,?String>();??
- map.put("sex",?"女");??
- map.put("name",?"李");??
- List<StudentEntity>?studentList?=?studentMapper.getStudentListWhereMap(map);??
- for?(StudentEntity?entityTemp?:?studentList)?{??
- ????System.out.println(entityTemp.toString());??
- }??
?
?
?
?
2.6.4多参数的实现?
?如果想传入多个参数,[email protected]?例:
?接口写法:
- public?List<StudentEntity>?getStudentListWhereParam(@Param(value?=?"name")?String?name,?@Param(value?=?"sex")?String?sex,?@Param(value?=?"birthday")?Date?birthdar,?@Param(value?=?"classEntity")?ClassEntity?classEntity);??
?
SQL写法:
- <!--?查询学生list,like姓名、=性别、=生日、=班级,多参数方式?-->??
- <select?id="getStudentListWhereParam"?resultMap="studentResultMap">??
- ????SELECT?*?from?STUDENT_TBL?ST??
- ????<where>??
- ????????<if?test="name!=null?and?name!=''?">??
- ????????????ST.STUDENT_NAME?LIKE?CONCAT(CONCAT('%',?#{name}),'%')??
- ????????</if>??
- ????????<if?test="sex!=?null?and?sex!=?''?">??
- ????????????AND?ST.STUDENT_SEX?=?#{sex}??
- ????????</if>??
- ????????<if?test="birthday!=null">??
- ????????????AND?ST.STUDENT_BIRTHDAY?=?#{birthday}??
- ????????</if>??
- ????????<if?test="classEntity!=null?and?classEntity.classID?!=null?and?classEntity.classID!=''?">??
- ????????????AND?ST.CLASS_ID?=?#{classEntity.classID}??
- ????????</if>??
- ????</where>??
- </select>??
?
?
进行查询:
- List<StudentEntity>?studentList?=?studentMapper.getStudentListWhereParam("",?"",StringUtil.parse("1985-05-28"),?classMapper.getClassByID("20000002"));??
- for?(StudentEntity?entityTemp?:?studentList)?{??
- ????System.out.println(entityTemp.toString());??
- }??
?
?
?
2.6.5字符串代入法
??????? 默认的情况下,使用#{}语法会促使MyBatis 生成PreparedStatement 属性并且使用PreparedStatement 的参数(=?)来安全的设置值。尽量这些是快捷安全,也是经常使用的。但有时候你可能想直接未更改的字符串代入到SQL 语句中。比如说,对于ORDER BY,你可能会这样使用:ORDER BY ${columnName}但MyBatis 不会修改和规避掉这个字符串。
??????? 注意:这样地接收和应用一个用户输入到未更改的语句中,是非常不安全的。这会让用户能植入破坏代码,所以,要么要求字段不要允许客户输入,要么你直接来检测他的合法性?。
?
?
2.7 cache缓存
??????? MyBatis 包含一个强在的、可配置、可定制的缓存机制。MyBatis 3 的缓存实现有了许多改进,既强劲也更容易配置。默认的情况,缓存是没有开启,除了会话缓存以外,它可以提高性能,且能解决全局依赖。开启二级缓存,你只需要在SQL 映射文件中加入简单的一行:<cache/>
这句简单的语句的作用如下:
1.?所有在映射文件里的select 语句都将被缓存。
2.?所有在映射文件里insert,update 和delete 语句会清空缓存。
3.?缓存使用“最近很少使用”算法来回收
4.?缓存不会被设定的时间所清空。
5.?每个缓存可以存储1024 个列表或对象的引用(不管查询出来的结果是什么)。
6.?缓存将作为“读/写”缓存,意味着获取的对象不是共享的且对调用者是安全的。不会有其它的调用
7.?者或线程潜在修改。
?
例如,创建一个FIFO 缓存让60 秒就清空一次,存储512 个对象结果或列表引用,并且返回的结果是只读。因为在不用的线程里的两个调用者修改它们可能会导致引用冲突。
- <cache?eviction="FIFO"?flushInterval="60000"?size="512"?readOnly="true">??
- </cache>??
?
?? ?还可以在不同的命名空间里共享同一个缓存配置或者实例。在这种情况下,你就可以使用cache-ref 来引用另外一个缓存。
- <cache-ref?namespace="com.liming.manager.data.StudentMapper"/>??
?
Cache 语句属性配置细节:
属性 | 说明 | 取值 | 默认值 |
eviction | 缓存策略: LRU - 最近最少使用法:移出最近较长周期内都没有被使用的对象。 FIFI- 先进先出:移出队列里较早的对象 SOFT - 软引用:基于软引用规则,使用垃圾回收机制来移出对象 WEAK - 弱引用:基于弱引用规则,使用垃圾回收机制来强制性地移出对象 | LRU FIFI SOFT WEAK | LRU |
flushInterval | 代表一个合理的毫秒总计时间。默认是不设置,因此使用无间隔清空即只能调用语句来清空。 | 正整数 | 不设置 |
size | 缓存的对象的大小 | 正整数 | 1024 |
readOnly | 只读缓存将对所有调用者返回同一个实例。因此都不能被修改,这可以极大的提高性能。可写的缓存将通过序列 化来返回一个缓存对象的拷贝。这会比较慢,但是比较安全。所以默认值是false。 | true|false | false |