Base class for all conversion services. More...

#include <GaudiKernel/ConversionSvc.h>

Inheritance diagram for ConversionSvc:

Collaboration diagram for ConversionSvc:

Classes
class	CnvTest

class	WorkerEntry

Public Types
typedef std::vector< WorkerEntry >	Workers

Public Types inherited from extends2< Service, IConversionSvc, IAddressCreator >
typedef extends2	base_class
	Typedef to this class. More...

typedef extend_interfaces2 < IConversionSvc, IAddressCreator >	extend_interfaces_base
	Typedef to the base of this class. More...

typedef extend_interfaces_base::ext_iids	interfaces
	MPL set of all the implemented interfaces. More...

Public Types inherited from Service
typedef Gaudi::PluginService::Factory2 < IService , const std::string &, ISvcLocator >	Factory

Public Types inherited from CommonMessaging< implements3< IService, IProperty, IStateful > >
typedef CommonMessaging	base_class

Public Types inherited from implements3< IService, IProperty, IStateful >
typedef implements3	base_class
	Typedef to this class. More...

typedef extend_interfaces3 < IService, IProperty, IStateful >	extend_interfaces_base
	Typedef to the base of this class. More...

typedef extend_interfaces_base::ext_iids	interfaces
	MPL set of all the implemented interfaces. More...

Public Types inherited from extend_interfaces3< IService, IProperty, IStateful >
typedef mpl::fold< typename IService::iid::iids::type, typename mpl::fold< typename IProperty::iid::iids::type, typename IStateful::iid::iids::type, mpl::insert< mpl::_1, mpl::_2 > >::type, mpl::insert< mpl::_1, mpl::_2 > >::type	ext_iids
	MPL set of interfaces extended by this one. More...

Public Types inherited from IInterface
enum	Status { SUCCESS = 1, NO_INTERFACE, VERSMISMATCH, LAST_ERROR }
	Return status. More...

typedef Gaudi::InterfaceId < IInterface, 0, 0 >	iid
	Interface ID. More...

typedef mpl::set1< iid >	ext_iids
	Extra interfaces. More...

Public Types inherited from extend_interfaces2< IConversionSvc, IAddressCreator >
typedef mpl::fold< typename IConversionSvc::iid::iids::type, typename IAddressCreator::iid::iids::type, mpl::insert< mpl::_1, mpl::_2 > >::type	ext_iids
	MPL set of interfaces extended by this one. More...

Public Types inherited from IConversionSvc
enum	Status { CONVERSIONSVC_NO_ERROR = ICONVERSIONSVC_LAST_ERROR+1, NO_CONVERTER }
	Status code definitions. More...

Public Types inherited from IConverter
enum	Status { INVALID_ADDRESS = IInterface::LAST_ERROR+1, INVALID_OBJECT, NO_MEMORY, BAD_STORAGE_TYPE, NO_SOURCE_OBJECT, ICONVERSIONSVC_LAST_ERROR }
	Status code. More...

Public Member Functions
virtual StatusCode	initialize ()
	Initialize the service. More...

virtual StatusCode	finalize ()
	stop the service. More...

virtual long	repSvcType () const
	Retrieve the class type of the data store the converter uses. More...

const CLID &	objType () const
	Implementation of IConverter: dummy call. More...

virtual StatusCode	setDataProvider (IDataProviderSvc *pService)
	Implementation of IConverter: Set Data provider service. More...

virtual SmartIF < IDataProviderSvc > &	dataProvider () const
	Implementation of IConverter: Get Data provider service. More...

virtual StatusCode	setConversionSvc (IConversionSvc *svc)
	Implementation of IConverter: Set conversion service the converter is connected to. More...

virtual SmartIF< IConversionSvc > &	conversionSvc () const
	Implementation of IConverter: Get conversion service the converter is connected to. More...

virtual StatusCode	setAddressCreator (IAddressCreator *creator)
	Set address creator facility. More...

virtual SmartIF < IAddressCreator > &	addressCreator () const
	Retrieve address creator facility. More...

virtual StatusCode	createObj (IOpaqueAddress pAddress, DataObject &refpObject)
	Implementation of IConverter: Create the transient representation of an object. More...

virtual StatusCode	fillObjRefs (IOpaqueAddress pAddress, DataObject pObject)
	Implementation of IConverter: Resolve the references of the created transient object. More...

virtual StatusCode	updateObj (IOpaqueAddress pAddress, DataObject refpObject)
	Implementation of IConverter: Update the transient object from the other representation. More...

virtual StatusCode	updateObjRefs (IOpaqueAddress pAddress, DataObject pObject)
	Implementation of IConverter: Update the references of an updated transient object. More...

virtual StatusCode	createRep (DataObject pObject, IOpaqueAddress &refpAddress)
	Implementation of IConverter: Convert the transient object to the requested representation. More...

virtual StatusCode	fillRepRefs (IOpaqueAddress pAddress, DataObject pObject)
	Implementation of IConverter: Resolve the references of the converted object. More...

