Java代码命名规范是真优雅呀!代码如诗

本文涉及的产品
云数据库 Tair(兼容Redis),内存型 2GB
Redis 开源版,标准版 2GB
推荐场景:
搭建游戏排行榜
全局流量管理 GTM,标准版 1个月
简介: Java代码命名规范是真优雅呀!代码如诗

Java 命名规范


一、Java总体命名规范

1、项目名全部小写.

2、包名全部小写.

3、类名首字母大写,其余组成词首字母依次大写.

4、变量名,方法名首字母小写,如果名称由多个单词组成,除首字母外的每个单词首字母都要大写.

5、常量名全部大写.

6、所有命名规则必须遵循以下规则 :


名称只能由字母、数字、下划线、$符号组成.

不能以数字开头.

名称不能使用Java中的关键字.

坚决不允许出现中文及拼音命名.

二、Java包名命名规范

Java的包名由小写单词组成,包的路径符合所开发的系统模块的定义,以便通过包名可得知其属于哪个模块,从而方便到对应包里找相应的实现类.


2.1 常规包名

为了保障每个Java Package命名的唯一性,在Java编程规范中要求开发人员在自己定义的包名前加上唯一的前缀.由于互联网上的域名称是不会重复的,所以多数开发人员采用自己公司在互联网上的域名称作为自己程序包的唯一前缀.例如 : com.sun.swt…


1.公司项目

com : 公司项目,copyright由项目发起的公司所有.

包名 : com.公司名.项目名.模块名…


2.团队项目

team : 团队项目,指由团队发起,并由该团队开发的项目,copyright属于该团队所有.

包名 : team.团队名.项目名.模块名…


2.2 自定义包名

一般公司命名为com.公司名.项目名.模块名…那我们个人的项目又怎么命名呢?


个人的英语单词有individual、personal、private、one-man,进一步对以上四个单词词意进行分析并在保证了唯一性,继而使用每个单词的前4个字母作为前缀,与com也做了区分.示例如下所示:

1.indi : 个体项目,指个人发起,但非自己独自完成的项目,可公开或私有项目,copyright主要属于发起者.   
包名 : indi.发起者名.项目名.模块名..
2.pers : 个人项目,指个人发起,独自完成,可分享的项目,copyright主要属于个人.
包名 : pers.个人名.项目名.模块名..
3.priv : 私有项目,指个人发起,独自完成,非公开的私人使用的项目,copyright属于个人.
包名 : priv.个人名.项目名.模块名..
4.onem : 与indi相同,推荐使用indi.

三、类名

3.1 管理类命名

写代码,少不了对统一资源的管理,清晰的启动过程可以有效的组织代码。为了让程序运行起来,少不了各种资源的注册、调度,少不了公共集合资源的管理。


(1)Bootstrap,Starter一般作为程序启动器使用,或者作为启动器的基类。通俗来说,可以认为是main函数的入口。


AbstractBootstrap

ServerBootstrap

MacosXApplicationStarter

DNSTaskStarter


(2)Processor 某一类功能的处理器,用来表示某个处理过程,是一系列代码片段的集合。如果你不知道一些顺序类的代码怎么命名,就可以使用它,显得高大上一些。


CompoundProcessor

BinaryComparisonProcessor

DefaultDefaultValueProcessor


(3)Manager 对有生命状态的对象进行管理,通常作为某一类资源的管理入口。


AccountManager

DevicePolicyManager

TransactionManager


(4)Holder 表示持有某个或者某类对象的引用,并可以对其进行统一管理。多见于不好回收的内存统一处理,或者一些全局集合容器的缓存。


QueryHolder

InstructionHolder

ViewHolder


(5)Factory 毫无疑问,工厂模式的命名,耳熟能详。尤其是Spring中,多不胜数。


SessionFactory

ScriptEngineFactory

LiveCaptureFactory


(6)Provider Provider = Strategy + Factory Method。它更高级一些,把策略模式和方法工厂揉在了一块,让人用起来很顺手。Provider一般是接口或者抽象类,以便能够完成子实现。


AccountFeatureProvider

