阿里巴巴Java开发手册(第2版)-第1章(2)

简介: 本章是传统意义上的代码规范,包括变量命名、代码风格、控制语句、代码注释、前后端规约等基本的编程习惯,以及从高并发场景中提炼出来的集合处理技巧与并发多线程的注意事项。

1.2 常量定义

1

【强制】不允许任何魔法值(即未经预先定义的常量)直接出现在代码中。

反例:

// 本例中,开发者A 定义了缓存的key,开发者B 使用缓存时少了下

// 画线,即key 是"Id#taobao"+tradeId,导致出现故障

String key = "Id#taobao_" + tradeId;

cache.put(key, value);

2

【强制】在对long 或者Long 赋值时,数值后使用大写字母L,不能用小写字母l,小写字母l 容易跟数字1 混淆,造成误解。

说明:Long a = 2l; 写的是数字的21,还是Long 型的2?

3

【推荐】不要使用一个常量类维护所有的常量,要按常量功能进行归类,分开维护。

说明:大而全的常量类杂乱无章,必须使用查找功能才能定位到要修改的常量,既不利于理解,也不利于维护。

正例:缓存相关常量放在类CacheConsts 下;系统配置相关常量放在类

SystemConfigConsts 下。

4

【推荐】常量的复用层次有五层:跨应用共享常量、应用内共享常量、子工程内共享常量、包内共享常量和类内共享常量。

1)跨应用共享常量:放置在二方库中,通常是在client.jar中的constant 目录下。

2)应用内共享常量:放置在一方库中,通常是在子模块中的constant 目录下。

反例:易懂变量也要统一定义成应用内共享常量,两位工程师在两个类中

分别定义了“是”的变量:

类A 中:public static final String YES = "yes";

类B 中:public static final String YES = "y";

A.YES.equals(B.YES),预期是true,但实际返回为false,导致

线上出现问题。

3)子工程内部共享常量:即在当前子工程的constant 目录下。

4)包内共享常量:即在当前包下单独的constant 目录下。

5)类内共享常量:直接在类内部以private static final 定义。

5

【推荐】如果变量值仅在一个固定范围内变化,则用enum 类型来定义。

说明:如果存在名称之外的延伸属性,应使用enum 类型,下面正例中的数字就是延伸信息,表示一年中的第几个季节。

正例:

public enum SeasonEnum {

      SPRING(1), SUMMER(2), AUTUMN(3), WINTER(4);

      private int seq;

      SeasonEnum(int seq) {

             this.seq = seq;

      }

      public int getSeq() {

             return seq;

      }



相关文章
|
22天前
|
监控 JavaScript 前端开发
《理解 WebSocket:Java Web 开发的实时通信技术》
【4月更文挑战第4天】WebSocket是Java Web实时通信的关键技术,提供双向持久连接,实现低延迟、高效率的实时交互。适用于聊天应用、在线游戏、数据监控和即时通知。开发涉及服务器端实现、客户端连接及数据协议定义,注意安全、错误处理、性能和兼容性。随着实时应用需求增加,WebSocket在Java Web开发中的地位将更加重要。
|
2天前
|
设计模式 存储 前端开发
Java从入门到精通:2.2.1学习Java Web开发,了解Servlet和JSP技术,掌握MVC设计模式
Java从入门到精通:2.2.1学习Java Web开发,了解Servlet和JSP技术,掌握MVC设计模式
|
7天前
|
IDE Java 数据库连接
使用 Java 进行桌面应用开发
【4月更文挑战第19天】Java 是一款广泛应用于企业级、网络和桌面应用开发的编程语言。其跨平台特性使Java程序能在不同操作系统上运行,而JDK提供了开发所需工具和库。使用Swing等GUI库构建用户界面,结合JDBC进行数据库操作,Socket实现网络通信。虽然面临性能和用户体验的挑战,但通过优化和选用合适的IDE,Java仍能开发出高效稳定的桌面应用。
|
7天前
|
前端开发 Java Go
开发语言详解(python、java、Go(Golong)。。。。)
开发语言详解(python、java、Go(Golong)。。。。)
|
8天前
|
人工智能 前端开发 Java
Java语言开发的AI智慧导诊系统源码springboot+redis 3D互联网智导诊系统源码
智慧导诊解决盲目就诊问题,减轻分诊工作压力。降低挂错号比例,优化就诊流程,有效提高线上线下医疗机构接诊效率。可通过人体画像选择症状部位,了解对应病症信息和推荐就医科室。
147 10
|
8天前
|
Java 关系型数据库 MySQL
一套java+ spring boot与vue+ mysql技术开发的UWB高精度工厂人员定位全套系统源码有应用案例
UWB (ULTRA WIDE BAND, UWB) 技术是一种无线载波通讯技术,它不采用正弦载波,而是利用纳秒级的非正弦波窄脉冲传输数据,因此其所占的频谱范围很宽。一套UWB精确定位系统,最高定位精度可达10cm,具有高精度,高动态,高容量,低功耗的应用。
一套java+ spring boot与vue+ mysql技术开发的UWB高精度工厂人员定位全套系统源码有应用案例
|
15天前
|
运维 NoSQL 算法
Java开发-深入理解Redis Cluster的工作原理
综上所述,Redis Cluster通过数据分片、节点发现、主从复制、数据迁移、故障检测和客户端路由等机制,实现了一个分布式的、高可用的Redis解决方案。它允许数据分布在多个节点上,提供了自动故障转移和读写分离的功能,适用于需要大规模、高性能、高可用性的应用场景。
16 0
|
17天前
|
人工智能 小程序 Java
JAVA开发智慧学校系统源码+人脸电子班牌布局
智慧校园是通过利用物联网,大数据技术来改变师生和校园资源相互交互的方式,以便提高交互的明确性、灵活性和响应速度,从而实现智慧化服务和管理的校园模式。
|
20天前
|
安全 前端开发 Java
Java Web开发知识点学习总结
Java Web开发涉及Java基础、Servlet、JSP、数据库操作(SQL+JDBC)、MVC设计模式、Spring框架、Hibernate ORM、Web服务(SOAP&RESTful)、安全认证(HTTP Basic/Digest/OAuth)及性能优化(缓存、异步、负载均衡)。
18 3
|
23天前
|
XML JSON JavaScript
使用JSON和XML:数据交换格式在Java Web开发中的应用
【4月更文挑战第3天】本文比较了JSON和XML在Java Web开发中的应用。JSON是一种轻量级、易读的数据交换格式,适合快速解析和节省空间,常用于API和Web服务。XML则提供更强的灵活性和数据描述能力,适合复杂数据结构。Java有Jackson和Gson等库处理JSON,JAXB和DOM/SAX处理XML。选择格式需根据应用场景和需求。