java 函数通用原则包括：单一职责，避免重复，仔细选择参数和返回值，处理异常，测试所有函数，可提高代码的可读性、可维护性和可测试性。
Java 函数通用原则解析
在 Java 中，函数（也称为方法）是代码的可重用单元，用于执行特定任务。遵循通用原则对于编写健壮且易于维护的函数至关重要。
原则 1：单一职责
每个函数应只执行一项特定职责。避免在单个函数中执行多个 unrelated 操作。这有助于提高可读性、可测试性和可维护性。
代码示例：
// 违反单一职责原则
private void doEverything(int num) {
System.out.println(num);
System.out.println(num * num);
return num + num;
}
// 遵循单一职责原则
private void printNumber(int num) {
System.out.println(num);
}
private int squareNumber(int num) {
return num * num;
}
private int addNumbers(int num) {
return num + num;
}
原则 2：不要重复
避免在不同的函数中编写重复的代码。如果需要执行相同或类似的操作，请创建一个可重用的通用函数。
代码示例：
// 代码重复
private int foo(int a, int b) {
if (a > b) {
return a;
} else {
return b;
}
}
private int bar(int a, int b) {
if (a > b) {
return a;
} else {
return b;
}
}
// 使用通用函数
private int max(int a, int b) {
if (a > b) {
return a;
} else {
return b;
}
}
原则 3：参数和返回值
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
精心选择函数的参数和返回值类型。避免使用原始值类型作为参数，而应使用对象。这有助于防止意外更改值，并提高可读性和可维护性。
代码示例：
// 传递原始值类型作为参数
public void setAge(int age) {
this.age = age;
}
// 传递对象作为参数
public void setPerson(Person person) {
this.person = person;
}
原则 4：异常处理
函数应明确处理可能发生的异常。不要从函数中传播异常，而应尝试处理它或传递给调用者。
代码示例：
public int divide(int a, int b) throws ArithmeticException {
if (b == 0) {
throw new ArithmeticException("Division by zero.");
}
return a / b;
}
原则 5： 测试
所有函数都应包含适当的测试以验证其正确性。使用单元测试框架（如 JUnit）来编写测试，以确保函数在各种输入下按预期工作。
实战案例：
// 一个计算两个数最大值的函数
public int findMax(int a, int b) {
if (a > b) {
return a;
} else {
return b;
}
}
// 测试案例
@Test
public void testFindMax() {
assertEquals(10, findMax(10, 5));
assertEquals(100, findMax(100, 50));
assertEquals(-10, findMax(-10, -20));
}
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
