# 服务器端，门面入口 ### 描述它是一个在后端页面代码中使用的方法，用于声明一个前端 [门面](http://en.wikipedia.org/wiki/Facade_pattern) 的初始化。这部分代码，并不是 'neocortex' 项目的设计，而是业务的 web framework 需要实现的方法。 ### 作用 - 作为前后端接口声明的唯一入口，意在统一前后端接口的格式 - 用于注册页面 **直接依赖** 的前端模块 ## API 设计说明以 freemarker 的 tag 为例， <@facade mod="${module_identifier}" data="${init_data}" /> 这一段代码需要在源代码的合适位置输出以下内容：（具体情况会在下个章节说明） facade({ mod : ${module_identifier}, data : ${init_data} }); ### 参数 #### module_identifier type: `String` ##### 'abc' 若模块的版本没有定义，则指代最新版本。 #### init_data type: `String` 类型为 `String` 只是因为它是 freemarker 页面上的内容，由于 `initData` 会拼装为 inline 的 JavaScript 代码，因此该变量必须为标准的 JavaScript 对象的代码字符串，必须符合 JavaScript 的语法。 ## 后端逻辑 ### 基础配置 #### cdn_domains type: `Array.` 用于做 cdn 散列的候选域名组 #### f2e_framework_code type: `String` 前端框架的初始化代码，包括基础的 JavaScript 文件，配置等。 ### 程序逻辑 #### 1. 依赖分析这里说明如何获取依赖，并赋值给 `modules` #### 1. 与 neocortex 服务通信 `<@facade />` 每次运行的时候，都会将 `mod` 加入到 `modList` 中 #### 2. 获取，分析依赖及生成打包配置由于这部分稍微复杂，请见文档 [dependency-analytics.md](dependency-analytics.md) 这部分内容需要在在程序向客户端传输响应之前完成。 #### 3. 输出响应 ##### 页面准备首先，我们先说明页面中几个重要的 placeholder top_framework: 位于中的的 JavaScript 脚本占位符 top_src : 紧跟在代码块后面 bottom_framework: 这部分占位符在标签之前，位于页脚所有 JavaScript 脚本的最前面 bottom_src : 紧跟在代码块后面，代码块前面 bottom_facades ##### 逻辑 ##### 门面 `<@facade />` 的输出中，如下的代码将插入到占位符中： facade({ mod : ${module_identifier}, data : ${init_data} }); 如果有多个模块，则输出多个上面的代码片段 ##### 基础框架及配置将 `f2e_framework_code` 输出到默认情况下，输出 ##### 模块资源文件在 "程序逻辑.2" 章节中，生成的 `module_combo_urls` 输出到页面响应中。若为 IE 浏览器，并且 IE < 10，则在页面中输出: （这里的代码，使用 freemarker 的语法来做示例，以便于理解。）若为其他浏览器，则在页面中输出: <#list module_combo_urls as url>