HarmonyOS NEXT实战：函数方法的重载

##HarmonyOS Next实战##HarmonyOS SDK应用服务##教育##

核心概念 函数方法重载（Method Overloading）是指在同一个类中，允许存在多个同名方法，但这些方法的参数列表必须不同（参数类型、数量或顺序的差异）。重载是编译时多态（静态多态）的一种实现方式，编译器根据调用时提供的参数自动选择匹配的方法。

重载规则 · 方法名相同：所有重载方法必须同名。 · 参数列表不同：参数的类型、数量或顺序至少有一项不同。 · 返回值类型无关：仅返回值类型不同不足以构成重载（例如，int func() 和 double func() 不是重载）。 · 访问修饰符无关：方法的访问权限（如 public/private）不影响重载。

重载的底层原理 · 编译时解析：编译器根据方法调用时的参数类型和数量，从所有同名方法中选择最匹配的一个。 · 参数类型提升：如果参数类型可以隐式转换（如 int 转为 double），编译器会尝试匹配更通用的方法。 · 歧义性错误：如果编译器无法明确选择方法（例如，两个方法都可能匹配），会报编译错误。

重载的实际应用场景 · 简化API设计：提供多个同名方法，让用户根据输入参数的类型和数量灵活调用。 · 增强代码可读性：例如，print(String) 和 print(int) 比 printString 和 printInt 更直观。 · 支持默认参数（部分语言）：如C++中通过重载模拟默认参数效果。

注意事项 · 避免过度重载：过多的重载方法可能导致代码难以维护。 · 参数类型歧义：例如，add(int, long) 和 add(long, int) 可能导致调用时混淆。 · 可变参数（Varargs）：Java中的可变参数（如 void func(String... args)）可以与其他重载方法共存，但需谨慎设计以避免歧义。

总结 方法重载是一种强大的语言特性，它通过编译时多态提高了代码的灵活性和可读性。合理使用重载可以简化API设计，但需注意避免过度复杂化。理解重载与重写的区别，以及不同语言对重载的支持方式，是掌握面向对象编程的关键之一。

实战场景：登录有两种方式。1. 通过手机号登录。2. 通过鉴权串登录。 代码实战：

@Entry
@Component
struct FunctionOverloading {
  build() {
    Column({space:10}) {
      Text('FunctionOverloading')
      Button('login by phone').onClick(()=>{
        login('12312341234','pwd123')
      })
      Button('login by authcode').onClick(()=>{
        login('authcode123')
      })
    }
    .height('100%')
    .width('100%')
  }
}

/**
 * 手机验证码登录
 * @param phone
 * @param code
 */
function login(phone: string, code: string);

/**
 * 通过authcode登录
 * @param authcode
 */
function login(authcode: string);

function login(param1: string, param2?: string) {
  if (param2 !== undefined) {
    console.info('login','通过手机验证码登录', `phone=${param1}, code=${param2}`)
  } else {
    console.info('login', '通过token登录', `authcode=${param1}`)
  }
}

点击“login by phone”按钮，输出日志：

05-13 10:30:35.857   7201-7201     A03D00/com.thi....hosapp/JSAPP  com.third...g.hosapp  I     login 通过手机验证码登录 phone=12312341234, code=pwd123

点击“login by authcode”按钮，输出日志：

05-13 10:30:36.524   7201-7201     A03D00/com.thi....hosapp/JSAPP  com.third...g.hosapp  I     login 通过token登录 authcode=authcode123