virtual StatusCode	updateRep (IOpaqueAddress pAddress, DataObject pObject)
	Implementation of IConverter: Update the converted representation of a transient object. More...

virtual StatusCode	updateRepRefs (IOpaqueAddress pAddress, DataObject pObject)
	Implementation of IConverter: Update the references of an already converted object. More...

virtual StatusCode	addConverter (const CLID &clid)
	Add converter object to conversion service. More...

virtual StatusCode	addConverter (IConverter *pConverter)
	Add converter object to conversion service. More...

virtual StatusCode	removeConverter (const CLID &clid)
	Remove converter object from conversion service (if present). More...

virtual IConverter *	converter (const CLID &wanted)
	Retrieve converter from list. More...

virtual StatusCode	connectOutput (const std::string &outputFile, const std::string &openMode)
	Connect the output file to the service with open mode. More...

virtual StatusCode	connectOutput (const std::string &output)
	Connect the output file to the service. More...

virtual StatusCode	commitOutput (const std::string &output, bool do_commit)
	Commit pending output. More...

virtual StatusCode	createAddress (long svc_type, const CLID &clid, const std::string par, const unsigned long ip, IOpaqueAddress *&refpAddress)
	Create a Generic address using explicit arguments to identify a single object. More...

virtual StatusCode	convertAddress (const IOpaqueAddress *pAddress, std::string &refAddress)
	Convert an address to string form. More...

virtual StatusCode	createAddress (long svc_type, const CLID &clid, const std::string &refAddress, IOpaqueAddress *&refpAddress)
	Convert an address in string form to object form. More...

virtual StatusCode	updateServiceState (IOpaqueAddress *pAddress)
	Update state of the service. More...

	ConversionSvc (const std::string &name, ISvcLocator *svc, long type)
	Standard Constructor. More...

Public Member Functions inherited from extends2< Service, IConversionSvc, IAddressCreator >
	extends2 (A1 a1, A2 a2, A3 a3)
	Templated constructor with 3 arguments. More...

	extends2 (A1 a1, A2 a2)
	Templated constructor with 2 arguments. More...

	extends2 (A1 a1)
	Templated constructor with 1 argument. More...

	extends2 ()
	Default constructor. More...

virtual void *	i_cast (const InterfaceID &tid) const
	Implementation of IInterface::i_cast. More...

virtual StatusCode	queryInterface (const InterfaceID &ti, void **pp)
	Implementation of IInterface::queryInterface. More...

virtual std::vector< std::string >	getInterfaceNames () const
	Implementation of IInterface::getInterfaceNames. More...

virtual	~extends2 ()
	Virtual destructor. More...

Public Member Functions inherited from Service
virtual unsigned long	release ()
	Release Interface instance. More...

virtual const std::string &	name () const
	Retrieve name of the service. More...

virtual StatusCode	configure ()
	Configuration (from OFFLINE to CONFIGURED). More...

virtual StatusCode	start ()
	Start (from INITIALIZED to RUNNING). More...

virtual StatusCode	stop ()
	Stop (from RUNNING to INITIALIZED). More...

virtual StatusCode	terminate ()
	Initialization (from CONFIGURED to OFFLINE). More...

virtual Gaudi::StateMachine::State	FSMState () const
	Get the current state. More...

virtual Gaudi::StateMachine::State	targetFSMState () const
	When we are in the middle of a transition, get the state where the transition is leading us. More...

virtual StatusCode	reinitialize ()
	Initialization (from INITIALIZED or RUNNING to INITIALIZED, via CONFIGURED). More...

virtual StatusCode	restart ()
	Initialization (from RUNNING to RUNNING, via INITIALIZED). More...

virtual StatusCode	sysInitialize ()
	Initialize Service. More...

virtual StatusCode	sysStart ()
	Initialize Service. More...

virtual StatusCode	sysStop ()
	Initialize Service. More...

virtual StatusCode	sysFinalize ()
	Finalize Service. More...

virtual StatusCode	sysReinitialize ()
	Re-initialize the Service. More...

virtual StatusCode	sysRestart ()
	Re-initialize the Service. More...

virtual StatusCode	setProperty (const Property &p)
	Set the property by property. More...

virtual StatusCode	setProperty (const std::string &s)
	Set the property by string. More...

virtual StatusCode	setProperty (const std::string &n, const std::string &v)
	Set the property by std::string. More...

virtual StatusCode	getProperty (Property *p) const
	Get the property by property. More...

virtual const Property &	getProperty (const std::string &name) const
	Get the property by name. More...

virtual StatusCode	getProperty (const std::string &n, std::string &v) const
	Get the property by std::string. More...

virtual const std::vector < Property * > &	getProperties () const
	Get list of properties. More...

template<class TYPE >
StatusCode	setProperty (const std::string &name, const TYPE &value)
	set the property form the value More...

	Service (const std::string &name, ISvcLocator *svcloc)
	Standard Constructor. More...

