Gaudi Framework, version v20r2
	Generated: 18 Jul 2008

IConversionSvc Class Reference

#include <GaudiKernel/IConversionSvc.h>

Inheritance diagram for IConversionSvc:

[legend]Collaboration diagram for IConversionSvc:

[legend]List of all members.

---

Detailed Description

The conversion service interface allows to:

• Add, get and remove data converters from the sercvice.
• Create objects using converters: e.g. create the transient representation of a persistent object.
• convert objects - the opposite of create: e.g. convert transient objects into the persistent representation of these objects. The objects to be converted are defined by a data selector object.
• update objects which already exist: e.g. update the existing persistent representation of objects which were read from the persistent store and should be modified. The objects to be converted are defined by a data selector object.
• Class specific aspects of the creation/update/conversion mechanism must be handled by the converters, the common aspects will be handled by the service.

Author:

Markus Frank

Version:

1.2

• Version 1.2 Remove createReps, updateReps - replaced by interface IConverter

Definition at line 42 of file IConversionSvc.h.

Public Types
enum	Status { CONVERSIONSVC_NO_ERROR = ICONVERSIONSVC_LAST_ERROR+1, NO_CONVERTER }
	Status code definitions. More...
Public Member Functions
virtual StatusCode	addConverter (IConverter *pConverter)=0
	Add converter object to conversion service.
virtual StatusCode	addConverter (const CLID &clid)=0
	Add converter object to conversion service.
virtual StatusCode	removeConverter (const CLID &clid)=0
	Remove converter object from conversion service (if present).
virtual IConverter *	converter (const CLID &clid)=0
	Retrieve converter from list.
virtual StatusCode	connectOutput (const std::string &outputFile)=0
	Connect the output file to the service.
virtual StatusCode	connectOutput (const std::string &outputFile, const std::string &openMode)=0
	Connect the output file to the service with open mode.
virtual StatusCode	commitOutput (const std::string &outputFile, bool do_commit)=0
	Commit pending output.
Static Public Member Functions
static const InterfaceID &	interfaceID ()
	Retrieve interface ID.

---

Member Enumeration Documentation

enum IConversionSvc::Status

Status code definitions.

Enumerator:

CONVERSIONSVC_NO_ERROR	Success.
NO_CONVERTER	No proper converter is availible to the service.

Reimplemented from IConverter.

Definition at line 99 of file IConversionSvc.h.

               {
   CONVERSIONSVC_NO_ERROR = ICONVERSIONSVC_LAST_ERROR+1,
   NO_CONVERTER
  };

---

Member Function Documentation

static const InterfaceID& IConversionSvc::interfaceID

(

)

[inline, static]

Retrieve interface ID.

Reimplemented from IConverter.

Definition at line 45 of file IConversionSvc.h.

References IID_IConversionSvc.

{ return IID_IConversionSvc; }

virtual StatusCode IConversionSvc::addConverter

(

IConverter *

pConverter

)

[pure virtual]

Add converter object to conversion service.

Parameters:

pConverter

Pointer to converter object

Returns:

Status code indicating success or failure.

Implemented in ConversionSvc, and PersistencySvc.

Referenced by PersistencySvc::addConverter().

virtual StatusCode IConversionSvc::addConverter

(

const CLID &

clid

)

[pure virtual]

Add converter object to conversion service.

Parameters:

clid

Class ID of the converter needed

Returns:

Status code indicating success or failure.

Implemented in ConversionSvc, and PersistencySvc.

virtual StatusCode IConversionSvc::removeConverter

(

const CLID &

clid

)

[pure virtual]

Remove converter object from conversion service (if present).

The converter is defined by the class type of the objects created.

Parameters:

clid

Class ID of the converter

Returns:

Status code indicating success or failure.

Implemented in ConversionSvc, and PersistencySvc.

virtual IConverter* IConversionSvc::converter

(

const CLID &

clid

)

[pure virtual]

Retrieve converter from list.

Parameters:

clid

the clid of the converter

Returns:

the converter corresponding to clid or 0 if non wasa found

Implemented in ConversionSvc, and PersistencySvc.

virtual StatusCode IConversionSvc::connectOutput

(

const std::string &

outputFile

)

[pure virtual]

Connect the output file to the service.

Parameters:

outputFile

String containig output file

Returns:

Status code indicating success or failure.

Implemented in ConversionSvc, PoolDbCnvSvc, and PersistencySvc.

Referenced by OutputStream::writeObjects().

virtual StatusCode IConversionSvc::connectOutput	(	const std::string &	outputFile,
		const std::string &	openMode
	)			[pure virtual]

Connect the output file to the service with open mode.

Parameters:

	outputFile	String containig output file
	openMode	String containig opening mode of the output file

Returns:

Status code indicating success or failure.

Implemented in ConversionSvc, PoolDbCnvSvc, and PersistencySvc.

virtual StatusCode IConversionSvc::commitOutput	(	const std::string &	outputFile,
		bool	do_commit
	)			[pure virtual]

Commit pending output.

Parameters:

	outputFile	String containig output file
	do_commit	if true commit the output and flush eventually pending items to the database if false, discard pending buffers. Note: The possibility to commit or rollback depends on the database technology used!

Returns:

Status code indicating success or failure.

Implemented in ConversionSvc, PoolDbCnvSvc, and PersistencySvc.

Referenced by OutputStream::writeObjects().

---

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

• /afs/cern.ch/sw/Gaudi/releases/GAUDI/GAUDI_v20r2/GaudiKernel/v25r2/GaudiKernel/IConversionSvc.h

---