ApplicationFeatureProviderImpl

CollatorProvider


(7)Registrar 注册并管理一系列资源。


ImportServiceRegistrar

IKryoRegistrar

PipelineOptionsRegistrar


(8)Engine 一般是核心模块,用来处理一类功能。引擎是个非常高级的名词,一般的类是没有资格用它的。


ScriptEngine

DataQLScriptEngine

C2DEngine


(9)Service 某个服务。太简单,不忍举例。范围太广,不要滥用哦。


IntegratorServiceImpl

ISelectionService

PersistenceService


(10)Task 某个任务。通常是个runnable.


WorkflowTask

FutureTask

ForkJoinTask


3.2 传播类命名

为了完成一些统计类或者全局类的功能,有些参数需要一传到底。传播类的对象就可以通过统一封装的方式进行传递,并在合适的地方进行拷贝或者更新。


(1)Context 如果你的程序执行,有一些变量,需要从函数执行的入口开始,一直传到大量子函数执行完毕之后。这些变量或者集合,如果以参数的形式传递,将会让代码变得冗长无比。这个时候,你就可以把变量统一塞到Context里面,以单个对象的形式进行传递。

在Java中,由于ThreadLocal的存在,Context甚至可以不用在参数之间进行传递。


AppContext

ServletContext

ApplicationContext


(2)Propagator 传播,繁殖。用来将context中传递的值进行复制,添加,清除,重置,检索,恢复等动作。通常,它会提供一个叫做propagate的方法,实现真正的变量管理。


TextMapPropagator

FilePropagator

TransactionPropagator


3.3 回调类命名

使用多核可以增加程序运行的效率,不可避免的引入异步化。我们需要有一定的手段,获取异步任务执行的结果,对任务执行过程中的关键点进行检查。回调类API可以通过监听、通知等形式,获取这些事件。

(1)Handler,Callback,Trigger,Listener callback通常是一个接口,用于响应某类消息,进行后续处理;Handler通常表示持有真正消息处理逻辑的对象,它是有状态的;tigger触发器代表某类事件的处理,属于Handler,通常不会出现在类的命名中;Listener的应用更加局限,通常在观察者模式中用来表示特定的含义。


ChannelHandler

SuccessCallback

CronTrigger

EventListener


(2)Aware Aware就是感知的意思,一般以该单词结尾的类,都实现了Aware接口。拿spring来说,Aware 的目的是为了让bean获取spring容器的服务。具体回调方法由子类实现,比如ApplicationContextAware。它有点回调的意思。


ApplicationContextAware

ApplicationStartupAware

ApplicationEventPublisherAware


3.4 监控类命名

现在的程序都比较复杂,运行状态监控已经成为居家必备之良品。监控数据的收集往往需要侵入到程序的边边角角,如何有效的与正常业务进行区分,是非常有必要的。


(1)Metric 表示监控数据。不要用Monitor了,比较丑。


TimelineMetric

HistogramMetric

Metric


(2)Estimator 估计,统计。用于计算某一类统计数值的计算器。


ConditionalDensityEstimator

FixedFrameRateEstimator

NestableLoadProfileEstimator


(2)Accumulator 累加器的意思。用来缓存累加的中间计算结果,并提供读取通道。


AbstractAccumulator

StatsAccumulator

TopFrequencyAccumulator


(3)Tracker 一般用于记录日志或者监控值,通常用于apm中。


VelocityTracker

RocketTracker

MediaTracker


3.5 内存管理类命名

(1)Allocator 与存储相关,通常表示内存分配器或者管理器。如果你得程序需要申请有规律得大块内存,allocator是你得不二选择。


AbstractByteBufAllocator

ArrayAllocator

RecyclingIntBlockAllocator


(2)Chunk 表示一块内存。如果你想要对一类存储资源进行抽象,并统一管理,可以采用它。


EncryptedChunk

ChunkFactory

MultiChunk


(3)Arena 英文是舞台、竞技场的意思。由于Linux把它用在内存管理上发扬光大,它普遍用于各种存储资源的申请、释放与管理。为不同规格的存储chunk提供舞台,好像也是非常形象的表示。


