Package org.eclipse.ui.services

Class AbstractServiceFactory

java.lang.Object

org.eclipse.ui.services.AbstractServiceFactory

public abstract class AbstractServiceFactory
extends Object

A factory for creating services for use with the org.eclipse.ui.services extension point. You are given a service locator to look up other services, and can retrieve your parent service (if one has already been created).

Since:

3.4

Constructor Summary

Constructors

Constructor	Description
AbstractServiceFactory()

Method Summary

Modifier and Type	Method	Description
abstract Object	create(Class serviceInterface, IServiceLocator parentLocator, IServiceLocator locator)	When a service locator cannot find a service it will request one from the registry, which will call this factory create method.

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractServiceFactory

public AbstractServiceFactory()

Method Detail

create

public abstract Object create(Class serviceInterface,
                              IServiceLocator parentLocator,
                              IServiceLocator locator)

When a service locator cannot find a service it will request one from the registry, which will call this factory create method.

You can use the locator to get any needed services and a parent service locator will be provided if you need access to the parent service. If the parent object return from the parent locator is not null it can be cast to the service interface that is requested. The parent service locator will only return the serviceInterface service.

Parameters:

serviceInterface - the service we need to create. Will not be null.

parentLocator - A locator that can return a parent service instance if desired. The parent service can be cast to serviceInterface. Will not be null.

locator - the service locator which can be used to retrieve dependent services. Will not be null

Returns:

the created service or null