SmartIF< ISvcLocator > &	serviceLocator () const
	Retrieve pointer to service locator. More...

StatusCode	setProperties ()
	Method for setting declared properties to the values specified for the job. More...

template<class T >
StatusCode	service (const std::string &name, const T *&psvc, bool createIf=true) const
	Access a service by name, creating it if it doesn't already exist. More...

template<class T >
StatusCode	service (const std::string &name, T *&psvc, bool createIf=true) const

template<class T >
StatusCode	service (const std::string &svcType, const std::string &svcName, T *&psvc) const
	Access a service by name and type, creating it if it doesn't already exist. More...

template<class T >
Property *	declareProperty (const std::string &name, T &property, const std::string &doc="none") const
	Declare the named property. More...

Property *	declareRemoteProperty (const std::string &name, IProperty *rsvc, const std::string &rname="") const
	Declare remote named properties. More...

SmartIF< IAuditorSvc > &	auditorSvc () const
	The standard auditor service.May not be invoked before sysInitialize() has been invoked. More...

Public Member Functions inherited from CommonMessaging< implements3< IService, IProperty, IStateful > >
	CommonMessaging (const A1 &a1, const A2 &a2, const A3 &a3)
	Templated constructor with 3 arguments. More...

	CommonMessaging (const A1 &a1, const A2 &a2)
	Templated constructor with 2 arguments. More...

	CommonMessaging (const A1 &a1)
	Templated constructor with 1 argument. More...

	CommonMessaging ()
	Default constructor. More...

virtual	~CommonMessaging ()
	Virtual destructor. More...

SmartIF< IMessageSvc > &	msgSvc () const
	The standard message service. More...

MsgStream &	msgStream () const
	Return an uninitialized MsgStream. More...

MsgStream &	msgStream (const MSG::Level level) const
	Predefined configurable message stream for the efficient printouts. More...

MsgStream &	always () const
	shortcut for the method msgStream(MSG::ALWAYS) More...

MsgStream &	fatal () const
	shortcut for the method msgStream(MSG::FATAL) More...

MsgStream &	err () const
	shortcut for the method msgStream(MSG::ERROR) More...

MsgStream &	error () const
	shortcut for the method msgStream(MSG::ERROR) More...

MsgStream &	warning () const
	shortcut for the method msgStream(MSG::WARNING) More...

MsgStream &	info () const
	shortcut for the method msgStream(MSG::INFO) More...

MsgStream &	debug () const
	shortcut for the method msgStream(MSG::DEBUG) More...

MsgStream &	verbose () const
	shortcut for the method msgStream(MSG::VERBOSE) More...

MsgStream &	msg () const
	shortcut for the method msgStream(MSG::INFO) More...

MSG::Level	msgLevel () const
	get the output level from the embedded MsgStream More...

bool	msgLevel (MSG::Level lvl) const
	get the output level from the embedded MsgStream More...

Public Member Functions inherited from extend_interfaces3< IService, IProperty, IStateful >
virtual	~extend_interfaces3 ()
	Virtual destructor. More...

Public Member Functions inherited from IService
	DeclareInterfaceID (IService, 3, 0)
	InterfaceID. More...

virtual	~IService ()
	virtual destructor More...

Public Member Functions inherited from INamedInterface
	DeclareInterfaceID (INamedInterface, 1, 0)
	InterfaceID. More...

virtual	~INamedInterface ()
	Virtual destructor (always needed for abstract classes). More...

Public Member Functions inherited from IInterface
virtual unsigned long	addRef ()=0
	Increment the reference count of Interface instance. More...

virtual unsigned long	refCount () const =0
	Current reference count. More...

virtual	~IInterface ()
	Virtual destructor. More...

Public Member Functions inherited from IProperty
	DeclareInterfaceID (IProperty, 2, 0)
	InterfaceID. More...

Public Member Functions inherited from IStateful
	DeclareInterfaceID (IStateful, 1, 0)
	InterfaceID. More...

virtual	~IStateful ()

Public Member Functions inherited from extend_interfaces2< IConversionSvc, IAddressCreator >
virtual	~extend_interfaces2 ()
	Virtual destructor. More...

Public Member Functions inherited from IConversionSvc
	DeclareInterfaceID (IConversionSvc, 4, 0)
	InterfaceID. More...

virtual	~IConversionSvc ()
	Virtual destructor. More...

Public Member Functions inherited from IConverter
	DeclareInterfaceID (IConverter, 3, 0)
	InterfaceID. More...

virtual	~IConverter ()
	Virtual destructor. More...

Public Member Functions inherited from IAddressCreator
	DeclareInterfaceID (IAddressCreator, 3, 0)
	InterfaceID. More...

Protected Member Functions
virtual	~ConversionSvc ()
	Standard Destructor. More...

virtual IConverter *	createConverter (long typ, const CLID &clid, const ICnvFactory *fac)
	Create new Converter using factory. More...

virtual StatusCode	configureConverter (long typ, const CLID &clid, IConverter *cnv)
	Configure the new converter before initialize is called. More...

