In This Package:

IConverter Class Reference

The data converters are reposible to translate data from one representation into another. More...

#include <GaudiKernel/IConverter.h>

Inheritance diagram for IConverter:

[legend]Collaboration diagram for IConverter:[legend]List of all members.


Public Types
	INVALID_ADDRESS = IInterface::LAST_ERROR+1
	Invalid address information.
	INVALID_OBJECT
	Object to be converted is invalid.
	NO_MEMORY
	No more memory availible.
	BAD_STORAGE_TYPE
	Invalid storage type.
	NO_SOURCE_OBJECT
	Error retrieving source data from source store.
	ICONVERSIONSVC_LAST_ERROR
	Last entry.
enum	Status { INVALID_ADDRESS = IInterface::LAST_ERROR+1, INVALID_OBJECT, NO_MEMORY, BAD_STORAGE_TYPE, NO_SOURCE_OBJECT, ICONVERSIONSVC_LAST_ERROR }
	Status code. More...
	SUCCESS = 1
	Normal successful completion.
	NO_INTERFACE
	Requested interface is not available.
	VERSMISMATCH
	Requested interface version is incompatible.
	LAST_ERROR
	Last error.
Public Member Functions
virtual StatusCode	initialize ()=0
	Initialize the converter.
virtual StatusCode	finalize ()=0
	Terminate the converter.
virtual const CLID &	objType () const =0
	Retrieve the class type of objects the converter produces.
virtual long	repSvcType () const =0
	Retrieve the class type of the data store the converter uses.
virtual StatusCode	setDataProvider (IDataProviderSvc *pService)=0
	Set Data provider service.
virtual IDataProviderSvc *	dataProvider () const =0
	Get Data provider service.
virtual StatusCode	setConversionSvc (IConversionSvc *pService)=0
	Set conversion service the converter is connected to.
virtual IConversionSvc *	conversionSvc () const =0
	Get conversion service the converter is connected to.
virtual StatusCode	setAddressCreator (IAddressCreator *creator)=0
	Set address creator facility.
virtual IAddressCreator *	addressCreator () const =0
	Get address creation interface needed to resolve links between objects.
virtual StatusCode	createObj (IOpaqueAddress pAddress, DataObject &refpObject)=0
	Create the transient representation of an object.
virtual StatusCode	fillObjRefs (IOpaqueAddress pAddress, DataObject pObject)=0
	Resolve the references of the created transient object.
virtual StatusCode	updateObj (IOpaqueAddress pAddress, DataObject refpObject)=0
	Update the transient object from the other representation.
virtual StatusCode	updateObjRefs (IOpaqueAddress pAddress, DataObject pObject)=0
	Update the references of an updated transient object.
virtual StatusCode	createRep (DataObject pObject, IOpaqueAddress &refpAddress)=0
	Convert the transient object to the requested representation.
virtual StatusCode	fillRepRefs (IOpaqueAddress pAddress, DataObject pObject)=0
	Resolve the references of the converted object.
virtual StatusCode	updateRep (IOpaqueAddress pAddress, DataObject pObject)=0
	Update the converted representation of a transient object.
virtual StatusCode	updateRepRefs (IOpaqueAddress pAddress, DataObject pObject)=0
	Update the references of an already converted object.
virtual StatusCode	queryInterface (const InterfaceID &riid, void **ppvInterface)=0
	Query interfaces of Interface.
virtual unsigned long	addRef ()=0
	Increment the reference count of Interface instance.
virtual unsigned long	release ()=0
	Release Interface instance.
Static Public Member Functions
static const InterfaceID &	interfaceID ()
	Retrieve interface ID.

Detailed Description

The data converters are reposible to translate data from one representation into another.

Concrete examples are e.g. converters creating transient objects representing parts of an event from the persistent (and disk based) representations. Converters will have to deal with the technology both representations are based on: in the upper example they have to know about the database internals as well as the structure of the transient representations. The converters know about the mechanism to retrieve persistent objects (ZEBRA, Objectivity, ) and only pass abstract instances of the converted objects, hence shielding the calling service from internals.

Data converters are meant to be light. This means there should not be all-in-one converters, which are able to convert the "world", but rather many converters. Each converter is then able to create a representation of a given type.

In order to function a converter must be able to

Answer (when asked) which kind of representation the converter is able to create.
Retrieve the source object from the source store.
Create the requested representation using the information contained in the source object.
Inform the registry entry of the created object that the object is now loaded.
This registry entry is located in the data store which is supposed to manage the requested object.
Register all leafs of the created object with the data store which is supposed to manage the requested object. Registering does not mean to create these representations, but rather to inform about the existence.

