阿里巴巴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;

      }



相关文章
|
人工智能 前端开发 Java
2025年WebStorm高效Java开发全指南:从配置到实战
WebStorm 2025不仅是一款强大的JavaScript IDE,也全面支持Java开发。本文详解其AI辅助编程、Java特性增强及性能优化,并提供环境配置、高效开发技巧与实战案例,助你打造流畅的全栈开发体验。
978 4
|
前端开发 JavaScript Java
Java 开发中 Swing 界面嵌入浏览器实现方法详解
摘要:Java中嵌入浏览器可通过多种技术实现:1) JCEF框架利用Chromium内核,适合复杂网页;2) JEditorPane组件支持简单HTML显示,但功能有限;3) DJNativeSwing-SWT可内嵌浏览器,需特定内核支持;4) JavaFX WebView结合Swing可完美支持现代网页技术。每种方案各有特点,开发者需根据项目需求选择合适方法,如JCEF适合高性能要求,JEditorPane适合简单展示。(149字)
1470 1
|
10月前
|
安全 前端开发 Java
《深入理解Spring》:现代Java开发的核心框架
Spring自2003年诞生以来,已成为Java企业级开发的基石,凭借IoC、AOP、声明式编程等核心特性,极大简化了开发复杂度。本系列将深入解析Spring框架核心原理及Spring Boot、Cloud、Security等生态组件,助力开发者构建高效、可扩展的应用体系。(238字)
|
安全 Java 领域建模
Java 17 探秘:不容错过的现代开发利器
Java 17 探秘:不容错过的现代开发利器
1292 0
|
11月前
|
消息中间件 人工智能 Java
抖音微信爆款小游戏大全:免费休闲/竞技/益智/PHP+Java全筏开源开发
本文基于2025年最新行业数据,深入解析抖音/微信爆款小游戏的开发逻辑,重点讲解PHP+Java双引擎架构实战,涵盖技术选型、架构设计、性能优化与开源生态,提供完整开源工具链,助力开发者从理论到落地打造高留存、高并发的小游戏产品。
|
JavaScript 安全 前端开发
Java开发:最新技术驱动的病人挂号系统实操指南与全流程操作技巧汇总
本文介绍基于Spring Boot 3.x、Vue 3等最新技术构建现代化病人挂号系统,涵盖技术选型、核心功能实现与部署方案,助力开发者快速搭建高效、安全的医疗挂号平台。
504 3
|
安全 Java 数据库
Java 项目实战病人挂号系统网站设计开发步骤及核心功能实现指南
本文介绍了基于Java的病人挂号系统网站的技术方案与应用实例,涵盖SSM与Spring Boot框架选型、数据库设计、功能模块划分及安全机制实现。系统支持患者在线注册、登录、挂号与预约,管理员可进行医院信息与排班管理。通过实际案例展示系统开发流程与核心代码实现,为Java Web医疗项目开发提供参考。
521 2
|
11月前
|
存储 Java 关系型数据库
Java 项目实战基于面向对象思想的汽车租赁系统开发实例 汽车租赁系统 Java 面向对象项目实战
本文介绍基于Java面向对象编程的汽车租赁系统技术方案与应用实例,涵盖系统功能需求分析、类设计、数据库设计及具体代码实现,帮助开发者掌握Java在实际项目中的应用。
412 0