virtual StatusCode	initializeConverter (long typ, const CLID &clid, IConverter *cnv)
	Initialize the new converter. More...

virtual StatusCode	activateConverter (long typ, const CLID &clid, IConverter *cnv)
	Activate the new converter after initialization. More...

virtual void	loadConverter (DataObject *pObject)
	Load converter or dictionary needed by the converter. More...

virtual SmartIF < IAddressCreator > &	addressCreator ()
	Retrieve address creation interface. More...

StatusCode	makeCall (int typ, bool ignore_add, bool ignore_obj, bool update, IOpaqueAddress &pAddress, DataObject &pObject)

Protected Member Functions inherited from Service
virtual	~Service ()
	Standard Destructor. More...

int	outputLevel () const
	get the `Service's` output level More...

Protected Member Functions inherited from CommonMessaging< implements3< IService, IProperty, IStateful > >
void	updateMsgStreamOutputLevel (int level)
	Update the output level of the cached MsgStream. More...

Protected Attributes
SmartIF< IDataProviderSvc >	m_dataSvc
	Pointer to data provider service. More...

SmartIF< IAddressCreator >	m_addressCreator
	Pointer to the address creation service interface. More...

SmartIF< IConversionSvc >	m_cnvSvc
	Pointer to the IConversionSvc interface of this. More...

long	m_type
	Conversion service type. More...

Workers *	m_workers
	List of conversion workers. More...

Protected Attributes inherited from Service
IntegerProperty	m_outputLevel
	Service output level. More...

Gaudi::StateMachine::State	m_state
	Service state. More...

Gaudi::StateMachine::State	m_targetState
	Service state. More...

Protected Attributes inherited from CommonMessaging< implements3< IService, IProperty, IStateful > >
SmartIF< IMessageSvc >	m_msgsvc
	Pointer to the message service;. More...

std::auto_ptr< MsgStream >	m_msgStream
	The predefined message stream. More...

bool	m_streamWithService
	Flag to create a new MsgStream if it was created without the message service. More...

Private Member Functions
	ConversionSvc (const ConversionSvc &)
	Fake copy constructor (never implemented). More...

ConversionSvc &	operator= (const ConversionSvc &)
	Fake assignment operator (never implemented). More...

Additional Inherited Members
Static Public Member Functions inherited from IInterface
static const InterfaceID &	interfaceID ()
	Return an instance of InterfaceID identifying the interface. More...

Detailed Description

Base class for all conversion services.

It manages a set of Converters that are specialized for conversions of specific objects.

This supports self learning converters: User hooks include the following (overridable) entries:

findCnvFactory: returns a suitable converter factory
createConverter: the actual convetrer creation
configureConverter: configure converter before initialize
initializeConverter: initializes the converter
activateConverter: any additional configuration to be done after initialize.

configureConverter and activateConverter are user hooks, where the convetrer can be manipulated by the hosting service and knowledge can be supplied, which a "generic" converter cannot aquire itself.

These hooks allow any sub-classed conversion service to override the calls and create converters, which aquire the knowledge about their persistency type and the object type they convert during the initialization.

Only AFTER these three steps the converter must satisfy the storage type of the hosting service and the class type of the required object type.

Author: Markus Frank

Version: 1.0

Definition at line 47 of file ConversionSvc.h.

Member Typedef Documentation

typedef std::vector<WorkerEntry> ConversionSvc::Workers

Definition at line 75 of file ConversionSvc.h.

Constructor & Destructor Documentation

ConversionSvc::ConversionSvc	(	const std::string &	name,
		ISvcLocator *	svc,
		long	type
	)

Standard Constructor.

Definition at line 404 of file ConversionSvc.cpp.

  : base_class(name, svc),
    m_cnvSvc(static_cast<IConversionSvc*>(this))
 {
   m_type            = type;
   m_dataSvc         = 0;
   m_workers = new Workers();
   setAddressCreator(this).ignore();
 }

ConversionSvc::~ConversionSvc ( )

protectedvirtual

Standard Destructor.

Definition at line 415 of file ConversionSvc.cpp.

                                 {
   // Release all workers.
   for ( Workers::iterator i = m_workers->begin(); i != m_workers->end(); i++ )    {
     (*i).converter()->release();
   }
   m_workers->erase(m_workers->begin(), m_workers->end() );
   delete m_workers;
 }

ConversionSvc::ConversionSvc ( const ConversionSvc & )

private

Fake copy constructor (never implemented).

Member Function Documentation

StatusCode ConversionSvc::activateConverter	(	long	typ,
		const CLID &	clid,
		IConverter *	cnv
	)

protectedvirtual

Activate the new converter after initialization.

Activate the freshly created converter.

Definition at line 340 of file ConversionSvc.cpp.

                                                                        {
   if ( 0 != pConverter )    {
     return StatusCode::SUCCESS;
   }
   return NO_CONVERTER;
 }

StatusCode ConversionSvc::addConverter ( const CLID & clid )

