资讯专栏INFORMATION COLUMN

从源码学习设计模式之模板方法

yankeys / 2728人阅读

摘要:模板方法模式定义了一个算法的步骤,并允许子类别为一个或多个步骤提供其实践方式。在软件工程中,它是一种软件设计模式,和模板没有关连。模板方法充分运用了多态与继承。去建设银行支付去招商银行支付实现模板方法的细节,我们来看使用逻辑。

Photo by Tomáš Malík on Unsplash

什么是模板方法模式?摘录 wiki 的介绍。

模板方法模式定义了一个算法的步骤,并允许子类别为一个或多个步骤提供其实践方式。让子类别在不改变算法架构的情况下,重新定义算法中的某些步骤。在软件工程中,它是一种软件设计模式,和C++模板没有关连。

模板设计方法存在目的在于某些算法逻辑存在一些相同处,而具体细节却不同。这样使用模板方法,可以抽取共用逻辑到父类,在子类实现具体算法细节,这样减少了重复代码。
模板方法充分运用了多态与继承。使用抽象父类定义抽象操作,然后在公共逻辑调用抽象方法。子类方法只要继承父类关注自身实现细节。

Talk is cheap. Show me the code

下面拿支付接入支付渠道例子来使用模板方法。

假设银行卡支付需要实现两家银行的支付功能。不同银行提供的接口,在参数,调用方式等肯定存在很大区别。这个时候我们就可以使用模板设计方法,父类实现支付前通用逻辑,用子类实现交互的不同。系统类结构如下。

AgreementPay 提供支付功能,AgreementBasePay 为抽象类实现通用逻辑,AgreementCCBPayAgreementCMBPay 实现具体的渠道支付方法。具体源码如下。

AgreementPay 接口

public interface AgreementPay {

    PayResponse payInChannel(PayRequest request);
}

AgreementBasePay 抽象方法实现通用逻辑。

public abstract class AgreementBasePay implements AgreementPay {

    public PayResponse pay(PayRequest request) {
        checkRequest(request);
        return this.payInChannel(request);
    }


    private void checkRequest(PayRequest request) {
        System.out.println("具体方法参数检查");
    }
}

具体实现类,实现具体渠道支付细节。

public class AgreementCCBPay extends AgreementBasePay {
    @Override
    public PayResponse payInChannel(PayRequest request) {
        System.out.println("去建设银行支付");
        return new PayResponse();
    }
}

public class AgreementCMBPay extends AgreementBasePay {
    @Override
    public PayResponse payInChannel(PayRequest request) {
        System.out.println("去招商银行支付");
        return new PayResponse();
    }
}

实现模板方法的细节,我们来看 client 使用逻辑。

public class Client {

    public static void main(String[] args) {
        System.out.println("使用招商银行支付");
        AgreementPay agreementPay = new AgreementCMBPay();
        PayRequest request = new PayRequest();
        agreementPay.payInChannel(request);
        System.out.println("使用建设银行支付");
        agreementPay = new AgreementCCBPay();
        agreementPay.payInChannel(request);
    }
}

上面 client 逻辑,其实看起来还是有一些死板,且需要外部知道调用哪个渠道接口。但是如果真正提供一个对外接口,外部调用方法是不关心你具体使用那个子类支付。所以这里我们可以改进一下,

    public static Map payCache = new HashMap<>();

    static {
        payCache.put("CMB", new AgreementCMBPay());
        payCache.put("CCB", new AgreementCCBPay());
    }


    public static void main(String[] args) {
        PayRequest request = new PayRequest();
        AgreementPay pa;
        switch (request.getBankCode()) {
            case "CMB":
                pa = payCache.get("CMB");
                pa.payInChannel(request);
                return;
            case "CCB":
                pa = payCache.get("CCB");
                pa.payInChannel(request);
                return;
            default:
                throw new RuntimeException();
        }

    }

改造之后我们先将其 AgreementPay 实例放入 map 中,然后调用时根据一个标志来选择具体实现类。

从上面的细节我们可以看到模板方法其实设计思路与实现细节都比较简单。看完我们的示例代码,我们去看下 mybatis 如何使用模板方法。

mybatis 模板方法应用

在看源码之前,我们先看下我们不使用 mybatis 之前,如何查询数据。

        Class.forName("com.mysql.jdbc.Driver");
        //2.获得数据库的连接
        Connection conn = DriverManager.getConnection(URL, NAME, PASSWORD);
        //3.通过数据库的连接操作数据库,实现增删改查
        PreparedStatement pstmt = conn.prepareStatement("select user_name,age from imooc_goddess where id=?");
        pstmt.setInt(1, 21);
        ResultSet rs = pstmt.execute();
        
        while (rs.next()) {//如果对象中有数据,就会循环打印出来
            System.out.println(rs.getString("user_name") + "," + rs.getInt("age"));
        }

我们可以看到直接使用 JDBC 查询,十分麻烦,且需要我们自己将 java 类型转换成 jdbc 数据类型。

ORM 框架重要作用在于把数据库表与 java,ORM 框架省去我们自己将 java 类型转化成 JDBC 类型的麻烦。JDBC 存在有那么多类型,如何做到转换的那?其实关键就是应用模板设计方法。

mybatis 中存在一个接口 TypeHandler,该接口方法主要如下:

public interface TypeHandler {