BookingArena

StandaloneArena

PoolArena


(4)Pool 表示池子。内存池,线程池,连接池,池池可用。


ConnectionPool

ObjectPool

MemoryPool


3.6 过滤检测类命名

程序收到的事件和信息是非常多的,有些是合法的,有些需要过滤扔掉。根据不同的使用范围和功能性差别,过滤操作也有多种形式。你会在框架类代码中发现大量这样的名词。

(1)Pipeline,Chain 一般用在责任链模式中。Netty,Spring MVC,Tomcat等都有大量应用。通过将某个处理过程加入到责任链的某个位置中,就可以接收前面处理过程的结果,强制添加或者改变某些功能。就像Linux的管道操作一样,最终构造出想要的结果。


Pipeline

ChildPipeline

DefaultResourceTransformerChain

FilterChain


(2)Filter 过滤器,用来筛选某些满足条件的数据集,或者在满足某些条件的时候执行一部分逻辑。如果和责任链连接起来,则通常能够实现多级的过滤。


FilenameFilter

AfterFirstEventTimeFilter

ScanFilter


(3)Interceptor 拦截器,其实和Filter差不多。不过在Tomcat中,Interceptor可以拿到controller对象,但filter不行。拦截器是被包裹在过滤器中。


HttpRequestInterceptor


(4)Evaluator 英文里是评估器的意思。可用于判断某些条件是否成立,一般内部方法evaluate会返回bool类型。比如你传递进去一个非常复杂的对象,或者字符串,进行正确与否的判断。


ScriptEvaluator

SubtractionExpressionEvaluator

StreamEvaluator


(5)Detector 探测器。用来管理一系列探测性事件,并在发生的时候能够进行捕获和响应。比如Android的手势检测,温度检测等。


FileHandlerReloadingDetector

TransformGestureDetector

ScaleGestureDetector


3.7 结构类命名

除了基本的数据结构,如数组、链表、队列、栈等,其他更高一层的常见抽象类,能够大量减少大家的交流,并能封装常见的变化。


(1)Cache


LoadingCache

EhCacheCache


(2)Buffer buffer是缓冲,不同于缓存,它一般用在数据写入阶段。


ByteBuffer

RingBuffer

DirectByteBuffer


(3)Composite 将相似的组件进行组合,并以相同的接口或者功能进行暴露,使用者不知道这到底是一个组合体还是其他个体。


CompositeData

CompositeMap

ScrolledComposite


(4)Wrapper 用来包装某个对象,做一些额外的处理,以便增加或者去掉某些功能。


IsoBufferWrapper

ResponseWrapper

MavenWrapperDownloader


(5)Option, Param,Attribute用来表示配置信息。说实话,它和Properties的区别并不大,但由于Option通常是一个类,所以功能可以扩展的更强大一些。它通常比Config的级别更小,关注的也是单个属性的值。Param一般是作为参数存在,对象生成的速度要快一些。


SpecificationOption

SelectOption

AlarmParam

ModelParam


(6)Tuple元组的概念。由于Java中缺乏元组结构,我们通常会自定义这样的类。


Tuple2

Tuple3


(7)Aggregator聚合器,可以做一些聚合计算。比如分库分表中的sum,max,min等聚合函数的汇集。


BigDecimalMaxAggregator

PipelineAggregator

TotalAggregator


(8)Iterator迭代器。可以实现Java的迭代器接口,也可以有自己的迭代方式。在数据集很大的时候,需要进行深度遍历,迭代器可以说是必备的。使用迭代器还可以在迭代过程中安全的删除某些元素。


BreakIterator

StringCharacterIterator


(9)Batch某些可以批量执行的请求或者对象。


SavedObjectBatch

BatchRequest


(10)Limiter限流器,使用漏桶算法或者令牌桶来完成平滑的限流。


DefaultTimepointLimiter

RateLimiter

TimeBasedLimiter


3.8 常见设计模式命名

设计模式是名词的重灾区,这里只列出最常使用的几个。