virtual

Add converter object to conversion service.

Implements IConversionSvc.

Definition at line 221 of file ConversionSvc.cpp.

                                                         {
   // First look for the more specific converter
   long typ = repSvcType();
   IConverter* pConverter = createConverter(typ, clid, 0);
   if ( 0 != pConverter )    {
     StatusCode status = configureConverter( typ, clid, pConverter );
     if ( status.isSuccess() )   {
       status = initializeConverter( typ, clid, pConverter );
       if ( status.isSuccess() )   {
         status = activateConverter( typ, clid, pConverter );
         if ( status.isSuccess() )   {
           long conv_typ  = pConverter->repSvcType();
           const CLID&   conv_clid = pConverter->objType();
           typ      = (typ<0xFF) ? typ : typ&0xFFFFFF00;
           conv_typ = (conv_typ<0xFF) ? conv_typ : conv_typ&0xFFFFFF00;
           if ( conv_typ == typ && conv_clid == clid )   {
             return addConverter(pConverter);
           }
         }
       }
     }
     pConverter->release();
   }
   return NO_CONVERTER;
 }

StatusCode ConversionSvc::addConverter ( IConverter * pConverter )

virtual

Add converter object to conversion service.

Implements IConversionSvc.

Definition at line 248 of file ConversionSvc.cpp.

                                                                 {
   if ( 0 != pConverter )    {
     const CLID& clid = pConverter->objType();
     removeConverter(clid).ignore();
     m_workers->push_back(WorkerEntry(clid, pConverter));
     pConverter->addRef();
     return StatusCode::SUCCESS;
   }
   return NO_CONVERTER;
 }

SmartIF< IAddressCreator > & ConversionSvc::addressCreator ( ) const

virtual

Retrieve address creator facility.

Access the transient store.

Implements IConverter.

Definition at line 206 of file ConversionSvc.cpp.

                                                                  {
   return m_addressCreator;
 }

virtual SmartIF<IAddressCreator>& ConversionSvc::addressCreator ( )

inlineprotectedvirtual

Retrieve address creation interface.

Definition at line 216 of file ConversionSvc.h.

                                                        {
     return m_addressCreator;
   }

StatusCode ConversionSvc::commitOutput	(	const std::string &	output,
		bool	do_commit
	)

virtual

Commit pending output.

Implements IConversionSvc.

Reimplemented in Gaudi::RootCnvSvc.

Definition at line 371 of file ConversionSvc.cpp.

                                                                {
   return StatusCode::SUCCESS;
 }

StatusCode ConversionSvc::configureConverter	(	long	typ,
		const CLID &	clid,
		IConverter *	cnv
	)

protectedvirtual

Configure the new converter before initialize is called.

Configure the freshly created converter.

Definition at line 317 of file ConversionSvc.cpp.

                                                                          {
   if ( 0 != pConverter )    {
     pConverter->setConversionSvc(this).ignore();
     pConverter->setAddressCreator(m_addressCreator).ignore();
     pConverter->setDataProvider(m_dataSvc).ignore();
     return StatusCode::SUCCESS;
   }
   return NO_CONVERTER;
 }

StatusCode ConversionSvc::connectOutput	(	const std::string &	outputFile,
		const std::string &	openMode
	)

virtual

Connect the output file to the service with open mode.

Implements IConversionSvc.

Reimplemented in Gaudi::RootCnvSvc.

Definition at line 360 of file ConversionSvc.cpp.

                                                             {
   return connectOutput(outputFile);
 }

StatusCode ConversionSvc::connectOutput ( const std::string & output )

virtual

Connect the output file to the service.

Implements IConversionSvc.

Reimplemented in Gaudi::RootCnvSvc.

Definition at line 366 of file ConversionSvc.cpp.

                                                           {
   return StatusCode::SUCCESS;
 }

SmartIF< IConversionSvc > & ConversionSvc::conversionSvc ( ) const

virtual

Implementation of IConverter: Get conversion service the converter is connected to.

Get conversion service the converter is connected to.

Implements IConverter.

Definition at line 216 of file ConversionSvc.cpp.

                                                                  {
   return m_cnvSvc;
 }

StatusCode ConversionSvc::convertAddress	(	const IOpaqueAddress *	pAddress,
		std::string &	refAddress
	)

virtual

Convert an address to string form.

Implements IAddressCreator.

Definition at line 386 of file ConversionSvc.cpp.

 {
   refAddress = "";
   return StatusCode::FAILURE;
 }

IConverter * ConversionSvc::converter ( const CLID & wanted )

virtual

Retrieve converter from list.

Implements IConversionSvc.

Definition at line 145 of file ConversionSvc.cpp.

                                                          {
   IConverter* cnv = 0;
   Workers::iterator i = std::find_if(m_workers->begin(),m_workers->end(),CnvTest(clid));
   if ( i != m_workers->end() )      {
     cnv = (*i).converter();
   }
   if ( 0 == cnv )     {
     StatusCode status = addConverter(clid);
     if ( status.isSuccess() )   {
       i = std::find_if(m_workers->begin(),m_workers->end(),CnvTest(clid));
       if ( i != m_workers->end() )      {
         cnv = (*i).converter();
       }
     }
   }
   return cnv;
 }

