sk.stuba.fiit.perconik.core.plugin

Class Activator

java.lang.Object

org.eclipse.core.runtime.Plugin

sk.stuba.fiit.perconik.eclipse.core.runtime.ExtendedPlugin

sk.stuba.fiit.perconik.core.plugin.Activator

All Implemented Interfaces:

org.osgi.framework.BundleActivator

public final class Activator
extends ExtendedPlugin

The Activator class controls the plug-in life cycle.

Warning: Users should not explicitly instantiate this class.

Author:

Pavol Zbell

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Activator.Startup Plug-in early startup.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	PLUGIN_ID The plug-in identifier.

Fields inherited from class sk.stuba.fiit.perconik.eclipse.core.runtime.ExtendedPlugin

console

Fields inherited from class org.eclipse.core.runtime.Plugin

PLUGIN_PREFERENCE_SCOPE, PREFERENCES_DEFAULT_OVERRIDE_BASE_NAME, PREFERENCES_DEFAULT_OVERRIDE_FILE_NAME

Constructor Summary

Constructors

Constructor and Description
Activator() The constructor.

Method Summary

Modifier and Type	Method and Description
static void	awaitServices(long timeout, java.util.concurrent.TimeUnit unit) Waits blocking until all supplied extensions are processed, core services loaded and started.
static void	awaitServices(TimeValue timeout)
static ClassResolver	classResolver() Returns primary ClassResolver utility to resolve unknown classes.
static java.util.List<org.osgi.framework.Bundle>	contributingBundles() Returns a list of bundles contributing extensions to this plug-in.
static PluginConsole	defaultConsole() Gets the shared console.
static Activator	defaultInstance() Gets the shared instance.
static java.util.Set<java.lang.String>	extensionContributors() Returns a set of extension contributors to this plug-in.
static boolean	loadedServices() Determines whether all supplied extensions are processed, core services loaded and started.
static void	loadServices(java.lang.Runnable hook, long timeout, java.util.concurrent.TimeUnit unit) Processes supplied extensions, loads and starts core services.
static void	loadServices(java.lang.Runnable hook, TimeValue timeout)
void	start(org.osgi.framework.BundleContext context) Starts this plug-in.
void	stop(org.osgi.framework.BundleContext context) Stops this plug-in.
static void	unloadServices(java.lang.Runnable hook, long timeout, java.util.concurrent.TimeUnit unit) Processes supplied extensions, stops and unloads core services.
static void	unloadServices(java.lang.Runnable hook, TimeValue timeout)

Methods inherited from class sk.stuba.fiit.perconik.eclipse.core.runtime.ExtendedPlugin

getConsole

Methods inherited from class org.eclipse.core.runtime.Plugin

find, find, getBundle, getDescriptor, getLog, getPluginPreferences, getStateLocation, initializeDefaultPluginPreferences, internalInitializeDefaultPluginPreferences, isDebugging, openStream, openStream, savePluginPreferences, setDebugging, shutdown, startup, toString

Methods inherited from class java.lang.Object

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

Field Detail

PLUGIN_ID

public static final java.lang.String PLUGIN_ID

The plug-in identifier.

See Also:

Constant Field Values

Constructor Detail

Activator

public Activator()

The constructor.

Method Detail

defaultInstance

public static Activator defaultInstance()

Gets the shared instance.

Returns:

the shared instance or null

defaultConsole

public static PluginConsole defaultConsole()

Gets the shared console.

Returns:

the shared console or null

extensionContributors

public static java.util.Set<java.lang.String> extensionContributors()

Returns a set of extension contributors to this plug-in.

contributingBundles

public static java.util.List<org.osgi.framework.Bundle> contributingBundles()

Returns a list of bundles contributing extensions to this plug-in.

classResolver

public static ClassResolver classResolver()

Returns primary ClassResolver utility to resolve unknown classes.

loadServices

public static void loadServices(java.lang.Runnable hook,
                                long timeout,
                                java.util.concurrent.TimeUnit unit)
                         throws java.util.concurrent.TimeoutException

Processes supplied extensions, loads and starts core services.

Parameters:

action - executed after services load prior to start, not null

timeout - the maximum time to load

unit - the time unit of the timeout argument

Throws:

java.lang.RuntimeException - if an error occurred

java.util.concurrent.TimeoutException - if the load timed out

loadServices

public static void loadServices(java.lang.Runnable hook,
                                TimeValue timeout)
                         throws java.util.concurrent.TimeoutException

Throws:

java.util.concurrent.TimeoutException

unloadServices

public static void unloadServices(java.lang.Runnable hook,
                                  long timeout,
                                  java.util.concurrent.TimeUnit unit)
                           throws java.util.concurrent.TimeoutException

Processes supplied extensions, stops and unloads core services.

Parameters:

action - executed after services stop prior to unload, not null

timeout - the maximum time to unload

unit - the time unit of the timeout argument

Throws:

java.lang.RuntimeException - if an error occurred

java.util.concurrent.TimeoutException - if the unload timed out

unloadServices

public static void unloadServices(java.lang.Runnable hook,
                                  TimeValue timeout)
                           throws java.util.concurrent.TimeoutException

Throws:

java.util.concurrent.TimeoutException

loadedServices

public static boolean loadedServices()

Determines whether all supplied extensions are processed, core services loaded and started.

awaitServices

public static void awaitServices(long timeout,
                                 java.util.concurrent.TimeUnit unit)
                          throws java.util.concurrent.TimeoutException

Waits blocking until all supplied extensions are processed, core services loaded and started.

Parameters:

timeout - the maximum time to wait

unit - the time unit of the timeout argument

Throws:

java.util.concurrent.TimeoutException - if the wait timed out

awaitServices

public static void awaitServices(TimeValue timeout)
                          throws java.util.concurrent.TimeoutException

Throws:

java.util.concurrent.TimeoutException

start

public void start(org.osgi.framework.BundleContext context)
           throws java.lang.Exception

Starts this plug-in.

Warning: Users must never explicitly call this method.

Specified by:

start in interface org.osgi.framework.BundleActivator

Overrides:

start in class org.eclipse.core.runtime.Plugin

Throws:

java.lang.Exception

stop

public void stop(org.osgi.framework.BundleContext context)
          throws java.lang.Exception

Stops this plug-in.

Warning: Users must never explicitly call this method.

Specified by:

stop in interface org.osgi.framework.BundleActivator

Overrides:

stop in class org.eclipse.core.runtime.Plugin

Throws:

java.lang.Exception