The interface should cover the entry points of concrete converter instances in order to serve conversion requests.

Author:: Markus Frank

Version:: 1.0

Definition at line 61 of file IConverter.h.

Member Enumeration Documentation

enum IConverter::Status

Status code.

Enumerator:

INVALID_ADDRESS	Invalid address information.
INVALID_OBJECT	Object to be converted is invalid.
NO_MEMORY	No more memory availible.
BAD_STORAGE_TYPE	Invalid storage type.
NO_SOURCE_OBJECT	Error retrieving source data from source store.
ICONVERSIONSVC_LAST_ERROR	Last entry.

Reimplemented from IInterface.

Reimplemented in IConversionSvc.

Definition at line 204 of file IConverter.h.

00204               {
00206     INVALID_ADDRESS = IInterface::LAST_ERROR+1,
00208     INVALID_OBJECT,
00210     NO_MEMORY,
00212     BAD_STORAGE_TYPE,
00214     NO_SOURCE_OBJECT,
00216     ICONVERSIONSVC_LAST_ERROR
00217   };

Member Function Documentation

static const InterfaceID& IConverter::interfaceID ( ) [inline, static]

Retrieve interface ID.

Reimplemented from IInterface.

Reimplemented in IConversionSvc.

Definition at line 64 of file IConverter.h.

00064 { return IID_IConverter; }

virtual StatusCode IConverter::initialize ( ) [pure virtual]

Initialize the converter.

Returns:: Status code indicating success or failure

Exceptions:

exception

(STL standard) in case of fatal errors

Implemented in ConversionSvc, and Converter.

virtual StatusCode IConverter::finalize ( ) [pure virtual]

Terminate the converter.

Returns:: Status code indicating success or failure

Exceptions:

exception

(STL standard) in case of fatal errors

Implemented in ConversionSvc, and Converter.

virtual const CLID& IConverter::objType ( ) const [pure virtual]

Retrieve the class type of objects the converter produces.

Returns:: Class type of the created object.

Implemented in ConversionSvc, and Converter.

virtual long IConverter::repSvcType ( ) const [pure virtual]

Retrieve the class type of the data store the converter uses.

Returns:: Class type information about the source data store type the converter will use to retrieve the information.

Implemented in ConversionSvc.

virtual StatusCode IConverter::setDataProvider ( IDataProviderSvc * pService ) [pure virtual]

Set Data provider service.

Returns:: Status code indicating success or failure

Parameters:

pService

Pointer to data provider service

Implemented in ConversionSvc, and Converter.

virtual IDataProviderSvc* IConverter::dataProvider ( ) const [pure virtual]

Get Data provider service.

Returns:: Pointer to data provider service

Implemented in ConversionSvc, and Converter.

virtual StatusCode IConverter::setConversionSvc ( IConversionSvc * pService ) [pure virtual]

Set conversion service the converter is connected to.

Returns:: Status code indicating success or failure

Parameters:

pService

Pointer to IConversionSvc interface

Implemented in ConversionSvc, and Converter.

virtual IConversionSvc* IConverter::conversionSvc ( ) const [pure virtual]

Get conversion service the converter is connected to.

Returns:: Pointer to IConversionSvc interface

Implemented in ConversionSvc, and Converter.

virtual StatusCode IConverter::setAddressCreator ( IAddressCreator * creator ) [pure virtual]

Set address creator facility.

Parameters:

creator

Reference to address creator interface

Returns:: Status code indicating success or failure.

Implemented in ConversionSvc, and Converter.

virtual IAddressCreator* IConverter::addressCreator ( ) const [pure virtual]

Get address creation interface needed to resolve links between objects.

Returns:: Pointer to IAddressCreator interface

Implemented in ConversionSvc, and Converter.

virtual StatusCode IConverter::createObj	(	IOpaqueAddress *	pAddress,
		DataObject *&	refpObject
	)			`[pure virtual]`

Create the transient representation of an object.

The transient representation is created by loading the persistent object using the source information contained in the address.

Returns:: Status code indicating success or failure

Parameters:

	pAddress	Opaque address information to retrieve the requested object from the store in order to produce the transient object.
	refpObject	Reference to location of pointer of the created object.

Implemented in ConversionSvc, and Converter.

virtual StatusCode IConverter::fillObjRefs	(	IOpaqueAddress *	pAddress,
		DataObject *	pObject
	)			`[pure virtual]`

Resolve the references of the created transient object.

