cern.gp.util

Class GPManager

java.lang.Object

cern.gp.util.GPManager

public class GPManager
extends java.lang.Object

This class must be used as a replacement for TopManager whenever TopManager has to be used. It provides the same utility methods for getting services from NetBeans. New versions of NetBeans removed TopManager completely and are changing the way those services are accessed. This class limits the impact of the changes in your code.

Author:

Lionel Mestre

Field Summary

Fields

Modifier and Type	Field and Description
static int	ERROR Serious problem, application may be crippled
static int	EXCEPTION Something went wrong, though it can be recovered
static int	INFORMATIONAL Message that would be useful for tracing events but which need not be a problem
static int	UNKNOWN Undefined severity
static int	USER Something the user should be aware of
static int	WARNING Something went wrong in the software, but it is continuing and the user need not be bothered

Constructor Summary

Constructors

Constructor and Description
GPManager()

Method Summary

Modifier and Type	Method and Description
static java.awt.Dialog	createDialog(org.openide.DialogDescriptor descriptor) Get a new standard dialog.
static org.openide.windows.InputOutput	getIO(java.lang.String name, boolean newIO) Support reading from and writing to a specific tab on the Output Window.
static org.openide.windows.OutputWriter	getStdOut() Support writing to the Output Window on the main tab.
static void	notify(int severity, java.lang.Throwable t) Prints the exception to the log file and (possibly) notifies the user.
static java.lang.Object	notify(org.openide.NotifyDescriptor descriptor) Notify the user of something in a message box, possibly with feedback.
static void	setStatusText(java.lang.String text) Show text in the IDE's status line.
static void	showURL(java.net.URL url) Browse a document named by some URL.

Methods inherited from class java.lang.Object

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

Field Detail

ERROR

public static final int ERROR

Serious problem, application may be crippled

EXCEPTION

public static final int EXCEPTION

Something went wrong, though it can be recovered

INFORMATIONAL

public static final int INFORMATIONAL

Message that would be useful for tracing events but which need not be a problem

UNKNOWN

public static final int UNKNOWN

Undefined severity

USER

public static final int USER

Something the user should be aware of

WARNING

public static final int WARNING

Something went wrong in the software, but it is continuing and the user need not be bothered

Constructor Detail

GPManager

public GPManager()

Method Detail

setStatusText

public static final void setStatusText(java.lang.String text)

Show text in the IDE's status line. Can be called at any time, but remember the text may not be updated until the AWT event queue is ready for it - so if you are hogging the event queue the text will not appear until you release it (finish your work or display a modal dialog, for example).

Parameters:

text - the text to be shown

createDialog

public static final java.awt.Dialog createDialog(org.openide.DialogDescriptor descriptor)

Get a new standard dialog. The dialog is designed and created as specified in the parameter. Anyone who wants a dialog with standard buttons and standard behavior should use this method.

Do not cache the resulting dialog if it is modal and try to reuse it! Always create a new dialog using this method if you need to show a dialog again. Otherwise previously closed windows can reappear.

Parameters:

descriptor - general description of the dialog

notify

public static final java.lang.Object notify(org.openide.NotifyDescriptor descriptor)

Notify the user of something in a message box, possibly with feedback.

To support both GUI and non-GUI use, this method may be called from any thread (providing you are not holding any locks), and will block the caller's thread. In GUI mode, it will be run in the AWT event thread automatically. If you wish to hold locks, or do not need the result object immediately or at all, please make this call asynchronously (e.g. from the request processor).

Parameters:

nd - description of the notification

Returns:

the option that caused the message box to be closed

getStdOut

public static final org.openide.windows.OutputWriter getStdOut()

Support writing to the Output Window on the main tab.

Returns:

a writer for the standard IDE output

getIO

public static final org.openide.windows.InputOutput getIO(java.lang.String name,
                                                          boolean newIO)

Support reading from and writing to a specific tab on the Output Window. If a tab with the supplied name already exists, a new tab with the same name will be created regardless.

Parameters:

name - desired name of the tab

Returns:

an InputOutput class for accessing the new tab

notify

public static final void notify(int severity,
                                java.lang.Throwable t)

Prints the exception to the log file and (possibly) notifies the user.

Parameters:

everity - the severity to be applied to the exception (overrides default), e.g. EXCEPTION

t - the exception to notify

showURL

public static final void showURL(java.net.URL url)

Browse a document named by some URL. HtmlBrowser provides more control in certain cases.

Parameters:

url - URL of WWW or local document to be shown

t - the exception to notify