org.eclipse.ecf.osgi.services.remoteserviceadmin

Class AbstractHostContainerSelector

java.lang.Object

org.eclipse.ecf.osgi.services.remoteserviceadmin.AbstractContainerSelector

org.eclipse.ecf.osgi.services.remoteserviceadmin.AbstractHostContainerSelector

Direct Known Subclasses:

HostContainerSelector

public abstract class AbstractHostContainerSelector
extends AbstractContainerSelector

Abstract superclass for host container selectors...i.e. implementers of IHostContainerSelector.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.String[]	defaultConfigTypes

Fields inherited from class org.eclipse.ecf.osgi.services.remoteserviceadmin.AbstractContainerSelector

EMPTY_REMOTE_SERVICE_CONTAINER_ARRAY

Constructor Summary

Constructors

Constructor and Description
AbstractHostContainerSelector(java.lang.String[] defaultConfigTypes)

Method Summary

Modifier and Type	Method and Description
protected void	connectHostContainer(org.osgi.framework.ServiceReference serviceReference, java.util.Map<java.lang.String,java.lang.Object> properties, IContainer container, java.lang.Object target)
protected java.util.Collection	createAndConfigureHostContainers(org.osgi.framework.ServiceReference serviceReference, java.util.Map<java.lang.String,java.lang.Object> properties, java.lang.String[] serviceExportedInterfaces, java.lang.String[] requiredConfigs, java.lang.String[] requiredIntents)
protected IRemoteServiceContainer	createMatchingContainer(ContainerTypeDescription containerTypeDescription, org.osgi.framework.ServiceReference serviceReference, java.util.Map<java.lang.String,java.lang.Object> properties, java.lang.String[] serviceExportedInterfaces, java.lang.String[] requiredConfigs, java.lang.String[] requiredIntents)
protected IRemoteServiceContainer	createRSContainer(org.osgi.framework.ServiceReference serviceReference, java.util.Map<java.lang.String,java.lang.Object> properties, ContainerTypeDescription containerTypeDescription)
protected ContainerTypeDescription[]	getContainerTypeDescriptionsForDefaultConfigTypes(ContainerTypeDescription[] descriptions)
protected java.lang.String[]	getDefaultConfigTypes()
protected boolean	matchDefaultConfigTypes(java.lang.String[] defaultConfigTypes, java.lang.String[] supportedConfigTypes)
protected boolean	matchExistingHostContainer(org.osgi.framework.ServiceReference serviceReference, java.util.Map<java.lang.String,java.lang.Object> properties, IContainer container, IRemoteServiceContainerAdapter adapter, ContainerTypeDescription description, java.lang.String[] requiredConfigTypes, java.lang.String[] requiredServiceIntents)
protected boolean	matchHostContainerID(org.osgi.framework.ServiceReference serviceReference, java.util.Map<java.lang.String,java.lang.Object> properties, IContainer container)
protected boolean	matchHostContainerToConnectTarget(org.osgi.framework.ServiceReference serviceReference, java.util.Map<java.lang.String,java.lang.Object> properties, IContainer container)
protected boolean	matchHostSupportedConfigTypes(java.lang.String[] requiredConfigTypes, ContainerTypeDescription containerTypeDescription)
protected boolean	matchHostSupportedIntents(java.lang.String[] serviceRequiredIntents, ContainerTypeDescription containerTypeDescription)
protected java.util.Collection	selectExistingHostContainers(org.osgi.framework.ServiceReference serviceReference, java.util.Map<java.lang.String,java.lang.Object> overridingProperties, java.lang.String[] serviceExportedInterfaces, java.lang.String[] serviceExportedConfigs, java.lang.String[] serviceIntents)

Methods inherited from class org.eclipse.ecf.osgi.services.remoteserviceadmin.AbstractContainerSelector

connectContainer, createConnectContext, createContainer, createTargetID, disconnectContainer, getContainerFactory, getContainerFactoryArguments, getContainerManager, getContainers, getContainerTypeDescription, getContainerTypeDescriptions, getRemoteServiceContainers, getSupportedConfigTypes, getSupportedIntents, hasRemoteServiceContainerAdapter, includeContainerWithConnectNamespace, logError, logError, logException, logWarning, matchConnectNamespace, matchContainerID, trace, traceException

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

defaultConfigTypes

protected java.lang.String[] defaultConfigTypes

Constructor Detail

AbstractHostContainerSelector

public AbstractHostContainerSelector(java.lang.String[] defaultConfigTypes)

Method Detail

selectExistingHostContainers

protected java.util.Collection selectExistingHostContainers(org.osgi.framework.ServiceReference serviceReference,
                                                            java.util.Map<java.lang.String,java.lang.Object> overridingProperties,
                                                            java.lang.String[] serviceExportedInterfaces,
                                                            java.lang.String[] serviceExportedConfigs,
                                                            java.lang.String[] serviceIntents)

Parameters:

serviceReference - service reference

overridingProperties - overriding properties

serviceExportedInterfaces - service exported interfaces to select for

