开源ACE的设计规范

所述的面向对象应用框架来源于合理地运用和对ACE C++框架设计和实现的再工程。ACE面向对象框架实现了许多并发通信软件的核心设计模式，ACE提供了一组丰富的可复用C++包装外观（Wrapper Facade）和框架组件，可跨越多种平台完成通用的通信软件任务。 《开源ACE的设计规范》 1 简介 开源ACE（Adaptive Communication Environment）是一个高度可移植、事件驱动的C++应用开发框架，主要用于构建分布式、实时和嵌入式系统。它提供了大量的通信模式和组件，如并发处理、网络编程、同步机制等，帮助开发者在各种操作系统平台上编写高效、可靠的软件。 2 编程原则 ACE的设计规范旨在提高代码的可读性、可维护性和可移植性，以下是一些核心编程原则： 2.1 守卫（guard）头文件 为了防止重复包含头文件，应使用`#ifndef`、`#define`、`#endif`来创建头文件保护。这可以避免由于多次包含同一头文件而导致的编译错误。 2.2 避免使用全局函数 全局函数可能导致命名冲突和难以调试的问题，因此，鼓励使用类成员函数或命名空间来封装功能。 2.3 考虑用户名字空间 使用用户自定义的名字空间可以避免与标准库或其他库的命名冲突，提高代码的可读性和可维护性。 2.4 使用 placement new 和显式调用析构函数 placement new允许在已分配的内存上构造对象，而显式调用析构函数则确保资源的正确释放，这对于内存管理至关重要。 2.5 避免链式使用指针成员选择操作符（->） 连续使用`->`可能会导致阅读困难和潜在的错误。考虑使用`.`操作符或临时变量来改善代码的清晰度。 2.6 避免直接调用系统函数 直接调用系统函数可能导致平台依赖性，推荐使用ACE提供的封装接口，这些接口通常已经处理了跨平台兼容性问题。 2.7 运用统一的出错处理 错误处理应遵循一致的策略，例如使用异常处理或返回错误代码，以确保程序的健壮性。 2.8 实现 dump()方法 dump()方法用于在调试时打印类的内部状态，便于问题排查。 2.9 使用文件描述符抽象 文件描述符在不同操作系统中有不同的表示，使用ACE的文件描述符抽象层可以确保跨平台兼容。 2.10 允许运行时跟踪 通过提供跟踪和日志功能，可以帮助开发者在运行时理解程序行为，便于调试和优化。 2.11 检查所有的返回值 对函数返回值进行检查是保证程序稳定性的关键，尤其是在涉及资源分配和错误处理的场景。 2.12 限定（qualify）不在范围内的方法 对于非成员函数，使用作用域解析运算符（::）明确指出其来源，以减少命名冲突的可能性。 2.13 基类中避免出现数据成员 基类通常作为接口使用，数据成员应尽量放在派生类中，以利于多态性和代码复用。 2.14 实现 open()/close()方法 open()和close()方法是IO操作的常用接口，它们分别用于初始化和清理资源，符合Unix哲学。 3 编译器兼容性 ACE的设计考虑了多种编译器的兼容性，确保在不同的编译环境和目标平台下都能正常工作。开发者应遵循相应的编译选项和宏定义，以适应特定平台的需求。 总结，ACE的设计规范强调了代码的可读性、可维护性和可移植性，通过遵循这些原则，开发者能够创建出高效、可靠的软件系统，同时充分利用ACE提供的通信模式和组件，以应对复杂的分布式系统挑战。