java代码规范（适合写程序之前先了解有助于开发协同）

2024-01-04 01:12
文章标签 java 代码 程序 开发 了解 之前 适合 规范 协同 有助于

本文主要是介绍java代码规范（适合写程序之前先了解有助于开发协同），希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

目录

一、类定义

二、方法定义

三、接口定义

四、变量定义

1、命名规范：

2、类型规范：

3、常量规范：

五、static关键字

1、静态变量（类变量）：

2、静态方法（类方法）：

一、类定义

  1. 类名应该使用大写字母开头的驼峰命名法。例如，PublicClass。
  2. 类定义应该包含在一个与类名同名的文件中。例如，PublicClass类的定义应该保存在名为PublicClass.java的文件中。
  3. 类定义应该包括访问修饰符，通常是public，表示该类可以被其他类访问。如果没有指定访问修饰符，则默认为package-private（即只有在同一包中的类可以访问）。
  4. 类定义可以包含类级别的变量（称为字段）和方法。字段和方法也应该使用驼峰命名法，并且方法名应该以动词开头。
  5. 类定义可以包含构造函数，用于初始化类的实例。构造函数应该与类名同名，没有返回类型，并且可以在其中初始化类的字段。
  6. 如果类定义包含方法，则应该为每个方法提供适当的访问修饰符，例如public、private、protected或默认（package-private）。方法的访问修饰符应该根据方法的用途和访问需求进行选择。
  7. 类定义可以包含注释和文档，以便其他人可以理解代码的功能和用途。注释应该清晰明了，并且应该使用JavaDoc格式进行编写。

二、方法定义

在Java中，方法的定义也需要遵循一定的规范，这有助于提高代码的可读性和一致性。以下是一些Java方法定义的规范：

  1. 方法命名：方法名应该使用小写字母开头的驼峰命名法。动词应该用来表示方法的行为。例如，calculateSum()。
  2. 访问修饰符：每个方法都应该有明确的访问修饰符，如 public，private，protected，或者默认（没有指定）。这决定了该方法从哪里可以被访问。
  • private：当一个类的成员被声明为private时，它只能被其本身访问，而不能被外部的类访问。这是访问权限最严格的修饰符。
  • protected：当一个类的成员被声明为protected时，它可以被其本身、相同包中的其他类以及不同包中的子类访问。
  • public：当一个类的成员被声明为public时，它具有最宽松的访问权限。它可以被任何其他类访问，无论这些类是否在相同的包中或是该类的子类。

首先包层次如下所示：

private只可以在类中访问：

protected同一包中访问：

Test类和User类属于同一包下可以访问：

EasyTest类在easy包下和User类不属于同一包下所以不可以访问：

public可以被其他的类任意访问：

不同包下也可以访问：

  1. 返回类型：方法应该明确声明其返回类型。如果方法不返回任何值，那么它应该声明为 void。返回的类型应该尽可能地精确，避免使用过于宽泛的类型，如 Object。
  2. 参数：方法的参数列表应该清晰明了，每个参数的类型和名称都应该明确。参数也应该使用驼峰命名法。
  3. 异常处理：方法应该清楚地声明它可能抛出的任何异常。这有助于调用此方法的代码理解可能发生的错误并适当处理。
  4. 注释：和方法相关的重要信息应该通过注释进行说明，包括方法的目的、参数的含义和返回值。注释应该使用JavaDoc格式。
  5. 方法体：方法体内部的代码应该简洁明了，避免冗长和复杂的代码。每个方法都应该尽量只做一件事情，这样有助于代码的重用和测试。

三、接口定义

1、接口命名：

  • 接口名称应具有描述性，通常以able，ible或er结尾，例如Runnable，Serializable。
  • 使用大写字母开头的驼峰命名法，例如PublicInterface。
  • 避免使用Java关键字作为接口名称。

2、接口位置：

  • 接口应该放在其使用者可以访问的位置。通常，这意味着接口应该放在一个包中，该包的名称反映了其用途。

3、方法命名：

  • 接口方法应该是动词或动词短语，表示一个操作，例如start()，stop()。
  • 方法也应该使用驼峰命名法，并且首字母小写，例如public void myMethod();。

4、注释：

  • 对接口和其方法进行充分的注释，以便其他开发者理解它们的用途。
  • 使用JavaDoc格式进行注释，以便可以通过工具生成API文档。

