javascript在线api文档生成文献—综述.docVIP

本科毕业设计文献综述 （201届）  关于JavaScript的研究 JavaScript 语言背景 JavaScript简称Js，是目前 Web应用程序开发者使用最为广泛的客户端脚本编程语言，它不仅可用来开发交互式的 Web页面，更重要的是它将 HTML、XML和 Java applet、flash等功能强大的 Web对象有机结合起来，使开发人员能快捷生成 Internet或 Intranet上使用的分布式应用程序。另外由于 Windows对其最为完善的支持并提供二次开发的接口来访问操作系统各组件并实施相应的管理功能，JavaScript成为继.bat(批处理文件)以 来 Windows系统里使用最为广泛的脚本语言[1]。 脚本语言 脚本语言是为了缩短传统的编写-编译-链接-运行（edit-compile-link-run）过程而创建的计算机编程语言[2]。此命名起源于一个脚本“screenplay”，每次运行都会使对话框逐字重复。早期的脚本语言经常被称为批量处理语言或工作控制语言。一个脚本通常是解释运行而非编译。脚本语言通常都有简单、易学、易用的特性，目的就是希望能让程序员快速完成程序的编写工作。 JavaScript语言特性 JavaScript作为一门脚本语言，具有较大的灵活性[3]。作者可以在代码任意位置定义和使用一个函数，也可以在任意变量读写属性。  关于API文档生成的研究 API 文档 API（Application Programming Interface,应用程序编程接口）是一些预先定义的函数，目的是提供应用程序与开发人员基于某软件或硬件的以访问一组例程的能力，而又无需访问源码，或理解内部工作机制的细节[4]。 API 文档则是专门用于描述API的文档。比如比较有名API文档如 java 2 api 文档[5]。 现有的API文档生成技术 目前主流的编程语言都有相应的文档生成工具，且这些工具也工作地很好，比如Java语言可以使用javadoc[6]来生成文档，生成的文档非常精确。 目前国外最有名的JS文档生成项目为 Jsdoc Toolkit[7]，它的工作原理是在书写文档的时候额外提供一些标记，以让文档生成工具更好地理解，确保最后生成的文档是正确的。这样做就让书写文档的工作量倍增。因此它不是完美的解决方案。 编译原理在API文档生成的应用 编译是为了解析源码，并根据源码生成对应的可执行文件。 现在的目标是API文档生成，因此需要用到编译技术中的词法分析和语法分析[8]技术，在词法分析同时，还需要额外进行API文档注释分析。 词法分析 一个词法分析器从输入中读取字符，并将它们组成“词法单元对象”[9]。 语法分析 语法分析器从词法分析器获得一个由词法单元组成的串，并验证这个串可以由源语言的文法生成[9]。JavaScript 语言遵循 ECMA-262[10] 语法规范，因此进行JavaScript语法分析时，必须严格按照其文档中的文法约定执行。JavaScript在语法上符合LR1规范，因此可以使用LR1生成器来定制适用于JavaScript的语法分析器。 图2-1 语法分析的位置 注释分析 如果是一个完整的编译器，则需要后续的单元链接[11]、代码优化过程语法分析可以得到代码语法树，通过遍历这棵树，可以分析出某个位置的注释的意义。 文档合成 分析注释的时候，将创建一个临时变量域，分析这个变量域可以提取整个文档数据，提取的文档数据被存储为XML文件，这个步骤称为文档合成。 基于DOM的XML文档解析技术 XML(可扩展标记语言)是W3C为适应Internet的发展，实现快速的电子商务和电子数据交换而推出的新型web语言．它具有自描述性、数据结构高度规范、良好的扩展性、以及其数据与平台无关性等诸多优点[12]。 文档对象模型DOM(Document object Model)是W3C为在内存中建立XML文档的树结构提供的一种标准规范，XML文档中的每个元素、属性、CDATA部分等都可以用DOM树结构中的节点来表示。DOM是处理XML数据的传统方法。使用DOM时，数据以树状结构的形式被加载到内存中[13]。  关于在线API文档的研究 在线API文档 传统的API文档都是一个类似word的本地数据文件，它确实完成了API文档所应该拥有的功能。但在 web2.0[14] 时代，如果能让更多人通过网页参与API文档内容的讨论，则可以帮助作者修正错误，更帮助读者对某个API进行评论。同时还能让来自不同地区的读者在网站上共同学习、共同进步。 在线API文档也方便读者浏览文档，读者不需要安装额外的软件，只需一个浏览器即可直接阅读文档。 目前比较有名的在线API文档如 MSDN[