org.eclipse.ecf.osgi.services.distribution
Interface IDistributionConstants

public interface IDistributionConstants

Since:

1.1

Field Summary

static java.lang.String	REMOTE_CONFIGS_SUPPORTED Type: String+
static java.lang.String	REMOTE_INTENTS_SUPPORTED Type: String+
static java.lang.String	SERVICE_EXPORTED_CONFIGS Type: String+
static java.lang.String	SERVICE_EXPORTED_CONTAINER_CONNECT_CONTEXT
static java.lang.String	SERVICE_EXPORTED_CONTAINER_CONNECT_TARGET
static java.lang.String	SERVICE_EXPORTED_CONTAINER_FACTORY_ARGUMENTS
static java.lang.String	SERVICE_EXPORTED_CONTAINER_ID
static java.lang.String	SERVICE_EXPORTED_INTENTS Type: String+
static java.lang.String	SERVICE_EXPORTED_INTENTS_EXTRA Type: String+
static java.lang.String	SERVICE_EXPORTED_INTERFACES Type: String+
static java.lang.String	SERVICE_EXPORTED_INTERFACES_WILDCARD
static java.lang.String	SERVICE_IMPORTED Type: *
static java.lang.String	SERVICE_IMPORTED_CONFIGS Type: String+
static java.lang.String	SERVICE_INTENTS Type: String+
static java.lang.String	SERVICE_PID Type: String+

Field Detail

REMOTE_CONFIGS_SUPPORTED

static final java.lang.String REMOTE_CONFIGS_SUPPORTED

Type: String+

Description: Registered by the distribution provider on one of its services to indicate the supported configuration types.

See Also:

Constant Field Values

REMOTE_INTENTS_SUPPORTED

static final java.lang.String REMOTE_INTENTS_SUPPORTED

Type: String+

Description: Registered by the distribution provider on one of its services to indicate the vocabulary of implemented intent.

See Also:

Constant Field Values

SERVICE_EXPORTED_CONFIGS

static final java.lang.String SERVICE_EXPORTED_CONFIGS

Type: String+

Description: A list of configuration types that should be used to export the service. Each configuration type represents the configuration parameters for an endpoint. A distribution provider should create an endpoint for each configuration type that it supports.

See Also:

Constant Field Values

SERVICE_EXPORTED_INTENTS

static final java.lang.String SERVICE_EXPORTED_INTENTS

Type: String+

Description: A list of intents that the distribution provider must implement to distribute the service. Intents listed in this property are reserved for intents that are critical for the code to function correctly, for example, ordering of messages. These intents should not be configurable.

See Also:

Constant Field Values

SERVICE_EXPORTED_INTENTS_EXTRA

static final java.lang.String SERVICE_EXPORTED_INTENTS_EXTRA

Type: String+

Description: This property is merged with the service.exported.intents property before the distribution provider interprets the listed intents; it has therefore the same semantics but the property should be configurable so the administrator can choose the intents based on the topology. Bundles should therefore make this property configurable, for example through the Configuration Admin service.

See Also:

Constant Field Values

SERVICE_EXPORTED_INTERFACES

static final java.lang.String SERVICE_EXPORTED_INTERFACES

Type: String+

Description: Setting this property marks this service for export. It defines the interfaces under which this service can be exported. This list must be a subset of the types listed in the objectClass service property. The single value of an asterisk (’*’, *) indicates all interfaces in the registration’s objectClass property and ignore the classes. It is strongly recommended to only export interfaces and not concrete classes due to the complexity of creating proxies for some type of concrete classes.

See Also:

Constant Field Values

SERVICE_EXPORTED_INTERFACES_WILDCARD

static final java.lang.String SERVICE_EXPORTED_INTERFACES_WILDCARD

See Also:

Constant Field Values

SERVICE_IMPORTED

static final java.lang.String SERVICE_IMPORTED

Type: *

Description: Must be set by a distribution provider to any value when it registers the endpoint proxy as an imported service. A bundle can use this property to filter out imported services.

See Also:

Constant Field Values

SERVICE_IMPORTED_CONFIGS

static final java.lang.String SERVICE_IMPORTED_CONFIGS

Type: String+

Description: The configuration information used to import this service, as described in service.exported.configs. Any associated properties for this configuration types must be properly mapped to the importing system. For example, a URL in these properties must point to a valid resource when used in the importing framework. If multiple configuration types are listed in this property, then they must be synonyms for exactly the same remote endpoint that is used to export this service.

See Also:

Constant Field Values

SERVICE_INTENTS

static final java.lang.String SERVICE_INTENTS

Type: String+

Description: A list of intents that this service implements. This property has a dual purpose:

• A bundle can use this service property to notify the distribution provider that these intents are already implemented by the exported service object.
• A distribution provider must use this property to convey the combined intents of:
  • The exporting service, and
  • The intents that the exporting distribution provider adds.
  • The intents that the importing distribution provider adds.

To export a service, a distribution provider must expand any qualified intents. Both the exporting and importing distribution providers must recognize all intents before a service can be distributed.

See Also:

Constant Field Values

SERVICE_PID

static final java.lang.String SERVICE_PID

Type: String+

Description: Services that are exported should have a service.pid property. The service.pid (PID) is a unique persistent identity for the service, the PID is defined in Persistent Identifier (PID) on page 129 of the Core specification. This property enables a distribution provider to associate persistent proprietary data with a service registration.

See Also:

Constant Field Values

SERVICE_EXPORTED_CONTAINER_FACTORY_ARGUMENTS

static final java.lang.String SERVICE_EXPORTED_CONTAINER_FACTORY_ARGUMENTS

See Also:

Constant Field Values

SERVICE_EXPORTED_CONTAINER_CONNECT_TARGET

static final java.lang.String SERVICE_EXPORTED_CONTAINER_CONNECT_TARGET

See Also:

Constant Field Values

SERVICE_EXPORTED_CONTAINER_CONNECT_CONTEXT

static final java.lang.String SERVICE_EXPORTED_CONTAINER_CONNECT_CONTEXT

See Also:

Constant Field Values

SERVICE_EXPORTED_CONTAINER_ID

static final java.lang.String SERVICE_EXPORTED_CONTAINER_ID

See Also:

Constant Field Values