Eclipse Platform
Release 3.3

org.eclipse.ui.services
Interface IServiceLocator

All Known Subinterfaces:
IEditorSite, IIntroSite, IPageSite, IViewSite, IWorkbench, IWorkbenchPartSite, IWorkbenchSite, IWorkbenchWindow
All Known Implementing Classes:
MultiPageEditorSite, PageSite

public interface IServiceLocator

* A component with which one or more services are registered. The services can * be retrieved from this locator using some key -- typically the class * representing the interface the service must implement. For example: *

* *
 * IHandlerService service = (IHandlerService) workbenchWindow
 * 		.getService(IHandlerService.class);
 * 
* *

* This interface is not to be implemented or extended by clients. *

* * @since 3.2


Method Summary
 Object getService(Class api)
          Retrieves the service corresponding to the given API
 boolean hasService(Class api)
          Whether this service exists within the scope of this service locator
 

Method Detail

getService

public Object getService(Class api)
Retrieves the service corresponding to the given API. * * @param api * This is the interface that the service implements. Must not be * null. * @return The service, or null if no such service could be * found.


hasService

public boolean hasService(Class api)
Whether this service exists within the scope of this service locator. * This does not include looking for the service within the scope of the * parents. This method can be used to determine whether a particular * service supports nesting in this scope. * * @param api * This is the interface that the service implements. Must not be * null. * @return true iff the service locator can find a service * for the given API; false otherwise.


Eclipse Platform
Release 3.3

Guidelines for using Eclipse APIs.

Copyright (c) IBM Corp. and others 2000, 2007. All rights reserved.