org.eclipse.core.runtime.internal.adaptor
Class EclipseErrorHandler

java.lang.Object
  org.eclipse.core.runtime.internal.adaptor.EclipseErrorHandler

All Implemented Interfaces:

HookConfigurator, AdaptorHook

public class EclipseErrorHandler
extends java.lang.Object
implements AdaptorHook, HookConfigurator

Constructor Summary

EclipseErrorHandler()

Method Summary

void	addHooks(HookRegistry hookRegistry) Adds hooks to the specified hook registry.
void	addProperties(java.util.Properties properties) Gets called by the adaptor during FrameworkAdaptor.getProperties().
FrameworkLog	createFrameworkLog() Gets called by the adaptor during FrameworkAdaptor.getFrameworkLog().
void	frameworkStart(BundleContext context) Gets called by the adaptor during FrameworkAdaptor.frameworkStart(BundleContext).
void	frameworkStop(BundleContext context) Gets called by the adaptor during FrameworkAdaptor.frameworkStop(BundleContext).
void	frameworkStopping(BundleContext context) Gets called by the adaptor during FrameworkAdaptor.frameworkStopping(BundleContext).
void	handleRuntimeError(java.lang.Throwable error) Gets called by the adaptor during FrameworkAdaptor.handleRuntimeError(Throwable).
void	initialize(BaseAdaptor adaptor) Gets called by the adaptor during FrameworkAdaptor.initialize(EventPublisher).
java.net.URLConnection	mapLocationToURLConnection(java.lang.String location) Gets called by the adaptor during FrameworkAdaptor.mapLocationToURLConnection(String).

Methods inherited from class java.lang.Object

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

Constructor Detail

EclipseErrorHandler

public EclipseErrorHandler()

Method Detail

frameworkStart

public void frameworkStart(BundleContext context)
                    throws BundleException

Description copied from interface: AdaptorHook

Gets called by the adaptor during FrameworkAdaptor.frameworkStart(BundleContext). This method allows an adaptor hook to execute code when the framework is starting (e.g. to register services).

Specified by:

frameworkStart in interface AdaptorHook

Parameters:

context - the system bundle context

Throws:

BundleException - if an error occurs

frameworkStop

public void frameworkStop(BundleContext context)
                   throws BundleException

Description copied from interface: AdaptorHook

Gets called by the adaptor during FrameworkAdaptor.frameworkStop(BundleContext). This method allows an adaptor hook to execute code when the framework is stopped (e.g. to unregister services).

Specified by:

frameworkStop in interface AdaptorHook

Parameters:

context - the system bundle context

Throws:

BundleException - if an error occurs.

frameworkStopping

public void frameworkStopping(BundleContext context)

Description copied from interface: AdaptorHook

Gets called by the adaptor during FrameworkAdaptor.frameworkStopping(BundleContext). This method allows an adaptor hook to execute code when the framework is about to start the shutdown process.

Specified by:

frameworkStopping in interface AdaptorHook

Parameters:

context - the system bundle context

addProperties

public void addProperties(java.util.Properties properties)

Description copied from interface: AdaptorHook

Gets called by the adaptor during FrameworkAdaptor.getProperties(). This method allows an adaptor hook to add property values to the adaptor properties object.

Specified by:

addProperties in interface AdaptorHook

Parameters:

properties - the adaptor properties object.

mapLocationToURLConnection

public java.net.URLConnection mapLocationToURLConnection(java.lang.String location)
                                                  throws java.io.IOException

Description copied from interface: AdaptorHook

Gets called by the adaptor during FrameworkAdaptor.mapLocationToURLConnection(String). The adaptor will call this method for each configured adaptor hook until one adaptor hook returns a non-null value. If no adaptor hook returns a non-null value then the adaptor will perform the default behavior.

Specified by:

mapLocationToURLConnection in interface AdaptorHook

Parameters:

location - a bundle location string to be converted to a URLConnection

Returns:

the URLConnection converted from the bundle location or null.

Throws:

java.io.IOException - if an error occured creating the URLConnection

handleRuntimeError

public void handleRuntimeError(java.lang.Throwable error)

Description copied from interface: AdaptorHook

Gets called by the adaptor during FrameworkAdaptor.handleRuntimeError(Throwable). The adaptor will call this method for each configured adaptor hook.

Specified by:

handleRuntimeError in interface AdaptorHook

Parameters:

error - the unexpected error that occured.

addHooks

public void addHooks(HookRegistry hookRegistry)

Description copied from interface: HookConfigurator

Adds hooks to the specified hook registry.

Specified by:

addHooks in interface HookConfigurator

Parameters:

hookRegistry - the hook registry used to add hooks

createFrameworkLog

public FrameworkLog createFrameworkLog()

Description copied from interface: AdaptorHook

Gets called by the adaptor during FrameworkAdaptor.getFrameworkLog(). The adaptor will call this method for each configured adaptor hook until one adaptor hook returns a non-null value. If no adaptor hook returns a non-null value then the adaptor will return null.

Specified by:

createFrameworkLog in interface AdaptorHook

Returns:

a FrameworkLog object or null.

initialize

public void initialize(BaseAdaptor adaptor)

Description copied from interface: AdaptorHook

Gets called by the adaptor during FrameworkAdaptor.initialize(EventPublisher). This method allows an adaptor hook to save the adaptor object for later.

Specified by:

initialize in interface AdaptorHook

Parameters:

adaptor - the adaptor object associated with this AdaptorHook.