Javadoc @link 不同的返回类型

Question

@link 的 Javadoc 在the two answers here 及其给定的链接中得到了很好的解释。
不过我有一个问题：如何区分其他类似方法的不同返回类型？

假设我有以下两种方法：

public String doSomething(){
   ...
}

public int doSomething(){
   ...
}

在另一种方法中，我想将 @link 改为 int doSomething()。如果只有一个 doSomething() 方法，则链接将类似于：

/*
 * ...
 * {@link com.example.package.MyClass#doSomething()}
 */
public void anotherMethod(){
   ...
}

如何区分@link 中的不同返回类型？

Answer 1

你不能有这样的方法，因为 Java 方法签名包括方法名称和参数类型，而不是结果的类型。

假设您有不同的情况：一个方法名称，但不同的参数。在这种情况下，方法链接应该包含参数类型。

/**
* This is {@link #doSomething(String)}
*/
public void doSomething(String string){
   ...
}

/**
* And this is {@link #doSomething(int)}
*/    
public void doSomething(int integer){
   ...
}