it.uniroma2.art.coda.provisioning

Interface ComponentProvider

public interface ComponentProvider

A Component Provider provisions the PEARL execution engine with the converters necessary to support the execution of a PEARL document. Currently, the provisioning interface only supports global policies, in which a dependency is bound to a converter irrespectively of the context in which it is mentioned. Therefore, it is possible for a component provider to cache previous resolutions, and always return the same object for successive requests concenring the same URI.

Author:

Manuel Fiorelli

Method Summary

Modifier and Type	Method and Description
void	close() Releases the resources associated with this component provider.
Collection<ConverterContractDescription>	listConverterContracts() Returns the descriptions of the currently known converter contracts.
Collection<ConverterDescription>	listConverters() Returns the description of the currently known converters.
Object	lookup(String dependencyURI) Looks up a suitable converter to satisfy the dependency expressed via the given URI.
void	open() Activates this component provider so that lookup and other operations can be invoked.
void	setGlobalContractBinding(String contractURI, String converterURI) Binds a dependency URI (which is assumed to denote a contract) to a given converter.

Method Detail

open

void open()

Activates this component provider so that lookup and other operations can be invoked.

lookup

Object lookup(String dependencyURI)
       throws ComponentProvisioningException

Looks up a suitable converter to satisfy the dependency expressed via the given URI.

Parameters:

dependencyURI - the URI identifies the required dependency

Returns:

a converter object to be bound to the dependency

Throws:

ComponentProvisioningException

setGlobalContractBinding

void setGlobalContractBinding(String contractURI,
                              String converterURI)

Binds a dependency URI (which is assumed to denote a contract) to a given converter.

Parameters:

contractURI -

converterURI -

listConverterContracts

Collection<ConverterContractDescription> listConverterContracts()

Returns the descriptions of the currently known converter contracts.

Returns:

listConverters

Collection<ConverterDescription> listConverters()

Returns the description of the currently known converters.

Returns:

close

void close()

Releases the resources associated with this component provider.