优化网站关键词怎么做,深圳建站公司网站,wordpress示例页面删除,新的seo网站优化排名 网站简洁清爽的代码风格应该是大多数工程师所期待的。在工作中笔者常常因为起名字而纠结#xff0c;夸张点可以说是编程 5 分钟#xff0c;命名两小时#xff01;究竟为什么命名成为了工作中的拦路虎。每个公司都有不同的标准#xff0c;目的是为了保持统一#xff0c;减少沟通…简洁清爽的代码风格应该是大多数工程师所期待的。在工作中笔者常常因为起名字而纠结夸张点可以说是编程 5 分钟命名两小时究竟为什么命名成为了工作中的拦路虎。每个公司都有不同的标准目的是为了保持统一减少沟通成本提升团队研发效能。所以本文中是笔者结合阿里巴巴开发规范以及工作中的见闻针对 Java 领域相关命名进行整理和总结仅供参考。一Java 中的命名规范好的命名能体现出代码的特征含义或者是用途让阅读者可以根据名称的含义快速厘清程序的脉络。不同语言中采用的命名形式大相径庭Java 中常用到的命名形式共有三种既首字母大写的 UpperCamelCase首字母小写的 lowerCamelCase 以及全部大写的并用下划线分割单词的 UPPER_CAMEL_UNSER_SCORE。通常约定类一般采用大驼峰命名方法和局部变量使用小驼峰命名而大写下划线命名通常是常量和枚举中使用。二包命名包名统一使用小写点分隔符之间有且仅有一个自然语义的英文单词或者多个单词自然连接到一块(如 springframeworkdeepspace 不需要使用任何分割)。包名统一使用单数形式如果类命有复数含义则可以使用复数形式。包名的构成可以分为以下几四部分【前缀】 【发起者名】【项目名】【模块名】。常见的前缀可以分为以下几种三类命名类名使用大驼峰命名形式类命通常时名词或名词短语接口名除了用名词和名词短语以外还可以使用形容词或形容词短语如 CloneableCallable 等表示实现该接口的类有某种功能或能力。对于测试类则以它要测试的类开头以 Test 结尾如 HashMapTest。对于一些特殊特有名词缩写也可以使用全大写命名比如 XMLHttpRequest不过笔者认为缩写三个字母以内都大写超过三个字母则按照要给单词算。这个没有标准如阿里巴巴中 fastjson 用 JSONObject 作为类命而 google 则使用 JsonObjectRequest 命名对于这种特殊的缩写原则是统一就好。四方法方法命名采用小驼峰的形式首字小写往后的每个单词首字母都要大写。和类名不同的是方法命名一般为动词或动词短语与参数或参数名共同组成动宾短语即动词 名词。一个好的函数名一般能通过名字直接获知该函数实现什么样的功能。4.1 返回真伪值的方法注Prefix-前缀Suffix-后缀Alone-单独使用4.2 用来检查的方法4.3 按需求才执行的方法4.4 异步相关方法4.5 回调方法4.6 操作对象生命周期的方法4.7 与集合操作相关的方法4.8 与数据相关的方法4.9 成对出现的动词五变量常量命名5.1 变量命名变量是指在程序运行中可以改变其值的量包括成员变量和局部变量。变量名由多单词组成时第一个单词的首字母小写其后单词的首字母大写俗称骆驼式命名法(也称驼峰命名法)如 computedValuesindex、变量命名时尽量简短且能清楚的表达变量的作用命名体现具体的业务含义即可。变量名不应以下划线或美元符号开头尽管这在语法上是允许的。变量名应简短且富于描述。变量名的选用应该易于记忆即能够指出其用途。尽量避免单个字符的变量名除非是一次性的临时变量。pojo 中的布尔变量都不要加 is(数据库中的布尔字段全都要加 is_ 前缀)。5.2 常量命名常量命名 CONSTANT_CASE一般采用全部大写(作为方法参数时除外)单词间用下划线分割。那么什么是常量呢常量是在作用域内保持不变的值一般使用 final 进行修饰。一般分为三种全局常量(public static final 修饰)类内常量(private static final 修饰)以及局部常量(方法内或者参数中的常量)局部常量比较特殊通常采用小驼峰命名即可。/** * 一个demo * * author Jann Lee * date 2019-12-07 00:25 **/public class HelloWorld { /** * 局部常量(正例) */ public static final long USER_MESSAGE_CACHE_EXPIRE_TIME 3600; /** * 局部常量(反例命名不清晰) */ public static final long MESSAGE_CACHE_TIME 3600; /** * 全局常量 */ private static final String ERROR_MESSAGE error message; /** * 成员变量 */ private int currentUserId; /** * 控制台打印 {code message} 信息 * * param message 消息体局部常量 */ public void sayHello(final String message){ System.out.println(Hello world!); }}常量一般都有自己的业务含义,不要害怕长度过长而进行省略或者缩写。如用户消息缓存过期时间的表示那种方式更佳清晰交给你来评判。通用命名规则#尽量不要使用拼音杜绝拼音和英文混用。对于一些通用的表示或者难以用英文描述的可以采用拼音一旦采用拼音就坚决不能和英文混用。正例BeiJing HangZhou 反例validateCanShu命名过程中尽量不要出现特殊的字符常量除外。尽量不要和 jdk 或者框架中已存在的类重名也不能使用 java 中的关键字命名。妙用介词如 for(可以用同音的 4 代替), to(可用同音的 2 代替), from, withof 等。如类名采用 User4RedisDO方法名 getUserInfoFromRedisconvertJson2Map 等。六代码注解6.1 注解的原则好的命名增加代码阅读性代码的命名往往有严格的限制。而注解不同程序员往往可以自由发挥单并不意味着可以为所欲为之胡作非为。优雅的注解通常要满足三要素。Nothing is strange 没有注解的代码对于阅读者非常不友好哪怕代码写的在清除阅读者至少从心理上会有抵触更何况代码中往往有许多复杂的逻辑所以一定要写注解不仅要记录代码的逻辑还有说清楚修改的逻辑。Less is more 从代码维护角度来讲代码中的注解一定是精华中的精华。合理清晰的命名能让代码易于理解对于逻辑简单且命名规范能够清楚表达代码功能的代码不需要注解。滥用注解会增加额外的负担更何况大部分都是废话。// 根据id获取信息【废话注解】getMessageById(id)Advance with the time 注解应该随着代码的变动而改变注解表达的信息要与代码中完全一致。通常情况下修改代码后一定要修改注解。6.2 注解格式注解大体上可以分为两种一种是 javadoc 注解另一种是简单注解。javadoc 注解可以生成 JavaAPI 为外部用户提供有效的支持 javadoc 注解通常在使用 IDEA或者 Eclipse 等开发工具时都可以自动生成也支持自定义的注解模板仅需要对对应的字段进行解释。参与同一项目开发的同学尽量设置成相同的注解模板。a. 包注解包注解在工作中往往比较特殊通过包注解可以快速知悉当前包下代码是用来实现哪些功能强烈建议工作中加上尤其是对于一些比较复杂的包包注解一般在包的根目录下名称统一为 package-info.java。/** * 落地也质量检测 * 1. 用来解决什么问题 * 对广告主投放的广告落地页进行性能检测模拟不同的系统如AndroidIOS等; 模拟不同的网络2G3G4Gwifi等 * * 2. 如何实现 * 基于chrome浏览器用chromedriver驱动浏览器设置对应的网络OS参数获取到浏览器返回结果。 * * 注意网络环境配置信息{link cn.mycookies.landingpagecheck.meta.NetWorkSpeedEnum}目前使用是常规速度可以根据实际情况进行调整 * * author cruder * time 2019/12/7 20:3 下午 */package cn.mycookies.landingpagecheck;b. 类注接javadoc 注解中每个类都必须有注解。/*** Copyright (C), 2019-2020, Jann balabala...** 类的介绍这是一个用来做什么事情的类有哪些功能用到的技术.....** author 类创建者姓名 保持对齐* date 创建日期 保持对齐* version 版本号 保持对齐*/c. 属性注解在每个属性前面必须加上属性注释通常有一下两种形式至于怎么选择你高兴就好不过一个项目中要保持统一。/** 提示信息 */private String userName;/** * 密码 */private String password;d. 方法注释在每个方法前面必须加上方法注释对于方法中的每个参数以及返回值都要有说明。/** * 方法的详细说明能干嘛怎么实现的注意事项... * * param xxx 参数1的使用说明 能否为null * return 返回结果的说明 不同情况下会返回怎样的结果 * throws 异常类型 注明从此类方法中抛出异常的说明 */e. 构造方法注释在每个构造方法前面必须加上注释注释模板如下 /** * 构造方法的详细说明 * * param xxx 参数1的使用说明 能否为null * throws 异常类型 注明从此类方法中抛出异常的说明 */而简单注解往往是需要工程师字节定义在使用注解时应该注意一下几点枚举类的各个属性值都要使用注解枚举可以理解为是常量通常不会发生改变通常会被在多个地方引用对枚举的修改和添加属性通常会带来很大的影响。保持排版整洁不要使用行尾注释双斜杠和星号之后要用 1 个空格分隔。id 1;// 反例不要使用行尾注释//反例换行符与注释之间没有缩进int age 18;// 正例姓名String name;/** * 1. 多行注释 * * 2. 对于不同的逻辑说明可以用空行分隔 */总结无论是命名和注解他们的目的都是为了让代码和工程师进行对话增强代码的可读性可维护性。优秀的代码往往能够见名知意注解往往是对命名的补充和完善。命名太南了