<change>

        <api name="JPDADebuggerAPI"/>

        <summary>Support for heap walking.</summary>

        <version major="2" minor="11"/>

        <date day="5" month="4" year="2007"/>

        <author login="mentlicher"/>

        <compatibility addition="yes" source="compatible" binary="compatible"/>

        <description>

            <p>

                In order to be able to provide heap walking functionality,

                we need methods for retrieval of class instances and

                back references.

            </p>

            <p>

                Added methods:<br/>

                <code>Field.getDeclaringClass()</code>,

                <code>JPDAClassType.getClassLoader()</code>,

                <code>JPDAClassType.getSuperClass()</code>,

                <code>JPDAClassType.getInstanceCount()</code>,

                <code>JPDAClassType.getInstances()</code>,

                <code>JPDADebugger.canGetInstanceInfo()</code>,

                <code>JPDADebugger.getAllClasses()</code>,

                <code>JPDADebugger.getClassesByName()</code>,

                <code>JPDADebugger.getInstanceCounts()</code>,

                <code>ObjectVariable.getReferringObjects()</code>,

                <code>ObjectVariable.getClassType()</code>,

                <code>ObjectVariable.getUniqueID()</code>.

            </p>

            <p>

                Added classes:<br/>

                <code>VariableType</code>,

                <code>JPDAArrayType</code>.

            </p>

        </description>

        <class package="org.netbeans.spi.debugger.jpda" name="JPDADebugger" />

        <class package="org.netbeans.spi.debugger.jpda" name="JPDAClassType" />

        <class package="org.netbeans.spi.debugger.jpda" name="ObjectVariable" />

        <class package="org.netbeans.spi.debugger.jpda" name="VariableType" />

        <class package="org.netbeans.spi.debugger.jpda" name="JPDAArrayType" />

        <issue number="100047"/>

    </change>

    /**

     * Get the class type in which this field was declared.

     * @return the class type

     */

    public abstract JPDAClassType getDeclaringClass();

     * Gets the classloader object which loaded the class corresponding to this type.

     * @return an object variable representing the classloader, or <code>null</code>

     *         if the class was loaded through the bootstrap class loader.

     */

    ObjectVariable getClassLoader();

    /**

     * Gets the superclass of this class.

     * @return the superclass of this class in the debuggee, or <code>null</code>

     *         if no such class exists.

     */

    Super getSuperClass();

    /**

    /**

     * Retrieves the number of instances this class.

     * Use {@link JPDADebugger#canGetInstanceInfo} to determine if this operation is supported.

     * @return the number of instances.

     */

    long getInstanceCount() throws UnsupportedOperationException;

    /**

     * Returns instances of this class type. Only instances that are reachable

     * for the purposes of garbage collection are returned.

     * Use {@link JPDADebugger#canGetInstanceInfo} to determine if this operation is supported.

     * @param maxInstances the maximum number of instances to return. Must be non-negative. If zero, all instances are returned.

     * @return a List of object variables.

     */

    List<ObjectVariable> getInstances(long maxInstances) throws UnsupportedOperationException;

import java.util.Collections;

    /**

     * Test whether the debuggee supports accessing of class instances, instance counts, and referring objects.

     * 

     * @see #getInstanceCounts

     * @see JPDAClassType#getInstanceCount

     * @see JPDAClassType#getInstances

     * @see ObjectVariable#getReferringObjects

     * 

     * @return <code>true</code> when the feature is supported, <code>false</code> otherwise.

     */

    public boolean canGetInstanceInfo() {

        return false;

    }

    /**

     * Get the list of all classes in the debuggee.

     * @return The list of all classes.

     */

    public List<JPDAClassType> getAllClasses() {

        return Collections.emptyList();

    }

    /**

     * Get the list of all classes mathing the given name in the debuggee.

     * @return The list of classes.

     */

    public List<JPDAClassType> getClassesByName(String name) {

        return Collections.emptyList();

    }

    /**

     * Retrieves the number of instances of each class in the list.

     * Use {@link #canGetInstanceInfo} to determine if this operation is supported.

     * @return an array of <code>long</code> containing one instance counts for

     *         each respective element in the <code>classTypes</code> list.

     */

    public long[] getInstanceCounts(List<JPDAClassType> classTypes) throws UnsupportedOperationException {

        throw new UnsupportedOperationException("Not supported.");

    }

import java.util.List;

     * Returns variables that directly reference this variable.

     * Use {@link JPDADebugger#canGetInstanceInfo} to determine if this operation is supported.

     * @param maxReferrers The maximum number of referring variables to return. Must be non-negative. If zero, all referring variables are returned.

     * @return A list of referring variables.

     */

    List<ObjectVariable> getReferringObjects(long maxReferrers) throws UnsupportedOperationException;

    /**

    /**

     * Get the run-time class type of this object variable.

     * @return The variable class type.

     */

    JPDAClassType getClassType();

    /**

     * Returns a unique identifier for this object variable.

     * It is guaranteed to be unique among all object variables from the same debuggee that have not yet been disposed.

     * @return a long unique ID

     */

    long getUniqueID();