厦门做商城网站,网站宣传册,企业网站快照更新,cn域名与com域名*************************************优雅的分割线 ********************************** 分享一波:程序员赚外快-必看的巅峰干货 如果以上内容对你觉得有用,并想获取更多的赚钱方式和免费的技术教程 请关注微信公众号:HB荷包 一个能让你学习技术和赚钱方法的公众号,持续更…*************************************优雅的分割线 ********************************** 分享一波:程序员赚外快-必看的巅峰干货 如果以上内容对你觉得有用,并想获取更多的赚钱方式和免费的技术教程 请关注微信公众号:HB荷包 一个能让你学习技术和赚钱方法的公众号,持续更新 *************************************优雅的分割线 ********************************** SimpleExecutor 前言 笔者大概是从今年的5月份开始喜欢上源码阅读的起初是阅读徐郡明前辈的《Mybatis技术内幕》入的坑不得不说大佬就是大佬书中讲得东西很细很全。半年过去了笔者对mybatis略知一二也开始在为公司搭架构并且基于Mybatis写了一套框架但是尽管如此还是感觉自己对于源码的理解稍微有点浅。好比是初高中学数学吧光看例题不做题是记不住的因此产生了为mybatis写注释的想法想要通过写注释的过程加强对mybatis的理解。虽然现在网上已经有了较全的mybatis中文注释但是感觉还是经过自己手敲更能加强记忆因此便挖下了这个大坑。笔者也希望可以在一年内把这个坑填完后续关于其他技术的文章可能就比较少大多数应该就都是mybatis源码阅读犀利了 在这里附上我的码云地址别问我为什么是码云而不是github下半天代码下不动急死人 mybatis中文注释 同时我也很欢迎更多的初中级开发者投入到阅读源码的行列并且很乐意大家在我的仓库上建立自己的分支希望可以和大家一同进步。 入口 Mybatis 初始化入口文件是SqlSessionFactoryBuilder。该类通过调用XMLConfigBuilder.parse方法初始化配置文件。 public SqlSessionFactory build(Reader reader, String environment, Properties properties) {try {// 读取配置文件XMLConfigBuilder parser new XMLConfigBuilder(reader, environment, properties);return build(parser.parse());} catch (Exception e) {throw ExceptionFactory.wrapException(Error building SqlSession., e);} finally {ErrorContext.instance().reset();try {reader.close();} catch (IOException e) {// Intentionally ignore. Prefer previous error.}}}在XMLConfigBuilder.parse方法中会先校验配置文件是否已经解析过了如果重复解析就抛出异常 public Configuration parse() {if (parsed) {// 已经解析过就不再解析。这里只解析一次throw new BuilderException(每个 XMLConfigBuilder 只能使用一次.);}parsed true;// 获取configuration节点进行解析// mybatis解析配置文件使用的是XPathParser这里的evalNode方法就是解析xml的代码// 这里对XPathParser不进行注释这不属于mybatis的范畴其实是懒。parseConfiguration(parser.evalNode(/configuration));return configuration;}parseConfiguration方法中传入configuration节点配置对mybatis-config.xml文件中的该节点进行解析。解析结果会set到Configuration类中。今天只注释完了properties和settings两个节点的解析 /*** 解析mybatis-config.xml文件** param root*/private void parseConfiguration(XNode root) {try {// 解析properties节点。该节点用来引入外部的资源文件如db.propertiespropertiesElement(root.evalNode(properties));// 解析settings节点校验配置中的配置项是否合法。该节点用来设置一些mybatis的配置项Properties settings settingsAsProperties(root.evalNode(settings));// 加载用户自己配置的虚拟文件系统loadCustomVfs(settings);// 加载日志loadCustomLogImpl(settings);// TODO 解析typeAliases节点下次继续typeAliasesElement(root.evalNode(typeAliases));pluginElement(root.evalNode(plugins));objectFactoryElement(root.evalNode(objectFactory));objectWrapperFactoryElement(root.evalNode(objectWrapperFactory));reflectorFactoryElement(root.evalNode(reflectorFactory));settingsElement(settings);// read it after objectFactory and objectWrapperFactory issue #631environmentsElement(root.evalNode(environments));databaseIdProviderElement(root.evalNode(databaseIdProvider));typeHandlerElement(root.evalNode(typeHandlers));mapperElement(root.evalNode(mappers));} catch (Exception e) {throw new BuilderException(Error parsing SQL Mapper Configuration. Cause: e, e);}}先看propertiesElement方法该方法用于解析properties节点。 /*** 解析mybatis-config.xml的properties节点* 将节点中所有的配置set到Configuration中** param context* throws Exception*/private void propertiesElement(XNode context) throws Exception {if (context ! null) {// 解析拿到节点下的所有子节点配置Properties defaults context.getChildrenAsProperties();// 获取properties节点的resource属性String resource context.getStringAttribute(resource);// 获取properties节点的url属性。String url context.getStringAttribute(url);if (resource ! null url ! null) {// resource和url属性只能同时存在一个。throw new BuilderException(properties节点不能同时指定resource和url两个属性.);}// url和resource属性只能同时存在一个// 读取引入的资源文件所有属性put到properties节点之下if (resource ! null) {defaults.putAll(Resources.getResourceAsProperties(resource));} else if (url ! null) {defaults.putAll(Resources.getUrlAsProperties(url));}Properties vars configuration.getVariables();// 如果configuration之前已经有了配置也put进去// put这些设置是为了能够保证后面set回configuration时可以set所有的配置if (vars ! null) {defaults.putAll(vars);}parser.setVariables(defaults);// 将Properties节点下所有的配置set到configurationconfiguration.setVariables(defaults);}}接着就是解析settings节点该节点用于配置一些mybatis配置项 /*** 解析settings节点** param context* return*/private Properties settingsAsProperties(XNode context) {if (context null) {return new Properties();}// 获取settings节点下所有的setting节点Properties props context.getChildrenAsProperties();// 通过Configuration获取metaClass用于方便对Configuration进行操作MetaClass metaConfig MetaClass.forClass(Configuration.class, localReflectorFactory);for (Object key : props.keySet()) {// 遍历setting配置// 如果Configuration没有这个set方法说明该配置是无效的if (!metaConfig.hasSetter(String.valueOf(key))) {throw new BuilderException(配置 key 无效. 请检查拼写是否正确.);}}// 校验完settings之后返回return props;}解析完settings节点后程序会加载用户配置的虚拟文件系统和日志。 /*** 加载用户自己设置的虚拟文件系统** param props* throws ClassNotFoundException*/private void loadCustomVfs(Properties props) throws ClassNotFoundException {// 从settings中拿到name是vfsImpl的配置节点String value props.getProperty(vfsImpl);if (value ! null) {String[] clazzes value.split(,);for (String clazz : clazzes) {if (!clazz.isEmpty()) {SuppressWarnings(unchecked)Class? extends VFS vfsImpl (Class? extends VFS) Resources.classForName(clazz);// 加载文件系统set到Configuration中configuration.setVfsImpl(vfsImpl);}}}}/*** 加载日志。代码比较简单* 就是从settings中拿到name为logImpl的配置项* 然后set到Configuration中去** param props*/private void loadCustomLogImpl(Properties props) {Class? extends Log logImpl resolveClass(props.getProperty(logImpl));configuration.setLogImpl(logImpl);}引申 上面的代码中使用到了MetaClass类和Configuration类。下面对这两个类进行解释。 首先是Configuration类。该类通过名称可以很明显的知道这是mybatis的配置类对应的是mybatis-config.xml文件的配置。其中今天将properties和settings节点对应的字段进行注释。 public class Configuration {/*** mybatis-config.xml属性* settings节点* 允许嵌套语句中使用分页*/protected boolean safeRowBoundsEnabled;/*** mybatis-config.xml属性* settings节点* 是否开启自动驼峰命名规则映射* 即从经典数据库列名 a_column 到经典 Java 属性名 aColumn 的类似映射。*/protected boolean mapUnderscoreToCamelCase;/*** mybatis-config.xml文件下* settings节点* 当启用时对任意延迟属性的调用会使带有延迟加载属性的对象完整加载* 反之每种属性将会按需加载。*/protected boolean aggressiveLazyLoading;/*** mybatis-config.xml文件下* settings节点* 是否允许单一语句返回多条结果集*/protected boolean multipleResultSetsEnabled true;/*** mybatis-config.xml文件* settings节点* 允许 JDBC 支持自动生成主键*/protected boolean useGeneratedKeys;/*** mybatis-config.xml文件* settings节点* 使用列标签代替列名*/protected boolean useColumnLabel true;/*** mybatis-config.xml文件* settings节点* 该配置影响的所有映射器中配置的缓存的全局开关*/protected boolean cacheEnabled true;/*** mybatis-config.xml文件* settings节点* 指定当结果集中值为null的时候是否调用映射对象的set方法*/protected boolean callSettersOnNulls;/*** mybatis-config.xml文件* settings节点* 指定MyBatis增加到日志名称的前缀*/protected String logPrefix;/*** mybatis-config.xml文件* settings节点* 指定MyBatis所用日志的具体实现*/protected Class? extends Log logImpl;/*** mybatis-config.xml文件* settings节点* VFS含义是虚拟文件系统* 主要是通过程序能够方便读取本地文件系统、FTP文件系统等系统中的文件资源。* Mybatis中提供了VFS这个配置。* 主要是通过该配置可以加载自定义的虚拟文件系统应用程序* 多个文件系统使用逗号隔开*/protected Class? extends VFS vfsImpl;/*** mybatis-config.xml文件* settings节点* mybatis利用本地缓存机制防止循环引用的加速重复嵌套查询。* 默认是SESSION这种情况会缓存一个会话中执行的所有查询* 如果是STATEMENT本地会话仅用在语句执行上* 对相同的SqlSession的不同调用将不会共享数据*/protected LocalCacheScope localCacheScope LocalCacheScope.SESSION;/*** mybatis-config.xml文件* settings节点* 当没有为菜蔬提供特定的JDBC类型时* 为空值制定JDBC类型*/protected JdbcType jdbcTypeForNull JdbcType.OTHER;/*** mybatis-config.xml* settings节点* 指定哪个对象的方法触发一次延迟加载*/protected SetString lazyLoadTriggerMethods new HashSet(Arrays.asList(equals, clone, hashCode, toString));/*** mybatis-config.xml文件* settings节点* 设置超时时间*/protected Integer defaultStatementTimeout;/*** mybatis-config.xml文件* settings节点* 为驱动程序设置提示以控制返回结果的获取大小*/protected Integer defaultFetchSize;/*** mybatis-config.xml文件* settings节点* 配置默认的执行器。* SIMPLE 就是普通的执行器* REUSE 执行器会重用预处理语句PreparedStatements* BATCH 执行器将重用语句并执行批量更新。*/protected ExecutorType defaultExecutorType ExecutorType.SIMPLE;/*** mybatis-config.xml文件* settings节点* 指定 MyBatis 应如何自动映射列到字段或属性。* NONE 表示取消自动映射* PARTIAL 只会自动映射没有定义嵌套结果集映射的结果集。* FULL 会自动映射任意复杂的结果集*/protected AutoMappingBehavior autoMappingBehavior AutoMappingBehavior.PARTIAL;/*** mybatis-config.xml文件下* properties节点的所有配置* 以及该节点对应的resource和url的所有配置* 在XMLConfigBuilder.propertiesElement方法中进行初始化*/protected Properties variables new Properties();/*** mybatis-config.xml文件* settings节点属性* 延迟加载的全局开关。* 当开启时所有关联对象都会延迟加载。* 特定关联关系中可通过设置fetchType属性来覆盖该项的开关状态*/protected boolean lazyLoadingEnabled false;/*** mybatis-config.xml文件* settings节点* 指定Mybatis创建具有延迟加载能力对象所用到的代理工厂*/protected ProxyFactory proxyFactory new JavassistProxyFactory();/*** 将数据库类型转换成Java类型*/protected final TypeHandlerRegistry typeHandlerRegistry new TypeHandlerRegistry(this);/*** 存储扫包得到的别名*/protected final TypeAliasRegistry typeAliasRegistry new TypeAliasRegistry();}而MetaClass是反射工具箱里的一个类。Reflector是Mybatis中反射模块的基础每个Reflector对象都对应一个类在该对象中缓存了反射操作需要使用的元信息如可读属性、可写属性、get、set方法等。ReflectorFactory接口主要实现了对Reflector对象的创建和缓存。而MetaClass则是对Reflector和reflectorFactory的封装使其更方便通过反射去操作一个类。 这里就不帖MetaClass的代码了感兴趣可以自行阅读。 结语 今天因为时间充裕所以写的博客比较清晰后面可能会因为加班所以博客仅仅是对代码注释的复制粘贴还希望读者可以谅解。这个坑我会继续填下去的。 最后需要提一下java里的一个容易被忽视的规范也是面试、大学考试经常喜欢问的内容。 类中定义的成员变量也称之为“字段”而属性则是指get和set方法。属性只与方法有关而与字段无关。如一个类中存在getName()和setName(String name)方法不管该类中有没有name字段我们都认为它有name这个属性。反之如果只有字段name而没有对应的get/set方法则该类仅仅是有name这个字段而没有name属性。后面对于get/set方法我不会称之为属性但是有必要分清楚这两个概念。 *************************************优雅的分割线 ********************************** 分享一波:程序员赚外快-必看的巅峰干货 如果以上内容对你觉得有用,并想获取更多的赚钱方式和免费的技术教程 请关注微信公众号:HB荷包 一个能让你学习技术和赚钱方法的公众号,持续更新 *************************************优雅的分割线 ********************************** SimpleExecutor