Adobe Flex编码规范指南

"Adobe Flex编码指南v1.2" 这篇文档是关于Adobe Flex 2 和 ActionScript 3 开发的编码规范，旨在提高代码的可读性和通用性，以适应软件开发过程中的维护需求和第三方部署。编码规范的制定考虑了两个主要原则：通用性和易理解性。 **ActionScript 3.0** 3.1 文件结构：ActionScript 代码通常被组织到单独的 `.as` 文件中，每个类对应一个文件。 3.2 样式： - 行与换行：代码应清晰分隔，适当使用换行以增强可读性。 - 声明：变量和函数声明应保持一致的缩进和排列。 - 括号：使用括号包围代码块，确保对齐。 - 声明：每行只声明一个变量或函数，除非它们是同一类型的连续声明。 - 换行与空格：正确使用空格增强代码的视觉层次感，如在操作符周围添加空格。 3.3 注释： - 文档注释：用于描述类、函数和变量的用途，以`/** ... */`形式。 - 执行注释：单行或多行注释，用于临时性或调试目的，以`//`或`/* ... */`形式。 **MXML** 4.1 文件结构：MXML 文件以 `.mxml` 扩展名存储，用于声明用户界面组件和绑定数据。 4.2 样式： - 行与换行：同样强调清晰的代码布局。 - Nesting components：正确组织嵌套组件，确保结构清晰。 - 属性：遵循特定的顺序和格式设置属性。 - 脚本：在MXML文件中内联AS3代码时，保持整洁和一致性。 - 注释：与ActionScript相同，有文档注释和执行注释。 4.3 风格指南：包括对组件属性、事件处理和内部逻辑的注释规范。 **样式** 5.1 一般规则：涵盖全局样式定义和组件特异性样式，确保代码在整个项目中的统一。 **命名** 6.1 一般规则：采用驼峰命名法，避免使用保留关键字。 - 语言：遵循ActionScript的命名约定。 - 包：使用小写字母和下划线分隔的名称。 - 类：首字母大写的驼峰命名。 - 接口：与类相似，但通常以"I"开头。 - 方法：描述性方法名，首字母大写。 - 变量：实例变量使用下划线前缀，局部变量遵循驼峰命名。 - 常量：全大写字母和下划线分隔。 - 命名空间：遵循特定的命名策略以区分不同的命名空间。 **一般习惯** 7.1 代码组织、代码复用、错误处理和性能优化等最佳实践。 **附录：预留关键字** 20. 列出ActionScript和MXML中的保留关键字，以避免在命名时冲突。 此编码指南通过提供具体指导，帮助开发者编写一致、清晰且易于维护的Adobe Flex应用，从而提高团队协作效率和代码质量。