阿里巴巴Java开发规范——编程规约（3）

# 阿里巴巴Java开发规范——编程规约（3）

编程规约

（四） OOP规约

1.【强制】构造方法里面禁止加入任何业务逻辑，如果有初始化逻辑，请放在 init 方法中

这条编程规范的目的是为了保持代码的清晰性、可读性和维护性。具体解释如下：

  1. 清晰性：构造函数的主要职责是初始化对象的基本属性，使其达到可用状态。如果在构造函数中混入复杂的业务逻辑，会使构造过程变得模糊不清，阅读者需要花费更多精力去理解这个构造函数究竟做了什么。将业务逻辑移至单独的 init 方法中，可以使构造过程专注于对象的初始化，业务逻辑则集中在一个明确命名的方法中，提高了代码的清晰度。

  2. 可读性：构造函数通常在创建对象时被调用，其内部逻辑应当一目了然。如果包含业务逻辑，尤其是较为复杂的逻辑，会增加代码阅读难度，影响开发人员对类功能和行为的理解。将业务逻辑封装在 init 方法中，并通过方法名清晰地表明其作用，有助于提高代码的可读性。

  3. 维护性：当业务需求发生变化时，如果业务逻辑嵌套在构造函数中，修改或扩展这些逻辑可能会牵涉到构造函数本身，增加修改风险。将业务逻辑分离到独立的 init 方法，使得改动更加局部化，降低了对构造过程的影响，提升了代码的维护性。同时，这样的设计也便于进行单元测试，可以针对 init 方法单独编写测试用例，确保业务逻辑的正确性。

  4. 灵活性：有时候，对象可能需要在不同的场景下进行不同程度的初始化。如果业务逻辑在构造函数中，那么每次创建对象时都会执行这些逻辑，无法根据实际需求进行灵活调整。而将业务逻辑放在 init 方法中，可以根据需要选择是否调用、何时调用以及如何调用该方法，增加了代码的灵活性。

综上所述，遵循“构造方法里面禁止加入任何业务逻辑，如果有初始化逻辑，请放在 init 方法中”这一规范，有利于提升代码的清晰性、可读性、维护性和灵活性。在实际编程中，应尽量保持构造函数简洁明了，仅用于设置对象的基本属性，将复杂的业务逻辑封装在专门的方法（如 init）中处理。

2. 【强制】POJO 类必须写 toString 方法。使用 IDE 中的工具：source> generate toString时，如果继承了另一个 POJO 类，注意在前面加一下 super.toString。

说明：在方法执行抛出异常时，可以直接调用 POJO 的toString()方法打印其属性值，便于排查问题。

3. 【推荐】循环体内，字符串的连接方式，使用 StringBuilder 的 append 方法进行扩展。

说明： 下例中，反编译出的字节码文件显示每次循环都会 new 出一个 StringBuilder 对象，
然后进行append 操作，最后通过 toString 方法返回String 对象，造成内存资源浪费。

反例：

String str = "start";
for (int i = 0; i < 100; i++) {
str = str + "hello";
}

(五) 集合处理

1. 【强制】关于hashCode 和equals 的处理，遵循如下规则：

1） 只要重写 equals，就必须重写hashCode。
2） 因为 Set 存储的是不重复的对象，依据 hashCode 和equals 进行判断，所以 Set 存储的
对象必须重写这两个方法。
3） 如果自定义对象作为Map 的键，那么必须重写 hashCode 和equals。
说明：String 重写了hashCode 和equals 方法，所以我们可以非常愉快地使用 String 对象
作为key 来使用。

在 Java 中，如果一个类重写了 equals() 方法，那么通常也应该同时重写 hashCode() 方法。原因在于，这两个方法在 Java 的集合框架（如 HashMap、HashSet 等）以及对象相等性的语义中扮演着重要且相互关联的角色。具体解释如下：

  1. 一致性要求：根据 Object 类中 equals() 和 hashCode() 方法的约定，对于任何非空对象 x，多次调用 x.hashCode() 应该返回相同的哈希码。同时，如果 x.equals(y) 为 true，那么 x.hashCode() 和 y.hashCode() 必须相等。这就是所谓的“相等的对象必须具有相等的哈希码”。如果不重写 hashCode()，默认实现可能无法满足这一要求，导致集合类的行为不符合预期。

  2. 集合类性能：HashMap、HashSet 等基于散列的集合类依赖于 hashCode() 方法来快速定位元素。它们首先计算对象的哈希码，然后将其映射到一个桶（bucket）中。如果两个相等的对象具有不同的哈希码，它们会被分配到不同的桶中，导致在查找、添加、删除等操作时效率降低，甚至可能导致无法找到已存在的对象。因此，当重写 equals() 改变了对象相等性的判断规则时，也需要相应地重写 hashCode()，确保相等对象的哈希码一致，以维持集合类的高效运作。

  3. API 合约：Java 官方文档明确指出，如果一个类覆盖了 equals() 方法，那么它必须也要覆盖 hashCode() 方法。这是为了保持 Java 集合框架的一致性和正确性。违反这一约定可能会导致程序在使用集合类时出现难以预料的问题。

