Service Activator Toolkit
Version 1.1.0 (20081206)

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

All Superinterfaces:
IServiceRecordContainer

public interface IImportServiceRecordContainer
extends IServiceRecordContainer

The IImportServiceRecordContainer interface declares the API for import service record containers. The following responsibilities are declared:

Note: Since this abstraction is used internally by the SAT bundle this interface is typically not used directly by bundle developers. For cases where subclassing the BaseBundleActivator is not appropriate, instances of this interface can be created using the FactoryUtility class.


Method Summary
 void acquire()
          Acquire all the contained import service records.
 boolean add(IImportServiceRecord record)
          Add an import service record to the container.
 String[] getUnacquiredServiceNames()
          Get the names of the services that have not been acquired.
 IImportServiceRecord getWithFilter(String name, Filter filter)
          Get the record from the container with the matching service name and filter.
 void release()
          Releases the container's import service records.
 boolean remove(IImportServiceRecord record)
          Remove an import service record from the container.
 void setOwner(IImportServiceRecordContainerOwner owner)
          Set the container's owner.
 
Methods inherited from interface org.eclipse.soda.sat.core.record.container.interfaces.IServiceRecordContainer
contains, doForEach, empty, get, get, getAll, getAll, isEmpty, removeAll, size
 

Method Detail

acquire

void acquire()
Acquire all the contained import service records.


add

boolean add(IImportServiceRecord record)
Add an import service record to the container.

Parameters:
record - The import service record to add.
Returns:
True if the record was added, otherwise false.

getUnacquiredServiceNames

String[] getUnacquiredServiceNames()
Get the names of the services that have not been acquired.

Returns:
The names of the services that have not been acquired.

getWithFilter

IImportServiceRecord getWithFilter(String name,
                                   Filter filter)
Get the record from the container with the matching service name and filter.

Parameters:
name - The name of a service.
filter - An LDP filter.
Returns:
The record matching the specified service name and filter, or null if no match is found.

release

void release()
Releases the container's import service records.


remove

boolean remove(IImportServiceRecord record)
Remove an import service record from the container. Once removed, an acquired record is released.

Parameters:
record - The import service record to remove.
Returns:
True if the record was removed, otherwise false.

setOwner

void setOwner(IImportServiceRecordContainerOwner owner)
Set the container's owner.

Parameters:
owner - The container's owner.

Service Activator Toolkit
Version 1.1.0 (20081206)