A marker interface is an interface that contains no method declarations but merely designates (or “marks”) a class that implements the interface as having some property. For example, consider the Serializable interface (Chapter 12). By implementing this interface, a class indicates that its instances can be written to an ObjectOutputStream (or “serialized”).

標(biāo)記接口是一種不包含任何方法聲明的接口，它只是指定（或「標(biāo)記」）一個(gè)類号枕，該類實(shí)現(xiàn)了具有某些屬性的接口醋粟。例如，考慮 Serializable 接口（Chapter 12）。通過實(shí)現(xiàn)此接口胰挑，表示類的實(shí)例可以寫入 ObjectOutputStream（或「序列化」）渣慕。

You may hear it said that marker annotations (Item 39) make marker interfaces obsolete. This assertion is incorrect. Marker interfaces have two advantages over marker annotations. First and foremost, marker interfaces define a type that is implemented by instances of the marked class; marker annotations do not. The existence of a marker interface type allows you to catch errors at compile time that you couldn’t catch until runtime if you used a marker annotation.

你可能聽過一個(gè)說法：標(biāo)記接口已經(jīng)過時(shí)众羡，更好的方式是標(biāo)記注解（Item-39）。這個(gè)言論是錯(cuò)誤的嗦嗡。與標(biāo)記注解相比，標(biāo)記接口有兩個(gè)優(yōu)點(diǎn)饭玲。首先侥祭，標(biāo)記接口定義的類型由標(biāo)記類的實(shí)例實(shí)現(xiàn)；標(biāo)記注解不會(huì)茄厘。 標(biāo)記接口類型的存在允許你在編譯時(shí)捕獲錯(cuò)誤矮冬，如果你使用標(biāo)記注解亡脑，則在運(yùn)行時(shí)才能捕獲這些錯(cuò)誤炼彪。

Java’s serialization facility (Chapter 6) uses the Serializable marker interface to indicate that a type is serializable. The ObjectOutputStream.writeObject method, which serializes the object that is passed to it, requires that its argument be serializable. Had the argument of this method been of type Serializable, an attempt to serialize an inappropriate object would have been detected at compile time (by type checking). Compile-time error detection is the intent of marker interfaces, but unfortunately, the ObjectOutputStream.write API does not take advantage of the Serializable interface: its argument is declared to be of type Object, so attempts to serialize an unserializable object won’t fail until runtime.

Java 的序列化工具（Chapter 6）使用 Serializable 標(biāo)記接口來表明一個(gè)類是可序列化的。ObjectOutputStream.writeObject 方法序列化傳遞給它的對(duì)象诱担，它要求其參數(shù)是可序列化的窑滞。假設(shè)該方法的參數(shù)類型是 Serializable琼牧，那么在編譯時(shí)（通過類型檢查）就會(huì)檢測(cè)到對(duì)不合適的對(duì)象進(jìn)行序列化的錯(cuò)誤。編譯時(shí)錯(cuò)誤檢測(cè)是使用標(biāo)記接口的目的哀卫，但不幸的是巨坊，ObjectOutputStream.writeObject 沒有利用 Serializable 接口：它的參數(shù)被聲明為 Object 類型，因此此改，如果嘗試序列化一個(gè)不可序列化對(duì)象趾撵，直到運(yùn)行時(shí)才會(huì)提示失敗。

譯注 1：原文 ObjectOutputStream.write 有誤共啃，該方法的每種重載僅支持 int 類型和 byte[]占调，應(yīng)修改為 ObjectOutputStream.writeObject，其源碼如下：

public final void writeObject(Object obj) throws IOException {
    if (enableOverride) {
        writeObjectOverride(obj);
        return;
    }
    try {
        writeObject0(obj, false);
    } catch (IOException ex) {
        if (depth == 0) {
            writeFatalException(ex);
        }
        throw ex;
    }
}

譯注 2：使用 ObjectOutputStream.writeObject 的例子

public class BaseClass implements Serializable {
    private final int id;
    private final String name;

    public BaseClass(int id, String name) {
        this.id = id;
        this.name = name;
    }

    @Override
    public String toString() {
        return "id=" + id + ", name='" + name + '\'';
    }
}

public class Main {
    private void Out() throws IOException {
        BaseClass obj = new BaseClass(1, "Mark");
        try (ObjectOutputStream out = new ObjectOutputStream(new FileOutputStream(new File("out.txt")))) {
            out.writeObject(obj);
        }
    }

    private void In() throws IOException, ClassNotFoundException {
        try (ObjectInputStream in = new ObjectInputStream(new FileInputStream(new File("out.txt")))) {
            BaseClass obj = (BaseClass) in.readObject();
            System.out.println(obj);
        }
    }
}

Another advantage of marker interfaces over marker annotations is that they can be targeted more precisely. If an annotation type is declared with target ElementType.TYPE, it can be applied to any class or interface. Suppose you have a marker that is applicable only to implementations of a particular interface. If you define it as a marker interface, you can have it extend the sole interface to which it is applicable, guaranteeing that all marked types are also subtypes of the sole interface to which it is applicable.

標(biāo)記接口相對(duì)于標(biāo)記注解的另一個(gè)優(yōu)點(diǎn)是可以更精確地定位它們移剪。 如果注解類型使用 @Target(ElementType.TYPE) 聲明究珊，它可以應(yīng)用于任何類或接口。假設(shè)你有一個(gè)只適用于特定接口來實(shí)現(xiàn)的標(biāo)記挂滓。如果將其定義為標(biāo)記接口苦银，則可以讓它擴(kuò)展其適用的惟一接口啸胧，確保所有標(biāo)記的類型也是其適用的惟一接口的子類型。

