Marker interface pattern: Difference between revisions

Content deleted Content added
m Updated external links into API docs to use the 1.5 Javadocs
Changed to use new Template:Javadoc:SE I just created
Line 3:
This pattern allows a class to implement a '''marker interface''', which exposes some underlying semantic property of the class that cannot be determined solely by the class' methods. Whereas a typical interface specifies functionality (in the form of method declarations) that an implementing class must support, a marker interface need not do so. The mere presence of such an interface indicates specific behavior on the part of the implementing class. Hybrid interfaces, which both act as markers and specify required methods, are possible but may prove confusing if improperly used.
 
One good example of a marker interface comes from the [[Java programming language]]. The ''[http{{Javadoc://java.sun.com/j2se/1.5.0/docs/api/SE|java/lang/|Cloneable.html Cloneable]''}} interface should be implemented by a class if it fully supports the [http{{Javadoc://java.sun.com/j2se/1.5.0/docs/api/SE|java/lang/|Object.html#|clone() Object.clone()]}} method. Every class in Java has the [http{{Javadoc://java.sun.com/j2se/1.5.0/docs/api/SE|java/lang/Object.html |Object]}} class at the root of its inheritance hierarchy and so every object instantiated from any class ''has'' an associated <code>clone()</code> method. However, developers should only call <code>clone()</code> on objects of classes which implement the ''<code>Clonable''</code> interface, as it indicates that the cloning functionality is actually supported in a proper manner.
 
Unfortunately there is a problem with this Java example, namely that in Java you cannot "unimplement" an interface. So if you subclass a class that implements <code>Clonable</code>, and then do something in your subclass that means it can't be cloned properly, your subclass will still be marked as a <code>Clonable</code> whether you want it or not. One way out is to throw an Exception (a [http{{Javadoc://java.sun.com/j2se/1.5.0/docs/api/SE|java/lang/|CloneNotSupportedException.html CloneNotSupportedException]}} is a good idea) in the <code>clone()</code> method, but then you are missing the whole point of the marker interface.
 
Still, this is generally a good idea, as subclasses usually ''do'' inherit behaviors from their parents and should inherit the marker interfaces as well.
Line 11:
==Critique==
This pattern is rather specific to Java. Other object models support richer ways of quickly querying static data. For example, .NET supports attributes that can be used to associate any type of data with a class or with its members.
 
[[Category:Software design patterns]]