前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >java教程系列三:Java 命名规范

java教程系列三:Java 命名规范

作者头像
java干货
发布2021-02-19 11:09:24
6580
发布2021-02-19 11:09:24
举报
文章被收录于专栏:java干货

相忘谁先忘,倾国是故国。泠泠不肯弹,蹁跹影惊鸿。

https://raw.githubusercontent.com/longfeizheng/longfeizheng.github.io/master/images/java/java17.jpg
https://raw.githubusercontent.com/longfeizheng/longfeizheng.github.io/master/images/java/java17.jpg

概述

Java命名规范是一种约定俗称的准则,应用程序开发者应遵循这些规范来在整个应用程序中编写可读的代码。如果团队不遵循这些规范,他们可能会编写出难以阅读和理解的程序代码。

Java大量使用Camel Case表示法来命名方法,变量等,而使用TitleCase用于类和接口。

让我们通过示例详细了解这些命名规范。

包命名规范

包的名称必须是一组以所有小写域名开头的字词(例如comorgnet等)。根据组织自己的内部命名约定,包名称的后续部分可能会有所不同。

代码语言:javascript
复制
package cn.howtodoinjava.webapp.controller;

package com.company.myapplication.web.controller;

package com.google.search.common;

类命名规范

Java中,类名通常应为名词,且每个单独的单词的首字母应大写。例如

代码语言:javascript
复制
public class ArrayList {}

public class Employee {}

public class Record {}

public class Identity {}

接口命名规范

Java中,接口名称通常应为形容词。接口应使用大写字母,每个单独单词的首字母大写。同样,当接口表示类概念时,接口也可以是名词(例如,ListMap)。

代码语言:javascript
复制
public interface Serializable {}

public interface Clonable {}

public interface Iterable {}

public interface List {}

方法命名规范

方法应该是动词。它们代表一个动作,方法名称应清晰易懂,表明它要执行的动作。为了清楚地表示操作,方法名称可以是单个单词,也可以是2-3个单词。单词应使用驼峰式大写。

代码语言:javascript
复制

变量命名规范

所有实例,静态和方法参数变量名称均应使用驼峰表示法。它们应该简短,且足以描述其目的。临时变量可以是单个字符,例如循环中的计数器。

代码语言:javascript
复制
public Long id;

public EmployeeDao employeeDao;

private Properties properties;

for (int i = 0; i < list.size(); i++) {

}

常量命名规范

Java常量应全部为大写,其中单词之间用下划线字符(”_“)分隔。确保将final修饰符与常量变量一起使用。

代码语言:javascript
复制
public final String SECURITY_TOKEN = "...";

public final int INITIAL_SIZE = 16;

public final Integer MAX_SIZE = Integer.MAX;

泛型命名规范

通用类型参数名称应为大写单字母。通常建议使用字母T作为类型。在JDK类中,E用于集合元素,S用于服务加载程序,而KV用于映射键和值。

代码语言:javascript
复制
public interface Map <K,V> {}

public interface List<E> extends Collection<E> {}

Iterator<E> iterator() {}

枚举命名规范

类似于类常量,枚举名称应全部为大写字母。

代码语言:javascript
复制
enum Direction {NORTH, EAST, SOUTH, WEST}

注解命名规范

注释名称遵循标题大小写。根据要求,它们可以是形容词,动词或名词。

代码语言:javascript
复制
public @interface FunctionalInterface {}

public @interface Deprecated {}

public @interface Documented {}

public @Async Documented {}

public @Test Documented {}

在本文中,我们讨论了再编写代码要遵循的Java命名规范,这使代码更具可读性和可维护性。

在使用任何编程语言编写简洁的代码时,命名约定可能是遵循的第一个最佳实践。

本文参与 腾讯云自媒体同步曝光计划,分享自作者个人站点/博客。
原始发表:2019/10/15,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 概述
    • 包命名规范
      • 类命名规范
        • 接口命名规范
          • 方法命名规范
            • 变量命名规范
              • 常量命名规范
                • 泛型命名规范
                  • 枚举命名规范
                    • 注解命名规范
                    领券
                    问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档