Reputation: 2931
I was being taught that Marker interface in Java is an empty interface and is used to signal to compiler or JVM that the objects of the class implementing this interface must be treated in a special way, like serializing, cloning, etc.
But lately I have learned that it actually has nothing to do with the compiler or the JVM. For example, in case of Serializable
interface the method writeObject(Object)
of ObjectOutputStream
does something like instanceOf Serializable
to detect whether the class implements Serializable
& throws NotSerializableException
accordingly.
Everything is handled in the code and this seems to be a design-pattern so I think we can define our own marker interfaces.
Now my doubts:
Is the definition of a marker interface mentioned above in 1st point wrong? How can we define a Marker interface then?
And instead of using the instanceOf
operator why can't the method be something like writeObject(Serializable)
so that there is a compile-time type checking rather than runtime?
How are Annotations better than Marker Interfaces?
Upvotes: 145
Views: 101370
Reputation: 1032
I have made a simple demonstration to resolve doubt no 1 and 2 :
We will be having Movable interface which will be implemented by MobilePhone.java
Class and one more class LandlinePhone.java
which do NOT implement Movable interface
Our marker Interface:
package com;
public interface Movable {
}
LandLinePhone.java
and MobilePhone.java
package com;
class LandLinePhone {
// more code here
}
class MobilePhone implements Movable {
// more code here
}
Our Custom Exception Class : package com;
public class NotMovableException extends Exception {
private static final long serialVersionUID = 1L;
@Override
public String getMessage() {
return "this object is not movable";
}
// more code here
}
Our Test class : TestMArkerInterface.java
package com;
public class TestMarkerInterface {
public static void main(String[] args) throws NotMovableException {
MobilePhone mobilePhone = new MobilePhone();
LandLinePhone landLinePhone = new LandLinePhone();
TestMarkerInterface.goTravel(mobilePhone);
TestMarkerInterface.goTravel(landLinePhone);
}
public static void goTravel(Object o) throws NotMovableException {
if (!(o instanceof Movable)) {
System.out.println("you cannot use :" + o.getClass().getName() + " while travelling");
throw new NotMovableException();
}
System.out.println("you can use :" + o.getClass().getName() + " while travelling");
}}
Now when we execute main class :
you can use :com.MobilePhone while travelling
you cannot use :com.LandLinePhone while travelling
Exception in thread "main" com.NotMovableException: this object is not movable
at com.TestMarkerInterface.goTravel(TestMarkerInterface.java:22)
at com.TestMarkerInterface.main(TestMarkerInterface.java:14)
So which ever class implements marker interface Movable
will pass the test else error message will be displayed.
This is the way instanceOf
operator check is done for Serializable, Cloneable etc
Upvotes: 7
Reputation: 21778
It is not possible to enforce Serializable
on writeObject
because children of non-serializable class can be serializable, but their instances may be upcasted back to the parent class. As a result, holding a reference to something non-serializable (like Object
) does not mean that the referred instance cannot be really serialized. For instance in
Object x = "abc";
if (x instanceof Serializable) {
}
the parent class (Object
) is not serializable and would be initialised using its parameter-less constructor. The value referenced by x
, String
, is serializable and the conditional statement would run.
Upvotes: 25
Reputation: 1
If an interface does not contain any method and by implementing that interface if our object will get some ability such type of interfaces are called marker interfaces.
Upvotes: 0
Reputation: 109
A marker interface in Java is an interface with no fields or methods. Put more simply, an empty interface in Java is called a marker interface. Examples of marker interfaces are the
Serializable
,Cloneable
andRemote
interfaces. These are used to indicate some information to compilers or JVMs. So if the JVM sees that a class isSerializable
, it can do some special operation on it. Similarly, if the JVM sees some class is implementingCloneable
, it can perform some operations to support cloning. The same is true for RMI and theRemote
interface. So in short, a marker interface indicates a signal or a command to the compiler or JVM.
The above started out as a copy of a blog post but has been lightly edited for grammar.
Upvotes: 6
Reputation: 681
The main purpose of marker interfaces is to create special types where types themselves have no behavior of their own.
public interface MarkerEntity {
}
public boolean save(Object object) throws InvalidEntityFoundException {
if(!(object instanceof MarkerEntity)) {
throw new InvalidEntityFoundException("Invalid Entity Found, can't be saved);
}
return db.save(object);
}
Here save method makes sure that only the objects of classes that implement the MarkerEntity interface are saved, for other types InvalidEntityFoundException is thrown. So here MarkerEntity marker interface is defining a type that adds special behavior to the classes implementing it.
Though annotations can also used now to mark classes for some special treatments but marker annotations are replacement for naming pattern not for Marker interfaces.
But marker annotations can't fully replace the marker interfaces because; marker interfaces are used to define type (as already explained above) where as marker annotations do not.
Source for marker interface comment
Upvotes: 3
Reputation: 39477
It has nothing to do (necessarily) with the JVM and the compilers, it has something to do with any code which is interested in and is testing for a given marker interface.
It's a design decision and it's done for a good reason. See the answer from Audrius Meškauskas.
With respect to this particular topic, I don't think it's a matter of being better or worse. The marker interface is doing what it's supposed to do just fine.
Upvotes: 4
Reputation: 59
I would argue first-off that Serializable and Cloneable are bad examples of marker interfaces. Sure, they're interfaces with methods, but they imply methods, such as writeObject(ObjectOutputStream)
. (The compiler will create a writeObject(ObjectOutputStream)
method for you if you don't override it, and all objects already have clone()
, but the compiler will again create a real clone()
method for you but with caveats. Both of these are weird edge cases that really aren't good design examples.)
Marker interfaces are generally used for one of two purposes:
1) As a shortcut to avoid an excessively long type, which can happen with lots of generics. For instance, say you have this method signature:
public void doSomething(Foobar<String, Map<String, SomethingElse<Integer, Long>>>) { ... }
That's messy and annoying to type, and more importantly, difficult to understand. Consider this instead:
public interface Widget extends Foobar<String, Map<String, SomethingElse<Integer, Long>>> { }
Then your method looks like this:
public void doSomething(Widget widget) { ... }
Not only is it clearer, but you can now Javadoc the Widget interface, and it's also easier to search for all occurrences in your code of Widget.
2) Marker interfaces can also be used as a way around Java's lack of intersection types. With a marker interface, you can require something to be of two different types, such as in a method signature. Say you have some interface Widget in your application, like we described above. If you have a method that requires a Widget that also happens to let you iterate over it (it's contrived, but work with me here), your only good solution is to create a marker interface that extends both interfaces:
public interface IterableWidget extends Iterable<String>, Widget { }
And in your code:
public void doSomething(IterableWidget widget) {
for (String s : widget) { ... }
}
Upvotes: 1
Reputation: 149185
a/ A marker interface as its name suggest exists only to notify anything that knows about it that a class declares something. The anything can be the JDK classes for the Serializable
interface, or any class you write yoursel for a custom one.
b/ If it is a marker interface, it should not imply the existence of any method - it would be better to include the implied method in the interface. But you can decide to design it as you want if you know why you need it
c/ There is little difference between an empty interface and an annotation that uses no value or parameter. But the difference is there : an annotation can declare a list of keys/values that will be accessible at run time.
Upvotes: 5
Reputation: 2600
a. I have always seen them as a design pattern and nothing JVM-Special I have used that pattern in several situations.
c. I beleive that using Annotations to mark something is a better solution then using marker interfaces. Simply because Interfaces are in the first place aimed to define common interfaces of Types / Classes. They are part of the class-hierachy.
Annotations are aimed to provide Meta-Informations to Code, and I think that marker are meta-informations. So they are exactly for that use-case.
Upvotes: 3
Reputation: 727137
writeObject(Serializable)
so that there is a compile-time type checking - This lets you avoid polluting your code with the name of the marker interface when a "plain Object
" is needed. For example, if you make a class that needs to be serializable, and has object members, you would be forced to either do casting or make your objects Serializable
at compile time. This is inconvenient, because the interface is devoid of any functionality.Upvotes: 124