StatusCode ConversionSvc::createAddress	(	long	svc_type,
		const CLID &	clid,
		const std::string *	par,
		const unsigned long *	ip,
		IOpaqueAddress *&	refpAddress
	)

virtual

Create a Generic address using explicit arguments to identify a single object.

Implements IAddressCreator.

Reimplemented in Gaudi::RootCnvSvc.

Definition at line 376 of file ConversionSvc.cpp.

                                                                          {
   refpAddress = 0;
   return StatusCode::FAILURE;
 }

StatusCode ConversionSvc::createAddress	(	long	svc_type,
		const CLID &	clid,
		const std::string &	refAddress,
		IOpaqueAddress *&	refpAddress
	)

virtual

Convert an address in string form to object form.

Implements IAddressCreator.

Reimplemented in Gaudi::RootCnvSvc.

Definition at line 394 of file ConversionSvc.cpp.

 {
   refpAddress = 0;
   return StatusCode::FAILURE;
 }

IConverter * ConversionSvc::createConverter	(	long	typ,
		const CLID &	clid,
		const ICnvFactory *	fac
	)

protectedvirtual

Create new Converter using factory.

Reimplemented in Gaudi::RootCnvSvc.

Definition at line 304 of file ConversionSvc.cpp.

                                                                    {
   IConverter* pConverter;
   pConverter = Converter::Factory::create(ConverterID(typ,clid), serviceLocator().get());
   if ( 0 == pConverter )  {
     typ = (typ<0xFF) ? typ : typ&0xFFFFFF00;
     pConverter = Converter::Factory::create(ConverterID(typ,clid), serviceLocator().get());
   }
   return pConverter;
 }

StatusCode ConversionSvc::createObj	(	IOpaqueAddress *	pAddress,
		DataObject *&	refpObject
	)

virtual

Implementation of IConverter: Create the transient representation of an object.

Create the transient representation of an object.

Implements IConverter.

Definition at line 105 of file ConversionSvc.cpp.

                                                                                     {
   return makeCall(CREATE_OBJ, false, true, false, pAddress, refpObj);
 }

StatusCode ConversionSvc::createRep	(	DataObject *	pObject,
		IOpaqueAddress *&	refpAddress
	)

virtual

Implementation of IConverter: Convert the transient object to the requested representation.

Convert the transient object to the requested representation.

Implements IConverter.

Reimplemented in RootHistCnv::PersSvc.

Definition at line 125 of file ConversionSvc.cpp.

                                                                                    {
   return makeCall(CREATE_REP, true, false, false, refpAddress, pObj);
 }

SmartIF< IDataProviderSvc > & ConversionSvc::dataProvider ( ) const

virtual

Implementation of IConverter: Get Data provider service.

Access the transient store.

Returns: Pointer to data provider service

Implements IConverter.

Definition at line 184 of file ConversionSvc.cpp.

                                                                 {
   return m_dataSvc;
 }

StatusCode ConversionSvc::fillObjRefs	(	IOpaqueAddress *	pAddress,
		DataObject *	pObject
	)

virtual

Implementation of IConverter: Resolve the references of the created transient object.

Resolve the references of the created transient object.

Implements IConverter.

Definition at line 110 of file ConversionSvc.cpp.

                                                                                    {
   return makeCall(FILL_OBJ_REFS, false, true, true, pAddress, pObj);
 }

StatusCode ConversionSvc::fillRepRefs	(	IOpaqueAddress *	pAddress,
		DataObject *	pObject
	)

virtual

Implementation of IConverter: Resolve the references of the converted object.

Resolve the references of the converted object.

Implements IConverter.

Definition at line 130 of file ConversionSvc.cpp.

                                                                                  {
   return makeCall(FILL_REP_REFS, true, false, false, pAddress, pObj);
 }

StatusCode ConversionSvc::finalize ( )

virtual

stop the service.

Reimplemented from Service.

Reimplemented in Gaudi::RootCnvSvc, and RootHistCnv::PersSvc.

Definition at line 285 of file ConversionSvc.cpp.

                                         {
   // Release all workers.
   MsgStream log(msgSvc(), name());
   for ( Workers::iterator i = m_workers->begin(); i != m_workers->end(); i++ )    {
     if ( (*i).converter()->finalize().isFailure() ) {
       log << MSG::ERROR << "finalizing worker" << endmsg;
     }
     (*i).converter()->release();
   }
   m_workers->erase(m_workers->begin(), m_workers->end() );
   // release interfaces
   m_addressCreator = 0;
   m_dataSvc = 0;
   m_cnvSvc = 0;
   return Service::finalize();
 }

StatusCode ConversionSvc::initialize ( )

virtual

Initialize the service.

