X-Git-Url: http://secure.phpeclipse.com
diff --git a/net.sourceforge.phpeclipse/src/net/sourceforge/phpdt/core/ITypeHierarchy.java b/net.sourceforge.phpeclipse/src/net/sourceforge/phpdt/core/ITypeHierarchy.java
index 339fba1..60fcc76 100644
--- a/net.sourceforge.phpeclipse/src/net/sourceforge/phpdt/core/ITypeHierarchy.java
+++ b/net.sourceforge.phpeclipse/src/net/sourceforge/phpdt/core/ITypeHierarchy.java
@@ -18,286 +18,332 @@ import org.eclipse.core.runtime.IProgressMonitor;
* A type hierarchy provides navigations between a type and its resolved
* supertypes and subtypes for a specific type or for all types within a region.
* Supertypes may extend outside of the type hierarchy's region in which it was
- * created such that the root of the hierarchy is always included. For example, if a type
- * hierarchy is created for a java.io.File
, and the region the hierarchy was
- * created in is the package fragment java.io
, the supertype
- * java.lang.Object
will still be included.
+ * created such that the root of the hierarchy is always included. For example,
+ * if a type hierarchy is created for a java.io.File
, and the
+ * region the hierarchy was created in is the package fragment
+ * java.io
, the supertype java.lang.Object
will
+ * still be included.
*
- * A type hierarchy is static and can become stale. Although consistent when
- * created, it does not automatically track changes in the model.
- * As changes in the model potentially invalidate the hierarchy, change notifications
- * are sent to registered ITypeHierarchyChangedListener
s. Listeners should
- * use the exists
method to determine if the hierarchy has become completely
- * invalid (for example, when the type or project the hierarchy was created on
- * has been removed). To refresh a hierarchy, use the refresh
method.
+ * A type hierarchy is static and can become stale. Although consistent when
+ * created, it does not automatically track changes in the model. As changes in
+ * the model potentially invalidate the hierarchy, change notifications are sent
+ * to registered ITypeHierarchyChangedListener
s. Listeners
+ * should use the exists
method to determine if the hierarchy has
+ * become completely invalid (for example, when the type or project the
+ * hierarchy was created on has been removed). To refresh a hierarchy, use the
+ * refresh
method.
*
- * The type hierarchy may contain cycles due to malformed supertype declarations.
- * Most type hierarchy queries are oblivious to cycles; the getAll*
- * methods are implemented such that they are unaffected by cycles.
+ * The type hierarchy may contain cycles due to malformed supertype
+ * declarations. Most type hierarchy queries are oblivious to cycles; the
+ * getAll*
methods are implemented such that they are unaffected
+ * by cycles.
*
* This interface is not intended to be implemented by clients. *
*/ public interface ITypeHierarchy { -/** - * Adds the given listener for changes to this type hierarchy. Listeners are - * notified when this type hierarchy changes and needs to be refreshed. - * Has no effect if an identical listener is already registered. - * - * @param listener the listener - */ -void addTypeHierarchyChangedListener(ITypeHierarchyChangedListener listener); -/** - * Returns whether the given type is part of this hierarchy. - * - * @param type the given type - * @return true if the given type is part of this hierarchy, false otherwise - */ -boolean contains(IType type); -/** - * Returns whether the type and project this hierarchy was created on exist. - * @return true if the type and project this hierarchy was created on exist, false otherwise - */ -boolean exists(); -/** - * Returns all classes in this type hierarchy's graph, in no particular - * order. Any classes in the creation region which were not resolved to - * have any subtypes or supertypes are not included in the result. - * - * @return all classes in this type hierarchy's graph - */ -IType[] getAllClasses(); -/** - * Returns all interfaces in this type hierarchy's graph, in no particular - * order. Any interfaces in the creation region which were not resolved to - * have any subtypes or supertypes are not included in the result. - * - * @return all interfaces in this type hierarchy's graph - */ -IType[] getAllInterfaces(); -/** - * Returns all resolved subtypes (direct and indirect) of the - * given type, in no particular order, limited to the - * types in this type hierarchy's graph. An empty array - * is returned if there are no resolved subtypes for the - * given type. - * - * @param type the given type - * @return all resolved subtypes (direct and indirect) of the given type - */ -IType[] getAllSubtypes(IType type); -/** - * Returns all resolved superclasses of the - * given class, in bottom-up order. An empty array - * is returned if there are no resolved superclasses for the - * given class. - * - *NOTE: once a type hierarchy has been created, it is more efficient to - * query the hierarchy for superclasses than to query a class recursively up - * the superclass chain. Querying an element performs a dynamic resolution, - * whereas the hierarchy returns a pre-computed result. - * - * @param type the given type - * @return all resolved superclasses of the given class, in bottom-up order, an empty - * array if none. - */ -IType[] getAllSuperclasses(IType type); -/** - * Returns all resolved superinterfaces (direct and indirect) of the given type. - * If the given type is a class, this includes all superinterfaces of all superclasses. - * An empty array is returned if there are no resolved superinterfaces for the - * given type. - * - *
NOTE: once a type hierarchy has been created, it is more efficient to - * query the hierarchy for superinterfaces than to query a type recursively. - * Querying an element performs a dynamic resolution, - * whereas the hierarchy returns a pre-computed result. - * - * @param type the given type - * @return all resolved superinterfaces (direct and indirect) of the given type, an empty array if none - */ -IType[] getAllSuperInterfaces(IType type); -/** - * Returns all resolved supertypes of the - * given type, in bottom-up order. An empty array - * is returned if there are no resolved supertypes for the - * given type. - *
- * Note that java.lang.Object
is NOT considered to be a supertype
- * of any interface type.
- *
NOTE: once a type hierarchy has been created, it is more efficient to
- * query the hierarchy for supertypes than to query a type recursively up
- * the supertype chain. Querying an element performs a dynamic resolution,
- * whereas the hierarchy returns a pre-computed result.
- *
- * @param type the given type
- * @return all resolved supertypes of the given class, in bottom-up order, an empty array
- * if none
- */
-IType[] getAllSupertypes(IType type);
-/**
- * Returns all types in this type hierarchy's graph, in no particular
- * order. Any types in the creation region which were not resolved to
- * have any subtypes or supertypes are not included in the result.
- *
- * @return all types in this type hierarchy's grap
- */
-IType[] getAllTypes();
+ /**
+ * Adds the given listener for changes to this type hierarchy. Listeners are
+ * notified when this type hierarchy changes and needs to be refreshed. Has
+ * no effect if an identical listener is already registered.
+ *
+ * @param listener
+ * the listener
+ */
+ void addTypeHierarchyChangedListener(ITypeHierarchyChangedListener listener);
-/**
- * Return the flags associated with the given type (would be equivalent to IMember.getFlags()
),
- * or -1
if this information wasn't cached on the hierarchy during its computation.
- *
- * @param type the given type
- * @return the modifier flags for this member
- * @see Flags
- * @since 2.0
- */
-int getCachedFlags(IType type);
+ /**
+ * Returns whether the given type is part of this hierarchy.
+ *
+ * @param type
+ * the given type
+ * @return true if the given type is part of this hierarchy, false otherwise
+ */
+ boolean contains(IType type);
-/**
- * Returns all interfaces resolved to extend the given interface,
- * in no particular order, limited to the interfaces in this
- * hierarchy's graph.
- * Returns an empty collection if the given type is a class, or
- * if no interfaces were resolved to extend the given interface.
- *
- * @param type the given type
- * @return all interfaces resolved to extend the given interface limited to the interfaces in this
- * hierarchy's graph, an empty array if none.
- */
-IType[] getExtendingInterfaces(IType type);
-/**
- * Returns all classes resolved to implement the given interface,
- * in no particular order, limited to the classes in this type
- * hierarchy's graph. Returns an empty collection if the given type is a
- * class, or if no classes were resolved to implement the given
- * interface.
- *
- * @param type the given type
- * @return all classes resolved to implement the given interface limited to the classes in this type
- * hierarchy's graph, an empty array if none
- */
-IType[] getImplementingClasses(IType type);
-/**
- * Returns all classes in the graph which have no resolved superclass,
- * in no particular order.
- *
- * @return all classes in the graph which have no resolved superclass
- */
-IType[] getRootClasses();
-/**
- * Returns all interfaces in the graph which have no resolved superinterfaces,
- * in no particular order.
- *
- * @return all interfaces in the graph which have no resolved superinterfaces
- */
-IType[] getRootInterfaces();
-/**
- * Returns the direct resolved subclasses of the given class,
- * in no particular order, limited to the classes in this
- * type hierarchy's graph.
- * Returns an empty collection if the given type is an interface,
- * or if no classes were resolved to be subclasses of the given
- * class.
- *
- * @param type the given type
- * @return the direct resolved subclasses of the given class limited to the classes in this
- * type hierarchy's graph, an empty collection if none.
- */
-IType[] getSubclasses(IType type);
-/**
- * Returns the direct resolved subtypes of the given type,
- * in no particular order, limited to the types in this
- * type hierarchy's graph.
- * If the type is a class, this returns the resolved subclasses.
- * If the type is an interface, this returns both the classes which implement
- * the interface and the interfaces which extend it.
- *
- * @param type the given type
- * @return the direct resolved subtypes of the given type limited to the types in this
- * type hierarchy's graph
- */
-IType[] getSubtypes(IType type);
-/**
- * Returns the resolved superclass of the given class,
- * or null
if the given class has no superclass,
- * the superclass could not be resolved, or if the given
- * type is an interface.
- *
- * @param type the given type
- * @return the resolved superclass of the given class,
- * or null
if the given class has no superclass,
- * the superclass could not be resolved, or if the given
- * type is an interface
- */
-IType getSuperclass(IType type);
-/**
- * Returns the direct resolved interfaces that the given type implements or extends,
- * in no particular order, limited to the interfaces in this type
- * hierarchy's graph.
- * For classes, this gives the interfaces that the class implements.
- * For interfaces, this gives the interfaces that the interface extends.
- *
- * @param type the given type
- * @return the direct resolved interfaces that the given type implements or extends limited to the interfaces in this type
- * hierarchy's graph
- */
-IType[] getSuperInterfaces(IType type);
-/**
- * Returns the resolved supertypes of the given type,
- * in no particular order, limited to the types in this
- * type hierarchy's graph.
- * For classes, this returns its superclass and the interfaces that the class implements.
- * For interfaces, this returns the interfaces that the interface extends. As a consequence
- * java.lang.Object
is NOT considered to be a supertype of any interface
- * type.
- *
- * @param type the given type
- * @return the resolved supertypes of the given type limited to the types in this
- * type hierarchy's graph
- */
-IType[] getSupertypes(IType type);
-/**
- * Returns the type this hierarchy was computed for.
- * Returns null
if this hierarchy was computed for a region.
- *
- * @return the type this hierarchy was computed for
- */
-IType getType();
-/**
- * Re-computes the type hierarchy reporting progress.
- *
- * @param monitor the given progress monitor
- * @exception JavaModelException if unable to refresh the hierarchy
- */
-void refresh(IProgressMonitor monitor) throws JavaModelException;
-/**
- * Removes the given listener from this type hierarchy.
- * Has no affect if an identical listener is not registered.
- *
- * @param listener the listener
- */
-void removeTypeHierarchyChangedListener(ITypeHierarchyChangedListener listener);
-/**
- * Stores the type hierarchy in an output stream. This stored hierarchy can be load by
- * IType#loadTypeHierachy(IJavaProject, InputStream, IProgressMonitor).
- * Listeners of this hierarchy are not stored.
- *
- * Only hierarchies created by the following methods can be store:
- *
+ * NOTE: once a type hierarchy has been created, it is more efficient to + * query the hierarchy for superclasses than to query a class recursively up + * the superclass chain. Querying an element performs a dynamic resolution, + * whereas the hierarchy returns a pre-computed result. + * + * @param type + * the given type + * @return all resolved superclasses of the given class, in bottom-up order, + * an empty array if none. + */ + IType[] getAllSuperclasses(IType type); + + /** + * Returns all resolved superinterfaces (direct and indirect) of the given + * type. If the given type is a class, this includes all superinterfaces of + * all superclasses. An empty array is returned if there are no resolved + * superinterfaces for the given type. + * + *
+ * NOTE: once a type hierarchy has been created, it is more efficient to + * query the hierarchy for superinterfaces than to query a type recursively. + * Querying an element performs a dynamic resolution, whereas the hierarchy + * returns a pre-computed result. + * + * @param type + * the given type + * @return all resolved superinterfaces (direct and indirect) of the given + * type, an empty array if none + */ + IType[] getAllSuperInterfaces(IType type); + + /** + * Returns all resolved supertypes of the given type, in bottom-up order. An + * empty array is returned if there are no resolved supertypes for the given + * type. + *
+ * Note that java.lang.Object
is NOT considered to be a
+ * supertype of any interface type.
+ *
+ * NOTE: once a type hierarchy has been created, it is more efficient to
+ * query the hierarchy for supertypes than to query a type recursively up
+ * the supertype chain. Querying an element performs a dynamic resolution,
+ * whereas the hierarchy returns a pre-computed result.
+ *
+ * @param type
+ * the given type
+ * @return all resolved supertypes of the given class, in bottom-up order,
+ * an empty array if none
+ */
+ IType[] getAllSupertypes(IType type);
+
+ /**
+ * Returns all types in this type hierarchy's graph, in no particular order.
+ * Any types in the creation region which were not resolved to have any
+ * subtypes or supertypes are not included in the result.
+ *
+ * @return all types in this type hierarchy's grap
+ */
+ IType[] getAllTypes();
+
+ /**
+ * Return the flags associated with the given type (would be equivalent to
+ * IMember.getFlags()
), or -1
if this
+ * information wasn't cached on the hierarchy during its computation.
+ *
+ * @param type
+ * the given type
+ * @return the modifier flags for this member
+ * @see Flags
+ * @since 2.0
+ */
+ int getCachedFlags(IType type);
+
+ /**
+ * Returns all interfaces resolved to extend the given interface, in no
+ * particular order, limited to the interfaces in this hierarchy's graph.
+ * Returns an empty collection if the given type is a class, or if no
+ * interfaces were resolved to extend the given interface.
+ *
+ * @param type
+ * the given type
+ * @return all interfaces resolved to extend the given interface limited to
+ * the interfaces in this hierarchy's graph, an empty array if none.
+ */
+ IType[] getExtendingInterfaces(IType type);
+
+ /**
+ * Returns all classes resolved to implement the given interface, in no
+ * particular order, limited to the classes in this type hierarchy's graph.
+ * Returns an empty collection if the given type is a class, or if no
+ * classes were resolved to implement the given interface.
+ *
+ * @param type
+ * the given type
+ * @return all classes resolved to implement the given interface limited to
+ * the classes in this type hierarchy's graph, an empty array if
+ * none
+ */
+ IType[] getImplementingClasses(IType type);
+
+ /**
+ * Returns all classes in the graph which have no resolved superclass, in no
+ * particular order.
+ *
+ * @return all classes in the graph which have no resolved superclass
+ */
+ IType[] getRootClasses();
+
+ /**
+ * Returns all interfaces in the graph which have no resolved
+ * superinterfaces, in no particular order.
+ *
+ * @return all interfaces in the graph which have no resolved
+ * superinterfaces
+ */
+ IType[] getRootInterfaces();
+
+ /**
+ * Returns the direct resolved subclasses of the given class, in no
+ * particular order, limited to the classes in this type hierarchy's graph.
+ * Returns an empty collection if the given type is an interface, or if no
+ * classes were resolved to be subclasses of the given class.
+ *
+ * @param type
+ * the given type
+ * @return the direct resolved subclasses of the given class limited to the
+ * classes in this type hierarchy's graph, an empty collection if
+ * none.
+ */
+ IType[] getSubclasses(IType type);
+
+ /**
+ * Returns the direct resolved subtypes of the given type, in no particular
+ * order, limited to the types in this type hierarchy's graph. If the type
+ * is a class, this returns the resolved subclasses. If the type is an
+ * interface, this returns both the classes which implement the interface
+ * and the interfaces which extend it.
+ *
+ * @param type
+ * the given type
+ * @return the direct resolved subtypes of the given type limited to the
+ * types in this type hierarchy's graph
+ */
+ IType[] getSubtypes(IType type);
+
+ /**
+ * Returns the resolved superclass of the given class, or null
+ * if the given class has no superclass, the superclass could not be
+ * resolved, or if the given type is an interface.
+ *
+ * @param type
+ * the given type
+ * @return the resolved superclass of the given class, or null
+ * if the given class has no superclass, the superclass could not be
+ * resolved, or if the given type is an interface
+ */
+ IType getSuperclass(IType type);
+
+ /**
+ * Returns the direct resolved interfaces that the given type implements or
+ * extends, in no particular order, limited to the interfaces in this type
+ * hierarchy's graph. For classes, this gives the interfaces that the class
+ * implements. For interfaces, this gives the interfaces that the interface
+ * extends.
+ *
+ * @param type
+ * the given type
+ * @return the direct resolved interfaces that the given type implements or
+ * extends limited to the interfaces in this type hierarchy's graph
+ */
+ IType[] getSuperInterfaces(IType type);
+
+ /**
+ * Returns the resolved supertypes of the given type, in no particular
+ * order, limited to the types in this type hierarchy's graph. For classes,
+ * this returns its superclass and the interfaces that the class implements.
+ * For interfaces, this returns the interfaces that the interface extends.
+ * As a consequence java.lang.Object
is NOT considered to be
+ * a supertype of any interface type.
+ *
+ * @param type
+ * the given type
+ * @return the resolved supertypes of the given type limited to the types in
+ * this type hierarchy's graph
+ */
+ IType[] getSupertypes(IType type);
+
+ /**
+ * Returns the type this hierarchy was computed for. Returns
+ * null
if this hierarchy was computed for a region.
+ *
+ * @return the type this hierarchy was computed for
+ */
+ IType getType();
+
+ /**
+ * Re-computes the type hierarchy reporting progress.
+ *
+ * @param monitor
+ * the given progress monitor
+ * @exception JavaModelException
+ * if unable to refresh the hierarchy
+ */
+ void refresh(IProgressMonitor monitor) throws JavaModelException;
+
+ /**
+ * Removes the given listener from this type hierarchy. Has no affect if an
+ * identical listener is not registered.
+ *
+ * @param listener
+ * the listener
+ */
+ void removeTypeHierarchyChangedListener(
+ ITypeHierarchyChangedListener listener);
+
+ /**
+ * Stores the type hierarchy in an output stream. This stored hierarchy can
+ * be load by IType#loadTypeHierachy(IJavaProject, InputStream,
+ * IProgressMonitor). Listeners of this hierarchy are not stored.
+ *
+ * Only hierarchies created by the following methods can be store:
+ *