After the object creation references of the objects pointing to objects outside its scope will have to be filled. The actual objects will not be loaded, but the recipe to load them will be present.

Returns:: Status code indicating success or failure

Parameters:

	pAddress	Opaque address information to retrieve the requested object from the store.
	pObject	Pointer to location of the object

Implemented in ConversionSvc, and Converter.

virtual StatusCode IConverter::updateObj	(	IOpaqueAddress *	pAddress,
		DataObject *	refpObject
	)			`[pure virtual]`

Update the transient object from the other representation.

The transient representation will be updated by loading the persistent object using the source information contained in the address and then refill transient data.

Returns:: Status code indicating success or failure

Parameters:

	pAddress	Opaque address information to retrieve the requested object from the store.
	pObject	Pointer to the object to be updated.

Implemented in ConversionSvc, and Converter.

virtual StatusCode IConverter::updateObjRefs	(	IOpaqueAddress *	pAddress,
		DataObject *	pObject
	)			`[pure virtual]`

Update the references of an updated transient object.

After the object was updated alse the references of the objects pointing to objects outside its scope will have to be filled. The actual pointers to objects will only be filled if already present. Otherwise only the recipe to load them will be present.

Returns:: Status code indicating success or failure

Parameters:

	pAddress	Opaque address information to retrieve the requested object from the store.
	pObject	Pointer to location of the object

Implemented in ConversionSvc, and Converter.

virtual StatusCode IConverter::createRep	(	DataObject *	pObject,
		IOpaqueAddress *&	refpAddress
	)			`[pure virtual]`

Convert the transient object to the requested representation.

e.g. conversion to persistent objects.

Returns:: Status code indicating success or failure

Parameters:

	pObject	Pointer to location of the object
	refpAddress	Reference to location of pointer with the object address.

Implemented in ConversionSvc, and Converter.

virtual StatusCode IConverter::fillRepRefs	(	IOpaqueAddress *	pAddress,
		DataObject *	pObject
	)			`[pure virtual]`

Resolve the references of the converted object.

After the requested representation was created the references in this representation must be resolved.

Returns:: Status code indicating success or failure

Parameters:

pObject

Pointer to location of the object

Implemented in ConversionSvc, and Converter.

virtual StatusCode IConverter::updateRep	(	IOpaqueAddress *	pAddress,
		DataObject *	pObject
	)			`[pure virtual]`

Update the converted representation of a transient object.

Returns:: Status code indicating success or failure

Parameters:

	pObject	Pointer to location of the object
	refpAddress	Reference to location of pointer with the object address.

Implemented in ConversionSvc, and Converter.

virtual StatusCode IConverter::updateRepRefs	(	IOpaqueAddress *	pAddress,
		DataObject *	pObject
	)			`[pure virtual]`

Update the references of an already converted object.

The object must be retrieved before it can be updated.

Returns:: Status code indicating success or failure

Parameters:

	pAddress	Pointer to location of object address with the store.
	pObject	Pointer to location of the object

Implemented in ConversionSvc, and Converter.

virtual StatusCode IInterface::queryInterface	(	const InterfaceID &	riid,
		void **	ppvInterface
	)			`[pure virtual, inherited]`

Query interfaces of Interface.

Parameters:

	riid	ID of Interface to be retrieved
	ppvInterface	Pointer to Location for interface pointer

Implemented in Algorithm, AlgTool, Auditor, ConversionSvc, Converter, DataSvc, EventSelectorDataStream, MinimalEventLoopMgr, PropertyMgr, SelectStatement, and Service.

virtual unsigned long IInterface::addRef ( ) [pure virtual, inherited]

Increment the reference count of Interface instance.

Implemented in Algorithm, AlgTool, Auditor, Converter, EventSelectorDataStream, IFactory, PropertyMgr, SelectStatement, and Service.

virtual unsigned long IInterface::release ( ) [pure virtual, inherited]

Release Interface instance.

Implemented in Algorithm, AlgTool, Auditor, Converter, EventSelectorDataStream, IFactory, PropertyMgr, SelectStatement, and Service.

The documentation for this class was generated from the following file:

/home/dayabay/installs/trunk_2011_04_11_opt/NuWa-trunk/gaudi/GaudiKernel/GaudiKernel/IConverter.h

Generated on Mon Apr 11 19:57:08 2011 for GaudiKernel by 1.4.7

In This Package:

IConverter Class Reference

Public Types

Public Member Functions

Static Public Member Functions

Detailed Description

Member Enumeration Documentation

Member Function Documentation