知识卡片
入口把通用接口显式化
外部系统常给出“万能”接口,如 send(类型字符串, 参数数组),灵活却看不出有哪些合法消息、各需什么参数。入口的职责是在客户这一侧把它翻译成显式方法,如 sendConfirmation(订单号, 金额),名字说明用途,参数带类型,编译器能帮忙查错。新增消息类型时要改入口,但用万能接口照样得改调用方。入口还把返回码翻译成本语言惯用的异常,并预留一个可覆盖的发送方法,测试时换成服务桩。参见[[入口与相近模式之别]]、[[服务桩越简单越好]]。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 2 处
- 入口与相近模式之别 · 查看原书依据
sendConfirmation方法的名字告诉了我们要发送的是什么消息,其参数也指明了类型和参数名。它的使用比通用方法要容易得多。创建一个更方便的接口是入口的职责。
- 入口与相近模式之别 · 查看原书依据
基于上述理由,入口必须完成两个操作:将显式接口转换成通用接口,将返回码转换成异常。
参考来源
- 位置:《企业应用架构模式》第18章“基本模式”之“18.1.3 例:私有消息服务的入口”(源文件:`_epub-src/OEBPS/Text/000212.html`)
- 结论依据:原文示例中消息系统只有 send(消息类型字符串, 参数数组) 的通用接口,灵活但不显式,无法从定义看出合法消息类型和所需参数;入口提供 sendConfirmation 等显式方法,新增消息类型时虽要改入口,但用通用接口也要改调用代码,且显式方式能让编译器帮助检查;同时入口把 C 风格的返回码转换为 Java 异常,并留出 doSend 供服务桩子类覆盖以便测试。
- 原始内容:sendConfirmation方法的名字告诉了我们要发送的是什么消息,其参数也指明了类型和参数名。它的使用比通用方法要容易得多。创建一个更方便的接口是入口的职责。……基于上述理由,入口必须完成两个操作:将显式接口转换成通用接口,将返回码转换成异常。