Service Activator Toolkit
Version 1.1.0 (20081206)

org.eclipse.soda.sat.core.record.interfaces
Interface IImportServiceRecordOwner


public interface IImportServiceRecordOwner

When an IImportServiceRecord is created it must have an owner to handle call-back notifications. The IImportServiceRecordOwner interface declares the role of an import service record's owner:

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


Method Summary
 Object getLock()
          Get the owner's lock.
 void serviceAcquired(IImportServiceRecord record)
          An imported service has been acquired.
 void serviceReleased(IImportServiceRecord record)
          An imported service has been released.
 

Method Detail

getLock

Object getLock()
Get the owner's lock. This method is used by an IImportServiceRecord to get access to an object for which a lock must be held before doing such things as acquiring and releasing itself. This method was added to ensure that lock ordering was maintained between an IImportServiceRecord and its IImportServiceRecordContainer. See bug 245021.

Returns:
Object

serviceAcquired

void serviceAcquired(IImportServiceRecord record)
An imported service has been acquired. The owner typically starts using an imported service once it has been acquired.

Parameters:
record - The import service record of the acquired service.

serviceReleased

void serviceReleased(IImportServiceRecord record)
An imported service has been released. The owner must stop using an imported service once it has been released.

When an imported service has been released the IImportServiceRecordOwner might consider changing the import service record's filter by calling the IImportServiceRecord method setFilter(Filter).

Parameters:
record - The import service record of the released service.
See Also:
IImportServiceRecord.setFilter(org.osgi.framework.Filter)

Service Activator Toolkit
Version 1.1.0 (20081206)