Mojo简介
Mojo 是一个运行时库的集合，提供与平台无关的通用 IPC 原语抽象、消息 IDL 格式以及具有针对多种目标语言的代码生成的绑定库，以便于跨任意进程间和进程内边界传递消息。
Mojo 分为清晰分离的层，子组件的基本层次结构如下：
分析Mojo之前，我们的思考
笔者在阅读源码前，喜欢会去思考，“如果让我来设计一个类似的功能的模块，我会怎么设计？”。然后对比文档去思考为什么会出现思路的差异，这种方式可以让我快速掌握一个开源库的设计精髓。
这次也是一样，我们想想，如果是我们自己设计Mojo，这会是什么样的架构和过程。
- 首先，Mojo是跨平台的，那么必然有一层platform的平台差异屏蔽层；
- 其次，跨进程通信在不同平台上的最佳实现方案可能不一样，例如有的平台是管道，有的平台是共享内存，具体如何选择取决于不同平台的性能差异，因此，我必须将跨平台通信细节进行抽象，提取出一些概念，用于描述通信的应用层细节。
- 之后，两个进程之间的通信之前，需要先建立连接，因此必然也需要定义一组规则和概念，来描述连接的应用层细节。
- 为了增加通信的灵活性，我们可以定义一组观察者或者过滤器的规则，可以实现对数据流的监测和量化，也能实现更灵活的扩展。因此我们需要定义一组规则和概念来实现这个目标。
- 为了让跨平台通信框架更加易于使用，我们需要提供一套序列化和反序列化的框架，这样可以让通信以自定义结构体的形式进行，而非数据流。
- 如果存在大量的通信消息，那么我们需要解决不同进程共享头文件，使用自定义结构体的形式；另外，Mojo除了跨平台，还需要夸语言，那么，我们必然不能使用某种语言的结构体定义形式（例如C的结构体或者JavaScript友好的Json），而是需要定义一种新的规则，通过工具自动生成不同语言友好的结构体源码。
上面的5和6本质上可以看作是同一个问题，并且我首先想到的是protobuffer库可以实现这两个问题的解法。
带着我们自己的设计思路，再去看看Mojo的设计方案。
的Mojo方案：
源码目录体积一览：
源码重要文件一览（排除test源文件，按大小排序，top的文件如下图）：
一般来说，体积大的源文件表示的功能都比较核心，因此这些文件里面对应的功能和概念，很大概率是Mojo框架的核心，值得每一项进行标注理解。
Mojo的底层Channel
在Mojo中的源码中，可以很明显的发现关键字Channel是最底层跨进程通信的关键概念，并且能找到平台相关的抽象和实现，直接搜索文件名关键字就一览无余了：
channel.h
看了一眼mojo\core\channel.h可以发现，抽象基类是mojo::core::Channel, 并且定义了许多核心概念，包括Message（A message to be written to a channel.）、Delegate（ // Delegate methods are called from the I/O task runner with which the Channel
was created (see Channel::Create). 关键回调OnChannelMessage）等。
不同平台通过继承抽象基类mojo::core::Channel实现平台相关的读写，以mojo\core\channel_win.cc的ChannelWin为例，使用Win32API的ReadFile、WriteFile从base::win::ScopedHandle句柄中读写数据，这个句柄是构造函数的参数ConnectionParams（TakeEndpoint().TakePlatformHandle().TakeHandle()）传入的获取的。
channel相关的重点类解析
-
PlatformChannel
是一个封装了两个交织在一起的端点的类或结构，这些端点属于特定平台的基本通信原语，比如在Windows上是管道，在Unix系统上是域套接字，在macOS上是Mach端口对。其中一个端点被指定为“本地”端点，由创建它的进程保留；另一个端点被指定为“远程”端点，应当传递给外部的进程。 -
PlatformChannel 可以用来在两个进程之间启动Mojo IPC（一种进程间通信机制）。通常情况下另一个进程是当前进程的子进程，PlatformChannel
提供辅助方法来将端点以这种方式传递给子进程；但这种设置在所有平台上并不是强制性的。
如果需要一个允许客户端通过名称来连接的通道（比如一个命名管道或者套接字服务器，这种类型仅在Windows和POSIX系统上被支持），那么可以参考
NamedPlatformChannel。 -
PlatformChannelServer 这个类负责持有一个 PlatformChannelServerEndpoint 实例，并监听一个单一的来自客户端的连接请求。这个类不是线程安全的，必须在运行I/O消息泵（Message Pump）的线程上使用。
-
PlatformChannelServer 和PlatformChannel 对比： 简而言之，PlatformChannel 负责创建和管理进程间通信的通道，而 PlatformChannelServer
则是在服务端监听和接受这些通道上的连接请求。PlatformChannel 可以看作是连接的“管道”，而 PlatformChannelServer 是“水龙头”，控制着连接的开启。 -
PlatformHandle平台句柄类，它带有一些额外的类型信息，用来表明它是一个通道端点（channel endpoint）。也就是说，它是一种句柄，可以被用来作为 MOJO_INVITATION_TRANSPORT_TYPE_CHANNEL
发送或接收邀请到一个远程的 PlatformChannelEndpoint。
结合调用堆栈：
Channel的创建：
Channel的发送消息：
通过调用堆栈可以发现，Channel的概念几乎是Mojo最底层的概念了，往上走有Router、InterfaceEndpointClient、Message、ChannelMojo概念等。以下是从最底层到更高层的一些核心概念及其作用的介绍：
-
Channel:
Channel是 Mojo IPC 系统中最底层的抽象。它代表了一个底层的通信通道，负责在两个进程之间传输原始的字节数据。Channel封装了操作系统级别的 IPC 机制（如套接字或共享内存），以便在不同的平台上提供一致的 API。它负责序列化和反序列化消息，保证数据的完整性，并处理底层的传输细节。 -
Router:
Router位于Channel之上，是一个稍高层次的抽象。它负责将发出的消息路由到正确的Channel，并从Channel接收消息。Router还管理消息的生命周期，确保消息按照正确的顺序发送和接收，并可能处理流控制和重试逻辑。 -
InterfaceEndpointClient:
InterfaceEndpointClient是 Mojo IPC 中的一个组件，它代表了 Mojo 接口的端点。它与Router配合，以便在 Mojo 接口上发送和接收消息。通常，每个 Mojo 接口都有一个或多个方法，这些方法对应于可以通过该端点发送的消息类型。InterfaceEndpointClient会序列化这些方法调用为消息，并将它们传递给Router进行传输。 -
Message:
Message是代表 IPC 系统中传递的一个消息实体。它通常包含要传输的数据（例如，方法调用的参数），以及可能的元数据（例如，消息类型或优先级）。在 Mojo IPC 中，Message是发送和接收的基本单位，由Router和Channel处理。 -
ChannelMojo:
ChannelMojo是Channel的一个具体实现，它利用 Mojo 系统的底层管道（如MessagePipe）来传输数据。ChannelMojo提供了一个适应 Mojo 管道特性的Channel接口，使得上层的Router和InterfaceEndpointClient能够通过 Mojo 管道发送和接收消息。
这些概念共同构成了 Mojo IPC 系统的框架，其中每个层次都建立在下一个层次之上，提供了逐步更高级别的抽象和功能。开发者可以根据需要选择在哪个层次上与 IPC 系统交互，从直接使用 Channel 的字节级操作，到通过 InterfaceEndpointClient 的接口级调用。
Mojo的Node
在源码一览中，我们发现node.cc是最大的源文件，我们以此为线索展开对Node的理解和阅读，Node相关文件有：
Node.h中，NodeChannel是一个核心，注释只有一句：Wraps a Channel to send and receive Node control messages.：
// Wraps a Channel to send and receive Node control messages.
class MOJO_SYSTEM_IMPL_EXPORT NodeChannel
: public base::RefCountedDeleteOnSequence<NodeChannel>,
public Channel::Delegate {
public:
// .... 略
由此可见，Channel 是一种底层概念，用于抽象化和平滑处理不同平台之间的差异，而 Node 概念则在 Channel 的基础上进行了进一步的封装和抽象化。NodeChannel用于定义 Mojo 中与连接、广播、中介（Broker）、消息传输以及错误处理相关的实现细节。如果用计算机网络的术语进行类比，那么 Channel 类似于网络协议栈中的 IP 层，它提供了寻址和路由的能力；而 NodeChannel则相当于应用层的协议，例如 UDP，它在更高层次上处理数据的传输和相关逻辑。
那么，可以预见，Mojo的应用层概念将围绕Node为核心展开。
从上面代码中我们发现，NodeChannel中有个重要的嵌入类：Delegate。Delegate的概念在chromium广泛存在，其实可以理解为Delegate就是一组回调，在宿主对象处理逻辑的关键节点时，通过Delegate回调转移执行绪，以实现行为的定制和扩展的能力。 通过了解Delegate回调的函数组成，可以快速了解宿主类的主要功能和关键流程，是阅读源码的重要技巧。例如NodeChannel的Delegate的类定义如下：
class Delegate {
public:
virtual ~Delegate() = default;
virtual void OnAcceptInvitee(const ports::NodeName& from_node,
const ports::NodeName& inviter_name,
const ports::NodeName& token) = 0;
virtual void OnAcceptInvitation(const ports::NodeName& from_node,
const ports::NodeName& token,
const ports::NodeName& invitee_name) = 0;
virtual void OnAddBrokerClient(const ports::NodeName& from_node,
const ports::NodeName& client_name,
base::ProcessHandle process_handle) = 0;
virtual void OnBrokerClientAdded(const ports::NodeName& from_node,
const ports::NodeName& client_name,
PlatformHandle broker_channel) = 0;
virtual void OnAcceptBrokerClient(const ports::NodeName& from_node,
const ports::NodeName& broker_name,
PlatformHandle broker_channel,
const uint64_t broker_capabilities) = 0;
virtual void OnEventMessage(const ports::NodeName& from_node,
Channel::MessagePtr message) = 0;
virtual void OnRequestPortMerge(const ports::NodeName& from_node,
const ports::PortName& connector_port_name,
const std::string& token) = 0;
virtual void OnRequestIntroduction(const ports::NodeName& from_node,
const ports::NodeName& name) = 0;
virtual void OnIntroduce(const ports::NodeName& from_node,
const ports::NodeName& name,
PlatformHandle channel_handle,
const uint64_t remote_capabilities) = 0;
virtual void OnBroadcast(const ports::NodeName& from_node,
Channel::MessagePtr message) = 0;
#if BUILDFLAG(IS_WIN)
virtual void OnRelayEventMessage(const ports::NodeName& from_node,
base::ProcessHandle from_process,
const ports::NodeName& destination,
Channel::MessagePtr message) = 0;
virtual void OnEventMessageFromRelay(const ports::NodeName& from_node,
const ports::NodeName& source_node,
Channel::MessagePtr message) = 0;
#endif
virtual void OnAcceptPeer(const ports::NodeName& from_node,
const ports::NodeName& token,
const ports::NodeName& peer_name,
const ports::PortName& port_name) = 0;
virtual void OnChannelError(const ports::NodeName& node,
NodeChannel* channel) = 0;
};
通过这个代理类，就能很直观地理解NodeChannel的功能和作用。
mojo的Port
在阅读NodeChannel类的时候，有一个关键字出现了多次，那就是port。在Mojo中，port是一个命名空间，也是一个重要概念，port这个类的头文件注释如下：
在 Mojo IPC 系统中，“Port”本质上是一个地址的循环列表中的一个节点。为了本文档的目的，这样的列表将被称为“路由”（route）。路由是所有 Node 事件流通的基本媒介，因此是所有 Mojo 消息传递的骨干。
每个 Port 都由一个节点（参见 node.h）内的 128 位地址唯一标识。Port 本身并不真正“做”任何事情：它是一系列状态的命名集合，而拥有它的 Node 管理所有事件的产生、传输、路由和处理逻辑。有关 Port 如何被用来传输任意用户消息以及其他 Ports 的更多细节，请参见 Node。
Ports 可以处于几种状态（见下面的 State），这些状态决定了它们如何响应以它们为目标的系统事件。在最简单和最常见的情况下，Ports 最初是作为一对纠缠在一起的状态（即由两个 Ports 组成的简单循环）创建的，都处于 kReceiving 状态。我们这里将这些 Ports 标为 |A| 和 |B|，它们可以使用 Node::CreatePortPair() 创建：
+-----+ +-----+
| |--------->| |
| A | | B |
| |<---------| |
+-----+ +-----+
|A| 通过 |peer_node_name| 和 |peer_port_name| 引用 |B|，同时 |B| 反过来引用
|A|。请注意，一个 Node 永远不会知道是谁向给定的 Port 发送事件；它只知道必须从给定的 Port 路由事件到哪里。
为了方便文档描述，我们将路由中的一个接收端 Port 称为另一个的“共轭”（conjugate）。一个接收端 Port 的共轭在初始创建时也是它的对端，但由于代理，这种关系可能随着时间而改变。 对这个数据结构的所有访问必须通过获取 |lock_|来进行保护，这只能通过 PortLocker 实现。PortLocker 确保在单个线程上重叠的 Port 锁获取总是以全局一致的顺序进行。
通过头文件注释，感觉似懂非懂，看看Port这个类的主要成员和方法吧：
Port类是 Mojo IPC 系统中的一个核心组件，它代表了消息传递路径上的一个节点。这个类继承自
base::RefCountedThreadSafe<Port>，允许它在多个线程中安全地共享和管理其生命周期。以下是Port
类的主要功能和特性：
State枚举：定义了Port可能处于的状态，包括kUninitialized（未初始化）、kReceiving（接收中）、kBuffering（缓冲中）、kProxying（代理中）和
kClosed（已关闭）。state成员变量：存储当前Port的状态。peer_node_name和peer_port_name成员变量：指定了事件应该从该Port路由到哪个节点和端口的地址。prev_node_name和prev_port_name成员变量：跟踪当前发送消息到这个Port的上一个端口，用于验证发送方节点是否有权限发送消息到这个端口，同时保持接收消息的顺序。pending_merge_peer成员变量：标记这个端口是否准备合并。- 一系列的序列号成员变量（
next_control_sequence_num_to_send、next_sequence_num_to_send
等）：用于跟踪控制和用户消息事件的序列号。message_queue成员变量：存储该Port接收到的用户消息队列。此队列只为kBuffering或kReceiving状态的Port提供服务。control_message_queue成员变量：在Port处于kBuffering状态时，暂存即将发送的控制消息。send_on_proxy_removal成员变量：在某些边缘情况下，如果这个（代理中的）Port被销毁，它可能需要记得路由一个特殊的事件。user_data成员变量：附加到Port的任意用户数据。在 Mojo 中，这通常用于存储通知有关Port状态变化的观察者接口。remove_proxy_on_last_message和peer_closed成员变量：标志位，用于指示Port的一些状态，如代理何时可以移除，以及它的对端Port是否已关闭。Port构造函数：用于初始化Port，设置初始的序列号。AssertLockAcquired方法：用于调试中检查是否已获取Port的锁。IsNextEvent方法：检查给定的事件是否应该根据序列号和发送方节点接下来处理。NextEvent方法：获取下一个要处理的缓冲事件。BufferEvent方法：将事件缓存以供后续处理。>TakePendingMessages方法：清空等待节点验证的事件队列，并返回所有用户事件。- 私有析构函数
~Port：确保Port只能通过引用计数安全地销毁。- 私有成员
lock_：用于确保对Port数据结构的线程安全访问。PortLocker友元类：用于确保在单个线程上以全局一致的顺序获取重叠的Port锁。
该类的设计允许它在 Mojo IPC 系统中作为消息的发送和接收点，管理消息的顺序和状态，并确保消息在正确的路径上流动。
结合其他源码，发现Port和Dispatcher相关逻辑结合紧密，另外，Port存储了Event的序号等数据信息，支持插入事件，并且许多数据成员用于Node.cc中实现消息处理，可见Port这个类做的事情确实很难和已有的概念类比出来，也难怪通过这个类的注释难以一下理解其作用。简而言之，Port这个类即负责一部分事件排序和派发相关的逻辑处理，也承载了一个寻址的功能。
在 Mojo IPC 系统中，Node 通常代表了一个独立的参与者，如一个进程，它是消息传递路径上的一个物理节点。Node 可以是消息的最初发送者或最终接收者。相比之下，Port 是 Node 内部的逻辑上的虚拟节点，它负责管理消息的复杂路由、转发以及过滤等操作。每个 Port 都由其所属的 Node 管理，并且可以与其他 Node 中的 Port 形成连接，从而构成消息传递的网络。
之所以这样设计，是为了让两个Node之间可以出现多个连接，每个连接就是一对“共轭”的Port。这样每个连接各自的序号（seq）就不会互相干扰。所以，序号的数据就存储在Port类里，这也就不奇怪了。正因为Port代表了连接，所以数据的过滤和代理也必须面向连接进行，因此Port也和相关的类紧密联系。
说实话，如果把Port改名为Connection，也许会更直观一些。
这里面出现了NodeName和Port Name，也顺便看看定义：
struct COMPONENT_EXPORT(MOJO_CORE_PORTS) PortName : Name {
constexpr PortName() : Name(0, 0) {}
constexpr PortName(uint64_t v1, uint64_t v2) : Name(v1, v2) {}
};
struct COMPONENT_EXPORT(MOJO_CORE_PORTS) NodeName : Name {
constexpr NodeName() : Name(0, 0) {}
constexpr NodeName(uint64_t v1, uint64_t v2) : Name(v1, v2) {}
};
接下来
接下来，我们继续阅读Mojo模块的代码。了解消息的过滤和派发、序列化和反序列化、Mojom、等功能逻辑。（未完待续…）