  void setParameter(PreparedStatement ps, int i, T parameter, JdbcType jdbcType) throws SQLException;

  T getResult(ResultSet rs, String columnName) throws SQLException;

  T getResult(ResultSet rs, int columnIndex) throws SQLException;

  T getResult(CallableStatement cs, int columnIndex) throws SQLException;

}

从方法上看,这个接口主要的方法为 PreparedStatement 设置列参数,或者从 ResultSet 获取列的值然后转换成相应的 java 数据类型。我们看下这个接口实现的类图。

可以看到 BaseTypeHandlerTypeHandler 的具体抽象类,我们具体看下 TypeHandler getResult 在抽象类中实现细节。

  @Override
  public T getResult(ResultSet rs, String columnName) throws SQLException {
    T result;
    try {
      result = getNullableResult(rs, columnName);
    } catch (Exception e) {
      throw new ResultMapException("Error attempting to get column "" + columnName + "" from result set.  Cause: " + e, e);
    }
    if (rs.wasNull()) {
      return null;
    } else {
      return result;
    }
  }

   public abstract T getNullableResult(ResultSet rs, String columnName) throws SQLException;

可以看到其最后调用抽象方法 getNullableResult。其由具体的子类的实现。我们具体找一个子类 DateTypeHandler 来查看具体实现。

public class DateTypeHandler extends BaseTypeHandler {


    // 忽略其他方法
  @Override
  public Date getNullableResult(ResultSet rs, String columnName)
      throws SQLException {
    Timestamp sqlTimestamp = rs.getTimestamp(columnName);
    if (sqlTimestamp != null) {
      return new Date(sqlTimestamp.getTime());
    }
    return null;
  }

}

可见其具体从 ResultSet 取出 JDBC 类型为 Timestamp,然后转换成 java 类型的 Date

实现具体的子类,那么在哪里使用了那?其实 mybatis 框架会把所有 TypeHandler 在 TypeHandlerRegistry 注册。具体类方法如图

其提供了相关 register 方法注册 TypeHandler,然后又提供了相关 getTypeHandler 方法取出具体 TypeHandler 实现类。

总结

使用模板方法,将公共逻辑抽取出来,将具体实现细节交给子类。

参考

Mybatis源代码分析之类型转换

文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。

转载请注明本文地址:https://www.ucloud.cn/yun/72794.html

相关文章

  • 源码分析 @angular/cdk Portal

    摘要:这些依赖对象也进一步暴露了其设计思想。关键功能包括在上下文内挂载在上下文外挂载在上下文外共享数据。在构造必须依赖,所以可以直接创建嵌入视图,然后手动强制执行变更检测。提供了两个指令和。 @angular/material 是 Angular 官方根据 Material Design 设计语言提供的 UI 库,开发人员在开发 UI 库时发现很多 UI 组件有着共同的逻辑,所以他们把这些共...

    BearyChat 评论0 收藏0
  • Codeigniter 4.0-dev 版源码学习笔记七—— View 视图

    摘要:行处理视图文件名后缀。结语从源码上看,使用了原始作为模版机制使得视图逻辑非常简单。无非也就是把视图进来,用输出缓冲把执行结果拿到即可。此文可以转载,但转载前需要发邮件到进行沟通,未沟通的均视作侵权。 前言 CI 的 View 没有像 Laravel 等一些流行框架一样设计的那么重,有自己的一套模版机制,CI 一直采用纯天然的 PHP 模板形式,纯天然的好处是不用再学习一套模板语言了,缺...

    LiangJ 评论0 收藏0
  • Bootstrap Metronic 模板学习路 - (3)源码分析 body 部分

    摘要:的组成结构部分包含了,其中部分又包含了几个部分。代码如下图内容展示截图代码截图快捷栏展示截图代码截图页面底部展示截图代码截图上一篇之模板的学习之路源码分析之部分下一篇之模板的学习之路源码分析之脚本部分 body 的组成结构 body 部分包含了 HEADER、CONTAINER、FOOTER,其中 CONTAINER 部分又包含了 SIDEBAR、CONTENT、QUICK SIDEB...

    afishhhhh 评论0 收藏0
  • Bootstrap Metronic 模板学习路 - (3)源码分析 body 部分

    摘要:的组成结构部分包含了,其中部分又包含了几个部分。代码如下图内容展示截图代码截图快捷栏展示截图代码截图页面底部展示截图代码截图上一篇之模板的学习之路源码分析之部分下一篇之模板的学习之路源码分析之脚本部分 body 的组成结构 body 部分包含了 HEADER、CONTAINER、FOOTER,其中 CONTAINER 部分又包含了 SIDEBAR、CONTENT、QUICK SIDEB...

    CompileYouth 评论0 收藏0
  • JavaScript 进阶深入理解数据双向绑定

    摘要:当我们的视图和数据任何一方发生变化的时候,我们希望能够通知对方也更新,这就是所谓的数据双向绑定。返回值返回传入函数的对象,即第一个参数该方法重点是描述,对象里目前存在的属性描述符有两种主要形式数据描述符和存取描述符。 前言 谈起当前前端最热门的 js 框架,必少不了 Vue、React、Angular,对于大多数人来说,我们更多的是在使用框架,对于框架解决痛点背后使用的基本原理往往关注...

    sarva 评论0 收藏0

发表评论

0条评论

最新活动
阅读需要支付1元查看
<