(1) Strategy将抽象部分与它的实现部分分离,使它们都可以独立地变化。策略模式。相同接口,不同实现类,同一方法结果不同,实现策略不同。比如一个配置文件,是放在xml里,还是放在json文件里,都可以使用不同的provider去命名


RemoteAddressStrategy

StrategyRegistration

AppStrategy


(2) Adapter将一个类的接口转换为客户希望的另一个接口,Adapter模式使得原本由于接口不兼容而不能一起工作的那些类一起工作。


不过,相对于传统的适配器进行api转接,如果你的某个Handler里面方法特别的多,可以使用Adapter实现一些默认的方法进行0适配。那么其他类使用的时候,只需要继承Adapter,然后重写他想要重写的方法就可以了。这也是Adapter的常见用法。


ExtendedPropertiesAdapter

ArrayObjectAdapter

CardGridCursorAdapter


(3) Action,Command将一个请求封装为一个对象,从而使你可用不同的请求对客户进行参数化,对请求排队或记录请求日志,以及支持可撤销的操作。


用来表示一系列动作指令,用来实现命令模式,封装一系列动作或者功能。Action一般用在UI操作上,后端框架可以无差别的使用。


在DDD的概念中,CQRS的Command的C,既为Command。


DeleteAction

BoardCommand


(4) Event表示一系列事件。一般的,在语义上,Action,Command等,来自于主动触发;Event来自于被动触发。


ObservesProtectedEvent

KeyEvent


(5) Delegate代理或者委托模式。委托模式是将一件属于委托者做的事情,交给另外一个被委托者来处理。


LayoutlibDelegate

FragmentDelegate


(6) Builder将一个复杂对象的构建与它的表示分离,使得同样的构建过程可以创建不同的表示。


构建者模式的标准命名。比如StringBuilder。当然StringBuffer是个另类。这也说明了,规则是人定的,人也可以破坏。


JsonBuilder

RequestBuilder


(7) Template模板方法类的命名。定义一个操作中的算法的骨架,而将一些步骤延迟到子类中。模板方法使得子类可以不改变一个算法的结构即可重定义该算法的某些特定步骤。


JDBCTemplate


(8) Proxy代理模式。为其他对象提供一种代理以控制对这个对象的访问。


ProxyFactory

SlowQueryProxy


3.9 解析类命名

写代码要涉及到大量的字符串解析、日期解析、对象转换等。根据语义和使用场合的区别,它们也分为多种。


(1) Converter,Resolver转换和解析。一般用于不同对象之间的格式转换,把一类对象转换成另一类。注意它们语义上的区别,一般特别复杂的转换或有加载过程的需求,可以使用Resolver


DataSetToListConverter

LayoutCommandLineConverter

InitRefResolver

MustacheViewResolver


(2) Parser用来表示非常复杂的解析器,比如解析DSL。


SQLParser

JSONParser


(3) Customizer用来表示对某个对象进行特别的配置。由于这些配置过程特别的复杂,值得单独提取出来进行自定义设置。


ContextCustomizer

DeviceFieldCustomizer


(4) Formatter格式化类。主要用于字符串、数字或者日期的格式化处理工作。


DateFormatter

StringFormatter


3.9 网络类命名

网络编程的同学,永远绕不过去的几个名词。


(1) Packet通常用于网络编程中的数据包。


DhcpPacket

PacketBuffer


(2) Protocol同样用户网络编程中,用来表示某个协议。


RedisProtocol

HttpProtocol


(3) Encoder、Decoder、Codec编码解码器


RedisEncoder

RedisDecoder

RedisCodec


(4) Request,Response一般用于网络请求的进和出。如果你用在非网络请求的方法上,会显得很怪异。


CRUD

这个就有意思多了,统一的Controller,Service,Repository,没什么好说的。但你一旦用了DDD,那就得按照DDD那一套的命名来。


由于DDD不属于通用编程范畴,它的名词就不多做介绍了。


3.10 其他

(1) Util,Helper都表示工具类,Util一般是无状态的,Helper以便需要创建实例才能使用。但是一般没有使用Tool作为后缀的。


