Class ConsolePlugin
- All Implemented Interfaces:
BundleActivator
- Since:
- 3.0
- Restriction:
- This class is not intended to be subclassed by clients.
- Restriction:
- This class is not intended to be instantiated by clients.
-
Field Summary
Fields inherited from class org.eclipse.core.runtime.Plugin
PLUGIN_PREFERENCE_SCOPE, PREFERENCES_DEFAULT_OVERRIDE_BASE_NAME, PREFERENCES_DEFAULT_OVERRIDE_FILE_NAME
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionstatic void
errorDialog
(Shell shell, String title, String message, Throwable t) Utility method with conventionsReturns the console manager.static ConsolePlugin
Returns the singleton instance of the console plug-in.static Image
Returns theImage
identified by the given key, ornull
if it does not exist.static ImageDescriptor
getImageDescriptor
(String key) Returns theImageDescriptor
identified by the given key, ornull
if it does not exist.static Display
Returns the workbench display.static String
Convenience method which returns the unique identifier of this plug-in.static void
Logs the specified throwable with this plug-in's log.static void
Logs the specified status with this plug-in's log.static IStatus
newErrorStatus
(String message, Throwable exception) Returns a new error status for this plug-in with the given messagevoid
stop
(BundleContext context) TheAbstractUIPlugin
implementation of thisPlugin
method saves this plug-in's preference and dialog stores and shuts down its image registry (if they are in use).Methods inherited from class org.eclipse.ui.plugin.AbstractUIPlugin
createImageRegistry, getDialogSettings, getImageRegistry, getPreferenceStore, getWorkbench, imageDescriptorFromPlugin, initializeDefaultPluginPreferences, initializeDefaultPreferences, initializeImageRegistry, loadDialogSettings, loadPreferenceStore, refreshPluginActions, saveDialogSettings, savePreferenceStore, shutdown, start, startup
Methods inherited from class org.eclipse.core.runtime.Plugin
find, find, getBundle, getLog, getPluginPreferences, getStateLocation, internalInitializeDefaultPluginPreferences, isDebugging, openStream, openStream, savePluginPreferences, setDebugging, toString
-
Constructor Details
-
ConsolePlugin
public ConsolePlugin()
-
-
Method Details
-
getDefault
Returns the singleton instance of the console plug-in.- Returns:
- the singleton instance of this console plug-in
-
getUniqueIdentifier
Convenience method which returns the unique identifier of this plug-in.- Returns:
- this plug-in's unique identifier
-
log
Logs the specified status with this plug-in's log.- Parameters:
status
- status to log
-
log
Logs the specified throwable with this plug-in's log.- Parameters:
t
- throwable to log
-
newErrorStatus
Returns a new error status for this plug-in with the given message- Parameters:
message
- the message to be included in the statusexception
- the exception to be included in the status ornull
if none- Returns:
- a new error status
-
getConsoleManager
Returns the console manager. The manager will be created lazily on the first access.- Returns:
- IConsoleManager
-
getStandardDisplay
Returns the workbench display.- Returns:
- the workbench display
-
errorDialog
Utility method with conventions- Parameters:
shell
- the parent shell for the dialogtitle
- dialog titlemessage
- dialog messaget
- error to show in dialog
-
getImage
Returns theImage
identified by the given key, ornull
if it does not exist.- Parameters:
key
- the image's key- Returns:
- the
Image
identified by the given key, ornull
if it does not exist - Since:
- 3.1
-
getImageDescriptor
Returns theImageDescriptor
identified by the given key, ornull
if it does not exist.- Parameters:
key
- the image's key- Returns:
- the
ImageDescriptor
identified by the given key, ornull
if it does not exist - Since:
- 3.1
-
stop
Description copied from class:AbstractUIPlugin
TheAbstractUIPlugin
implementation of thisPlugin
method saves this plug-in's preference and dialog stores and shuts down its image registry (if they are in use). Subclasses may extend this method, but must send super last. A try-finally statement should be used where necessary to ensure thatsuper.stop()
is always done. Stops this plug-in.This method should be re-implemented in subclasses that need to do something when the plug-in is shut down. Implementors should call the inherited method as late as possible to ensure that any system requirements can be met.
Plug-in shutdown code should be robust. In particular, this method should always make an effort to shut down the plug-in. Furthermore, the code should not assume that the plug-in was started successfully.
Note 1: If a plug-in has been automatically started, this method will be automatically invoked by the platform when the platform is shut down.
Note 2: This method is intended to perform simple termination of the plug-in environment. The platform may terminate invocations that do not complete in a timely fashion.
Note 3: The supplied bundle context represents the plug-in to the OSGi framework. For security reasons, it is strongly recommended that this object should not be divulged.
Note 4: This method and the
Clients must never explicitly call this method.Plugin.start(BundleContext)
may be called from separate threads, but the OSGi framework ensures that both methods will not be called simultaneously.- Specified by:
stop
in interfaceBundleActivator
- Overrides:
stop
in classAbstractUIPlugin
- Parameters:
context
- the bundle context for this plug-in- Throws:
Exception
- if this method fails to shut down this plug-in
-