Action Cable `Channel` `Base`¶ ↑

Channel 提供了在 WebSocket 连接上通信时将行为分组到逻辑单元的基本结构。您可以将 Channel 视为一种控制器，但它除了响应订阅者的直接请求外，还能将内容推送到订阅者。

Channel 实例是长生命周期的。当 Cable 消费者成为订阅者时，Channel 对象将被实例化，然后一直存在直到消费者断开连接。这可能持续几秒、几分钟、几小时甚至几天。这意味着您必须特别小心，不要在 Channel 中执行任何可能导致其内存占用膨胀的愚蠢操作。引用是永久的，因此它们不会像通常情况下被丢弃的控制器实例那样被释放。

长生命周期的 Channel（和连接）也意味着您有责任确保数据的时效性。如果您持有一个用户记录的引用，但在持有该引用的同时更改了该用户的姓名，那么如果您不采取预防措施，可能会发送过时的数据。

长生命周期 Channel 实例的好处在于，您可以使用实例变量来保留对象引用，供将来的订阅者请求进行交互。下面是一个简单的例子：

class ChatChannel < ApplicationCable::Channel
  def subscribed
    @room = Chat::Room[params[:room_number]]
  end

  def speak(data)
    @room.speak data, user: current_user
  end
end

当消费者订阅 Channel 时，`speak` 操作会简单地使用创建的 `Chat::Room` 对象，以便在订阅者想要在房间里发言时使用。

Action 处理¶ ↑

与 ActionController::Base 的子类不同，Channel 不遵循 RESTful 约束形式的 Action。相反，Action Cable 通过远程过程调用（RPC）模型进行操作。您可以在 Channel 上声明任何公共方法（可选参数为 `data`），该方法会自动暴露给客户端调用。

示例

class AppearanceChannel < ApplicationCable::Channel
  def subscribed
    @connection_token = generate_connection_token
  end

  def unsubscribed
    current_user.disappear @connection_token
  end

  def appear(data)
    current_user.appear @connection_token, on: data['appearing_on']
  end

  def away
    current_user.away @connection_token
  end

  private
    def generate_connection_token
      SecureRandom.hex(36)
    end
end

在此示例中，`subscribed` 和 `unsubscribed` 方法不是可调用方法，因为它们已经在 ActionCable::Channel::Base 中声明，但 `appear` 和 `away` 是。`generate_connection_token` 也不是可调用的，因为它是一个私有方法。您会看到 `appear` 接受一个 `data` 参数，然后将其用作模型调用的部分。而 `away` 不接受，因为它只是一个触发操作。

另请注意，在此示例中，`current_user` 可用，因为它已在连接上标记为识别属性。所有此类标识符都会自动在 Channel 实例上创建一个同名的委托方法。

拒绝订阅请求¶ ↑

Channel 可以在 subscribed 回调中调用 reject 方法来拒绝订阅请求。

class ChatChannel < ApplicationCable::Channel
  def subscribed
    @room = Chat::Room[params[:room_number]]
    reject unless current_user.can_access?(@room)
  end
end