搜索

[25680] 2016-11-04_C++程序员ProtocolBuffers基础指南

文档创建者：s7ckTeam
浏览次数：1
最后更新：2025-01-19
2016-11-04_C++程序员ProtocolBuffers基础指南 0 2 % 0 9 % 1 0 % 2 9 % 3 3 % 4 6 % 4 9 % 5 2 % 5 9 % 7 4 % 8 3 % 9 0 % 9 4 % C + +   程 序 员   P r o t o c o l   B u f f e r s   基 础 指 南 原 创   译 者 ： c p o s t u r e   L i n u x 中 国   2 0 1 6 - 1 1 - 0 4 本 文 导 航 - 为 什 么 使 用   P r o t o c o l   B u f f e r s - 在 哪 可 以 找 到 示 例 代 码 - 定 义 你 的 协 议 格 式 - 编 译 你 的   P r o t o c o l   B u f f e r s - P r o t o c o l   B u f f e r   A P I - 枚 举 和 嵌 套 类 - 标 准 的 消 息 方 法 - 解 析 和 序 列 化 - 写 消 息 - 读 取 消 息 - 扩 展   P r o t o c o l   B u f f e r - 优 化 技 巧 - 高 级 用 法 这 篇 教 程 提 供 了 一 个 面 向   C + +   程 序 员 关 于   p r o t o c o l   b u f f e r s   的 基 础 介 绍 。 通 过 创 建 一 个 简 单 的 示 例 应 用 程 序 ， 它 将 向 我 们 展 示 ： 在     文 件 中 定 义 消 息 格 式 使 用   p r o t o c o l   b u f f e r   编 译 器 使 用   C + +   p r o t o c o l   b u f f e r   A P I   读 写 消 息 这 不 是 一 个 关 于 在   C + +   中 使 用   p r o t o c o l   b u f f e r s   的 全 面 指 南 。 要 获 取 更 详 细 的 信 息 ， 请 参 考   P r o t o c o l   B u f f e r   L a n g u a g e   G u i d e [ 1 ]   和   E n c o d i n g   R e f e r e n c e [ 2 ] 。 为 什 么 使 用 为 什 么 使 用   P r o t o c o l   B u f f e r s 我 们 接 下 来 要 使 用 的 例 子 是 一 个 非 常 简 单 的 " 地 址 簿 " 应 用 程 序 ， 它 能 从 文 件 中 读 取 联 系 人 详 细 信 息 。 地 址 簿 中 的 每 一 个 人 都 有 一 个 名 字 、 I D 、 邮 件 地 址 和 联 系 电 话 。 如 何 序 列 化 和 获 取 结 构 化 的 数 据 ？ 这 里 有 几 种 解 决 方 案 ： 以 二 进 制 形 式 发 送 / 接 收 原 生 的 内 存 数 据 结 构 。 通 常 ， 这 是 一 种 脆 弱 的 方 法 ， 因 为 接 收 / 读 取 代 码 必 须 基 于 完 全 相 同 的 内 存 布 局 、 大 小 端 等 环 境 进 行 编 译 。 同 时 ， 当 文 件 增 加 时 ， 原 始 格 式 数 据 会 随 着 与 该 格 式 相 关 的 软 件 而 迅 速 扩 散 ， 这 将 导 致 很 难 扩 展 文 件 格 式 。 你 可 以 创 造 一 种   a d - h o c   方 法 ， 将 数 据 项 编 码 为 一 个 字 符 串 — — 比 如 将   4   个 整 数 编 码 为   。 虽 然 它 需 要 编 写 一 次 性 的 编 码 和 解 码 代 码 且 解 码 需 要 耗 费 一 点 运 行 时 成 本 ， 但 这 是 一 种 简 单 灵 活 的 方 法 。 这 最 适 合 编 码 非 常 简 单 的 数 据 。 序 列 化 数 据 为   X M L 。 这 种 方 法 是 非 常 吸 引 人 的 ， 因 为   X M L   是 一 种 适 合 人 阅 读 的 格 式 ， 并 且 有 为 许 多 语 言 开 发 的 库 。 如 果 你 想 与 其 他 程 序 和 项 目 共 享 数 据 ， 这 可 能 是 一 种 不 错 的 选 择 。 然 而 ， 众 所 周 知 ， X M L   是 空 间 密 集 型 的 ， 且 在 编 码 和 解 码 时 ， 它 对 程 序 会 造 成 巨 大 的 性 能 损 失 。 同 时 ， 使 用   X M L   D O M   树 被 认 为 比 操 作 一 个 类 的 简 单 字 段 更 加 复 杂 。 P r o t o c o l   b u f f e r s   是 针 对 这 个 问 题 的 一 种 灵 活 、 高 效 、 自 动 化 的 解 决 方 案 。 使 用   P r o t o c o l   b u f f e r s ， 你 需 要 写 一 个     说 明 ， 用 于 描 述 你 所 希 望 存 储 的 数 据 结 构 。 利 用   . p r o t o 1 2 : 3 : - 2 3 : 6 7 . p r o t o . p r o t o
  文 件 ， p r o t o c o l   b u f f e r   编 译 器 可 以 创 建 一 个 类 ， 用 于 实 现 对 高 效 的 二 进 制 格 式 的   p r o t o c o l   b u f f e r   数 据 的 自 动 化 编 码 和 解 码 。 产 生 的 类 提 供 了 构 造   p r o t o c o l   b u f f e r   的 字 段 的   g e t t e r s   和   s e t t e r s ， 并 且 作 为 一 个 单 元 来 处 理 读 写   p r o t o c o l   b u f f e r   的 细 节 。 重 要 的 是 ， p r o t o c o l   b u f f e r   格 式 支 持 格 式 的 扩 展 ， 代 码 仍 然 可 以 读 取 以 旧 格 式 编 码 的 数 据 。 在 哪 可 以 找 到 示 例 代 码 在 哪 可 以 找 到 示 例 代 码 示 例 代 码 被 包 含 于 源 代 码 包 ， 位 于 “ e x a m p l e s ” 文 件 夹 。 可 在 这 里 [ 3 ] 下 载 代 码 。 定 义 你 的 协 议 格 式 定 义 你 的 协 议 格 式 为 了 创 建 自 己 的 地 址 簿 应 用 程 序 ， 你 需 要 从     开 始 。   文 件 中 的 定 义 很 简 单 ： 为 你 所 需 要 序 列 化 的 每 个 数 据 结 构 添 加 一 个 m e s s a g e 消 息 ， 然 后 为 消 息 中 的 每 一 个 字 段 指 定 一 个 名 字 和 类 型 。 这 里 是 定 义 你 消 息 的     文 件   。 2 .   7 .   . p r o t o . p r o t o . p r o t o . p r o t o a d d r e s s b o o k . p r o t o 1 .   p a c k a g e   t u t o r i a l ; 3 .   m e s s a g e   P e r s o n   { 4 .       r e q u i r e d   s t r i n g   n a m e   =   1 ; 5 .       r e q u i r e d   i n t 3 2   i d   =   2 ; 6 .       o p t i o n a l   s t r i n g   e m a i l   =   3 ;
1 3 .   1 8 .   2 1 .   如 你 所 见 ， 其 语 法 类 似 于   C + +   或   J a v a 。 我 们 开 始 看 看 文 件 的 每 一 部 分 内 容 做 了 什 么 。   文 件 以 一 个     声 明 开 始 ， 这 可 以 避 免 不 同 项 目 的 命 名 冲 突 。 在   C + + ， 你 生 成 的 类 会 被 置 于 与     名 字 一 样 的 命 名 空 间 。 下 一 步 ， 你 需 要 定 义 m e s s a g e 消 息 。 消 息 只 是 一 个 包 含 一 系 列 类 型 字 段 的 集 合 。 大 多 标 准 的 简 单 数 据 类 型 是 可 以 作 为 字 段 类 型 的 ， 包 括   、 、 、   和   8 .       e n u m   P h o n e T y p e   { 9 .           M O B I L E   =   0 ; 1 0 .           H O M E   =   1 ; 1 1 .           W O R K   =   2 ; 1 2 .       } 1 4 .       m e s s a g e   P h o n e N u m b e r   { 1 5 .           r e q u i r e d   s t r i n g   n u m b e r   =   1 ; 1 6 .           o p t i o n a l   P h o n e T y p e   t y p e   =   2   [ d e f a u l t   =   H O M E ] ; 1 7 .       } 1 9 .       r e p e a t e d   P h o n e N u m b e r   p h o n e   =   4 ; 2 0 .   } 2 2 .   m e s s a g e   A d d r e s s B o o k   { 2 3 .       r e p e a t e d   P e r s o n   p e r s o n   =   1 ; 2 4 .   } . p r o t o p a c k a g e p a c k a g e b o o l i n t 3 2 f l o a t d o u b l e
。 你 也 可 以 通 过 使 用 其 他 消 息 类 型 作 为 字 段 类 型 ， 将 更 多 的 数 据 结 构 添 加 到 你 的 消 息 中 — — 在 以 上 的 示 例 ，   消 息 包 含 了     消 息 ， 同 时     消 息 包 含     消 息 。 你 甚 至 可 以 定 义 嵌 套 在 其 他 消 息 内 的 消 息 类 型 — — 如 你 所 见 ，   类 型 定 义 于     内 部 。 如 果 你 想 要 其 中 某 一 个 字 段 的 值 是 预 定 义 值 列 表 中 的 某 个 值 ， 你 也 可 以 定 义     类 型 — — 这 儿 你 可 以 指 定 一 个 电 话 号 码 是   、   或     中 的 某 一 个 。 每 一 个 元 素 上 的   、   标 记 确 定 了 用 于 二 进 制 编 码 的 唯 一 t a g “ 标 签 ” 。 标 签 数 字   1 - 1 5   的 编 码 比 更 大 的 数 字 少 需 要 一 个 字 节 ， 因 此 作 为 一 种 优 化 ， 你 可 以 将 这 些 标 签 用 于 经 常 使 用 的 元 素 或     元 素 ， 剩 下   1 6   以 及 更 高 的 标 签 用 于 非 经 常 使 用 的 元 素 或     元 素 。 每 一 个     字 段 的 元 素 需 要 重 新 编 码 标 签 数 字 ， 因 此     字 段 适 合 于 使 用 这 种 优 化 手 段 。 每 一 个 字 段 必 须 使 用 下 面 的 修 饰 符 加 以 标 注 ： ： 必 须 提 供 该 字 段 的 值 ， 否 则 消 息 会 被 认 为 是 u n i n i t i a l i z e d “ 未 初 始 化 的 ” 。 如 果     以 调 试 模 式 编 译 ， 序 列 化 未 初 始 化 的 消 息 将 引 起 一 个 断 言 失 败 。 以 优 化 形 式 构 建 ， 将 会 跳 过 检 查 ， 并 且 无 论 如 何 都 会 写 入 该 消 息 。 然 而 ， 解 析 未 初 始 化 的 消 息 总 是 会 失 败 （ 通 过     方 法 返 回   s t r i n g P e r s o n P h o n e N u m b e r A d d r e s s B o o k P e r s o n P h o n e N u m b e r P e r s o n e n u m M O B I L E H O M E W O R K =   1 =   2 r e p e a t e d o p t i o n a l r e p e a t e d r e p e a t e d r e q u i r e d l i b p r o t o b u f p a r s e f a l s e
） 。 除 此 之 外 ， 一 个     字 段 的 表 现 与     字 段 完 全 一 样 。 ： 字 段 可 能 会 被 设 置 ， 也 可 能 不 会 。 如 果 一 个     字 段 没 被 设 置 ， 它 将 使 用 默 认 值 。 对 于 简 单 类 型 ， 你 可 以 指 定 你 自 己 的 默 认 值 ， 正 如 例 子 中 我 们 对 电 话 号 码 的     一 样 ， 否 则 使 用 系 统 默 认 值 ： 数 字 类 型 为   0 、 字 符 串 为 空 字 符 串 、 布 尔 值 为   f a l s e 。 对 于 嵌 套 消 息 ， 默 认 值 总 为 消 息 的 “ 默 认 实 例 ” 或 “ 原 型 ” ， 它 的 所 有 字 段 都 没 被 设 置 。 调 用   a c c e s s o r   来 获 取 一 个 没 有 显 式 设 置 的   （ 或   ）   字 段 的 值 总 是 返 回 字 段 的 默 认 值 。 ： 字 段 可 以 重 复 任 意 次 数 （ 包 括   0   次 ） 。   值 的 顺 序 会 被 保 存 于   p r o t o c o l   b u f f e r 。 可 以 将     字 段 想 象 为 动 态 大 小 的 数 组 。 你 可 以 查 找 关 于 编 写     文 件 的 完 整 指 导 — — 包 括 所 有 可 能 的 字 段 类 型 — — 在   P r o t o c o l   B u f f e r   L a n g u a g e   G u i d e [ 4 ]   里 面 。 不 要 在 这 里 面 查 找 与 类 继 承 相 似 的 特 性 ， 因 为   p r o t o c o l   b u f f e r s   不 会 做 这 些 。   是 永 久 性 的 在 把 一 个 字 段 标 识 为     的 时 候 ， 你 应 该 特 别 小 心 。 如 果 在 某 些 情 况 下 你 不 想 写 入 或 者 发 送 一 个     的 字 段 ， 那 么 将 该 字 段 更 改 为     可 能 会 遇 到 问 题 — — 旧 版 本 的 读 者 （ L C T T   译 注 ： 即 读 取 、 解 析 旧 版 本   P r o t o c o l   B u f f e r   消 息 的 一 方 ） 会 认 为 不 含 该 字 段 的 消 息 是 不 完 整 的 ， 从 而 有 可 能 会 拒 绝 解 析 。 在 这 种 情 况 下 ， 你 应 该 考 虑 编 写 特 别 针 对 于 应 用 程 序 的 、 自 定 义 的 消 息 校 验 函 数 。 G o o g l e   的 一 些 工 程 师 得 出 了 一 个 结 论 ： 使 用     弊 多 于 利 ； 他 们 更 愿 意 使 用     和     而 不 是   。 当 然 ， 这 个 观 点 并 不 具 有 普 遍 性 。 编 译 你 的 编 译 你 的   P r o t o c o l   B u f f e r s r e q u i r e d o p t i o n a l o p t i o n a l o p t i o n a l t y p e o p t i o n a l r e q u i r e d r e p e a t e d r e p e a t e d r e p e a t e d . p r o t o r e q u i r e d r e q u i r e d r e q u i r e d o p t i o n a l r e q u i r e d o p t i o n a l r e p e a t e d r e q u i r e d
既 然 你 有 了 一 个   ， 那 你 需 要 做 的 下 一 件 事 就 是 生 成 一 个 将 用 于 读 写     消 息 的 类 （ 从 而 包 括     和   ） 。 为 了 做 到 这 样 ， 你 需 要 在 你 的     上 运 行   p r o t o c o l   b u f f e r   编 译 器   ： 1 .   如 果 你 没 有 安 装 编 译 器 ， 请 下 载 这 个 包 [ 5 ] ， 并 按 照   R E A D M E   中 的 指 令 进 行 安 装 。 2 .   现 在 运 行 编 译 器 ， 指 定 源 目 录 （ 你 的 应 用 程 序 源 代 码 位 于 哪 里 — — 如 果 你 没 有 提 供 任 何 值 ， 将 使 用 当 前 目 录 ） 、 目 标 目 录 （ 你 想 要 生 成 的 代 码 放 在 哪 里 ； 常 与     相 同 ） ， 以 及 你 的     路 径 。 在 此 示 例 中 ： 因 为 你 想 要   C + +   的 类 ， 所 以 你 使 用 了     选 项 — — 也 为 其 他 支 持 的 语 言 提 供 了 类 似 选 项 。 在 你 指 定 的 目 标 文 件 夹 ， 将 生 成 以 下 的 文 件 ： ， 声 明 你 生 成 类 的 头 文 件 。 ， 包 含 你 的 类 的 实 现 。 P r o t o c o l   B u f f e r   A P I 让 我 们 看 看 生 成 的 一 些 代 码 ， 了 解 一 下 编 译 器 为 你 创 建 了 什 么 类 和 函 数 。 如 果 你 查 看   ， 你 可 以 看 到 有 一 个 在     中 指 定 所 有 消 息 的 类 。 关 注     类 ， 可 以 看 到 编 译 器 为 每 个 字 段 生 成 了 a c c e s s o r s 读 写 函 数 。 例 如 ， 对 于   、 . p r o t o A d d r e s s B o o k P e r s o n P h o n e N u m b e r . p r o t o p r o t o c $ S R C _ D I R . p r o t o 1 .   p r o t o c   - I = $ S R C _ D I R   - - c p p _ o u t = $ D S T _ D I R   $ S R C _ D I R / a d d r e s s b o o k . p r o t o - - c p p _ o u t a d d r e s s b o o k . p b . h a d d r e s s b o o k . p b . c c a d d r e s s b o o k . p b . h a d d r e s s b o o k . p r o t o P e r s o n n a m e i d
、   和     字 段 ， 有 下 面 这 些 方 法 ： （ L C T T   译 注 ： 此 处 原 文 所 指 文 件 名 有 误 ， 径 该 之 。 ） 8 .   1 4 .   2 2 .   e m a i l p h o n e 1 .   / /   n a m e 2 .   i n l i n e   b o o l   h a s _ n a m e ( )   c o n s t ; 3 .   i n l i n e   v o i d   c l e a r _ n a m e ( ) ; 4 .   i n l i n e   c o n s t   : : s t d : : s t r i n g &   n a m e ( )   c o n s t ; 5 .   i n l i n e   v o i d   s e t _ n a m e ( c o n s t   : : s t d : : s t r i n g &   v a l u e ) ; 6 .   i n l i n e   v o i d   s e t _ n a m e ( c o n s t   c h a r *   v a l u e ) ; 7 .   i n l i n e   : : s t d : : s t r i n g *   m u t a b l e _ n a m e ( ) ; 9 .   / /   i d 1 0 .   i n l i n e   b o o l   h a s _ i d ( )   c o n s t ; 1 1 .   i n l i n e   v o i d   c l e a r _ i d ( ) ; 1 2 .   i n l i n e   i n t 3 2 _ t   i d ( )   c o n s t ; 1 3 .   i n l i n e   v o i d   s e t _ i d ( i n t 3 2 _ t   v a l u e ) ; 1 5 .   / /   e m a i l 1 6 .   i n l i n e   b o o l   h a s _ e m a i l ( )   c o n s t ; 1 7 .   i n l i n e   v o i d   c l e a r _ e m a i l ( ) ; 1 8 .   i n l i n e   c o n s t   : : s t d : : s t r i n g &   e m a i l ( )   c o n s t ; 1 9 .   i n l i n e   v o i d   s e t _ e m a i l ( c o n s t   : : s t d : : s t r i n g &   v a l u e ) ; 2 0 .   i n l i n e   v o i d   s e t _ e m a i l ( c o n s t   c h a r *   v a l u e ) ; 2 1 .   i n l i n e   : : s t d : : s t r i n g *   m u t a b l e _ e m a i l ( ) ; 2 3 .   / /   p h o n e 2 4 .   i n l i n e   i n t   p h o n e _ s i z e ( )   c o n s t ; 2 5 .   i n l i n e   v o i d   c l e a r _ p h o n e ( ) ; 2 6 .   i n l i n e   c o n s t   : : g o o g l e : : p r o t o b u f : : R e p e a t e d P t r F i e l d <   : : t u t o r i a l : : P e r s o n _ P h o n e N u m b e r   > &   p h o n e ( )   c o n s t ;
正 如 你 所 见 到 ， g e t t e r s   的 名 字 与 字 段 的 小 写 名 字 完 全 一 样 ， 并 且   s e t t e r   方 法 以     开 头 。 同 时 每 个 s i n g u l a r 单 一 （   或   ） 字 段 都 有     方 法 ， 该 方 法 在 字 段 被 设 置 了 值 的 情 况 下 返 回   t r u e 。 最 后 ， 所 有 字 段 都 有 一 个     方 法 ， 用 以 清 除 字 段 到 e m p t y 空 状 态 。 数 字 型 的     字 段 仅 有 上 述 的 基 本 a c c e s s o r s 读 写 函 数 集 合 ， 而     和     字 段 有 两 个 额 外 的 方 法 ， 因 为 它 们 是 字 符 串 — — 一 个 是 可 以 获 得 字 符 串 直 接 指 针 的   的   g e t t e r   ， 另 一 个 为 额 外 的   s e t t e r 。 注 意 ， 尽 管     还 没 被 s e t 设 置 ， 你 也 可 以 调 用   ； 因 为     会 被 自 动 地 初 始 化 为 空 字 符 串 。 在 本 例 中 ， 如 果 你 有 一 个 单 一 的 （   或   ） 消 息 字 段 ， 它 会 有 一 个     方 法 ， 而 没 有     方 法 。   字 段 也 有 一 些 特 殊 的 方 法 — — 如 果 你 看 看     的   2 7 .   i n l i n e   : : g o o g l e : : p r o t o b u f : : R e p e a t e d P t r F i e l d <   : : t u t o r i a l : : P e r s o n _ P h o n e N u m b e r   > *   m u t a b l e _ p h o n e ( ) ; 2 8 .   i n l i n e   c o n s t   : : t u t o r i a l : : P e r s o n _ P h o n e N u m b e r &   p h o n e ( i n t   i n d e x )   c o n s t ; 2 9 .   i n l i n e   : : t u t o r i a l : : P e r s o n _ P h o n e N u m b e r *   m u t a b l e _ p h o n e ( i n t   i n d e x ) ; 3 0 .   i n l i n e   : : t u t o r i a l : : P e r s o n _ P h o n e N u m b e r *   a d d _ p h o n e ( ) ; s e t _ r e q u i r e d o p t i o n a l h a s _ c l e a r _ i d n a m e e m a i l m u t a b l e _ e m a i l m u t a b l e _ e m a i l e m a i l r e q u i r e d o p t i o n a l m u t a b l e _ s e t _ r e p e a t e d r e p e a t e d p h o n e
  字 段 的 方 法 ， 你 可 以 看 到 ： 检 查     字 段 的   （ 也 就 是 说 ， 与     相 关 的 电 话 号 码 的 个 数 ） 使 用 下 标 取 得 特 定 的 电 话 号 码 更 新 特 定 下 标 的 电 话 号 码 添 加 新 的 电 话 号 码 到 消 息 中 ， 之 后 你 便 可 以 编 辑 。 （   标 量 类 型 有 一 个     方 法 ， 用 于 传 入 新 的 值 ） 为 了 获 取   p r o t o c o l   编 译 器 为 所 有 字 段 定 义 生 成 的 方 法 的 信 息 ， 可 以 查 看   C + +   g e n e r a t e d   c o d e   r e f e r e n c e [ 6 ] 。 枚 举 和 嵌 套 类 枚 举 和 嵌 套 类 与     的 枚 举 相 对 应 ， 生 成 的 代 码 包 含 了 一 个     枚 举 。 你 可 以 通 过     引 用 这 个 类 型 ， 通 过   、   和     引 用 它 的 值 。 （ 实 现 细 节 有 点 复 杂 ， 但 是 你 无 须 了 解 它 们 而 可 以 直 接 使 用 ） 编 译 器 也 生 成 了 一 个     的 嵌 套 类 。 如 果 你 查 看 代 码 ， 你 可 以 发 现 真 正 的 类 型 为   ， 但 它 通 过 在     内 部 使 用     定 义 ， 使 你 可 以 把     当 成 嵌 套 类 。 唯 一 产 生 影 响 的 一 个 例 子 是 ， 如 果 你 想 要 在 其 他 文 件 前 置 声 明 该 类 — — 在   C + +   中 你 不 能 前 置 声 明 嵌 套 类 ， 但 是 你 可 以 前 置 声 明   。 r e p e a t e d _ s i z e P e r s o n r e p e a t e d a d d _ . p r o t o P h o n e T y p e P e r s o n : : P h o n e T y p e P e r s o n : : M O B I L E P e r s o n : : H O M E P e r s o n : : W O R K P e r s o n : : P h o n e N u m b e r P e r s o n _ P h o n e N u m b e r P e r s o n t y p e d e f P e r s o n _ P h o n e N u m b e r P e r s o n _ P h o n e N u m b e r