示例：

假设有一个 Person 类，包含 name 和 age 属性，并且我们希望两个 Person 对象在 name 相同且 age 相同时被视为相等。此时，我们需要同时重写 equals() 和 hashCode() 方法：

public class Person {private String name;private int age;// 构造函数、getter/setter...@Overridepublic boolean equals(Object obj) {if (this == obj) return true;if (!(obj instanceof Person)) return false;Person other = (Person) obj;return Objects.equals(name, other.name) && age == other.age;}@Overridepublic int hashCode() {return Objects.hash(name, age);}
}

在这个例子中，我们不仅重写了 equals() 方法，使其基于 name 和 age 判断对象相等性，还同时重写了 hashCode() 方法，使用 Objects.hash() 工具方法生成一个基于 name 和 age 的哈希码。这样，当两个 Person 对象相等时，它们的哈希码也必然相等，符合集合类的要求。

总之，只要重写 equals() 方法，就必须同时重写 hashCode() 方法，以确保对象相等性的一致性、维持基于散列的集合类的性能，并遵守 Java API 的约定。

2. 【【强制】不要在foreach 循环里进行元素的remove/add 操作。remove 元素请使用Iterator方式，如果并发操作，需要对 Iterator 对象加锁。

正例：

List<String> list = new ArrayList<>();
list.add("1");
list.add("2");
Iterator<String> iterator = list.iterator();
while (iterator.hasNext()) {
String item = iterator.next();
if (删除元素的条件) {
iterator.remove();
}
}

反例：:

for (String item : list) {
if ("1".equals(item)) {
list.remove(item);
}
}
3. 【推荐】集合初始化时，指定集合初始值大小。

说明： HashMap 使用 HashMap(int initialCapacity) 初始化。
正例： initialCapacity = (需要存储的元素个数 / 负载因子) + 1。 注意负载因子 （即loader
factor）默认为0.75，如果暂时无法确定初始值大小，请设置为 16（即默认值）。
反例：HashMap 需要放置1024 个元素，由于没有设置容量初始大小，随着元素不断增加，容
量7 次被迫扩大，resize 需要重建hash 表，严重影响性能。

4. 【推荐】使用entrySet 遍历Map 类集合KV，而不是keySet 方式进行遍历。

说明： keySet 其实是遍历了 2 次，一次是转为 Iterator 对象，另一次是从 hashMap 中取出
key 所对应的value。而entrySet 只是遍历了一次就把 key 和value 都放到了entry 中，效
率更高。如果是JDK8，使用Map.foreach 方法。
正例： values()返回的是 V 值集合，是一个list 集合对象；keySet()返回的是K 值集合，是
一个Set 集合对象；entrySet()返回的是K-V 值组合集合。

5. 【推荐】集合泛型定义时，在JDK7 及以上，使用diamond 语法或全省略。

说明：菱形泛型，即 diamond，直接使用<>来指代前边已经指定的类型。
正例：

// <> diamond 方式
HashMap<String, String> userCache = new HashMap<>(16);
// 全省略方式
ArrayList<User> users = new ArrayList(10);
6. 【推荐】高度注意 Map 类集合K/V 能不能存储 null 值的情况，如下表格:

在这里插入图片描述

反例： 由于HashMap 的干扰，很多人认为ConcurrentHashMap 是可以置入 null 值，而事实上，
存储null 值时会抛出NPE 异常。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.mzph.cn/diannao/1908.shtml

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

AOP

AOP

代理模式 提出问题 现有缺陷 假设我们有一个计算类&#xff0c;里面有加减乘除四个方法&#xff0c;现在我们要为这四个方法添加日志&#xff0c;即在方法执行的前后分别输出一句话&#xff0c;这时我们会发现如下缺陷&#xff1a; 1.对核心业务有干扰。核心业务是加减乘除…
阅读更多...
货拉拉0-1数据指标体系构建与应用