HttpUtil

TestKeyFieldHelper

CreationHelper


(2) Mode,Type看到mode这个后缀,就能猜到这个类大概率是枚举。它通常把常见的可能性都列到枚举类里面,其他地方就可以引用这个Mode。


OperationMode

BridgeMode

ActionType


(3) Invoker,Invocation invoker是一类接口,通常会以反射或者触发的方式,执行一些具体的业务逻辑。通过抽象出invoke方法,可以在invoke执行之前对入参进行记录或者处理;在invoke执行之后对结果和异常进行处理,是AOP中常见的操作方式。


MethodInvoker

Invoker

ConstructorInvocation


(4) Initializer 如果你的应用程序,需要经过大量的初始化操作才能启动,那就需要把它独立出来,专门处理初始化动作。


MultiBackgroundInitialize

ApplicationContextInitializer


(5) Feture,Promise 它们都是用在多线程之间的,进行数据传递。


Feture相当于一个占位符,代表一个操作将来的结果。一般通过get可以直接阻塞得到结果,或者让它异步执行然后通过callback回调结果。


但如果回调中嵌入了回调呢?如果层次很深,就是回调地狱。Java中的CompletableFuture其实就是Promise,用来解决回调地狱问题。Promise是为了让代码变得优美而存在的。


(6) Selector 根据一系列条件,获得相应的同类资源。它比较像Factory,但只处理单项资源。


X509CertSelector

NodeSelector


(7) Reporter 用来汇报某些执行结果。


ExtentHtmlReporter

MetricReporter


(8) Constants 一般用于常量列表。


(9) Accessor 封装了一系列get和set方法的类。像lombok就有Accessors注解,生成这些方法。但Accessor类一般是要通过计算来完成get和set,而不是直接操作变量。这适合比较复杂的对象存取服务。


ComponentAccessor

StompHeaderAccessor


(10) Generator 生成器,一般用于生成代码,生成id等。


CodeGenerator

CipherKeyGenerator


======================= End =======================


