Service Activator Toolkit
Version 1.1.0 (20081206)

org.eclipse.soda.sat.core.record.container.interfaces
Interface IImportServiceRecordContainerLenientOwner

All Superinterfaces:
IImportServiceRecordContainerOwner

public interface IImportServiceRecordContainerLenientOwner
extends IImportServiceRecordContainerOwner

When an IImportServiceRecordContainer is created it must be given an owner that will handle call-back notifications. The IImportServiceRecordContainerLenientOwner interface declares the role of a container's owner, which has the following responsibilities:

Lenient Container Responsibilities

These responsibilities only apply to a lenient container. A lenient container is more complicated than a strict container since it cares when each of the import service records is acquired and released.

Note: Since this abstraction is used internally by the SAT bundle this interface is typically not used directly by bundle developers.


Method Summary
 void serviceAcquired(IImportServiceRecordContainer container, IImportServiceRecord record)
          One of the container's IImportServiceRecord objects has been acquired.
 void serviceReleased(IImportServiceRecordContainer container, IImportServiceRecord record)
          One of the container's IImportServiceRecord objects has been released.
 
Methods inherited from interface org.eclipse.soda.sat.core.record.container.interfaces.IImportServiceRecordContainerOwner
acquired, released
 

Method Detail

serviceAcquired

void serviceAcquired(IImportServiceRecordContainer container,
                     IImportServiceRecord record)
One of the container's IImportServiceRecord objects has been acquired. This call-back is only sent when the container is non-strict. The purpose of this call-back is to inform the container's owner that it should handle the acquisition of an imported service.

Typically the container's owner responds by starting to use the imported service. Just because this call-back is sent, does not mean that the container itself is fully acquired, although it might be. Use the IImportServiceRecordContainer method isAcquired() to query whether it is acquired or not.

Parameters:
container - The owned container.
record - The acquired import service record.

serviceReleased

void serviceReleased(IImportServiceRecordContainer container,
                     IImportServiceRecord record)
One of the container's IImportServiceRecord objects has been released. This call-back is only sent when the container is non-strict. The purpose of this call-back is to inform the container's owner that it should handle the release of an imported service.

Typically the container's owner responds by stopping using the imported service, although it would be equally legal for the owner to update the IImportServiceRecord object's properties and attempt to reacquire the released service.

Parameters:
container - The owned container.
record - The acquired import service record.

Service Activator Toolkit
Version 1.1.0 (20081206)