Java Doc for IAdaptable.java in  » Apache-Harmony-Java-SE » org-package » org » apache » harmony » luni » platform » Java Source Code / Java DocumentationJava Source Code and Java Documentation

Classes can implement this interface (a single method) to provide interfaces that are not API -- each interface type has to be handled in the implementation of getAdapter(Class). This is a good way to extend the class without breaking existing API.

In addition, classes can be augmented by interfaces that are defined by other classes (which requires the getAdapter(Class) to be implemented by a factory.

The adapter is typically obtained using the class literal, like this:

 ...
 IAdaptable = (IAdaptable) foo;
 IMyInterface bar = (IMyInterface)foo.getAdapter(IMyInterface.class);
 bar.doMyThing();
 ...