Java计算圆面积两种实现方案的最佳编码实践探讨

问题背景 #

我在Java课程作业中需要实现一个功能：接收用户输入的半径，计算并打印圆的面积。我写出了两种实现方案，想请教哪种更符合编码最佳实践，以及具体原因。

方案1：单一void方法包揽输入、计算、输出 #

import java.util.*;
class Example{
   public static void area(){
      Scanner input = new Scanner (System.in);
      double area = 0;
      double radius = input.nextInt();
      area = 3.14 * radius * radius;
      System.out.println("Area is: " + area);
   }

   public static void main(String args[]){
      System.out.println("Input the radius: ");
      area();
   }
}

方案2：拆分输入、计算、输出职责 #

import java.util.*;
class Example{
   public static double area(double r){
      double area = 0;
      area = 3.14 * r * r;
      return area;
   }

   public static void main(String args[]){
      System.out.println("Input the radius: ");
      Scanner input = new Scanner (System.in);
      double radius = input.nextDouble();
      System.out.println("Area is: " + area(radius));
   }
}

最佳实践分析：方案2更符合编码规范 #

方案2的实现更贴合单一职责原则，这是Java编码中最基础的最佳实践之一，具体原因如下：

• 职责拆分清晰：
  方案2把「用户输入」「面积计算」「结果输出」三个独立操作拆分开：main方法负责处理输入和输出，area方法只专注于计算圆的面积。而方案1的area方法同时包揽三件事，后续要修改任意一个环节（比如换输入方式、调整计算精度、修改输出格式），都得改动同一个方法，维护成本更高。

• 方法复用性更强：
  方案2的area(double r)是纯计算逻辑，只要传入半径就能返回结果——不管半径来自控制台输入、数据库读取还是其他业务场景，都能直接调用这个方法。而方案1的area()绑定了控制台输入和打印逻辑，只能在需要交互的场景下使用，无法复用在其他计算场景中。

• 便于测试：
  验证面积计算的正确性时，方案2只需直接调用area方法传入已知值（比如area(2)），就能快速验证结果。而方案1必须启动程序、手动输入值才能测试，无法通过单元测试自动化验证计算逻辑，效率极低。

• 代码可读性更高：
  方案2的方法命名和职责对应清晰，看到area(double r)就知道它是用来计算面积并返回结果的；而方案1的area()方法名无法体现它还包含输入和输出逻辑，其他开发者阅读代码时需要额外时间理解功能。

另外补充一个小优化：计算圆面积时，建议使用Math.PI代替硬编码的3.14，精度更高且符合Java标准用法。

内容的提问来源于Stack Exchange，提问作者Klord