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){
   ...
}