Eclipse Platform
Release 3.2

org.eclipse.ui.services
Interface IDisposable

All Known Subinterfaces:
IBindingService, ICommandService, IContextService, IHandlerService, IServiceWithSources
All Known Implementing Classes:
SaveablesProvider

public interface IDisposable

The interface that should be implemented by services that make themselves available through the IAdaptable mechanism. This is the interface that drives the majority of services provided at the workbench level.

A service has life-cycle. When the constructor completes, the service must be fully functional. When it comes time for the service to go away, then the service will receive a dispose() call. At this point, the service must release all resources and detach all listeners. A service can only be disposed once; it cannot be reused.

This interface has nothing to do with OSGi services.

This interface can be extended or implemented by clients.

Since:
3.2

Method Summary
 void dispose()
          Disposes of this service.
 

Method Detail

dispose

public void dispose()
Disposes of this service. All resources must be freed. All listeners must be detached. Dispose will only be called once during the life cycle of a service.


Eclipse Platform
Release 3.2

Guidelines for using Eclipse APIs.

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