5、接口与实现分离：

  • 接口不应包含任何具体的实现细节。这些细节应在实现接口的类中定义。

6、避免过于庞大：

  • 避免创建过于庞大的接口，接口中的方法数量应适中。过于庞大的接口会使得实现类变得复杂和难以理解。

7、常量定义：

  • 如果接口需要定义常量，则这些常量应该是公共的、静态的和最终的，通常这些常量都是大写字母，用下划线分隔单词，例如：public static final String CONSTANT_NAME = "value";

8、默认方法和静态方法：

  • 在合适的情况下，可以使用默认方法和静态方法。默认方法可以在不破坏已有实现的情况下向接口添加新方法，而静态方法则可以提供与接口相关的工具性函数。

接口的定义 接口类中的方法和属性不要加任何修饰符号（public 也不要加）

⭐⭐⭐在JDK8以后接口中的方法也可以实现了，就是要在方法前面加一个default关键词。

实现接口使用implements，下面的图片中的代码有这么一行

Animal myDog = new Dog();

这一行是通过new Dog对象从而向上转型实现了Animal接口因为接口是不可以直接的被new出来的。

向上转型（Upcasting）和向下转型（Downcasting）是Java中两种重要的类型转换操作。

1、向上转型（Upcasting）：

  • 向上转型是将子类的引用转为父类的引用。
  • 由于子类对象可以当作父类对象来使用（子类是父类的扩展），这种转换是自动的，不需要使用任何特殊的语法。
  • 向上转型是安全的，不会丢失任何数据。示例：

                class Animal { }

                class Dog extends Animal { }

                Dog dog = new Dog();

                Animal animal = dog; // 向上转型, 自动完成

2、向下转型（Downcasting）：

  • 向下转型是将父类的引用转为子类的引用。
  • 由于父类引用可能指向子类对象，也可能指向真正的父类对象，所以这种转换是不安全的，需要强制转换。
  • 在转换前，通常会使用instanceof操作符来检查是否可以安全地进行向下转型。示例：

                Animal animal = new Dog(); // 向上转型

                if (animal instanceof Dog) { // 检查是否可以安全地向下转型为Dog类型

                        Dog dog = (Dog) animal; // 向下转型, 需要强制转换

                        // ...

                }

四、变量定义

1、命名规范：

  • 使用有意义的变量名，变量名应清晰地表达变量的用途。
  • 采用驼峰命名法，变量名首字母小写，例如 myVariable。
  • 对于多个单词组成的变量名，使用驼峰命名法，例如 mySecondVariable。

2、类型规范：

  • 使用合适的数据类型，避免不必要的数据类型转换和浪费内存。
  • 在可能的情况下，优先使用基本数据类型而不是其包装类。

3、常量规范：

  • 常量通常使用 static 和 final 关键字进行定义。
  • 常量名全部大写，单词之间使用下划线分隔，例如 MY_CONSTANT。
  • 常量不应被改变，因此在定义时应初始化。

五、static关键字

1、静态变量（类变量）：

  • 使用static修饰的变量称为静态变量或类变量。
  • 它属于类，而不属于类的任何一个实例。也就是说，类的所有实例共享同一个静态变量。
  • 静态变量在类加载时初始化，仅在类加载时分配内存一次。
class Counter {  static int count = 0; // 静态变量  Counter() {  count++;  System.out.println(count);  }  public static void main(String args[]) {  Counter c1 = new Counter();  Counter c2 = new Counter();  Counter c3 = new Counter();  }  
}  
// 输出  
// 1  
// 2  
// 3

2、静态方法（类方法）：

  • 使用static修饰的方法称为静态方法或类方法。
  • 静态方法可以直接通过类名来调用，不需要创建类的实例。
  • 静态方法可以访问静态数据成员并且可以更改静态数据成员的值。