Reimplemented from Service.

Reimplemented in Gaudi::RootCnvSvc, and RootHistCnv::PersSvc.

Definition at line 279 of file ConversionSvc.cpp.

                                          {
   StatusCode status = Service::initialize();
   return status;
 }

StatusCode ConversionSvc::initializeConverter	(	long	typ,
		const CLID &	clid,
		IConverter *	cnv
	)

protectedvirtual

Initialize the new converter.

Initialize new converter.

Definition at line 330 of file ConversionSvc.cpp.

                                                                          {
   if ( pConverter )    {
     return pConverter->initialize();
   }
   return NO_CONVERTER;
 }

void ConversionSvc::loadConverter ( DataObject * pObject )

protectedvirtual

Load converter or dictionary needed by the converter.

Reimplemented in Gaudi::RootCnvSvc.

Definition at line 96 of file ConversionSvc.cpp.

                                              {
 
 }

StatusCode ConversionSvc::makeCall	(	int	typ,
		bool	ignore_add,
		bool	ignore_obj,
		bool	update,
		IOpaqueAddress *&	pAddress,
		DataObject *&	pObject
	)

protected

Definition at line 24 of file ConversionSvc.cpp.

                                                               {
   if ( 0 != pAddress || ignore_add )    {
     if ( 0 != pObject  || ignore_obj )    {
       const CLID&  obj_class =
         (0 != pObject && !ignore_obj) ? pObject->clID()
         : (0 != pAddress && !ignore_add)
         ? pAddress->clID()
         : CLID_NULL;
       IConverter*  cnv  = converter(obj_class);
       if ( !cnv && pObject ) {
         //Give it a try to autoload the class (dictionary) for which the converter is needed
         loadConverter( pObject);
         cnv  = converter(obj_class);
       }
 
       StatusCode status(StatusCode::FAILURE,true);
       if ( 0 != cnv )   {
         switch(typ)   {
         case CREATE_OBJ:
           pObject = 0;
           status = cnv->createObj(pAddress, pObject);
           break;
         case FILL_OBJ_REFS:
           status = cnv->fillObjRefs(pAddress, pObject);
           break;
         case UPDATE_OBJ:
           status = cnv->updateObj(pAddress, pObject);
           break;
         case UPDATE_OBJ_REFS:
           status = cnv->updateObjRefs(pAddress, pObject);
           break;
         case CREATE_REP:
           pAddress = 0;
           status = cnv->createRep(pObject, pAddress);
           break;
         case FILL_REP_REFS:
           status = cnv->fillRepRefs(pAddress, pObject);
           break;
         case UPDATE_REP:
           status = cnv->updateRep(pAddress, pObject);
           break;
         case UPDATE_REP_REFS:
           status = cnv->updateRepRefs(pAddress, pObject);
           break;
         default:
           status = StatusCode::FAILURE;
           break;
         }
         if ( status.isSuccess() && update )   {
           status = updateServiceState(pAddress);
         }
         return status;
       }
       status.ignore();
       MsgStream log(msgSvc(), name());
       log << MSG::INFO << "No converter for object ";
       if ( pObject != 0 )   {
         log << System::typeinfoName(typeid(*pObject));
       }
       log << "  CLID= " << obj_class << endmsg;
       return NO_CONVERTER;
     }
     return INVALID_OBJECT;
   }
   return INVALID_ADDRESS;
 }

const CLID & ConversionSvc::objType ( ) const

virtual

Implementation of IConverter: dummy call.

Retrieve the class type of objects the converter produces.

Implements IConverter.

Definition at line 350 of file ConversionSvc.cpp.

                                             {
   return CLID_NULL;
 }

ConversionSvc& ConversionSvc::operator= ( const ConversionSvc & )

private

Fake assignment operator (never implemented).

StatusCode ConversionSvc::removeConverter ( const CLID & clid )

virtual

Remove converter object from conversion service (if present).

Implements IConversionSvc.

Definition at line 260 of file ConversionSvc.cpp.

                                                            {
   CnvTest test(clid);
   Workers::iterator stop  = m_workers->end();
   Workers::iterator start = m_workers->begin();
   for(Workers::iterator i=start; i != stop; i++ )    {
     if ( test( *i ) )   {
       (*i).converter()->finalize().ignore();
       (*i).converter()->release();
     }
   }
   Workers::iterator j = std::remove_if(start, stop, test);
   if ( j != stop )  {
     m_workers->erase(j, stop);
     return StatusCode::SUCCESS;
   }
   return NO_CONVERTER;
 }

long ConversionSvc::repSvcType ( ) const

virtual

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

Implements IConverter.

Definition at line 355 of file ConversionSvc.cpp.

                                      {
   return m_type;
 }

StatusCode ConversionSvc::setAddressCreator ( IAddressCreator * creator )

virtual

Set address creator facility.

Implements IConverter.

