Technical Services Interfaces
This pages lists definitions of technical service interfaces.
Next WebLab Version
TODO: This part has to be completed. Define a service interface relying on Query to process services data.
TODO: This part has to be completed. Explain use cases of a Query compliant service interface to deal with removal.
It might be a good idea to have an exemple by type of service:
- knowledge repository
WebLab 1.2.5 /1.2.8
The Cleanable interface defines the operation clean that allows the service consumer to remove existing resource that are stored by the requested service. These resources are designated by their URI and can be related to a particular usage context.
The Auditable interface defines the operation report that allows the service consumer to get a summary information about the service execution. The generated report is represented by a PoK within a set of RDF properties (to be defined and or customised per project) and it can be related to a particular usage context.
There is currently one project that has use this interface. The processing (Analyser) service on that project were quite long since we where dealing with Image processing. This interface was used by the portal to get the status of each processing service. The properties were something like: number of successfully processed document, min/mean/max processing time per document, number of errors, currently processed document.
We decided to remove the Source Reader service interface since as far as we know, no more service is using this interface. For a replacement, see Queue Manager interface. Even the QueueManager interface is not usd any more. We are now mainly relying on the Karaf+Camel to dequeue documents from JMS/ActiveMQ queues and then start the processing. All our data sources are integrated as Karaf/Camel components that enqueue quite empty documents (like they were outputted from
This interface has evolved into two distinct service interfaces:
This technical service interface offers 3 methods for
- reporting information about data stored ;
- dropping all data linked to a context and
- deleting a specific resource.
Repositories (ie ResourceContainer) and search engines (ie Indexer) should expose such interface. Generally, all service that may store data should implement it too. This interface provides a common data management board that conforms with legal constraints applied with data storage.
- WSDL: http://jira.ow2.org/secure/attachment/10379/DataOperator.wsdl
- XSD: http://jira.ow2.org/secure/attachment/10380/DataOperatorTypes.xsd
- Discussion on this interface: http://jira.ow2.org/browse/WEBLAB-257