方法组合器库使用与技术文档

1. 安装指南

要安装方法组合器库，可以使用npm命令：

npm install method-combinators

确保已经安装了Node.js和npm。

2. 项目使用说明

方法组合器库提供了一些便捷的函数组合器，用于在CoffeeScript中创建方法装饰器。以下是一些基本的使用方式：

方法装饰器示例

mustBeLoggedIn = (methodBody) ->
  ->
    if currentUser?.isValid()
      methodBody.apply(this, arguments)

使用方法装饰器：

class SomeControllerLikeThing

  showUserPreferences: mustBeLoggedIn ->
    # ... 显示用户偏好设置

方法组合器

方法组合器是一些方便的函数组合器，用于创建方法装饰器。它们可以帮助你轻松实现以下几种模式：

1. 在方法基础逻辑执行前做一些操作。
2. 在方法基础逻辑执行后做一些操作。
3. 在方法基础逻辑周围包裹一些逻辑。
4. 仅当某些条件为真时才执行方法的基础逻辑。

以下是一些使用方法组合器的示例：

mustBeLoggedIn = provided -> currentUser?.isValid()
triggersMenuRedraw = after -> @trigger('menu:redraww')

然后，可以这样使用它们：

class AnotherControllerLikeThing

  updateUserPreferences: mustBeLoggedIn triggersMenuRedraw ->
    # ... 保存更新的用户偏好设置

3. 项目API使用文档

以下是方法组合器库提供的一些核心API：

before

在方法基础逻辑执行前执行装饰。

this.before = (decoration) -> (base) -> -> decoration.apply(this, arguments); base.apply(this, arguments)

after

在方法基础逻辑执行后执行装饰。

this.after = (decoration) -> (base) -> -> decoration.call(this, __value__ = base.apply(this, arguments)); __value__

around

在方法基础逻辑周围执行装饰。

this.around = (decoration) -> (base) -> (argv...) -> __value__ = undefined; callback = => __value__ = base.apply(this, argv); decoration.apply(this, [callback].concat(argv)); __value__

provided

仅当条件为真时执行方法。

this.provided = (condition) -> (base) -> -> if condition.apply(this, arguments) then base.apply(this, arguments)

excepting

仅当条件为假时执行方法。

this.excepting = (condition) -> (base) -> -> unless condition.apply(this, arguments) then base.apply(this, arguments)

4. 项目安装方式

项目安装方式已在安装指南中说明，使用npm进行安装：

npm install method-combinators

以上就是方法组合器库的使用和技术文档。希望对您有所帮助！