阿里巴巴Java开发手册：工程规约与Web开发实践

"阿里巴巴Java开发手册-PowerBuilder 9.0 Web开发篇" 《阿里巴巴Java开发手册》是一份由阿里巴巴技术团队编写的指南，旨在提供一套完整的开发规范，以提高软件质量和开发效率。本手册特别关注PowerBuilder 9.0在Web开发中的应用，强调了工程规约的重要性。 在工程规约方面，主要涉及应用的分层架构设计： 1. **开放接口层**：此层可以直接调用Service层，也可以直接封装成RPC或HTTP接口，负责网关安全控制和流量管理。 2. **终端显示层**：主要用于模板渲染和不同端的显示，包括Velocity、JS、JSP和移动端展示。 3. **Web层**：处理访问控制转发，基础参数验证，以及非复用的简单业务逻辑。 4. **Service层**：提供相对具体的业务逻辑服务。 5. **Manager层**：作为通用业务处理层，封装第三方平台，下沉Service层的通用能力（如缓存和中间件处理），并协调多个DAO操作。 6. **DAO层**：直接与数据库交互，负责数据访问。 7. **外部接口或第三方平台**：包括内部RPC接口、基础平台和其他公司HTTP接口。 异常日志规约中提到： - DAO层应捕获所有异常并包装成DAOException，不打印日志，因为上层会记录日志。 - Service层出现异常时，必须记录日志，包含参数信息，以便分析问题。 - Manager层与Service层同部署时，处理方式与DAO层相同，独立部署则与Service层一致。 - Web层不应向上抛出异常，避免影响用户界面。 此外，手册还包括编程规约、异常日志规约、MySQL规约、工程规约和安全规约等其他内容，涵盖命名规范、常量定义、格式规范、面向对象原则、集合处理、并发控制、控制语句、注释规则、异常处理策略、日志记录方式、数据库设计和SQL编写规范、版本历史、专有名词解释和法律声明等。 这些规约旨在确保代码的可读性、可维护性和安全性，促进团队间的有效协作，减少因不规范编码引发的问题。遵循这些规约，开发者能够提高软件的健壮性和可靠性，同时降低协同开发的复杂性。