com.prosyst.mprm.gateway.provisioning
Interface ProvisioningInfoProvider

public interface ProvisioningInfoProvider

Provides a set (can be empty) of configuration properties used by the Initial Provisioning Bundle. The properties obtained by the providers become part of the Provisioning Dictionary. Arbitrary number of Configuration Loaders could be registered as services in the OSGi framework. Different providers could export different set of configuration properties. If a property is provided by more than one provider, the Provisioning Bundle uses this one, which is exported by a provider with the higher service ranking.

Author:

Avgustin Marinov, e-mail: a_marinov@prosyst.bg

Field Summary

static java.lang.String	GM_HOST This property specifies the host of the Gateway Manager that mPRM management agent bundle must connect to.
static java.lang.String	MANAGER_URL This property specifies URL for connecting to the mPRM Management Server.
static java.lang.String	PROVIDERS This manifest header determines the packed into the provisioning agent bundle providers that are to be started.

Method Summary

java.lang.Object	get(java.lang.Object propertyKey) Gets a property with a supplied key from the provider.
java.util.Dictionary	init(ProvisioningService prvSrv) Initializes provider.

Field Detail

MANAGER_URL

static final java.lang.String MANAGER_URL

This property specifies URL for connecting to the mPRM Management Server.

See Also:

Constant Field Values

GM_HOST

static final java.lang.String GM_HOST

This property specifies the host of the Gateway Manager that mPRM management agent bundle must connect to. If this property is not present in the dictionary, then mPRM bundle will listen for a back end device to push this information to.

See Also:

Constant Field Values

PROVIDERS

static final java.lang.String PROVIDERS

This manifest header determines the packed into the provisioning agent bundle providers that are to be started.

See Also:

Constant Field Values

Method Detail

init

java.util.Dictionary init(ProvisioningService prvSrv)
                          throws java.lang.Exception

Initializes provider. Give to the provider a reference to ProvisioningService dictionary. Provider can return properties that are to be set properties in the provisioning dictionary. It is not necessary for provider to insert explicitly a property unless it has to be listed through the Dictionary.keys() method or it evokes action (as ProvisioningService.PROVISIONIN_REFERENCE).

Parameters:

prvSrv - provisioning service reference

Returns:

the initial data. It can be null.

Throws:

java.lang.Exception - on initialization error

get

java.lang.Object get(java.lang.Object propertyKey)

Gets a property with a supplied key from the provider. This method is invoked by the Provisioning Agent when Dictionary.get(propertyKey) is invoked for a propertyKey which is not already stored in the ProvisioningDictionary. The method is invoked subsequently on all registered providers ordered by service ranking until some of them returns value different from null.

Parameters:

propertyKey - the key.

Returns:

the property value or null if there is no such property.