org.eclipse.core.runtime

Class PlatformObject

java.lang.Object

org.eclipse.core.runtime.PlatformObject

All Implemented Interfaces:

IAdaptable

public abstract class PlatformObject
extends java.lang.Object
implements IAdaptable

An abstract superclass implementing the IAdaptable interface. getAdapter invocations are directed to the platform's adapter manager.

Note: In situations where it would be awkward to subclass this class, the same effect can be achieved simply by implementing the IAdaptable interface and explicitly forwarding the getAdapter request to an implementation of the IAdapterManager service. The method would look like:

     public <T> T getAdapter(Class<T> adapter) {
         IAdapterManager manager = ...;//lookup the IAdapterManager service         
         return manager.getAdapter(this, adapter);
     }
 

This class can be used without OSGi running.

Clients may subclass.

See Also:

IAdapterManager, IAdaptable

Constructor Summary

Constructors

Constructor and Description
PlatformObject() Constructs a new platform object.

Method Summary

Modifier and Type	Method and Description
<T> T	getAdapter(java.lang.Class<T> adapter) Returns an object which is an instance of the given class associated with this object.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

PlatformObject

public PlatformObject()

Constructs a new platform object.

Method Detail

getAdapter

public <T> T getAdapter(java.lang.Class<T> adapter)

Returns an object which is an instance of the given class associated with this object. Returns null if no such object can be found.

This implementation of the method declared by IAdaptable passes the request along to the platform's adapter manager; roughly Platform.getAdapterManager().getAdapter(this, adapter). Subclasses may override this method (however, if they do so, they should invoke the method on their superclass to ensure that the Platform's adapter manager is consulted).

Specified by:

getAdapter in interface IAdaptable

Parameters:

adapter - the class to adapt to

Returns:

the adapted object or null

See Also:

IAdaptable.getAdapter(Class)