首页  

Java类命名建议     所属分类 architecture 浏览量 99
java类名

管理类 
传播类
回调类
监控类
内存类
网络类
解析类 
设计模式类 
结构类
过滤检测类 


管理类命名 统一资源的管理,清晰的启动过程可以有效的组织代码。各种资源的注册、调度,公共集合资源的管理。 (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 工厂模式的命名, 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
传播类命名 为了完成一些统计类或者全局类的功能,有些参数需要一传到底。传播类的对象就可以通过统一封装的方式进行传递,并在合适的地方进行拷贝或者更新。 (1)Context 如果你的程序执行,有一些变量,需要从函数执行的入口开始,一直传到大量子函数执行完毕之后。 这些变量或者集合,如果以参数的形式传递,将会让代码变得冗长无比。这个时候,可以把变量统一塞到Context里面,以单个对象的形式进行传递。 在Java中,由于ThreadLocal的存在,Context甚至可以不用在参数之间进行传递。 AppContext ServletContext ApplicationContext (2)Propagator 传播,繁殖。用来将context中传递的值进行复制,添加,清除,重置,检索,恢复等动作。通常,它会提供一个叫做propagate的方法,实现真正的变量管理。 TextMapPropagator FilePropagator TransactionPropagator
回调类命名 使用多核可以增加程序运行的效率,不可避免的引入异步化。 需要有一定的手段,获取异步任务执行的结果,对任务执行过程中的关键点进行检查。 回调类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
监控类命名 (1)Metric 表示监控数据。 TimelineMetric HistogramMetric Metric (2)Estimator 估计,统计。用于计算某一类统计数值的计算器。 ConditionalDensityEstimator FixedFrameRateEstimator NestableLoadProfileEstimator (2)Accumulator 累加器的意思。用来缓存累加的中间计算结果,并提供读取通道。 AbstractAccumulator StatsAccumulator TopFrequencyAccumulator (3)Tracker 一般用于记录日志或者监控值,通常用于apm中。 VelocityTracker RocketTracker MediaTracker
内存管理类命名 (1)Allocator 与存储相关,通常表示内存分配器或者管理器。如果程序需要申请有规律得大块内存,allocator是不二选择。 AbstractByteBufAllocator ArrayAllocator RecyclingIntBlockAllocator (2)Chunk 表示一块内存。如果要对一类存储资源进行抽象,并统一管理,可以采用它。 EncryptedChunk ChunkFactory MultiChunk (3)Arena 英文是舞台、竞技场的意思。 由于Linux把它用在内存管理上发扬光大,它普遍用于各种存储资源的申请、释放与管理。 为不同规格的存储chunk提供舞台,好像也是非常形象的表示。 BookingArena StandaloneArena PoolArena (4)Pool 表示池子。内存池,线程池,连接池 ConnectionPool ObjectPool MemoryPool
过滤检测类命名 程序收到的事件和信息是非常多的,有些是合法的,有些需要过滤扔掉。根据不同的使用范围和功能性差别,过滤操作也有多种形式。 (1)Pipeline,Chain 一般用在责任链模式中。Netty,Spring MVC,Tomcat等都有大量应用。 通过将某个处理过程加入到责任链的某个位置中,就可以接收前面处理过程的结果,强制添加或者改变某些功能。 就像Linux的管道操作一样,最终构造出想要的结果。 Pipeline ChildPipeline DefaultResourceTransformerChain FilterChain (2)Filter 过滤器,用来筛选某些满足条件的数据集,或者在满足某些条件的时候执行一部分逻辑。如果和责任链连接起来,则通常能够实现多级的过滤。 FilenameFilter AfterFirstEventTimeFilter ScanFilter (3)Interceptor 拦截器,和Filter差不多。 springboot,Interceptor可以拿到controller对象,但filter不行 HttpRequestInterceptor (4)Evaluator 评估 。 计算结果 比如传递进去一个非常复杂的对象,或者字符串,评估结果。 ScriptEvaluator SubtractionExpressionEvaluator StreamEvaluator (5)Detector 探测器。用来管理一系列探测性事件,并在发生的时候能够进行捕获和响应。比如Android的手势检测,温度检测等。 FileHandlerReloadingDetector TransformGestureDetector ScaleGestureDetector
结构类命名 除了基本的数据结构,如数组、链表、队列、栈等,其他更高一层的常见抽象类,能够大量减少大家的交流,并能封装常见的变化。 (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迭代器 。在数据集很大的时候,需要进行深度遍历,迭代器可以说是必备的。使用迭代器还可以在迭代过程中安全的删除某些元素。 BreakIterator StringCharacterIterator (9)Batch某些可以批量执行的请求或者对象。 SavedObjectBatch BatchRequest (10)Limiter限流器,使用漏桶算法或者令牌桶来完成平滑的限流。 DefaultTimepointLimiter RateLimiter TimeBasedLimiter
常见设计模式命名 (1) Strategy将抽象部分与它的实现部分分离,使它们都可以独立地变化。 策略模式。相同接口,不同实现类,同一方法结果不同,实现策略不同。比如一个配置文件,是放在xml里,还是放在json文件里,都可以使用不同的provider去命名 RemoteAddressStrategy StrategyRegistration AppStrategy (2) Adapter将一个类的接口转换为客户希望的另一个接口,Adapter模式使得原本由于接口不兼容而不能一起工作的那些类一起工作。 不过,相对于传统的适配器进行api转接,如果你的某个Handler里面方法特别的多,可以使用Adapter实现一些默认的方法进行适配。 那么其他类使用的时候,只需要继承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。 JsonBuilder RequestBuilder (7) Template模板方法类的命名。定义一个操作中的算法的骨架,而将一些步骤延迟到子类中。模板方法使得子类可以不改变一个算法的结构即可重定义该算法的某些特定步骤。 JDBCTemplate (8) Proxy代理模式。为其他对象提供一种代理以控制对这个对象的访问。 ProxyFactory SlowQueryProxy
解析类命名 写代码要涉及到大量的字符串解析、日期解析、对象转换等。根据语义和使用场合的区别,它们也分为多种。 (1) Converter,Resolver转换和解析。 一般用于不同对象之间的格式转换,把一类对象转换成另一类。注意它们语义上的区别,一般特别复杂的转换或有加载过程的需求,可以使用Resolver DataSetToListConverter LayoutCommandLineConverter InitRefResolver MustacheViewResolver (2) Parser用来表示非常复杂的解析器,比如解析DSL。 SQLParser JSONParser (3) Customizer用来表示对某个对象进行特别的配置。由于这些配置过程特别的复杂,值得单独提取出来进行自定义设置。 ContextCustomizer DeviceFieldCustomizer (4) Formatter格式化类。主要用于字符串、数字或者日期的格式化处理工作。 DateFormatter StringFormatter
网络类命名 网络编程 (1) Packet通常用于网络编程中的数据包。 DhcpPacket PacketBuffer (2) Protocol同样用户网络编程中,用来表示某个协议。 RedisProtocol HttpProtocol (3) Encoder、Decoder、Codec编码解码器 RedisEncoder RedisDecoder RedisCodec (4) Request,Response一般用于网络请求的进和出。 CRUD 这个就有意思多了,统一的Controller,Service,Repository,没什么好说的。一旦用了DDD,那就得按照DDD那一套的命名来。
其他 (1) Util,Helper都表示工具类,Util一般是无状态的,Helper以便需要创建实例才能使用。 HttpUtil TestKeyFieldHelper CreationHelper (2) Mode,Type 枚举 OperationMode BridgeMode ActionType (3) Invoker,Invocation invoker是一类接口,通常会以反射或者触发的方式,执行一些具体的业务逻辑。 通过抽象出invoke方法,可以在invoke执行之前对入参进行记录或者处理;在invoke执行之后对结果和异常进行处理,是AOP中常见的操作方式。 MethodInvoker Invoker ConstructorInvocation (4) Initializer 如果应用程序,需要经过大量的初始化操作才能启动,那就需要把它独立出来,专门处理初始化动作。 MultiBackgroundInitialize ApplicationContextInitializer (5) Feture,Promise Feture相当于一个占位符,代表一个操作将来的结果。一般通过get可以直接阻塞得到结果,或者让它异步执行然后通过callback回调结果。 (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

上一篇     下一篇
热锅冷油,炒菜不粘锅的科学原理

netty Event Handler 和 Pipeline

netty中的设计模式

中证A500指数

JDK future 与 netty future promise 实例

netty整体架构笔记