Arguably, the Set interface is just such a restricted marker interface. It is applicable only to Collection subtypes, but it adds no methods beyond those defined by Collection. It is not generally considered to be a marker interface because it refines the contracts of several Collection methods, including add, equals, and hashCode. But it is easy to imagine a marker interface that is applicable only to subtypes of some particular interface and does not refine the contracts of any of the interface’s methods. Such a marker interface might describe some invariant of the entire object or indicate that instances are eligible for processing by a method of some other class (in the way that the Serializable interface indicates that instances are eligible for processing by ObjectOutputStream).

可以說幔虏，Set 接口就是這樣一個(gè)受限的標(biāo)記接口纺念。它只適用于 Collection 的子類，但是除了 Collection 定義的方法之外想括，它不添加任何方法陷谱。它通常不被認(rèn)為是一個(gè)標(biāo)記接口，因?yàn)樗?xì)化了幾個(gè) Collection 方法的約定瑟蜈，包括 add烟逊、equals 和 hashCode。但是很容易想象一個(gè)標(biāo)記接口只適用于某些特定接口的子類铺根，而不細(xì)化任何接口方法的約定宪躯。這樣的標(biāo)記接口可能描述整個(gè)對(duì)象的某個(gè)不變量，或者表明實(shí)例能夠利用其他類的方法進(jìn)行處理（就像 Serializable 接口能夠利用 ObjectOutputStream 進(jìn)行處理一樣）位迂。

The chief advantage of marker annotations over marker interfaces is that they are part of the larger annotation facility. Therefore, marker annotations allow for consistency in annotation-based frameworks.

相對(duì)于標(biāo)記接口访雪，標(biāo)記注解的主要優(yōu)勢(shì)是它們可以是其他注解功能的一部分。 因此掂林，標(biāo)記注解能夠與基于使用注解的框架保持一致性臣缀。

So when should you use a marker annotation and when should you use a marker interface? Clearly you must use an annotation if the marker applies to any program element other than a class or interface, because only classes and interfaces can be made to implement or extend an interface. If the marker applies only to classes and interfaces, ask yourself the question “Might I want to write one or more methods that accept only objects that have this marking?” If so, you should use a marker interface in preference to an annotation. This will make it possible for you to use the interface as a parameter type for the methods in question, which will result in the benefit of compile-time type checking. If you can convince yourself that you’ll never want to write a method that accepts only objects with the marking, then you’re probably better off using a marker annotation. If, additionally, the marking is part of a framework that makes heavy use of annotations, then a marker annotation is the clear choice.

那么什么時(shí)候應(yīng)該使用標(biāo)記注解，什么時(shí)候應(yīng)該使用標(biāo)記接口呢泻帮？顯然精置，如果標(biāo)記應(yīng)用于類或接口之外的任何程序元素，則必須使用標(biāo)記注解锣杂，因?yàn)橹挥蓄惡徒涌诓拍軐?shí)現(xiàn)或擴(kuò)展接口脂倦。如果標(biāo)記只適用于類和接口，那么可以問自己這樣一個(gè)問題：「我是否可以編寫一個(gè)或多個(gè)方法元莫，只接受具有這種標(biāo)記的對(duì)象狼讨？」如果是這樣，你應(yīng)該使用標(biāo)記接口而不是標(biāo)記注解柒竞。這將使你能夠?qū)⒔涌谟米飨嚓P(guān)方法的參數(shù)類型政供，這將帶來編譯時(shí)類型檢查的好處。如果你確信自己永遠(yuǎn)不會(huì)編寫只接受帶有標(biāo)記的對(duì)象的方法朽基，那么最好使用標(biāo)記注解布隔。此外，如果框架大量使用注解稼虎，那么標(biāo)記注解就是明確的選擇衅檀。

In summary, marker interfaces and marker annotations both have their uses. If you want to define a type that does not have any new methods associated with it, a marker interface is the way to go. If you want to mark program elements other than classes and interfaces or to fit the marker into a framework that already makes heavy use of annotation types, then a marker annotation is the correct choice. If you find yourself writing a marker annotation type whose target is ElementType.TYPE, take the time to figure out whether it really should be an annotation type or whether a marker interface would be more appropriate.

總之，標(biāo)記接口和標(biāo)記注解都有各自的用途霎俩。如果你想要定義一個(gè)沒有與之關(guān)聯(lián)的新方法的類型哀军，可以使用標(biāo)記接口沉眶。如果你希望標(biāo)記類和接口之外的程序元素，或者將標(biāo)記符放入已經(jīng)大量使用注解類型的框架中杉适，那么標(biāo)記注解就是正確的選擇谎倔。如果你發(fā)現(xiàn)自己編寫的標(biāo)記注解類型有 @Target(ElementType.TYPE) 聲明（譯注：意在說明既可以用標(biāo)記注解，也可以用標(biāo)記接口的情況）猿推，那么請(qǐng)花時(shí)間弄清楚究竟應(yīng)該用注解類型片习，還是標(biāo)記接口更合適。

In a sense, this item is the inverse of Item 22, which says, “If you don’t want to define a type, don’t use an interface.” To a first approximation, this item says, “If you do want to define a type, do use an interface.”

從某種意義上說蹬叭，本條目與 Item-22 的說法相反藕咏，也就是說，「如果不想定義類型秽五，就不要使用接口孽查。」坦喘，與本條目應(yīng)用場(chǎng)景適應(yīng)的說法是卦碾，「如果你確實(shí)想定義類型，那么就要使用接口起宽。」

Back to contents of the chapter（返回章節(jié)目錄）

• Previous Item（上一條目）：Item 40: Consistently use the Override annotation（堅(jiān)持使用 @Override 注解）
• Next Item（下一條目）：Chapter 7 Introduction（章節(jié)介紹）