Why doesn't Java 5+ API take advantage of covariant return types?

Question

Since Java 5 we are allowed to have covariant return types. Why doesn\'t the Java API take advantage of this?

Take Graphics2D.create() for instance. Why

Answer 1

That would break binary compatibility. Previously compiled classes cannot find the method with the new return type. JLS3 §13.4.15, §13.4.12

Answer 2

In general, this is indeed in order to maintain backward compatibility. Note that the compatibility must be kept on the bytecode level too, and changing the return type changes the bytecode. So in general, if there are any subclasses which may have overridden the method in question, switching to a covariant return type would break those classes.

Since Graphics2D is abstract, it is obviously meant to be subclassed, so the above reasoning applies.

Java Generics and Collections, although focuses more on the generics point of view, contains a discussion on covariant overriding in section 8.4.