标 准 的 消 息 方 法 标 准 的 消 息 方 法 所 有 的 消 息 方 法 都 包 含 了 许 多 别 的 方 法 ， 用 于 检 查 和 操 作 整 个 消 息 ， 包 括 ：   ： 检 查 是 否 所 有     字 段 已 经 被 设 置 。   ： 返 回 人 类 可 读 的 消 息 表 示 ， 对 调 试 特 别 有 用 。 ： 使 用 给 定 的 值 重 写 消 息 。 ： 清 除 所 有 元 素 为 空 的 状 态 。 上 面 这 些 方 法 以 及 下 一 节 要 讲 的   I / O   方 法 实 现 了 被 所 有   C + +   p r o t o c o l   b u f f e r   类 共 享 的 M e s s a g e 消 息 接 口 。 为 了 获 取 更 多 信 息 ， 请 查 看   c o m p l e t e   A P I   d o c u m e n t a t i o n   f o r   M e s s a g e [ 7 ] 。 解 析 和 序 列 化 解 析 和 序 列 化 最 后 ， 所 有   p r o t o c o l   b u f f e r   类 都 有 读 写 你 选 定 类 型 消 息 的 方 法 ， 这 些 方 法 使 用 了 特 定 的   p r o t o c o l   b u f f e r   二 进 制 格 式 [ 8 ] 。 这 些 方 法 包 括 ： ： 序 列 化 消 息 并 将 消 息 字 节 数 据 存 储 在 给 定 的 字 符 串 中 。 注 意 ， 字 节 数 据 是 二 进 制 格 式 的 ， 而 不 是 文 本 格 式 ； 我 们 只 使 用   类 作 为 合 适 的 容 器 。 ： 从 给 定 的 字 符 创 解 析 消 息 。 ： 将 消 息 写 到 给 定 的   C + +   。 ： 从 给 定 的   C + +     解 析 消 息 。 这 些 只 是 两 个 用 于 解 析 和 序 列 化 的 选 择 。 再 次 说 明 ， 可 以 查 看     完 整 的 列 表 。 P r o t o c o l   B u f f e r s   和 面 向 对 象 设 计 P r o t o c o l   b u f f e r   类 通 常 只 是 纯 粹 的 数 据 存 储 器 （ 像   C + +   中 的 结 构 体 ） ； 它 们 在 对 象 模 型 中 并 不 是 一 等 公 民 。 如 果 你 想 向 生 成 的 p r o t o c o l   b u f f e r   类 中 添 加 更 丰 富 的 行 为 ， 最 好 的 方 法 就 是 在 应 用 程 序 中 对 它 进 行 封 装 。 如 果 你 无 权 控 制   b o o l   I s I n i t i a l i z e d ( )   c o n s t ; r e q u i r e d s t r i n g   D e b u g S t r i n g ( )   c o n s t ; v o i d   C o p y F r o m ( c o n s t   P e r s o n &   f r o m ) ; v o i d   C l e a r ( ) ; b o o l   S e r i a l i z e T o S t r i n g ( s t r i n g *   o u t p u t )   c o n s t ; s t r i n g b o o l   P a r s e F r o m S t r i n g ( c o n s t   s t r i n g &   d a t a ) ; b o o l   S e r i a l i z e T o O s t r e a m ( o s t r e a m *   o u t p u t )   c o n s t ; o s t r e a m b o o l   P a r s e F r o m I s t r e a m ( i s t r e a m *   i n p u t ) ; i s t r e a m M e s s a g e   A P I   r e f e r e n c e . p r o t o
回复

举报

高级模式
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

使用Markdown编辑器编辑 使用富文本编辑器编辑

Archiver| 手机版| 小黑屋|
Powered by Discuz! X3.4 Copyright © 2001-2020, Tencent Cloud. 商业源码建议获取授权，如侵犯您的权益，请联系客服处理