Adobe Flex编码规范与指南

"flex编码规范.pdf" Adobe Flex编码规范提供了针对Flex 2和ActionScript 3的编程指导，强调了代码的可读性和通用性，旨在促进团队协作和代码维护。文档涵盖了多个方面，包括文件格式、ActionScript 3和MXML的编码样式、注释规则、样式和命名约定。 **一、文件** 1. 文件扩展名应明确区分不同类型的代码： - MXML代码使用`.mxml`扩展名。 - ActionScript代码使用`.as`扩展名。 - CSS代码使用`.css`扩展名。 2. 文件名应避免空格、标点和特殊符号，并推荐使用驼峰式命名法，尤其是对于ActionScript中的类和接口。 **二、ActionScript 3.0** 3.1 文件结构：ActionScript文件应遵循一定的结构，包括类定义、成员变量、构造函数、方法等。 3.2 样式： - 行与换行：保持代码整洁，适当使用换行。 - 声明：每个声明占用一行。 - 括号：使用一致的括号对齐方式。 - 声明和空格：在操作符周围使用适当的空格。 3.3 注释： - 文档注释：用于描述类、方法等，通常以`/** */`包裹。 - 执行注释：单行或多行，用于临时或内部注释。 **三、MXML** 4.1 文件结构：MXML文件包含组件结构、样式和脚本。 4.2 样式： - 行与换行：保持良好的缩进和布局。 - Nesting components：正确嵌套组件。 - 属性：每个属性应单独一行。 - 脚本：放置在`<mx:Script>`标签内。 4.3 注释： - 文档注释：同ActionScript。 - 执行注释：同ActionScript。 **四、样式和命名** 5.1 一般样式规则：确保代码一致性，如颜色、字体等。 6.1 命名的一般规则：遵循一定的命名约定，提高代码可读性。 6.2 语言：使用清晰、有意义的名称。 6.3 包：包名采用小写字母，使用点分隔。 6.4 类：类名采用驼峰式，首字母大写。 6.5 接口：接口名与类相似，但通常以"I"开头。 6.6 方法：方法名遵循驼峰式，描述其功能。 6.7 变量：变量名使用小写字母和下划线分隔。 6.8 常量：全大写字母，下划线分隔。 6.9 命名空间：遵循特定的命名规则以区分不同的作用域。 **五、一般习惯** 7.1 代码应遵循良好的编程实践，如避免全局变量，使用适当的访问修饰符等。 **六、附录** 8. 预留关键字：了解并避免使用Flex和AS3的保留关键字，以免引发冲突。 这个编码指南旨在帮助开发者创建易于阅读、理解和维护的Flex和ActionScript代码，促进团队合作，提高软件质量。通过遵循这些规范，开发者可以减少误解，增强代码的可维护性，同时也为可能的第三方集成提供便利。