Open UI5 源代码解析之1241：TranslationAPI.js

源代码仓库：

https://github.com/SAP/openui5

源代码位置：src\sap.ui.fl\src\sap\ui\fl\write\api\TranslationAPI.js

TranslationAPI.js 详细分析

文件定位与整体结论

TranslationAPI.js位于sap.ui.fl.write.api这一层。从命名就能看出来，它不是一个直接渲染界面的控件文件，也不是一个单纯访问后端的低层连接器，而是一个处在Runtime Authoring与flex write storage之间的中间 API。它承担的任务很明确：把运行时适配场景中的翻译需求，整理成一个稳定、简单、可复用的接口，提供给像sap.ui.rta这样的上层工具使用。

如果把整个项目类比成一家跨国企业的软件工厂，那么TranslationAPI更像一个翻译事务协调台。设计人员在界面里改了文案，翻译团队需要把这些文案导出为XLIFF，外部语言服务供应商翻译完后，再把结果回传。界面层不该直接了解底层存储连接器的细节，连接器层也不该感知界面对话框、按钮状态与工具栏交互。TranslationAPI正好站在两者之间，既懂应用级别的reference、layer、脏变更，也懂上层工具真正需要的动作，比