channel是muduo中的事件分发器，它只属于一个EventLoop,Channel类中保存着IO事件的类型以及对应的回调函数,每个channel只负责一个文件描述符，但它并不拥有这个文件描述符。channel是在epoll和TcpConnection之间起沟通作用，故也叫做通道，其它类通过调用channel的setCallbcak来和建立channel沟通关系。
///
///一个能被选择的 I/O channel
//这个类不拥有自己的文件描述符
/// 这个文件描述符可能是socket，eventfd， timerfd，或者 signalfd.
class Channel : noncopyable
{
public:
typedef std::function<void()> EventCallback; //事件回调
typedef std::function<void(Timestamp)> ReadEventCallback; //读事件回调
Channel(EventLoop* loop, int fd); //一个channel属于一个loop，一个loop可以对应多个channel
~Channel();
void handleEvent(Timestamp receiveTime); //处理事件
void setReadCallback(ReadEventCallback cb) //设置读回调
{ readCallback_ = std::move(cb); }
void setWriteCallback(EventCallback cb) //设置写回调
{ writeCallback_ = std::move(cb); }
void setCloseCallback(EventCallback cb) //设置关闭回调
{ closeCallback_ = std::move(cb); }
void setErrorCallback(EventCallback cb) //设置错误回调
{ errorCallback_ = std::move(cb); }
/// 将此channel与shared_ptr管理的所有者对象绑定，
///阻止shared_ptr管理的所有者对象在handleEvent被销毁
void tie(const std::shared_ptr<void>&);
int fd() const { return fd_; }
int events() const { return events_; } //返回注册的事件
void set_revents(int revt) { revents_ = revt; } // 设置监听到的事件类型
// int revents() const { return revents_; }
bool isNoneEvent() const { return events_ == kNoneEvent; }
void enableReading() { events_ |= kReadEvent; update(); } //监听读事件
void disableReading() { events_ &= ~kReadEvent; update(); } //取消监听读事件
void enableWriting() { events_ |= kWriteEvent; update(); } //监听写事件
void disableWriting() { events_ &= ~kWriteEvent; update(); } //取消监听写事件
void disableAll() { events_ = kNoneEvent; update(); } //不监听任何事件
bool isWriting() const { return events_ & kWriteEvent; } //是否监听写事件
bool isReading() const { return events_ & kReadEvent; } //是否监听读事件
// for Poller
int index() { return index_; } //poller事件数组中的下标
void set_index(int idx) { index_ = idx; }
// for debug
string reventsToString() const;
string eventsToString() const;
void doNotLogHup() { logHup_ = false; }
EventLoop* ownerLoop() { return loop_; } //返回所属的loop
void remove(); //将channel从loop中移除
private:
static string eventsToString(int fd, int ev);
void update(); //根据index_的状态，控制监听数组
void handleEventWithGuard(Timestamp receiveTime); //对监听到事件的一个处理
static const int kNoneEvent; //无事件
static const int kReadEvent; //可读事件
static const int kWriteEvent; //可写事件
EventLoop* loop_;
const int fd_;
int events_; //监听的事件类型
int revents_; //监听到的事件类型
int index_; // 表示poller事件数组中的序号
bool logHup_;
std::weak_ptr<void> tie_;
bool tied_;
bool eventHandling_; //是否处于处理事件中
bool addedToLoop_; //是否添加到loop上
ReadEventCallback readCallback_; //读回调
EventCallback writeCallback_; //写回调
EventCallback closeCallback_; //关闭回调
EventCallback errorCallback_; //错误回调
};
// Copyright 2010, Shuo Chen. All rights reserved.
// http://code.google.com/p/muduo/
//
// Use of this source code is governed by a BSD-style license
// that can be found in the License file.
// Author: Shuo Chen (chenshuo at chenshuo dot com)
#include "muduo/base/Logging.h"
#include "muduo/net/Channel.h"
#include "muduo/net/EventLoop.h"
#include