@jerryc/method-fuse v0.0.7

Method Fuse 函数保险丝

Motivation

在日常开发中，我们会遇到很多这样的场景：

1. 在抢购活动中，用户往往会频繁刷新接口，要给接口加上防护，频繁调用停止响应。
2. 在弱网环境中，往往会实现失败重试功能，如果失败次数多了，频繁的重试需要制止。
3. 在股票市场中，当价格波动的幅度在交易时间中达到某一个限定的熔断点时，对其暂停交易一段时间的机制。
4. ......

这类问题，本质是：「过热的调用」

在物理电路中，对于「过热的调用」有一种大家生活中都常见的电子元件：保险丝

保险丝会在电流异常升高到一定的高度和热度的时候，自身熔断切断电流，保护电路安全运行。

Feature

我们可以模仿以上的思路，去解决编程中的「过热的调用」问题：

1. 设定一个阈值，如果函数在短时间内调用次数达到这个阈值，就熔断一段时间。
2. 在函数有一段时间没有被调用了，让函数的热度降下来。

Quick Usage

1. Install

   $ npm install @jerryc/method-fuse

2. Import and use

   import { MethodFuse } from '@jerryc/method-fuse';
   
   // 一个请求远程资源的异步函数
   const getAssets = async () => API.requestAssets();
   
   // 创建 MethodFuse 实例
   const fuse = new MethodFuse({
     // 命名，用于日志输出
     name: 'TestFuse',
   
     // 最大负荷，默认：3
     maxLoad: 3,
   
     // 每次熔断时间。每次熔断之后，间隔 N 毫秒之后重铸，默认：5000ms
     breakingTime: 5000,
   
     // 自动冷却时间。在最后一次调用间隔 N 毫秒之后自动重铸，默认：1000ms
     coolDownTime: 1000,
   });
   
   // 代理原函数
   const getAssetsProxy = fuse.proxy(getAssets);
   
   // 高频并发调用 getAssetsProxy。
   getAssetsProxy();
   getAssetsProxy();
   getAssetsProxy();
   getAssetsProxy(); // 此次调用会熔断
   setTimeout(() => getAssetsProxy(), 5000); // 等待熔断重铸后，方可重新调用。
   
   // 以上会打印日志：
   // [method-fuse:info] TestFuse-通过保险丝(1/3)
   // [method-fuse:info] TestFuse-通过保险丝(2/3)
   // [method-fuse:info] TestFuse-通过保险丝(3/3)
   // [method-fuse:error] TestFuse-保险丝熔断，5000ms 之后重铸
   // [method-fuse:info] TestFuse-保险丝重置
   // [method-fuse:info] TestFuse-通过保险丝(1/3)

Senior Usage

1. Decorator

如果你的项目中支持 TS 或者 ES Decorator，那么 MethodFuse 提供了快捷使用的装饰器。

import { decorator as methodFuse } from '@jerryc/method-fuse';

@methodFuse({ name: 'TestFuse' })
async function getAsset() {
  return API.requestAssets();
};

2. Modify Log Level

MethodFuse 内置了一个迷你 logger（power by @jerryc/mini-logger），方便内部日志打印，外部可以获得 Logger 的实例，进行 log level 的控制。

import { LoggerLevel } from '@jerryc/mini-logger';
import { logger, MethodFuse } from '@jerryc/method-fuse';

// 创建 MethodFuse 实例
const MethodFuse = new MethodFuse({ name: 'TestFuse' });

// 下调 Log level
logger.level = LoggerLevel.ERROR;

关于 Log Level 的详细，查看：@jerryc/mini-logger

API

详见：https://jerryc8080.github.io/method-fuse/

测试覆盖率

详见：https://jerryc8080.github.io/method-fuse/coverage/index.html