如何替代@Deprecated提示开发者使用更优方法？（Eclipse环境）

针对你的场景（仅在特殊场景使用RareSpecialTool，需提示开发者用method2()而非method1()，但不想用易被误解为“将被移除”的@Deprecated），可以通过以下两种方式实现：

一、Eclipse原生支持的注解方案 #

Eclipse的JDT提供了@org.eclipse.jdt.annotation.Prefer注解（需引入Eclipse JDT注解库），这个注解的作用就是标记某个方法是推荐的替代选项，不会被误解为“即将删除”。

使用方式：

1. 引入Eclipse JDT注解依赖（Maven项目可添加对应依赖，或直接复制注解类到项目中）
2. 在method1()上添加该注解并指定推荐方法：

import org.eclipse.jdt.annotation.Prefer;

class RareSpecialTool extends Tool {
    /**
     * 推荐使用{@link #method2()}
     */
    @Prefer("method2")
    @Override 
    String method1() {
        return super.method1();
    }

    String[] method2() {
        return new String[] { "even", "better" };
    }
}

当开发者调用method1()时，Eclipse会在编辑器中显示提示，告知该方法有推荐的替代实现，不会出现@Deprecated的删除线，避免误解为方法会被移除。

另外也可以继续使用@Deprecated，但必须在javadoc中明确强调“此方法并非将被移除，仅推荐使用method2()”，同时调整Eclipse的警告级别：将Deprecated的警告从“错误”改为“警告”。不过这种方式仍易引发误解，不如@Prefer直观。

二、自定义注解实现专属提示 #

如果不想依赖Eclipse的JDT注解，可以自定义注解并配合Eclipse的问题检测器配置来触发提示：

步骤1：创建自定义注解 #

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface PreferAlternative {
    String value(); // 指定替代方法的名称
}

步骤2：在Eclipse中配置问题提示 #

1. 打开Window > Preferences > Java > Compiler > Errors/Warnings
2. 展开Annotations选项，选择Custom warning annotations
3. 添加自定义的@PreferAlternative注解，设置警告级别为“Warning”，并自定义提示信息，比如："请使用{0}替代此方法"（{0}会自动填充注解的value值）

步骤3：在代码中使用自定义注解 #

class RareSpecialTool extends Tool {
    /**
     * 推荐使用{@link #method2()}
     */
    @PreferAlternative("method2")
    @Override 
    String method1() {
        return super.method1();
    }

    String[] method2() {
        return new String[] { "even", "better" };
    }
}

之后开发者调用method1()时，Eclipse会弹出你自定义的警告提示，引导使用method2()。

内容的提问来源于stack exchange，提问作者JayC667