From 588a361d0e8ba0da54dbca398564bb3cef7e30f5 Mon Sep 17 00:00:00 2001 From: AmyliaY <471816751@qq.com> Date: Sat, 1 Feb 2020 22:38:40 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BB=8ESpring=E5=8F=8AMybatis=E6=A1=86?= =?UTF-8?q?=E6=9E=B6=E6=BA=90=E7=A0=81=E4=B8=AD=E5=AD=A6=E4=B9=A0=E8=AE=BE?= =?UTF-8?q?=E8=AE=A1=E6=A8=A1=E5=BC=8F(=E7=BB=93=E6=9E=84=E5=9E=8B)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...源码中学习设计模式(结构型).md | 1076 ++++++++++++++++- images/DesignPattern/策略模式类图.png | Bin 0 -> 33823 bytes .../DesignPattern/观察者模式类图.png | Bin 0 -> 34878 bytes 3 files changed, 1075 insertions(+), 1 deletion(-) create mode 100644 images/DesignPattern/策略模式类图.png create mode 100644 images/DesignPattern/观察者模式类图.png diff --git a/docs/LearningExperience/DesignPattern/从Spring及Mybatis框架源码中学习设计模式(结构型).md b/docs/LearningExperience/DesignPattern/从Spring及Mybatis框架源码中学习设计模式(结构型).md index 5439a4a..fe6b324 100644 --- a/docs/LearningExperience/DesignPattern/从Spring及Mybatis框架源码中学习设计模式(结构型).md +++ b/docs/LearningExperience/DesignPattern/从Spring及Mybatis框架源码中学习设计模式(结构型).md @@ -1 +1,1075 @@ -编写中... \ No newline at end of file +设计模式是解决问题的方案，从大神的代码中学习对设计模式的使用，可以有效提升个人编码及设计代码的能力。本系列博文用于总结阅读过的框架源码（Spring系列、Mybatis）及JDK源码中 所使用过的设计模式，并结合个人工作经验，重新理解设计模式。 + +本篇博文主要看一下结构型的几个设计模式，即，策略模式、模板方法模式、迭代器模式 及 观察者模式。 + +## 策略模式 +#### 个人理解 +去年看了蛮多源码，发现 框架的开发者在实际使用设计模式时，大都会根据实际情况 使用其变体，老老实实按照书上的类图及定义去设计代码的比较少。不过我们依然还是先看一下书上的定义，然后比较一下理论与实践的一些差别吧。策略模式的类图及定义如下。 + +![avatar](/images/DesignPattern/策略模式类图.png) + +定义一系列算法，封装每个算法 并使它们可以互换。该模式的主要角色如下： + +- Strategy接口：用于定义一个算法族，它们都具有behavior()方法； +- Context：使用该算法的类，持有Strategy对象，其中的setStrategy(Strategy stra)方法可以动态地改变strategy对象，以此改变自己所使用的算法。 + +很多书上都使用Duck和QuackBehavior作为示例进行说明，这里就不重复咯，主要看一下Spring中是如何使用该模式的。 + +#### Spring中的实现 +Spring的 AbstractAutowireCapableBeanFactory 在进行bean实例化时使用了策略模式的变种，其中InstantiationStrategy 接口 定义了实例化方法，实现类SimpleInstantiationStrategy 和 CglibSubclassingInstantiationStrategy 分别实现了各自的算法，AbstractAutowireCapableBeanFactory 则通过持有 InstantiationStrategy 对象，对算进行使用。其源码实现如下。 +```java +/** + * 本接口用于定义bean实例的创建，通过给定的RootBeanDefinition对象 + * 本组件使用了策略模式，因为各种情况，需要使用不同的方法来实现，包括使用CGLIB动态创建子类 + * @author Rod Johnson + * @since 1.1 + */ +public interface InstantiationStrategy { + + /** + * 返回一个bean实例，使用BeanFactory给定的参数 + */ + Object instantiate(RootBeanDefinition beanDefinition, String beanName, BeanFactory owner) + throws BeansException; + + Object instantiate(RootBeanDefinition beanDefinition, String beanName, BeanFactory owner, + Constructor ctor, Object[] args) throws BeansException; + + Object instantiate(RootBeanDefinition beanDefinition, String beanName, BeanFactory owner, + Object factoryBean, Method factoryMethod, Object[] args) throws BeansException; + +} + + +public class SimpleInstantiationStrategy implements InstantiationStrategy { + + /** + * 具体使用哪个策略进行bean的实例化，是在这个实现类中决定的 + */ + public Object instantiate(RootBeanDefinition beanDefinition, String beanName, BeanFactory owner) { + // 如果beanDefinition中没有方法覆盖，则使用Java的反射机制实例化对象，否则使用CGLIB策略 + if (beanDefinition.getMethodOverrides().isEmpty()) { + Constructor constructorToUse; + synchronized (beanDefinition.constructorArgumentLock) { + // 获取对象的构造方法或生成对象的工厂方法对bean进行实例化 + constructorToUse = (Constructor) beanDefinition.resolvedConstructorOrFactoryMethod; + + // 如果前面没有获取到构造方法，则通过反射获取 + if (constructorToUse == null) { + // 使用JDK的反射机制，判断要实例化的Bean是否是接口 + final Class clazz = beanDefinition.getBeanClass(); + // 如果clazz是一个接口，直接抛出异常 + if (clazz.isInterface()) { + throw new BeanInstantiationException(clazz, "Specified class is an interface"); + } + try { + if (System.getSecurityManager() != null) { + // 这里是一个匿名内置类，使用反射机制获取Bean的构造方法 + constructorToUse = AccessController.doPrivileged(new PrivilegedExceptionAction() { + public Constructor run() throws Exception { + return clazz.getDeclaredConstructor((Class[]) null); + } + }); + } + else { + constructorToUse = clazz.getDeclaredConstructor((Class[]) null); + } + beanDefinition.resolvedConstructorOrFactoryMethod = constructorToUse; + } + catch (Exception ex) { + throw new BeanInstantiationException(clazz, "No default constructor found", ex); + } + } + } + // 使用BeanUtils实例化，通过反射机制调用”构造方法.newInstance(arg)”来进行实例化 + return BeanUtils.instantiateClass(constructorToUse); + } + else { + /** + * ！！！！！！！！！！！！！！ + * 使用CGLIB来实例化对象 + * 调用了其子类CglibSubclassingInstantiationStrategy中的实现 + * ！！！！！！！！！！！！！！ + */ + return instantiateWithMethodInjection(beanDefinition, beanName, owner); + } + } +} + + +public class CglibSubclassingInstantiationStrategy extends SimpleInstantiationStrategy { + + /** + * 下面两个方法都通过实例化自己的私有静态内部类CglibSubclassCreator， + * 然后调用该内部类对象的实例化方法instantiate()完成实例化 + */ + protected Object instantiateWithMethodInjection( + RootBeanDefinition beanDefinition, String beanName, BeanFactory owner) { + + // 必须生成cglib子类 + return new CglibSubclassCreator(beanDefinition, owner).instantiate(null, null); + } + + @Override + protected Object instantiateWithMethodInjection( + RootBeanDefinition beanDefinition, String beanName, BeanFactory owner, + Constructor ctor, Object[] args) { + + return new CglibSubclassCreator(beanDefinition, owner).instantiate(ctor, args); + } + + /** + * 为避免3.2之前的Spring版本中的外部cglib依赖而创建的内部类 + */ + private static class CglibSubclassCreator { + + private final RootBeanDefinition beanDefinition; + + private final BeanFactory owner; + + public CglibSubclassCreator(RootBeanDefinition beanDefinition, BeanFactory owner) { + this.beanDefinition = beanDefinition; + this.owner = owner; + } + + //使用CGLIB进行Bean对象实例化 + public Object instantiate(Constructor ctor, Object[] args) { + //实例化Enhancer对象，并为Enhancer对象设置父类，生成Java对象的参数，比如：基类、回调方法等 + Enhancer enhancer = new Enhancer(); + //将Bean本身作为其父类 + enhancer.setSuperclass(this.beanDefinition.getBeanClass()); + enhancer.setCallbackFilter(new CallbackFilterImpl()); + enhancer.setCallbacks(new Callback[] { + NoOp.INSTANCE, + new LookupOverrideMethodInterceptor(), + new ReplaceOverrideMethodInterceptor() + }); + + //使用CGLIB的create方法生成实例对象 + return (ctor == null) ? enhancer.create() : enhancer.create(ctor.getParameterTypes(), args); + } + } +} + + +public abstract class AbstractAutowireCapableBeanFactory extends AbstractBeanFactory + implements AutowireCapableBeanFactory { + + /** 创建bean实例的策略，注意 这里直接实例化的是 CglibSubclassingInstantiationStrategy 对象 */ + private InstantiationStrategy instantiationStrategy = new CglibSubclassingInstantiationStrategy(); + + /** + * 设置用于创建bean实例的实例化策略，默认使用CglibSubclassingInstantiationStrategy + */ + public void setInstantiationStrategy(InstantiationStrategy instantiationStrategy) { + this.instantiationStrategy = instantiationStrategy; + } + + protected InstantiationStrategy getInstantiationStrategy() { + return this.instantiationStrategy; + } + + /** + * 使用默认的无参构造方法实例化Bean对象 + */ + protected BeanWrapper instantiateBean(final String beanName, final RootBeanDefinition mbd) { + try { + Object beanInstance; + final BeanFactory parent = this; + // 获取系统的安全管理接口，JDK标准的安全管理API + if (System.getSecurityManager() != null) { + // 这里是一个匿名内置类，根据实例化策略创建实例对象 + beanInstance = AccessController.doPrivileged(new PrivilegedAction() { + public Object run() { + return getInstantiationStrategy().instantiate(mbd, beanName, parent); + } + }, getAccessControlContext()); + } + else { + + /** + * ！！！！！！！！！！！！！！ + * 使用初始化策略实例化Bean对象 + * ！！！！！！！！！！！！！！ + */ + beanInstance = getInstantiationStrategy().instantiate(mbd, beanName, parent); + } + BeanWrapper bw = new BeanWrapperImpl(beanInstance); + initBeanWrapper(bw); + return bw; + } + catch (Throwable ex) { + throw new BeanCreationException(mbd.getResourceDescription(), beanName, "Instantiation of bean failed", ex); + } + } + + ... + +} +``` +与标准的策略模式的设计区别在于，实现类CglibSubclassingInstantiationStrategy并不是直接实现了InstantiationStrategy接口，而是继承了SimpleInstantiationStrategy，SimpleInstantiationStrategy直接实现了 通过JDK反射机制实例化bean的策略，而CglibSubclassingInstantiationStrategy则是在自己的私有静态内部类中 完成的 通过CGLIB实例化bean的策略。 + +另外，虽然AbstractAutowireCapableBeanFactory默认持有的是CglibSubclassingInstantiationStrategy的实例，但具体使用哪个实现类中的策略，则是由CglibSubclassingInstantiationStrategy的父类SimpleInstantiationStrategy中的instantiate()方法决定的。也就是说，虽然持有的是CglibSubclassingInstantiationStrategy对象，但实际上可能使用的是 JDK反射机制实例化bean的策略。 + +设计模式的生产实践可能比 理论上的那些示例复杂的多，所以，若想确实提高自己代码的设计能力，还是要摆脱书本，多看实际应用。 + +#### Mybatis 中的实现 +mybatis 的 DefaultSqlSession 使用了策略模式，DefaultSqlSession 扮演了 Context 的角色，Executor 接口及其实现类扮演了策略接口及实现。DefaultSqlSession 持有 Executor 对象，在DefaultSqlSession 实例化时通过构造方法传入具体的 Executor 对象，根据持有的 Executor 对象的不同，而使用不同的策略进行数据库操作。具体使用哪个 Executor 的实例，由 Configuration 的 newExecutor() 方法决定。 +```java +public class DefaultSqlSession implements SqlSession { + + private final Executor executor; + + /** + * 在构造方法中为 executor 赋值，没有提供专门的set方法 + */ + public DefaultSqlSession(Configuration configuration, Executor executor, boolean autoCommit) { + this.configuration = configuration; + this.executor = executor; + this.dirty = false; + this.autoCommit = autoCommit; + } + + /** + * executor的不同，决定了DefaultSqlSession使用哪种策略执行SQL操作 + */ + @Override + public void select(String statement, Object parameter, RowBounds rowBounds, ResultHandler handler) { + try { + MappedStatement ms = configuration.getMappedStatement(statement); + executor.query(ms, wrapCollection(parameter), rowBounds, handler); + } catch (Exception e) { + throw ExceptionFactory.wrapException("Error querying database. Cause: " + e, e); + } finally { + ErrorContext.instance().reset(); + } + } + + @Override + public int update(String statement, Object parameter) { + try { + dirty = true; + MappedStatement ms = configuration.getMappedStatement(statement); + return executor.update(ms, wrapCollection(parameter)); + } catch (Exception e) { + throw ExceptionFactory.wrapException("Error updating database. Cause: " + e, e); + } finally { + ErrorContext.instance().reset(); + } + } +} + + +public interface Executor { + + int update(MappedStatement ms, Object parameter) throws SQLException; + + List query(MappedStatement ms, Object parameter, RowBounds rowBounds, ResultHandler resultHandler, CacheKey cacheKey, BoundSql boundSql) throws SQLException; + + void commit(boolean required) throws SQLException; + + void rollback(boolean required) throws SQLException; + + Transaction getTransaction(); + + ...... +} + + +public abstract class BaseExecutor implements Executor { + + ...... + + protected BaseExecutor(Configuration configuration, Transaction transaction) { + this.transaction = transaction; + this.deferredLoads = new ConcurrentLinkedQueue<>(); + this.localCache = new PerpetualCache("LocalCache"); + this.localOutputParameterCache = new PerpetualCache("LocalOutputParameterCache"); + this.closed = false; + this.configuration = configuration; + this.wrapper = this; + } + + ...... +} + + +public class SimpleExecutor extends BaseExecutor { + + public SimpleExecutor(Configuration configuration, Transaction transaction) { + super(configuration, transaction); + } + + @Override + public int doUpdate(MappedStatement ms, Object parameter) throws SQLException { + Statement stmt = null; + try { + Configuration configuration = ms.getConfiguration(); + StatementHandler handler = configuration.newStatementHandler(this, ms, parameter, RowBounds.DEFAULT, null, null); + stmt = prepareStatement(handler, ms.getStatementLog()); + return handler.update(stmt); + } finally { + closeStatement(stmt); + } + } + + @Override + public List doQuery(MappedStatement ms, Object parameter, RowBounds rowBounds, ResultHandler resultHandler, BoundSql boundSql) throws SQLException { + Statement stmt = null; + try { + // 获取配置对象 + Configuration configuration = ms.getConfiguration(); + // 创建 StatementHandler 对象，实际返回的是 RoutingStatementHandler 对象，前面介绍过， + // 其中根据 MappedStatement.statementType 选择具体的 StatementHandler 实现 + StatementHandler handler = configuration.newStatementHandler(wrapper, ms, parameter, rowBounds, resultHandler, boundSql); + // 完成 Statement 的创建和初始化，该方法首先会调用 StatementHandler.prepare() 方法 + // 创建 Statement 对象， 然后调用 StatementHandler. parameterize() 方法处理占位符 + stmt = prepareStatement(handler, ms.getStatementLog()); + // 调用 StatementHandler.query() 方法，执行 SQL 语句，并通过 ResultSetHandler 完成 + // 结果集的映射 + return handler.query(stmt, resultHandler); + } finally { + // 关闭 Statement 对象 + closeStatement(stmt); + } + } + + ...... +} + + +public class BatchExecutor extends BaseExecutor { + + @Override + public int doUpdate(MappedStatement ms, Object parameterObject) throws SQLException { + // 获取配置对象 + final Configuration configuration = ms.getConfiguration(); + // 创建 StatementHandler 对象 + final StatementHandler handler = configuration.newStatementHandler(this, ms, parameterObject, RowBounds.DEFAULT, null, null); + final BoundSql boundSql = handler.getBoundSql(); + // 获取 SQL 语句 + final String sql = boundSql.getSql(); + final Statement stmt; + // 如果当前执行的 SQL 模式与上次执行的 SQL 模式相同且对应的 MappedStatement 对象相同 + if (sql.equals(currentSql) && ms.equals(currentStatement)) { + // 获取 statementList 集合中最后一个 Statement 对象 + int last = statementList.size() - 1; + stmt = statementList.get(last); + applyTransactionTimeout(stmt); + // 绑定实参，处理占位符 “？” + handler.parameterize(stmt);//fix Issues 322 + // 查找对应的 BatchResult 对象，并记录用户传入的实参 + BatchResult batchResult = batchResultList.get(last); + batchResult.addParameterObject(parameterObject); + } else { + Connection connection = getConnection(ms.getStatementLog()); + // 创建新的 Statement 对象 + stmt = handler.prepare(connection, transaction.getTimeout()); + // 绑定实参，处理占位符“？” + handler.parameterize(stmt); //fix Issues 322 + // 更新 currentSql 和 currentStatement + currentSql = sql; + currentStatement = ms; + // 将新创建的 Statement 对象添加到 statementList 集合中 + statementList.add(stmt); + // 添加新的 BatchResult 对象 + batchResultList.add(new BatchResult(ms, sql, parameterObject)); + } + // 底层通过调用 Statement.addBatch() 方法添加 SQL 语句 + handler.batch(stmt); + return BATCH_UPDATE_RETURN_VALUE; + } + + ...... +} + + +public class Configuration { + + /** + * 在这个方法中决定使用哪个 Executor 实现 + */ + public Executor newExecutor(Transaction transaction, ExecutorType executorType) { + executorType = executorType == null ? defaultExecutorType : executorType; + executorType = executorType == null ? ExecutorType.SIMPLE : executorType; + Executor executor; + if (ExecutorType.BATCH == executorType) { + executor = new BatchExecutor(this, transaction); + } else if (ExecutorType.REUSE == executorType) { + executor = new ReuseExecutor(this, transaction); + } else { + executor = new SimpleExecutor(this, transaction); + } + if (cacheEnabled) { + executor = new CachingExecutor(executor); + } + executor = (Executor) interceptorChain.pluginAll(executor); + return executor; + } + + ...... +} +``` + +## 模板方法模式 +#### 个人理解 +在该模式中，一个算法可以分为多个步骤，这些步骤的执行次序在一个被称为“模板方法”的方法中定义，而算法的每个步骤都对应着一个方法，这些方法被称为 “基本方法”。 模板方法按照它定义的顺序依次调用多个基本方法，从而实现整个算法流程。在模板方法模式中，会将模板方法的实现以及那些固定不变的基本方法的实现放在父类中，而那些不固定的基 本方法在父类中只是抽象方法，其真正的实现代码会被延迟到子类中完成。 + +我觉得这是最简单且常用的设计模式之一咯，自己在实现一些功能时也会使用这种模式，在抽象类中定义好流程的执行顺序，通用的流程在抽象类中实现，个性化的流程交给各个子类去实现。spring及mybatis中均有应用。 + +#### Spring中的应用 +Spring 中的 AbstractApplicationContext 和其子类 AbstractRefreshableApplicationContext、GenericApplicationContext 使用了模板方法模式。源码实现及详细注释如下。 +```java +public abstract class AbstractApplicationContext extends DefaultResourceLoader + implements ConfigurableApplicationContext, DisposableBean { + + /** + * 告诉子类启动refreshBeanFactory()方法，BeanDefinition资源文件的载入 + * 从子类的refreshBeanFactory()方法启动开始 + */ + protected ConfigurableListableBeanFactory obtainFreshBeanFactory() { + // 这里使用了模板方法模式，自己定义了流程，个性化的方法实现交由子类完成 + // 其中，refreshBeanFactory() 和 getBeanFactory()为抽象方法 + refreshBeanFactory(); + ConfigurableListableBeanFactory beanFactory = getBeanFactory(); + if (logger.isDebugEnabled()) { + logger.debug("Bean factory for " + getDisplayName() + ": " + beanFactory); + } + return beanFactory; + } + + protected abstract void refreshBeanFactory() throws BeansException, IllegalStateException; + + public abstract ConfigurableListableBeanFactory getBeanFactory() throws IllegalStateException; + +} + + +public abstract class AbstractRefreshableApplicationContext extends AbstractApplicationContext { + + /** + * 在这里完成了容器的初始化，并赋值给自己private的beanFactory属性，为下一步调用做准备 + * 从父类AbstractApplicationContext继承的抽象方法，自己做了实现 + */ + @Override + protected final void refreshBeanFactory() throws BeansException { + // 如果已经建立了IoC容器，则销毁并关闭容器 + if (hasBeanFactory()) { + destroyBeans(); + closeBeanFactory(); + } + try { + // 创建IoC容器，DefaultListableBeanFactory类实现了ConfigurableListableBeanFactory接口 + DefaultListableBeanFactory beanFactory = createBeanFactory(); + beanFactory.setSerializationId(getId()); + // 定制化IoC容器，如设置启动参数，开启注解的自动装配等 + customizeBeanFactory(beanFactory); + // 载入BeanDefinition，这里又使用了一个委派模式，在当前类定义此抽象方法，子类容器具体实现 + loadBeanDefinitions(beanFactory); + synchronized (this.beanFactoryMonitor) { + // 给自己的属性赋值 + this.beanFactory = beanFactory; + } + } + catch (IOException ex) { + throw new ApplicationContextException("I/O error parsing bean definition source for " + getDisplayName(), ex); + } + } + + @Override + public final ConfigurableListableBeanFactory getBeanFactory() { + synchronized (this.beanFactoryMonitor) { + if (this.beanFactory == null) { + throw new IllegalStateException("BeanFactory not initialized or already closed - " + + "call 'refresh' before accessing beans via the ApplicationContext"); + } + return this.beanFactory; + } + } +} + + +public class GenericApplicationContext extends AbstractApplicationContext implements BeanDefinitionRegistry { + + @Override + protected final void refreshBeanFactory() throws IllegalStateException { + if (this.refreshed) { + throw new IllegalStateException( + "GenericApplicationContext does not support multiple refresh attempts: just call 'refresh' once"); + } + this.beanFactory.setSerializationId(getId()); + this.refreshed = true; + } + + public final ConfigurableListableBeanFactory getBeanFactory() { + return this.beanFactory; + } +} +``` + +#### Mybatis中的应用 +mybatis的 Executor 组件使用了该模式，其中抽象类 BaseExecutor 定义了模板方法和抽象方法，实现类 SimpleExecutor、BatchExecutor 及 ReuseExecutor 对抽象方法进行具体实现。源码如下。 +```java +public abstract class BaseExecutor implements Executor { + + @Override + public int update(MappedStatement ms, Object parameter) throws SQLException { + ErrorContext.instance().resource(ms.getResource()).activity("executing an update").object(ms.getId()); + // 判断当前 Executor 是否已经关闭 + if (closed) { + throw new ExecutorException("Executor was closed."); + } + // clearLocalCache() 方法中会调用 localCache()、localOutputParameterCache() 两个 + // 缓存的 clear() 方法完成清理工作。这是影响一级缓存中数据存活时长的第三个方面 + clearLocalCache(); + // 调用 doUpdate() 抽象方法执行 SQL 语句 + return doUpdate(ms, parameter); + } + + public List flushStatements(boolean isRollBack) throws SQLException { + // 判断当前 Executor 是否已经关闭 + if (closed) { + throw new ExecutorException("Executor was closed."); + } + // 调用抽象方法 doFlushStatements()，其参数 isRollBack 表示是否执行 Executor 中缓存的 + // SQL 语句，false 表示执行，true 表示不执行 + return doFlushStatements(isRollBack); + } + + /** + * 调用 doQuery() 方法完成数据库查询，并得到映射后的结果集对象， + */ + private List queryFromDatabase(MappedStatement ms, Object parameter, RowBounds rowBounds, ResultHandler resultHandler, CacheKey key, BoundSql boundSql) throws SQLException { + List list; + // 在缓存中添加占位符 + localCache.putObject(key, EXECUTION_PLACEHOLDER); + try { + // 调用 doQuery() 抽象方法，完成数据库查询操作，并返回结果集对象 + list = doQuery(ms, parameter, rowBounds, resultHandler, boundSql); + } finally { + // 删除占位符 + localCache.removeObject(key); + } + // 将真正的结采对象添加到一级缓存中 + localCache.putObject(key, list); + // 是否为存储过程调用 + if (ms.getStatementType() == StatementType.CALLABLE) { + // 缓存输出类型的参数 + localOutputParameterCache.putObject(key, parameter); + } + return list; + } + + @Override + public Cursor queryCursor(MappedStatement ms, Object parameter, RowBounds rowBounds) throws SQLException { + BoundSql boundSql = ms.getBoundSql(parameter); + return doQueryCursor(ms, parameter, rowBounds, boundSql); + } + + protected abstract int doUpdate(MappedStatement ms, Object parameter) + throws SQLException; + + protected abstract List doFlushStatements(boolean isRollback) + throws SQLException; + + protected abstract List doQuery(MappedStatement ms, Object parameter, RowBounds rowBounds, ResultHandler resultHandler, BoundSql boundSql) + throws SQLException; + + protected abstract Cursor doQueryCursor(MappedStatement ms, Object parameter, RowBounds rowBounds, BoundSql boundSql) + throws SQLException; +} + + +public class SimpleExecutor extends BaseExecutor { + + @Override + public int doUpdate(MappedStatement ms, Object parameter) throws SQLException { + Statement stmt = null; + try { + Configuration configuration = ms.getConfiguration(); + StatementHandler handler = configuration.newStatementHandler(this, ms, parameter, RowBounds.DEFAULT, null, null); + stmt = prepareStatement(handler, ms.getStatementLog()); + return handler.update(stmt); + } finally { + closeStatement(stmt); + } + } + + @Override + public List doQuery(MappedStatement ms, Object parameter, RowBounds rowBounds, ResultHandler resultHandler, BoundSql boundSql) throws SQLException { + Statement stmt = null; + try { + // 获取配置对象 + Configuration configuration = ms.getConfiguration(); + // 创建 StatementHandler 对象，实际返回的是 RoutingStatementHandler 对象，前面介绍过， + // 其中根据 MappedStatement.statementType 选择具体的 StatementHandler 实现 + StatementHandler handler = configuration.newStatementHandler(wrapper, ms, parameter, rowBounds, resultHandler, boundSql); + // 完成 Statement 的创建和初始化，该方法首先会调用 StatementHandler.prepare() 方法 + // 创建 Statement 对象， 然后调用 StatementHandler. parameterize() 方法处理占位符 + stmt = prepareStatement(handler, ms.getStatementLog()); + // 调用 StatementHandler.query() 方法，执行 SQL 语句，并通过 ResultSetHandler 完成 + // 结果集的映射 + return handler.query(stmt, resultHandler); + } finally { + // 关闭 Statement 对象 + closeStatement(stmt); + } + } + + @Override + protected Cursor doQueryCursor(MappedStatement ms, Object parameter, RowBounds rowBounds, BoundSql boundSql) throws SQLException { + Configuration configuration = ms.getConfiguration(); + StatementHandler handler = configuration.newStatementHandler(wrapper, ms, parameter, rowBounds, null, boundSql); + Statement stmt = prepareStatement(handler, ms.getStatementLog()); + Cursor cursor = handler.queryCursor(stmt); + stmt.closeOnCompletion(); + return cursor; + } + + @Override + public List doFlushStatements(boolean isRollback) { + return Collections.emptyList(); + } + + private Statement prepareStatement(StatementHandler handler, Log statementLog) throws SQLException { + Statement stmt; + Connection connection = getConnection(statementLog); + stmt = handler.prepare(connection, transaction.getTimeout()); + handler.parameterize(stmt); + return stmt; + } +} + + +public class BatchExecutor extends BaseExecutor { + + @Override + public int doUpdate(MappedStatement ms, Object parameterObject) throws SQLException { + // 获取配置对象 + final Configuration configuration = ms.getConfiguration(); + // 创建 StatementHandler 对象 + final StatementHandler handler = configuration.newStatementHandler(this, ms, parameterObject, RowBounds.DEFAULT, null, null); + final BoundSql boundSql = handler.getBoundSql(); + // 获取 SQL 语句 + final String sql = boundSql.getSql(); + final Statement stmt; + // 如果当前执行的 SQL 模式与上次执行的 SQL 模式相同且对应的 MappedStatement 对象相同 + if (sql.equals(currentSql) && ms.equals(currentStatement)) { + // 获取 statementList 集合中最后一个 Statement 对象 + int last = statementList.size() - 1; + stmt = statementList.get(last); + applyTransactionTimeout(stmt); + // 绑定实参，处理占位符 “？” + handler.parameterize(stmt);//fix Issues 322 + // 查找对应的 BatchResult 对象，并记录用户传入的实参 + BatchResult batchResult = batchResultList.get(last); + batchResult.addParameterObject(parameterObject); + } else { + Connection connection = getConnection(ms.getStatementLog()); + // 创建新的 Statement 对象 + stmt = handler.prepare(connection, transaction.getTimeout()); + // 绑定实参，处理占位符“？” + handler.parameterize(stmt); //fix Issues 322 + // 更新 currentSql 和 currentStatement + currentSql = sql; + currentStatement = ms; + // 将新创建的 Statement 对象添加到 statementList 集合中 + statementList.add(stmt); + // 添加新的 BatchResult 对象 + batchResultList.add(new BatchResult(ms, sql, parameterObject)); + } + // 底层通过调用 Statement.addBatch() 方法添加 SQL 语句 + handler.batch(stmt); + return BATCH_UPDATE_RETURN_VALUE; + } + + @Override + public List doQuery(MappedStatement ms, Object parameterObject, RowBounds rowBounds, ResultHandler resultHandler, BoundSql boundSql) + throws SQLException { + Statement stmt = null; + try { + flushStatements(); + Configuration configuration = ms.getConfiguration(); + StatementHandler handler = configuration.newStatementHandler(wrapper, ms, parameterObject, rowBounds, resultHandler, boundSql); + Connection connection = getConnection(ms.getStatementLog()); + stmt = handler.prepare(connection, transaction.getTimeout()); + handler.parameterize(stmt); + return handler.query(stmt, resultHandler); + } finally { + closeStatement(stmt); + } + } + + @Override + protected Cursor doQueryCursor(MappedStatement ms, Object parameter, RowBounds rowBounds, BoundSql boundSql) throws SQLException { + flushStatements(); + Configuration configuration = ms.getConfiguration(); + StatementHandler handler = configuration.newStatementHandler(wrapper, ms, parameter, rowBounds, null, boundSql); + Connection connection = getConnection(ms.getStatementLog()); + Statement stmt = handler.prepare(connection, transaction.getTimeout()); + handler.parameterize(stmt); + Cursor cursor = handler.queryCursor(stmt); + stmt.closeOnCompletion(); + return cursor; + } + + @Override + public List doFlushStatements(boolean isRollback) throws SQLException { + try { + // results 集合用于储存批处理的结采 + List results = new ArrayList<>(); + // 如果明确指定了要回滚事务，则直接返回空集合，忽略 statementList 集合中记录的 SQL 语句 + if (isRollback) { + return Collections.emptyList(); + } + // 遍历 statementList 集合 + for (int i = 0, n = statementList.size(); i < n; i++) { + // 获取 Statement 对象 + Statement stmt = statementList.get(i); + applyTransactionTimeout(stmt); + // 获取对应 BatchResult 对象 + BatchResult batchResult = batchResultList.get(i); + try { + // 调用 Statement.executeBatch() 方法批量执行其中记录的 SQL 语句，并使用返回的 int 数组 + // 更新 BatchResult.updateCounts 字段，其中每一个元素都表示一条 SQL 语句影响的记录条数 + batchResult.setUpdateCounts(stmt.executeBatch()); + MappedStatement ms = batchResult.getMappedStatement(); + List parameterObjects = batchResult.getParameterObjects(); + // 获取配置的 KeyGenerator 对象 + KeyGenerator keyGenerator = ms.getKeyGenerator(); + if (Jdbc3KeyGenerator.class.equals(keyGenerator.getClass())) { + Jdbc3KeyGenerator jdbc3KeyGenerator = (Jdbc3KeyGenerator) keyGenerator; + // 获取数据库生成的主键，并设置到 parameterObjects 中，前面已经分析过，这里不再重复 + jdbc3KeyGenerator.processBatch(ms, stmt, parameterObjects); + } else if (!NoKeyGenerator.class.equals(keyGenerator.getClass())) { //issue #141 + // 对于其他类型的 KeyGenerator，会调用其 processAfter() 方法 + for (Object parameter : parameterObjects) { + keyGenerator.processAfter(this, ms, stmt, parameter); + } + } + // Close statement to close cursor #1109 + closeStatement(stmt); + } catch (BatchUpdateException e) { + StringBuilder message = new StringBuilder(); + message.append(batchResult.getMappedStatement().getId()) + .append(" (batch index #") + .append(i + 1) + .append(")") + .append(" failed."); + if (i > 0) { + message.append(" ") + .append(i) + .append(" prior sub executor(s) completed successfully, but will be rolled back."); + } + throw new BatchExecutorException(message.toString(), e, results, batchResult); + } + // 添加 BatchResult 到 results 集合 + results.add(batchResult); + } + return results; + } finally { + // 关闭所有 Statement 对象，并清空 currentSql 字段、清空 statementList 集合、 + // 清空 batchResultList 集合（略） + for (Statement stmt : statementList) { + closeStatement(stmt); + } + currentSql = null; + statementList.clear(); + batchResultList.clear(); + } + } +} + + +public class ReuseExecutor extends BaseExecutor { + + @Override + public int doUpdate(MappedStatement ms, Object parameter) throws SQLException { + Configuration configuration = ms.getConfiguration(); + StatementHandler handler = configuration.newStatementHandler(this, ms, parameter, RowBounds.DEFAULT, null, null); + Statement stmt = prepareStatement(handler, ms.getStatementLog()); + return handler.update(stmt); + } + + @Override + public List doQuery(MappedStatement ms, Object parameter, RowBounds rowBounds, ResultHandler resultHandler, BoundSql boundSql) throws SQLException { + Configuration configuration = ms.getConfiguration(); + StatementHandler handler = configuration.newStatementHandler(wrapper, ms, parameter, rowBounds, resultHandler, boundSql); + Statement stmt = prepareStatement(handler, ms.getStatementLog()); + return handler.query(stmt, resultHandler); + } + + @Override + protected Cursor doQueryCursor(MappedStatement ms, Object parameter, RowBounds rowBounds, BoundSql boundSql) throws SQLException { + Configuration configuration = ms.getConfiguration(); + StatementHandler handler = configuration.newStatementHandler(wrapper, ms, parameter, rowBounds, null, boundSql); + Statement stmt = prepareStatement(handler, ms.getStatementLog()); + return handler.queryCursor(stmt); + } + + @Override + public List doFlushStatements(boolean isRollback) { + for (Statement stmt : statementMap.values()) { + closeStatement(stmt); + } + statementMap.clear(); + return Collections.emptyList(); + } +} +``` +可以看得出来，模板方法就是BaseExecutor的update()、flushStatements()、queryFromDatabase() 及 queryCursor()，分别使用了抽象方法doUpdate()、doFlushStatements()、doQuery() 及 doQueryCursor()。 + +## 迭代器模式 +#### 个人理解 +这个模式最经典的实现莫过于 Java的集合类咯。同样还是先简单介绍一下这个设计模式，然后结合ArrayList的源码进行分析。 + +本设计模式用于提供一种遍历集合元素的方法，且不暴露集合对象的内部表示。其主要角色 和 简单实现如下： + +- Aggregate：聚合类，有一个可以获取 Iterator 对象的 iterator() 方法； +- Iterator：主要定义了hasNest() 和 next()方法； +```java +public interface Aggregate { + Iterator iterator(); +} + + +public class ConcreteAggregate implements Aggregate { + + private Integer[] elements; + + public ConcreteAggregate() { + elements = new Integer[10]; + for (int i = 0; i < elements.length; i++) { + elements[i] = i; + } + } + + @Override + public Iterator iterator() { + return new ConcreteIterator(elements); + } +} + + +public interface Iterator { + + boolean hasNext(); + + Integer next(); +} + + +public class ConcreteIterator implements Iterator { + + private Integer[] elements; + private int position = 0; + + public ConcreteIterator(Integer[] elements) { + this.elements = elements; + } + + @Override + public boolean hasNext() { + return position < elements.length; + } + + @Override + public Integer next() { + return elements[position ++]; + } +} + + +public class Client { + + public static void main(String[] args) { + Aggregate aggregate = new ConcreteAggregate(); + Iterator iterator = aggregate.iterator(); + while (iterator.hasNext()) { + System.out.println(iterator.next()); + } + } +} +``` + +#### ArrayList 对迭代器模式的实现 +```java +public class ArrayList extends AbstractList + implements List, RandomAccess, Cloneable, java.io.Serializable { + + /** + * 存储ArrayList元素的数组缓冲区。ArrayList的容量是此数组缓冲区的长度 + */ + transient Object[] elementData; // non-private to simplify nested class access + + /** + * ArrayList的大小（其包含的元素数） + */ + private int size; + + /** + * 以正确的顺序返回此列表中元素的迭代器 + */ + public Iterator iterator() { + return new Itr(); + } + + /** + * ArrayList的私有内部类，其实现了Iterator接口，所以也是一个迭代器 + * AbstractList.Itr的优化版本 + */ + private class Itr implements Iterator { + int cursor; // 要返回的下一个元素的索引 + int lastRet = -1; // 返回的最后一个元素的索引；如果没有则返回 -1 + int expectedModCount = modCount; + + public boolean hasNext() { + return cursor != size; + } + + @SuppressWarnings("unchecked") + public E next() { + checkForComodification(); + int i = cursor; + if (i >= size) + throw new NoSuchElementException(); + Object[] elementData = ArrayList.this.elementData; + if (i >= elementData.length) + throw new ConcurrentModificationException(); + cursor = i + 1; + return (E) elementData[lastRet = i]; + } + } +} +``` + +## 观察者模式 +#### 个人理解 +这个模式也是平时很少使用的，所以就简单介绍一下，然后结合JDK中的源码加深理解。该模式用于定义对象之间的一对多依赖，当一个对象状态改变时，它的所有依赖都会收到通知，然后自动更新。类图和主要角色如下： + +![avatar](/images/DesignPattern/观察者模式类图.png) + +- Subject主题：具有注册、移除及通知观察者的功能，主题是通过维护一个观察者列表来实现这些功能的； +- Observer观察者：其注册需要Subject的registerObserver()方法。 + +#### JDK中的源码实现 +java.util包中提供了 Observable 类和 Observer 接口，其中要求，被观察者需要继承Observable类，观察则需要实现Observer接口。下面看一下其源码实现。 +```java +/** + * 当一个类希望获知 所观察的对象的变化时，可以通过实现本接口来完成 + * 而被观察的对象则需要继承 Observable 类 + * @author Chris Warth + * @see java.util.Observable + * @since JDK1.0 + */ +public interface Observer { + /** + * 每当所观察的对象发生更改时，此方法都会被调用。应用程序调用Observable对象的 + * notifyObservators()方法时，将通知所有注册的观察者 本对象（被观察者）已更新 + */ + void update(Observable o, Object arg); +} + + +/** + * 这个类表示一个可被观察的对象，或者模型视图范例中的“数据”。它可以被继承， + * 以表示该类 可以被观察到。 + * 一个Observable对象可以有一个或多个观察者，观察者可以是实现了Observer接口的任何对象。 + * 在一个Observable实例更改之后，调用其notifyObservers()方法，该方法可以通过调用 所有 + * 已注册的Observer对象的update()方法通知其所有观察者，被观察的对象已更新。 + * @author Chris Warth + * @see java.util.Observable#notifyObservers() + * @see java.util.Observable#notifyObservers(java.lang.Object) + * @see java.util.Observer + * @see java.util.Observer#update(java.util.Observable, java.lang.Object) + * @since JDK1.0 + */ +public class Observable { + private boolean changed = false; + /** + * 通过一个Vector来维护 观察者列表。 + * 由于该集合主要涉及元素的增删操作，所以个人认为使用LinkedList + * 效果会更好一下 + */ + private Vector obs; + + public Observable() { + obs = new Vector<>(); + } + + /** + * 注册 观察者对象 + */ + public synchronized void addObserver(Observer o) { + if (o == null) + throw new NullPointerException(); + if (!obs.contains(o)) { + obs.addElement(o); + } + } + + /** + * 移除观察者对象 + */ + public synchronized void deleteObserver(Observer o) { + obs.removeElement(o); + } + + public void notifyObservers() { + notifyObservers(null); + } + + /** + * 如果此对象已更改，则通知其所有观察者，然后调用clearChanged()方法 清除更改标记 + */ + public void notifyObservers(Object arg) { + // 一个临时数组缓冲区，用作当前观察者状态的快照 + Object[] arrLocal; + + synchronized (this) { + if (!changed) + return; + arrLocal = obs.toArray(); + clearChanged(); + } + + for (int i = arrLocal.length-1; i>=0; i--) + ((Observer)arrLocal[i]).update(this, arg); + } + + /** + * 清除观察者列表，使此对象不再具有任何观察者 + */ + public synchronized void deleteObservers() { + obs.removeAllElements(); + } + + /** + * 将本对象标记为已更改 + */ + protected synchronized void setChanged() { + changed = true; + } + + /** + * 清除本对象的更改标准 + */ + protected synchronized void clearChanged() { + changed = false; + } + + /** + * 查看本对象是否已更改 + */ + public synchronized boolean hasChanged() { + return changed; + } + + /** + * 返回观察者列表的长度 + */ + public synchronized int countObservers() { + return obs.size(); + } +} +``` \ No newline at end of file diff --git a/images/DesignPattern/策略模式类图.png b/images/DesignPattern/策略模式类图.png new file mode 100644 index 0000000000000000000000000000000000000000..ec6788e7d086e78989206ed6819d89ea56cc0b56 GIT binary patch literal 33823 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 t^=8iCoB+G^WrIA{n2!gdXHWjz9c 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 literal 0 HcmV?d00001