【源码】hamcrest 源码阅读 泛型 extends 和迭代器模式

文章目录

• • 前言
  • [1. 泛型参数和自定义迭代器](#1. 泛型参数和自定义迭代器)
  • • [1.1 使用场景](#1.1 使用场景)
    • [1.2 实现](#1.2 实现)
  • [2. 值得一提](#2. 值得一提)

前言

• 官方文档
  Hamcrest Tutorial

• 上篇文章
  Hamcrest 源码阅读及空对象模式、模板方法模式的应用

• 本篇文章

  • 迭代器模式

1. 泛型参数和自定义迭代器

hamcrest 作为一个matcher库，把某个matcher的职责打印出来，可以方便开发者进行调试。

1.1 使用场景

这里表示实例化一个 IsIn 的 Matcher，规则是需要满足在 a, b, c 中任意的一个值。

打印逻辑就在 StringDescription.toString() 中，这个方法在上篇文章中有提到。

使用jdk的迭代器可以保证打印方法的复用性，下文就读读框架中的实现。

1.2 实现

关注到这个泛型参数，? extends SelfDescribing 表示必须是来自于 SelfDescribing 子类的迭代器。

自定义迭代器

声明该参数的作用：appendDescription方法只接收 SelfDescribing，而appendList方法需要对存储 SelfDescribing 的容器进行遍历，所以需要约束容器内的成员类型

2. 值得一提

• "跳过第一个元素" 的一种写法

        boolean separate = false;
        append(start);
        while (i.hasNext()) {
            // 第一个字符前不拼接连接符, 其他都拼接
            if (separate) {
                append(separator);
            }
            // 打印字符
            appendDescriptionOf(i.next());
            separate = true;
        }
        append(end);