javax.ide

Class Service

java.lang.Object

javax.ide.Service

Direct Known Subclasses:

ActionRegistry, BuildSystem, CommandProcessor, Debugger, DocumentFactory, EditorManager, ExtensionRegistry, GUIUtilities, IDE, LogManager, MenuManager, PropertyPageRegistry, VirtualFileSystem, WizardManager

public abstract class Service
extends java.lang.Object

Services provide access to distinct areas of functionality in the IDE for an extension developer.

Constructor Summary

Constructors

Constructor and Description
Service()

Method Summary

Modifier and Type	Method and Description
static java.util.HashMap<java.lang.Class<?>,Service>	cloneLoadedServices() Clones loaded services table.
protected static Service	getService(java.lang.Class serviceClass) Get a service.
protected void	initialize() Initialize this manager.
static void	resetAllServices() Resets all services, causing them to be recreated from scratch next time the getService( Class ) API is used.
static void	setLoadedServices(java.util.HashMap<java.lang.Class<?>,Service> loadedServices) Set the loaded services table.

Methods inherited from class java.lang.Object

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

Constructor Detail

Service

public Service()

Method Detail

initialize

protected void initialize()

Initialize this manager. This is called the first time a manager is retrieved programmatically. The manager should process necessary information from the extension manifest to initialize itself.

This implementation does nothing.

getService

protected static Service getService(java.lang.Class serviceClass)
                             throws javax.ide.spi.ProviderNotFoundException

Get a service. This implementation looks for a META-INF/services/className resource on the classpath of the context classloader. If such a resource exists, it must contain the fully qualified class name of an implementation class of the specified class.

Parameters:

serviceClass - the class of the service.

Returns:

the service.

Throws:

javax.ide.spi.ProviderNotFoundException - if an implementation of the service could not be located.

resetAllServices

public static void resetAllServices()

Resets all services, causing them to be recreated from scratch next time the getService( Class ) API is used.

Extension developers are strongly discouraged from using this method. It is called by the internal LookupProvider API to reset services when a new provider is registered.

Since:

2.0

cloneLoadedServices

public static java.util.HashMap<java.lang.Class<?>,Service> cloneLoadedServices()

Clones loaded services table.

This should only ever be called from test code.

Returns:

the stored table of active servcices

setLoadedServices

public static void setLoadedServices(java.util.HashMap<java.lang.Class<?>,Service> loadedServices)

Set the loaded services table.

This should only ever be called from test code.

Parameters:

loadedServices - the loaded services.