class IConversionSvc : public IInterface

IDataProviderSvc interface definition

Inheritance:


Public

Interface calls
virtual StatusCode initialze() throw(exception)
Initialize the service
virtual StatusCode stop() throw(exception)
stop the service
virtual StatusCode createObject(IOpaqueAddress* pAddress, DataObject*& pObject) throw(exception)
Create a transient representation from another representation of this object
virtual StatusCode updateObjects(IDataSelector* pSelector) throw(exception)
Update the original representation of a collection of transient objects
virtual StatusCode convertObjects(IDataSelector* pSelector) throw(exception)
Convert a collection of transient data objects into another representation
Interface Specific stuff
enum Status
Status code definitions
NO_ERROR
Success
NO_CONVERTER
No proper converter is availible to the service
NO_MEMORY
Cannot fulfill the request due to lack of memory

Documentation

IDataProviderSvc interface definition.

System: The LHCb Offline System

Package: DataProviderSvc

The conversion service interface allows to:

Dependencies: History:
+---------+----------------------------------------------+---------+
|    Date |                 Comment                      | Who     |
+---------+----------------------------------------------+---------+
| 3/11/98 | Initial version                              | M.Frank |
+---------+----------------------------------------------+---------+
Interface calls

virtual StatusCode initialze() throw(exception)
Initialize the service. After the initialisation the service is active and able to accept data conversion requests.
Throws:
exception (Standard STL) on occurence of fatal errors.
Returns:
Status code indicating success or failure.

virtual StatusCode stop() throw(exception)
stop the service. Once the service is stopped, requests will be rejected. However, the service can be reinitialized and reactivated.
Throws:
exception (Standard STL) on occurence of fatal errors.
Returns:
Status code indicating success or failure.

virtual StatusCode createObject(IOpaqueAddress* pAddress, DataObject*& pObject) throw(exception)
Create a transient representation from another representation of this object. This entrypoint is used e.g. for the creation of a transient object from its persistent representation. The information how to retrieve the object from the persistent store is passed in an opaque manner, hence shielding the service from the underlying technology.
Throws:
exception (Standard STL) on occurence of fatal errors.
Returns:
Status code indicating success or failure.
Parameters:
pAddress - Pointer to opaque address of the object: e.g. the ooRef in case of objectivity
refpObject - Reference to pointer where the created transient object will be returned.

virtual StatusCode updateObjects(IDataSelector* pSelector) throw(exception)
Update the original representation of a collection of transient objects. This entrypoint is used e.g. for the update of a persistent objects from their transient representation. The transient representation of the object must have been created by the service before it can be updated. The selector indicates to the service which objects will have to be updated.
Throws:
exception (Standard STL) on occurence of fatal errors.
Returns:
Status code indicating success or failure.
Parameters:
pSelector - Pointer to DataSelector structure.

virtual StatusCode convertObjects(IDataSelector* pSelector) throw(exception)
Convert a collection of transient data objects into another representation. This entrypoint is used e.g. for the creation of a persistent objects from their transient representation. The selector indicates to the service which objects will have to be updated.
Throws:
exception (Standard STL) on occurence of fatal errors.
Returns:
Status code indicating success or failure.
Parameters:
pSelector - Pointer to DataSelector structure.

Interface Specific stuff

enum Status
Status code definitions

NO_ERROR
Success

NO_CONVERTER
No proper converter is availible to the service

NO_MEMORY
Cannot fulfill the request due to lack of memory


This class has no child classes.
Author:
Markus Frank
Version:
1.0


The New Software