BaseSubscriber

SampleSubscriber 类继承自 BaseSubscriber，这是 Reactor 框架中推荐用户自定义 Subscriber 的抽象类。理解这段话的关键在于以下几个方面：

1. BaseSubscriber 的作用
   BaseSubscriber 是一个抽象类，它提供了许多可以重写的“钩子”（hook）方法，用于调整 Subscriber 的行为。例如，hookOnSubscribe、hookOnNext、hookOnError、hookOnComplete 等方法，允许开发者在特定事件发生时执行自定义逻辑。这些钩子方法封装了 Subscriber 接口中的原始方法（如 onSubscribe、onNext 等），并提供了异常处理和状态管理的便利性 。

2. 默认行为：无界请求
   默认情况下，BaseSubscriber 会触发一个无界的请求（request(Long.MAX_VALUE)），这相当于调用 subscribe() 方法。这种行为使得 BaseSubscriber 的行为与 subscribe() 方法非常相似，但提供了更大的灵活性，尤其是在需要自定义请求量时 。

3. 自定义请求量的场景
   当你需要自定义请求的元素数量时，BaseSubscriber 就显得非常有用。例如，你可以通过覆盖 hookOnSubscribe 方法来指定初始请求的元素数量，或者在 hookOnNext 方法中根据需要动态调整请求的元素数量。这种方式可以实现对背压（backpressure）的精细控制，确保上游流不会因下游处理速度慢而“卡住” 。

4. 实现示例
   以下是一个简单的 SampleSubscriber 实现示例，展示了如何通过覆盖 hookOnSubscribe 和 hookOnNext 方法来自定义请求行为：

   public class SampleSubscriber<T> extends BaseSubscriber<T> {
       @Override
       public void hookOnSubscribe(Subscription subscription) {
           System.out.println("Subscribed");
           request(1); // 初始请求1个元素
       }
   
       @Override
       public void hookOnNext(T value) {
           System.out.println(value);
           request(1); // 每次处理完一个元素后请求下一个
       }
   }
   

   在这个示例中，hookOnSubscribe 方法打印“Subscribed”并请求第一个元素，hookOnNext 方法打印接收到的值，并请求下一个元素。这种方式确保了每个元素都被处理，而不会导致上游流被阻塞 。

5. 钩子方法的其他用途
   BaseSubscriber 还提供了其他钩子方法，如 hookOnComplete、hookOnError、hookOnCancel 和 hookFinally。这些方法可以用于处理流的完成、错误、取消等事件。例如，hookOnComplete 可以用于记录日志，hookOnError 可以用于处理异常，hookFinally 可以用于在流终止后执行清理操作 。

6. 与 Lambda 表达式的对比
   BaseSubscriber 提供了一个更通用的替代方案，可以替代使用 Lambda 表达式的 subscribe() 方法。通过 BaseSubscriber，你可以更灵活地控制订阅行为，而不仅仅是通过 Lambda 表达式组合出一个简单的 Subscriber 实例 。

7. 背压管理
   BaseSubscriber 提供了 request(n) 和 requestUnbounded() 方法，用于管理背压。request(n) 用于向上游请求 n 个元素，而 requestUnbounded() 用于切换到无界的请求模式。通过合理使用这些方法，可以实现对数据流的精细控制 。

8. 注意事项
   在使用 BaseSubscriber 时，需要注意以下几点：

   • 覆盖 hookOnSubscribe 和 hookOnNext：至少需要覆盖这两个方法，以确保至少一次请求被发送，否则上游流可能会被阻塞 。
   • 异常处理：BaseSubscriber 的钩子方法封装了异常处理，可以避免在 Subscriber 接口的原始方法中处理异常 。
   • 单次使用：BaseSubscriber 是单次使用的，这意味着如果它订阅了多个发布者，可能会取消对第一个发布者的订阅。因此，在使用时需要注意避免并行订阅多个发布者 。

通过理解 BaseSubscriber 的作用和使用方法，可以更好地利用 Reactor 框架来实现自定义的 Subscriber，从而更灵活地控制数据流的行为。