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 =======================