带你读《2022技术人的百宝黑皮书》——开发规约的意义与细则(3)

简介: 带你读《2022技术人的百宝黑皮书》——开发规约的意义与细则(3)

带你读《2022技术人的百宝黑皮书》——开发规约的意义与细则(2)https://developer.aliyun.com/article/1339988?groupCode=taobaotech 

image.png代码层次

image.png

 

 

 

  1. Client层:对外的接口,DTO,Enum等等,是最轻量的包,所有层都可以依赖client,client不应该依赖任何其他层;
  2. Adaptor层:负责对外系统的适配,Controller,HSF,MTOP接口实现都属于这一层;
  3. Application层:Application按照业务场景进行组织,主要负责交互参数的处理(入参校验,出参错误信息转  换),领域逻辑的组织编排;
  4. Domain层:封装了核心的业务逻辑,通过领域服务DomainService和领域对象DomainEntity对外提供业务实体对象和计算逻辑。
  5. Infrastructure层:负责外部依赖引入,数据库,外部hsf依赖,cache,mq等等。同时也是领域层与外部系统的防腐层(Anti-Corruption-Layer)。

 

image.png新老分层对比

两者其实非常相似,核心区别在于业务逻辑层新增了领域和应用层,进行了更细化的职责划分。

image.png

异常处理

 

  1. Java  类库中定义的可以通过预检查方式规避的RuntimeException异常不应该通过catch   的方式来处理,比如:NullPointerException,IndexOutOfBoundsException等等。说明:无法通过预检查的异常除外,比  如,在解析字符串形式的数字时,可能数字格式错误,不得不通过catch  NumberFormatException来实现。正例:if (obj != null) {...}反例:try { obj.method() } catch (NullPointerException e) {…}
  2. 异常捕获后不要用来做流程控制,条件控制。说明:异常设计的初衷是解决程序运行中的各种意外情况,且异常的处理效率比条件判断方式要低很多。

 

 

 

  1. catch时请分清稳定代码和非稳定代码,稳定代码指的是无论如何不会出错的代码。对于非稳定代码的catch尽可能进行区分异常类型,再做对应的异常处理。说明:对大段代码进行try-catch,使程序无法根据不同的异常做出正确的应激反应,也不利于定位问题,这是一种不负责任的表现。正例:用户注册的场景中,如果用户输入非法字符,或用户名称已存在,或输入密码过于简单,在程序上作出分门别类的判断,并提示给用户。
  2. 捕获异常是为了处理它,不要捕获了却什么都不处理而抛弃之,如果不想处理它,请将该异常抛给它的调用者。最外层的业务使用者,必须处理异常,将其转化为用户可以理解的内容。
  3. 事务场景中,抛出异常被catch后,如果需要回滚,一定要手动回滚事务。
  4. finally块必须对资源对象、流对象进行关闭,有异常也要做try- catch。说明:如果JDK7 ,可以使用 try-with-resources方式。
  5. 不要在finally块中使用return。说明:try块中的return语句执行成功后,并不马上返回,而是继续执行finally块中的语句,如果此处存在return语句,则在此直接返回,无情丢弃掉try块中的返回点。

反例:

 

private int x = 0;
public int checkReturn() {
try {
// x等于1,此处不返回
return ++x;
} finally {
// 返回的结果是2
return ++x;
  }
  }

 

 

  1. 捕获异常与抛异常,必须是完全匹配,或者捕获异常是抛异常的父类。说明:如果预期对方抛的是绣球,实际接到的是铅球,就会产生意外情况。
  2. 方法的返回值可以为null,不强制返回空集合,或者空对象等,必须添加注释充分说明什么情况下会返回null值。说明:本规约明确防止NPE是调用者的责任。即使被调用方法返回空集合或者空对象,对调用者来说,也并非高枕无忧,必须考虑到远程调用失败,运行时异常等场景返回null的情况。
  3. 防止NPE,是程序员的基本修养,注意NPE产生的场景:

1) 返回类型为基本数据类型,return包装数据类型的对象时,自动拆箱有可能产生NPE。   反例:public int f(){ return Integer对象},如果为null,自动解箱抛NPE。 2) 数据库的查询结果可能为null。 3) 集合里的元素即使isNotEmpty,取出的数据元素也可能为null。 4) 远程调用返回对象时,一律要求空指针判断,防止NPE。 5) 对于session中获取的数据,建议进行NPE检查,避免空指针。 6) 级联调用obj.getA().getB ().getC();易产生NPE。

 

 

带你读《2022技术人的百宝黑皮书》——开发规约的意义与细则(4)https://developer.aliyun.com/article/1339986?groupCode=taobaotech