货拉拉0-1数据指标体系构建与应用

目录 一、背景 二、指标体系搭建 2.1 指标设计 2.2 指标体系搭建 2.3 指标维度拆解 三、指标标准化建设 四、指标元数据管理 五、指标应用&未来规划 原文大佬介绍的这篇指标体系构建有借鉴意义&#xff0c;现摘抄下来用作沉淀学习。如有侵权请告知~ 一、背景 指标…
阅读更多...
汽车摄像头匿名化处理解决方案，保护信息的安全性和隐私性

汽车摄像头匿名化处理解决方案，保护信息的安全性和隐私性

随着智能交通和自动驾驶技术的迅猛发展&#xff0c;汽车摄像头已成为现代汽车不可或缺的一部分&#xff0c;摄像头所捕捉的图像信息也引发了日益严峻的信息安全问题。如何在充分利用摄像头功能的同时&#xff0c;保障个人隐私和信息安全&#xff0c;已成为企业亟待解决的问题。…
阅读更多...
IP地址定位技术引发的个人隐私保护问题

IP地址定位技术引发的个人隐私保护问题

IP地址定位技术对互联网的影响深远且多面&#xff0c;它不仅改变了网络管理与优化的方式&#xff0c;还极大地推动了在线广告营销、电子商务、地理信息服务等多个领域的发展。然而&#xff0c;与此同时&#xff0c;它也引发了一系列关于个人隐私保护的问题。 首先&#xff0c;I…
阅读更多...
vue的学习之用vue写一个hello，vue

vue的学习之用vue写一个hello，vue

根据以下步骤下载vue.js 介绍 — Vue.js 创建一个damo.html &#xff0c;引入vue.js即可 <body><div id"app">{{ message }}</div><!-- Vue --><!-- 开发环境版本&#xff0c;包含了有帮助的命令行警告 --><script src"js/vu…
阅读更多...
清华新突破，360°REA重塑多智能体系统：全方位提升复杂任务表现

清华新突破，360°REA重塑多智能体系统：全方位提升复杂任务表现

引言&#xff1a;多智能体系统的新篇章——360REA框架 在多智能体系统的研究领域&#xff0c;最新的进展揭示了一种全新的框架——360REA&#xff08;Reusable Experience Accumulation with 360 Assessment&#xff09;。这一框架的提出&#xff0c;不仅是对现有系统的一次重大…
阅读更多...
如何修改WordPress数据库表前缀以提高安全性

如何修改WordPress数据库表前缀以提高安全性

WordPress作为世界上最受欢迎的内容管理系统之一&#xff0c;吸引了数以百万计的用户。然而&#xff0c;正因为其广泛的使用&#xff0c;WordPress网站也成为了黑客攻击的目标之一。其中一个最常见的安全漏洞是使用默认的数据库表前缀wp_&#xff0c;使得黑客能够更轻松地进行大…
阅读更多...
Oracle交换分区测试

Oracle交换分区测试