class Example {  static int cube(int x) {  // 静态方法  return x * x * x;  }  public static void main(String args[]) {  int result = Example.cube(5); // 通过类名直接调用静态方法  System.out.println(result);  }  
}

这篇关于java代码规范（适合写程序之前先了解有助于开发协同）的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/567700。

相关文章

使用Python开发一个带EPUB转换功能的Markdown编辑器

使用Python开发一个带EPUB转换功能的Markdown编辑器

《使用Python开发一个带EPUB转换功能的Markdown编辑器》Markdown因其简单易用和强大的格式支持,成为了写作者、开发者及内容创作者的首选格式,本文将通过Python开发一个Markd... 目录应用概览代码结构与核心组件1. 初始化与布局 (__init__)2. 工具栏 (setup_t
阅读更多...
SpringBoot应用中出现的Full GC问题的场景与解决

SpringBoot应用中出现的Full GC问题的场景与解决

《SpringBoot应用中出现的FullGC问题的场景与解决》这篇文章主要为大家详细介绍了SpringBoot应用中出现的FullGC问题的场景与解决方法,文中的示例代码讲解详细,感兴趣的小伙伴可... 目录Full GC的原理与触发条件原理触发条件对Spring Boot应用的影响示例代码优化建议结论F
阅读更多...
springboot项目中常用的工具类和api详解

springboot项目中常用的工具类和api详解

《springboot项目中常用的工具类和api详解》在SpringBoot项目中,开发者通常会依赖一些工具类和API来简化开发、提高效率,以下是一些常用的工具类及其典型应用场景,涵盖Spring原生... 目录1. Spring Framework 自带工具类(1) StringUtils(2) Coll
阅读更多...
SpringBoot条件注解核心作用与使用场景详解

SpringBoot条件注解核心作用与使用场景详解

《SpringBoot条件注解核心作用与使用场景详解》SpringBoot的条件注解为开发者提供了强大的动态配置能力,理解其原理和适用场景是构建灵活、可扩展应用的关键,本文将系统梳理所有常用的条件注... 目录引言一、条件注解的核心机制二、SpringBoot内置条件注解详解1、@ConditionalOn
阅读更多...
通过Spring层面进行事务回滚的实现

通过Spring层面进行事务回滚的实现

《通过Spring层面进行事务回滚的实现》本文主要介绍了通过Spring层面进行事务回滚的实现,包括声明式事务和编程式事务,具有一定的参考价值,感兴趣的可以了解一下... 目录声明式事务回滚：1. 基础注解配置2. 指定回滚异常类型3. ​不回滚特殊场景编程式事务回滚：1. ​使用 TransactionT
阅读更多...
使用Python实现全能手机虚拟键盘的示例代码

使用Python实现全能手机虚拟键盘的示例代码

《使用Python实现全能手机虚拟键盘的示例代码》在数字化办公时代,你是否遇到过这样的场景：会议室投影电脑突然键盘失灵、躺在沙发上想远程控制书房电脑、或者需要给长辈远程协助操作？今天我要分享的Pyth... 目录一、项目概述：不止于键盘的远程控制方案1.1 创新价值1.2 技术栈全景二、需求实现步骤一、需求
阅读更多...
Spring LDAP目录服务的使用示例

Spring LDAP目录服务的使用示例

《SpringLDAP目录服务的使用示例》本文主要介绍了SpringLDAP目录服务的使用示例... 目录引言一、Spring LDAP基础二、LdapTemplate详解三、LDAP对象映射四、基本LDAP操作4.1 查询操作4.2 添加操作4.3 修改操作4.4 删除操作五、认证与授权六、高级特性与最佳
阅读更多...
Spring Shell 命令行实现交互式Shell应用开发

Spring Shell 命令行实现交互式Shell应用开发

《SpringShell命令行实现交互式Shell应用开发》本文主要介绍了SpringShell命令行实现交互式Shell应用开发,能够帮助开发者快速构建功能丰富的命令行应用程序,具有一定的参考价... 目录引言一、Spring Shell概述二、创建命令类三、命令参数处理四、命令分组与帮助系统五、自定义S
阅读更多...
SpringSecurity JWT基于令牌的无状态认证实现

SpringSecurity JWT基于令牌的无状态认证实现

《SpringSecurityJWT基于令牌的无状态认证实现》SpringSecurity中实现基于JWT的无状态认证是一种常见的做法,本文就来介绍一下SpringSecurityJWT基于令牌的无... 目录引言一、JWT基本原理与结构二、Spring Security JWT依赖配置三、JWT令牌生成与
阅读更多...
Java中Date、LocalDate、LocalDateTime、LocalTime、时间戳之间的相互转换代码

Java中Date、LocalDate、LocalDateTime、LocalTime、时间戳之间的相互转换代码

《Java中Date、LocalDate、LocalDateTime、LocalTime、时间戳之间的相互转换代码》：本文主要介绍Java中日期时间转换的多种方法,包括将Date转换为LocalD... 目录一、Date转LocalDateTime二、Date转LocalDate三、LocalDateTim
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2