相关实践学习
基于Redis实现在线游戏积分排行榜
本场景将介绍如何基于Redis数据库实现在线游戏中的游戏玩家积分排行榜功能。
云数据库 Redis 版使用教程
云数据库Redis版是兼容Redis协议标准的、提供持久化的内存数据库服务,基于高可靠双机热备架构及可无缝扩展的集群架构,满足高读写性能场景及容量需弹性变配的业务需求。 产品详情:https://www.aliyun.com/product/kvstore     ------------------------------------------------------------------------- 阿里云数据库体验:数据库上云实战 开发者云会免费提供一台带自建MySQL的源数据库 ECS 实例和一台目标数据库 RDS实例。跟着指引,您可以一步步实现将ECS自建数据库迁移到目标数据库RDS。 点击下方链接,领取免费ECS&RDS资源,30分钟完成数据库上云实战!https://developer.aliyun.com/adc/scenario/51eefbd1894e42f6bb9acacadd3f9121?spm=a2c6h.13788135.J_3257954370.9.4ba85f24utseFl
相关文章
|
8天前
|
JavaScript NoSQL Java
接替此文【下篇-服务端+后台管理】优雅草蜻蜓z系统JAVA版暗影版为例-【蜻蜓z系列通用】-2025年全新项目整合搭建方式-这是独立吃透代码以后首次改变-独立PC版本vue版搭建教程-优雅草卓伊凡
接替此文【下篇-服务端+后台管理】优雅草蜻蜓z系统JAVA版暗影版为例-【蜻蜓z系列通用】-2025年全新项目整合搭建方式-这是独立吃透代码以后首次改变-独立PC版本vue版搭建教程-优雅草卓伊凡
152 96
接替此文【下篇-服务端+后台管理】优雅草蜻蜓z系统JAVA版暗影版为例-【蜻蜓z系列通用】-2025年全新项目整合搭建方式-这是独立吃透代码以后首次改变-独立PC版本vue版搭建教程-优雅草卓伊凡
|
1月前
|
SQL Java 数据库连接
如何在 Java 代码中使用 JSqlParser 解析复杂的 SQL 语句?
大家好,我是 V 哥。JSqlParser 是一个用于解析 SQL 语句的 Java 库,可将 SQL 解析为 Java 对象树,支持多种 SQL 类型(如 `SELECT`、`INSERT` 等)。它适用于 SQL 分析、修改、生成和验证等场景。通过 Maven 或 Gradle 安装后,可以方便地在 Java 代码中使用。
272 11
|
1月前
|
JSON Java 数据挖掘
利用 Java 代码获取淘宝关键字 API 接口
在数字化商业时代,精准把握市场动态与消费者需求是企业成功的关键。淘宝作为中国最大的电商平台之一,其海量数据中蕴含丰富的商业洞察。本文介绍如何通过Java代码高效、合规地获取淘宝关键字API接口数据,帮助商家优化产品布局、制定营销策略。主要内容包括: 1. **淘宝关键字API的价值**:洞察用户需求、优化产品标题与详情、制定营销策略。 2. **获取API接口的步骤**:注册账号、申请权限、搭建Java开发环境、编写调用代码、解析响应数据。 3. **注意事项**:遵守法律法规与平台规则,处理API调用限制。 通过这些步骤,商家可以在激烈的市场竞争中脱颖而出。
|
2月前
|
安全 Java 编译器
深入理解Java中synchronized三种使用方式:助您写出线程安全的代码
`synchronized` 是 Java 中的关键字,用于实现线程同步,确保多个线程互斥访问共享资源。它通过内置的监视器锁机制,防止多个线程同时执行被 `synchronized` 修饰的方法或代码块。`synchronized` 可以修饰非静态方法、静态方法和代码块,分别锁定实例对象、类对象或指定的对象。其底层原理基于 JVM 的指令和对象的监视器,JDK 1.6 后引入了偏向锁、轻量级锁等优化措施,提高了性能。
77 3
|
2月前
|
前端开发 Java 测试技术
java日常开发中如何写出优雅的好维护的代码
代码可读性太差,实际是给团队后续开发中埋坑,优化在平时,没有那个团队会说我专门给你一个月来优化之前的代码,所以在日常开发中就要多注意可读性问题,不要写出几天之后自己都看不懂的代码。
78 2
|
2月前
|
安全 Java API
Java中的Lambda表达式:简化代码的现代魔法
在Java 8的发布中,Lambda表达式的引入无疑是一场编程范式的革命。它不仅让代码变得更加简洁,还使得函数式编程在Java中成为可能。本文将深入探讨Lambda表达式如何改变我们编写和维护Java代码的方式,以及它是如何提升我们编码效率的。
|
2月前
|
Java 编译器 数据库
Java 中的注解(Annotations):代码中的 “元数据” 魔法
Java注解是代码中的“元数据”标签,不直接参与业务逻辑,但在编译或运行时提供重要信息。本文介绍了注解的基础语法、内置注解的应用场景,以及如何自定义注解和结合AOP技术实现方法执行日志记录,展示了注解在提升代码质量、简化开发流程和增强程序功能方面的强大作用。
142 5
|
2月前
|
存储 算法 Java
Java 内存管理与优化:掌控堆与栈,雕琢高效代码
Java内存管理与优化是提升程序性能的关键。掌握堆与栈的运作机制,学习如何有效管理内存资源,雕琢出更加高效的代码,是每个Java开发者必备的技能。
94 5
|
3月前
|
Java API 开发者
Java中的Lambda表达式:简洁代码的利器####
本文探讨了Java中Lambda表达式的概念、用途及其在简化代码和提高开发效率方面的显著作用。通过具体实例,展示了Lambda表达式如何在Java 8及更高版本中替代传统的匿名内部类,使代码更加简洁易读。文章还简要介绍了Lambda表达式的语法和常见用法,帮助开发者更好地理解和应用这一强大的工具。 ####
|
3月前
|
Java
java小工具util系列4:基础工具代码(Msg、PageResult、Response、常量、枚举)
java小工具util系列4:基础工具代码(Msg、PageResult、Response、常量、枚举)
75 24