- 一、序言
- 二、组件介绍
- 三、组件的使用
一、序言
本文主要目的是介绍平台组件之Mapper组件的使用方法，使得一位研发工程师在本文的帮助下就能够达到运用熟练的基本目的。同时还介绍了Mapper组件的生态能力，为后续广大使用者使用和扩展Mapper组件起到奠基的作用。
本组件最大的优点是生态扩展能力，自带的基础功能仅为提供最基本的组件特征，只有强大的生态能力，才能让该组件得到日益的丰富，而不是单靠一个人，一个组件就能带来一片生机。
如果你想迅速了解Mapper组件带来了什么，请直接查看第三章。
二、组件介绍
1、前置条件
学习和使用Mapper组件的前置条件：
①、软件版本-基于Mybatis3.0.5，以及mybatis-spring-1.0.1，配套的Spring版本为3.0.5；
②、编译JDK版本号：1.6，支持运行环境1.7，未使用到1.7+的特性代码；
③、掌握基本的Mybatis3.0+，以及Spring3.0+的使用方法；
④、额外依赖：slf4j-api 任意版本（不传递依赖），
2、独立性和兼容性
☆、Mapper组件没有修改Mybatis原生态的代码，而是采用扩展和改写的方式来扩展和增强Mybatis的使用；
☆、Mapper组件可以独立使用，可以在任意能够使用Mybatis 3.0+的系统中直接使用；
☆、Mapper组件采用的是反射，继承，可选组件兼容等方式来增强Mybatis的能力，因此升级Mybatis组件可能会存在版本不兼容的情况；
☆、Mapper组件采用Maven管理，对外部组件依赖采用provided，也即不传递依赖任何其它组件，如果需要，自行导入；
☆、Mapper组件对在spring环境下，对mybatis-spring-1.0.1版本的依赖是可选的，即便我们使用到的Spring组件；
☆、Mapper组件对在spring环境下，对Spring组件的依赖是可选的，如果需要使用到Spring，那么建议版本为 [3.0.5, 4.0.0)；
☆、Mapper组件对于已有的使用Mybatis的项目(可以是Spring环境下)是能够兼容的（稍许核心配置需要修改）；
3、环境的搭建
POM依赖如下：
其中framework.mapper.version值，为引用的版本号，请参见发行手册。以下使用都是基于本章节的前置条件的基础之上的。
注：因该组件采用的scope为provider进行组件的依赖，因此不会做任何传递依赖，需要自行引入Mybatis组件。
⑴、独立环境的使用
①自定义mybatis-config.xml配置文件
注：内容不做额外的限制，并不依赖于sqlmap配置文件
②创建测试表以及数据
注：测试数据采用的是hsqldb的语法，如果使用oracle数据库，请自行调整。
③构建SqlSessionFactory
注：其中getConfigFileAsReader() 为①的配置文件的流对象。
④创建PO对象以及Mapper接口
注：类名和②表名一致，除了首字符大写，命名规则有限制，不要使用驼峰模式（后续有介绍原因）；
注：字段名和②列名一致，命名规则有限制，不要使用驼峰模式（后续有介绍原因）；
注：此处省略了构造函数以及GET和SET方法，请自行补充；
注：此Mapper的类名命名规则无限制，仅需要继承Mapper组件中的通用Mapper<T>接口即可，其中T为泛型为上述的实体类对象（必须）。
⑤配置和测试Mapper对象
注：使用Mapper前，需要将待测试的Mapper接口，添加进去（添加的方式有多种，这里目前只演示这一种）。
注：没有任何要求，跟原生态一样
⑥小结
使用方面，除了构造SqlSessionFactory跟原生态不一致（更换了一个API）其它基本相同。
注：更多使用，请参考第4章节（组件的使用）
最低0.47元/天 解锁文章
2421
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
