/*
 * Copyright (c) 2001, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.
 *
 * This code is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 * version 2 for more details (a copy is included in the LICENSE file that
 * accompanied this code).
 *
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 * or visit www.oracle.com if you need additional information or have any
 * questions.
 *
 */

package sun.jvm.hotspot.ui;

import javax.swing.JComponent;

An EditorFactory is the basis of pluggable editor components. One can configure the debugger with a new EditorFactory, which completely replaces how the debugger displays source code.
/** An EditorFactory is the basis of pluggable editor components. One can configure the debugger with a new EditorFactory, which completely replaces how the debugger displays source code. */
public interface EditorFactory {
Opens the given file in a new window. The debugger has already taken care of ensuring that the file can be found. The debugger will typically not create two Editor objects for the same source file, as it keeps track of open files. The EditorCommands object provided to the Editor by the debugger allows the Editor to notify the debugger of events such as a breakpoint being set or a window being closed.
/** Opens the given file in a new window. The debugger has already taken care of ensuring that the file can be found. The debugger will typically not create two Editor objects for the same source file, as it keeps track of open files. The EditorCommands object provided to the Editor by the debugger allows the Editor to notify the debugger of events such as a breakpoint being set or a window being closed. */
public Editor openFile(String filename, EditorCommands commands);
Retrieves the current topmost file of all of the Editors this EditorFactory has opened. This is used for the debugger user interface to request that a breakpoint be set. (Editors can also request that breakpoints be set via the EditorCommands, but this is intended to support external editors with their own keystrokes for performing this operation.) Returns null if there is no file currently being edited.
/** Retrieves the current topmost file of all of the Editors this EditorFactory has opened. This is used for the debugger user interface to request that a breakpoint be set. (Editors can also request that breakpoints be set via the EditorCommands, but this is intended to support external editors with their own keystrokes for performing this operation.) Returns null if there is no file currently being edited. */
public Editor getCurrentEditor(); }