Java 注释 - 对象数组或 toString 值

Question

我需要编写一个注释来从结果集中排除某些值。

背景：

不同的值从字段中 select 编辑并列在组合框中。一些遗留值已弃用，我不想显示它们，即使它们由 JDBC 的 SELECT DISTINCT() 返回。它就像一个迷你框架，人们可以在其中通过单击 ComboBoxes 中的值来构建 select 查询。

我尝试了以下方法（代码无法编译 - 注释行是我尝试解决问题的方法）：

public enum JobType {
    //...
    S,
    //...
}

public @interface Exclude {
    Object[] values(); // Invalid type
    Enum[] values(); // Invalid type again
    String[] values(); // Accepts but see the following lines
}

@Table(name = "jobs_view")
public class JobSelectionView extends View {
    //...
    @Exclude(values = {JobType.S.toString()}) // Not a constant expression
    @Exclude(values = {JobType.S.name()}) // Not a constant expression ?!?!?!
    @Exclude(values = {"S"}) // Works but... come on!
    @Enumerated(value = EnumType.STRING)
    @Column(name = "type")
    private JobType type;
    //...
}

我不喜欢使用 {"S"}，有什么建议吗？

Answer 1

But if declare JobType[] values() then I won't be able to reuse the @Exclude for other types of Enum.

不过，这是实现您想要的效果的最佳方式。事情是这样的：

class `Enum` 本身是没有意义的。

它只有在 subclassed 时才有意义。假设您想添加另一个过滤器，比如 Color（您自己的自定义 Color 枚举，而不是 java.awt.Color）。显然，过滤 class 所做的事情对于过滤掉 JobType 和过滤掉 Color!

是非常不同的

因此，最好的办法是让 enum 的每个不同时间都在尝试过滤它自己的参数，例如

public @interface Exclude {
    JobType[] jobs;
    Color[] colors;
    Foo[] foos;
    Quux[] quuxes;
}

这将完成两件事：

使您可以轻松地为每种不同的过滤器类型执行不同的过滤行为。
通过将不同的参数分类到不同的组中，使 @Excludes 注释更易读。

Enum.name() 的 Javadoc 说：

Returns the name of this enum constant, exactly as declared in its enum declaration. Most programmers should use the toString() method in preference to this one, as the toString method may return a more user-friendly name. This method is designed primarily for use in specialized situations where correctness depends on getting the exact name, which will not vary from release to release.

我建议你试着让你公司的人仔细阅读 Open/Closed principle 并解释为什么在这种情况下违反它会特别有害。

Java 注释 - 对象数组或 toString 值

Java Annotation - array of Objects or toString values

java

annotations

coding-style

class `Enum` 本身是没有意义的。

Java 注释 - 对象数组或 toString 值

Java Annotation - array of Objects or toString values

java

annotations

coding-style

class Enum 本身是没有意义的。

class `Enum` 本身是没有意义的。