1、用exchange分区表减少初始化过程中对业务中断的影响 2、创建分区表 create table t_p (id number,name varchar2(30),addr varchar2(50)) partition by range(id) (partition p1 values less than(10), partition p2 values less than(20), partition p3 values less …
阅读更多...
sql(ctfhub)

sql(ctfhub)

一.整数型注入 输入1 输入2 输入2-1&#xff0c;回显为1的结果&#xff0c;说明是数字型&#xff0c;只有数字型才可加减 判断字段数为2 查询数据库 查表 查列 显示flag内容 二.字符型注入 输入1 输入2 输入2-1&#xff0c;说明为字符型&#xff0c;不是数字型 判断闭合方式为…
阅读更多...
【数据分析面试】27. 计算广告评论比例 （SQL）

【数据分析面试】27. 计算广告评论比例 （SQL）

题目: 计算广告评论比例 假设你有一个ads表&#xff0c;包含ID和广告名称&#xff0c;比如“劳动节衬衫促销”。feed_comments表保存了不同用户在常规信息流中对广告的评论。moments_comments表保存了不同用户在moments中对广告的评论。 编写一个查询&#xff0c;获取广告在f…
阅读更多...
问题总结笔记

问题总结笔记

1.向量旋转 问题&#xff1a; 将一个向量旋转90 方法&#xff1a;旋转矩阵 FVector FrontDir EndMousePoint - Point; FrontDir.Normalize(); FVector Left FVector(-FrontDir.Y, FrontDir.X, 0); Verties.Add(Point Left * (WallWedith / 2)); Verties.Add(FVector(Vertie…
阅读更多...
BFS 专题 ——FloodFill算法：733.图像渲染

BFS 专题 ——FloodFill算法：733.图像渲染

文章目录 前言FloodFill算法简介题目描述算法原理代码实现——BFSCJava 前言 大家好啊&#xff0c;今天就正式开始我们的BFS专题了&#xff0c;觉得有用的朋友给个三连呗。 FloodFill算法简介 中文&#xff1a;洪水灌溉 举个例子&#xff0c;正数为凸起的山峰&#xff0c;负…
阅读更多...
攻防世界---misc---easycap

攻防世界---misc---easycap

1.下载附件是一个流量包&#xff0c;拿到wireshark中分析 2.查看分级协议 3.过滤data 4.追踪tcp流 5.得到flag
阅读更多...
OpenCV与AI深度学习 | OpenCV如何读取仪表中的指针刻度

OpenCV与AI深度学习 | OpenCV如何读取仪表中的指针刻度

本文来源公众号“OpenCV与AI深度学习”&#xff0c;仅用于学术分享&#xff0c;侵权删&#xff0c;干货满满。 原文链接&#xff1a;OpenCV如何读取仪表中的指针刻度 最近遇到一个问题&#xff0c;如何读取仪表中的指针指向的刻度。 解决方法有多种&#xff0c;比如&#xff…
阅读更多...
Linux使用Docker部署DashDot访问本地服务器面板

Linux使用Docker部署DashDot访问本地服务器面板

文章目录 1. 本地环境检查1.1 安装docker1.2 下载Dashdot镜像 2. 部署DashDot应用 本篇文章我们将使用Docker在本地部署DashDot服务器仪表盘&#xff0c;并且结合cpolar内网穿透工具可以实现公网实时监测服务器系统、处理器、内存、存储、网络、显卡等&#xff0c;并且拥有API接…
阅读更多...
【C++】双指针算法：复写零

【C++】双指针算法：复写零

1.题目 别看这是一道简单题&#xff0c;它的通过率低于一些中等甚至困难的题目&#xff01; 大大增加这道题目难度的是最后一句话&#xff1a;1.不可越界写入。2.就地修改。 如果可以再创建一个数组的话&#xff0c;那么这道题目就会非常简单&#xff0c;但这道题目必须要求在…
阅读更多...
Linux的学习之路：18、进程间通信（2）

Linux的学习之路：18、进程间通信（2）

摘要 本章主要是说一下命名管道和共享内存 目录 摘要 一、命名管道 1、创建一个命名管道 2、匿名管道与命名管道的区别 3、命名管道的打开规则 4、代码实现 二、system V共享内存 1、共享内存 2、共享内存函数 三、代码 四、思维导图 一、命名管道 1、创建一个命…
阅读更多...
13.Nacos简介，下载，安装，启动-windows

13.Nacos简介，下载，安装，启动-windows

Nacos是阿里巴巴的产品&#xff0c;现在是SpringCloud的一个组件。 相比Eureka功能更加丰富&#xff0c;服务注册与发现和分布式配置。 Nacos下载地址&#xff1a; https://github.com/alibaba/nacos windows下载nacos-server-1.4.1.zip文件 nacos是基于java语言实现的&…
阅读更多...
【系统架构师】-案例考点（三）

【系统架构师】-案例考点（三）

1、信息系统架构ISA设计 四种架构模型&#xff1a; 1&#xff09;单机应用 2&#xff09;客户机/服务器模式&#xff1a;两层、三层C/S、B/S模型、MVC模式等 3&#xff09;面向服务架构SOA 4&#xff09;企业数据交换总线&#xff1a;不同企业应用之间通过信息交换的公共频…
阅读更多...
一招下载transformers真不用网上那些教程（我试了1*mol多次才知道）

一招下载transformers真不用网上那些教程（我试了1*mol多次才知道）

pip很多是2 然而&#xff01;&#xff01;&#xff01;&#xff01;&#xff01;&#xff01;&#xff01;&#xff01;&#xff01;&#xff01;&#xff01;&#xff01;&#xff01;&#xff01;&#xff01;&#xff01;&#xff01;&#xff01;&#xff01;&#xff01;…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023