serviceExportedConfigs - service exported configs to select for

serviceIntents - service exported intents to select for

Returns:

Collection of existing host containers

Since:

2.0

matchHostContainerToConnectTarget

protected boolean matchHostContainerToConnectTarget(org.osgi.framework.ServiceReference serviceReference,
                                                    java.util.Map<java.lang.String,java.lang.Object> properties,
                                                    IContainer container)

Parameters:

serviceReference - serviceReference

properties - properties

container - container to match

Returns:

boolean true if match false otherwise

Since:

2.0

matchExistingHostContainer

protected boolean matchExistingHostContainer(org.osgi.framework.ServiceReference serviceReference,
                                             java.util.Map<java.lang.String,java.lang.Object> properties,
                                             IContainer container,
                                             IRemoteServiceContainerAdapter adapter,
                                             ContainerTypeDescription description,
                                             java.lang.String[] requiredConfigTypes,
                                             java.lang.String[] requiredServiceIntents)

Parameters:

serviceReference - service reference

properties - properties

container - container

adapter - remote service container adapter

description - container type description

requiredConfigTypes - required config types

requiredServiceIntents - required service intents

Returns:

boolean true if match, false otherwise

Since:

2.0

matchHostContainerID

protected boolean matchHostContainerID(org.osgi.framework.ServiceReference serviceReference,
                                       java.util.Map<java.lang.String,java.lang.Object> properties,
                                       IContainer container)

Parameters:

serviceReference - serviceReference

properties - properties

container - container

Returns:

boolean true if match, false otherwise

Since:

2.0

matchHostSupportedConfigTypes

protected boolean matchHostSupportedConfigTypes(java.lang.String[] requiredConfigTypes,
                                                ContainerTypeDescription containerTypeDescription)

Parameters:

requiredConfigTypes - request config types

containerTypeDescription - container type description

Returns:

boolean true if match, false otherwise

createAndConfigureHostContainers

protected java.util.Collection createAndConfigureHostContainers(org.osgi.framework.ServiceReference serviceReference,
                                                                java.util.Map<java.lang.String,java.lang.Object> properties,
                                                                java.lang.String[] serviceExportedInterfaces,
                                                                java.lang.String[] requiredConfigs,
                                                                java.lang.String[] requiredIntents)
                                                         throws SelectContainerException

Parameters:

serviceReference - service reference

properties - overriding properties

serviceExportedInterfaces - service exported interfaces to select for

requiredConfigs - service exported configs to select for

requiredIntents - intents to select for

Returns:

Collection of host containers

Throws:

SelectContainerException - if container cannot be created or configured

Since:

2.0

getContainerTypeDescriptionsForDefaultConfigTypes

protected ContainerTypeDescription[] getContainerTypeDescriptionsForDefaultConfigTypes(ContainerTypeDescription[] descriptions)

matchDefaultConfigTypes

protected boolean matchDefaultConfigTypes(java.lang.String[] defaultConfigTypes,
                                          java.lang.String[] supportedConfigTypes)

getDefaultConfigTypes

protected java.lang.String[] getDefaultConfigTypes()

createMatchingContainer

protected IRemoteServiceContainer createMatchingContainer(ContainerTypeDescription containerTypeDescription,
                                                          org.osgi.framework.ServiceReference serviceReference,
                                                          java.util.Map<java.lang.String,java.lang.Object> properties,
                                                          java.lang.String[] serviceExportedInterfaces,
                                                          java.lang.String[] requiredConfigs,
                                                          java.lang.String[] requiredIntents)
                                                   throws SelectContainerException

Parameters:

containerTypeDescription - containerTypeDescription

serviceReference - reference

properties - properties

serviceExportedInterfaces - exported interfaces

requiredConfigs - configs

requiredIntents - intents

Returns:

IRemoteServiceContainer matching container created

Throws:

SelectContainerException - container cannot be created or selected

Since:

2.0

createRSContainer

protected IRemoteServiceContainer createRSContainer(org.osgi.framework.ServiceReference serviceReference,
                                                    java.util.Map<java.lang.String,java.lang.Object> properties,
                                                    ContainerTypeDescription containerTypeDescription)
                                             throws SelectContainerException

Parameters:

serviceReference - serviceReference

properties - properties

containerTypeDescription - container type description

Returns:

IRemoteServiceContainer created remote service container

Throws:

SelectContainerException - if could not be created

Since:

2.0

connectHostContainer

protected void connectHostContainer(org.osgi.framework.ServiceReference serviceReference,
                                    java.util.Map<java.lang.String,java.lang.Object> properties,
                                    IContainer container,
                                    java.lang.Object target)
                             throws ContainerConnectException,
                                    IDCreateException

Parameters:

serviceReference - service reference

properties - properties

container - container

target - target

Throws:

ContainerConnectException - if container cannot be connected

IDCreateException - thrown if ID cannot be created

Since:

2.0

matchHostSupportedIntents

protected boolean matchHostSupportedIntents(java.lang.String[] serviceRequiredIntents,
                                            ContainerTypeDescription containerTypeDescription)