/*
 *                 Sun Public License Notice
 * 
 * The contents of this file are subject to the Sun Public License
 * Version 1.0 (the "License"). You may not use this file except in
 * compliance with the License. A copy of the License is available at
 * http://www.sun.com/
 * 
 * The Original Code is NetBeans. The Initial Developer of the Original
 * Code is Sun Microsystems, Inc. Portions Copyright 1997-2003 Sun
 * Microsystems, Inc. All Rights Reserved.
 */

package org.openide.debugger;


/**
* Contains information about a class to debug.
* Consists of these pieces of information:
* 

* 
the class to run
* 
parameters for its main method
* 
a class name to stop execution in, if desired
* 
*
* @deprecated Use new Debugger API (http://www.netbeans.org/download/dev/javadoc/).
* @author Jan Jancura, Jaroslav Tulach
*/
public class DebuggerInfo extends org.openide.execution.ExecInfo {
    /** class to stop at */
    private String stopClassName;

    /**
    * Construct a new DebuggerInfo with the class to run and its parameters specified.
    * Sets class to stop in to be the class to run.
    *
    * @param className name of debugged class
    * @param argv command-line arguments used for debugging this class; may be empty but not null
    */
    public DebuggerInfo (
        String className,
        String[] argv
    ) {
        this (
            className,
            argv,
            className
        );
    }

    /**
    * Construct a new DebuggerInfo with the class to run, parameters, and a class to stop at.
    *
    * @param className name of debugged class
    * @param argv command-line arguments used for debugging this class; may be empty but not null
    * @param stopClassName name of class to stop in (may be null)
    */
    public DebuggerInfo (
        String className,
        String[] argv,
        String stopClassName
    ) {
        super (className, argv);
        this.stopClassName = stopClassName;
    }

    /** Checks whether the method has declaring class.
    * @param m method
    * @return the same method
    * @exception IllegalArgumentException if the stopMethod does not have
    *   declaring class
    *
    private static MethodElement method (MethodElement m) {
      if (m.getDeclaringClass () == null) {
        throw new IllegalArgumentException ("No declaring class for method: " + m.getName ());
      }
      return m;
}
    */


    /** Get the class to stop execution in.
    *
    * @return the class name or null
    */
    public String getStopClassName () {
        return stopClassName;
    }

    /** Getter for a method to stop at. If the method is not null
    * it has a declaring class. So
    * @return method or null
    *
    public MethodElement getStopMethod () {
      return stopMethod;
}
    */
}