相关文章
|
3月前
|
JSON 小程序 API
商品药品条码查询 API 教程:从接入到上线的完整指南
这是一款面向全行业的通用条码查询API,支持商品及药品条码(含UPC、短码等)识别,秒级返回名称、价格、厂商、图片及药品批准文号等权威信息。高稳定(SLA 100%)、低延迟(均值127ms),兼容电商、医药、ERP、小程序等多场景,提供免费试用、批量调用与私有化部署。
669 0
|
4月前
|
存储 自然语言处理 运维
企业知识库接入大模型前,如何完成内容安全和数据安全检查
企业知识库接入大模型前,需要把文档入库、向量化、检索、生成和审计放在统一安全链路中设计。推荐流程是:数据分级分类、敏感信息扫描、文档脱敏、权限元数据继承、向量库访问控制、输入风险检测、输出内容审核、日志留存和样本回流。对企业来说,RAG 的安全重点不是“模型是否安全”一个问题,而是知识是否该被召回、回答是否该被输出、过程是否可追踪。
|
边缘计算 缓存 安全
GitHub Release下载慢、老中断?断点续传多线路加速方案
GitHub未在中国大陆部署服务器与CDN,所有访问需经跨境出口,受国际链路拥塞、丢包等影响,导致时通时断、图片/头像/Release下载失败,严重影响开发效率。(239字)
941 0
|
5月前
|
弹性计算 5G 云计算
2026年阿里云秒杀活动抢购攻略:轻量应用服务器2核4G200M峰值带宽,秒杀价38元/年!
阿里云2026年秒杀活动每日两场(10:00/15:00),主打轻量服务器:2核2G仅38元/年、2核4G低至9.9元/月。新用户实名后可抢,需拼手速。文内含直达入口、抢购技巧及68元起备选方案,助力大家低成本上云!
933 3
|
4月前
|
缓存 人工智能 安全
GPT-5.6 Terra与GPT-5.5全维度实测:定价、性能、迁移A/B方案完整解析
2026年OpenAI正式发布GPT-5.6系列全量模型,包含旗舰Sol、均衡Terra、轻量Luna三大层级,其中GPT-5.6 Terra作为替代前代GPT-5.5的主力均衡模型,凭借全套计费标准统一减半的核心优势,成为批量编码、长上下文重构、企业日常AI工作流的热门选择。Terra与GPT-5.5共享完全一致的上下文容量、最大输出长度与API兼容协议,迁移仅需替换一行模型标识字符串,但存在关键短板:官方未单独公布Terra编码专项基准分数,仅放出定性成本对比描述,无法直接确认其代码生成、复杂补丁修复能力是否持平GPT-5.5。本文结合官方定价数据、多套行业基准、不同量级业务成本测算、标准
882 0
|
5月前
|
缓存 Kubernetes Serverless
阿里云弹性容器实例ECI对接使用完全指南:从快速上手到生产级实践
本文系统阐述了阿里云弹性容器实例(ECI)的对接使用方法与生产级实践。作为Serverless容器运行服务,ECI让用户无需管理底层服务器即可运行容器。文章从基础概念出发,详述了通过控制台、OpenAPI/SDK三种方式直接使用ECI的完整流程,并提供了Python SDK代码示例。重点剖析了ECI与Kubernetes生态的三种集成方案:ACK Serverless集群(完全基于ECI)、ACK集群(混合使用ECI与ECS)以及自建Kubernetes集群通过虚拟节点(VNode)对接。在深度实践层面,涵盖了镜像缓存加速实例启动、ACR企业版免密拉取、日志服务SLS采集配置、云监控告警设置、
|
5月前
|
运维 监控 安全
企业服务器数据泄露频发?3个低成本安全防护配置方案
企业服务器频遭泄露?本文提供3个零/低成本安全配置方案:①端口收敛+IP白名单,封堵外部入侵;②最小权限+强密码策略,杜绝内部泄密;③全量日志+异常预警,实现可追溯、可响应。无需高价设备,5–10分钟单机落地,覆盖80%基础漏洞。(239字)
|
10月前
|
SQL 存储 数据库
Python实现员工管理系统:从基础功能到完整应用开发指南
本文介绍如何用Python从零开发员工管理系统:基于SQLite实现员工信息、薪资计算、考勤记录等核心功能,支持命令行与Flask Web双界面,兼顾易用性与可扩展性,适合中小团队快速落地。(239字)
785 1
|
12月前
|
存储 机器学习/深度学习 人工智能
基于反馈循环的自我进化AI智能体:原理、架构与代码实现
自我进化智能体突破传统AI静态局限,通过“执行-反馈-调整”闭环,实现持续自主优化。它结合大模型与在线学习,利用多评分器反馈自动改进提示或参数,无需人工干预。适用于医疗、金融、编程等动态场景,推动AI迈向终身学习。
1897 12
基于反馈循环的自我进化AI智能体:原理、架构与代码实现
|
SQL XML Java
MyBatis Mapper中使用limit参数的查询问题
总结而言,MyBatis中使用 `limit`参数的查询可以高度定制并且灵活,基于方法签名和XML映射文件的组合来达成多样化的查询需求。通过参数化查询和动态SQL,MyBatis可以有效地处理各种复杂情境下的数据库操作,并且将SQL语句的维护与业务代码的编写相分离,提升代码的可维护性和可阅读性。
1005 13