Definition at line 189 of file ConversionSvc.cpp.

                                                                       {
   m_addressCreator = creator;
   Workers::iterator stop  = m_workers->end();
   Workers::iterator start = m_workers->begin();
   for(Workers::iterator i=start; i != stop; i++ )    {
     IConverter* cnv = (*i).converter();
     if ( 0 != cnv )   {
       if (cnv->setAddressCreator(m_addressCreator).isFailure()) {
     MsgStream log(msgSvc(), name());
     log << MSG::ERROR << "setting Address Creator"  << endmsg;
       }
     }
   }
   return StatusCode::SUCCESS;
 }

StatusCode ConversionSvc::setConversionSvc ( IConversionSvc * svc )

virtual

Implementation of IConverter: Set conversion service the converter is connected to.

Set conversion service the converter is connected to.

Implements IConverter.

Definition at line 211 of file ConversionSvc.cpp.

                                                               {
   return StatusCode::FAILURE;
 }

StatusCode ConversionSvc::setDataProvider ( IDataProviderSvc * pService )

virtual

Implementation of IConverter: Set Data provider service.

Define transient data store.

Returns: Status code indicating success or failure

Parameters

pService Pointer to data provider service

Implements IConverter.

Definition at line 164 of file ConversionSvc.cpp.

                                                                        {
   if ( !pDataSvc ) return StatusCode::SUCCESS; //Atlas does not use DataSvc
   if ( m_dataSvc ) m_dataSvc->release();
   m_dataSvc = pDataSvc;
   m_dataSvc->addRef();
   Workers::iterator stop  = m_workers->end();
   Workers::iterator start = m_workers->begin();
   for(Workers::iterator i=start; i != stop; i++ )    {
     IConverter* cnv = (*i).converter();
     if ( 0 != cnv )   {
       if (cnv->setDataProvider(m_dataSvc).isFailure()) {
         MsgStream log(msgSvc(), name());
         log << MSG::ERROR << "setting Data Provider" << endmsg;
       }
     }
   }
   return StatusCode::SUCCESS;
 }

StatusCode ConversionSvc::updateObj	(	IOpaqueAddress *	pAddress,
		DataObject *	refpObject
	)

virtual

Implementation of IConverter: Update the transient object from the other representation.

Update the transient object from the other representation.

Implements IConverter.

Definition at line 115 of file ConversionSvc.cpp.

                                                                                 {
   return makeCall(UPDATE_OBJ, false, true, false, pAddress, pObj);
 }

StatusCode ConversionSvc::updateObjRefs	(	IOpaqueAddress *	pAddress,
		DataObject *	pObject
	)

virtual

Implementation of IConverter: Update the references of an updated transient object.

Update the references of an updated transient object.

Implements IConverter.

Definition at line 120 of file ConversionSvc.cpp.

                                                                                    {
   return makeCall(UPDATE_OBJ_REFS, false, true, true, pAddress, pObj);
 }

StatusCode ConversionSvc::updateRep	(	IOpaqueAddress *	pAddress,
		DataObject *	pObject
	)

virtual

Implementation of IConverter: Update the converted representation of a transient object.

Update the converted representation of a transient object.

Implements IConverter.

Definition at line 135 of file ConversionSvc.cpp.

                                                                                {
   return makeCall(UPDATE_REP, true, false, false, pAddress, pObj);
 }

StatusCode ConversionSvc::updateRepRefs	(	IOpaqueAddress *	pAddress,
		DataObject *	pObject
	)

virtual

Implementation of IConverter: Update the references of an already converted object.

Update the references of an already converted object.

Implements IConverter.

Definition at line 140 of file ConversionSvc.cpp.

                                                                                      {
   return makeCall(UPDATE_REP_REFS, true, false, false, pAddress, pObj);
 }

StatusCode ConversionSvc::updateServiceState ( IOpaqueAddress * pAddress )

virtual

Update state of the service.

Reimplemented in Gaudi::RootCnvSvc.

Definition at line 100 of file ConversionSvc.cpp.

                                                                 {
   return StatusCode::SUCCESS;
 }

Member Data Documentation

SmartIF<IAddressCreator> ConversionSvc::m_addressCreator

mutableprotected

Pointer to the address creation service interface.

Definition at line 231 of file ConversionSvc.h.

SmartIF<IConversionSvc> ConversionSvc::m_cnvSvc

mutableprotected

Pointer to the IConversionSvc interface of this.

Definition at line 233 of file ConversionSvc.h.

SmartIF<IDataProviderSvc> ConversionSvc::m_dataSvc

mutableprotected

Pointer to data provider service.

Definition at line 229 of file ConversionSvc.h.

long ConversionSvc::m_type

protected

Conversion service type.

Definition at line 235 of file ConversionSvc.h.

Workers* ConversionSvc::m_workers

protected

List of conversion workers.

Definition at line 237 of file ConversionSvc.h.

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

GaudiKernel/GaudiKernel/ConversionSvc.h
GaudiKernel/src/Lib/ConversionSvc.cpp

Classes

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Private Member Functions

Additional Inherited Members

Detailed Description

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation