#include <GaudiKernel/Converter.h>

Inheritance diagram for Converter:

[legend]

Collaboration diagram for Converter:

[legend]

Public Types
using	Factory = Gaudi::PluginService::Factory< IConverter (ISvcLocator )>

Public Types inherited from implements< IConverter >
using	base_class = implements< Interfaces... >
	Typedef to this class. More...

using	extend_interfaces_base = extend_interfaces< Interfaces... >
	Typedef to the base of this class. More...

using	iids = typename extend_interfaces_base::ext_iids

Public Types inherited from extend_interfaces< Interfaces... >
using	ext_iids = typename Gaudi::interface_list_cat< typename Interfaces::ext_iids... >::type
	take union of the ext_iids of all Interfaces... More...

Public Member Functions
StatusCode	initialize () override
	Initialize the converter. More...

StatusCode	finalize () override
	Initialize the converter. More...

StatusCode	setDataProvider (IDataProviderSvc *svc) override
	Set Data provider service. More...

SmartIF< IDataProviderSvc > &	dataProvider () const override
	Get Data provider service. More...

StatusCode	setConversionSvc (IConversionSvc *svc) override
	Set conversion service the converter is connected to. More...

SmartIF< IConversionSvc > &	conversionSvc () const override
	Get conversion service the converter is connected to. More...

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

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

const CLID &	objType () const override
	Retrieve the class type of objects the converter produces. More...

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

StatusCode	createObj (IOpaqueAddress pAddress, DataObject &refpObject) override
	Create the transient representation of an object. More...

StatusCode	fillObjRefs (IOpaqueAddress pAddress, DataObject pObject) override
	Resolve the references of the created transient object. More...

StatusCode	updateObj (IOpaqueAddress pAddress, DataObject refpObject) override
	Update the transient object from the other representation. More...

StatusCode	updateObjRefs (IOpaqueAddress pAddress, DataObject pObject) override
	Update the references of an updated transient object. More...

StatusCode	createRep (DataObject pObject, IOpaqueAddress &refpAddress) override
	Convert the transient object to the requested representation. More...

StatusCode	fillRepRefs (IOpaqueAddress pAddress, DataObject pObject) override
	Resolve the references of the converted object. More...

StatusCode	updateRep (IOpaqueAddress pAddress, DataObject pObject) override
	Update the converted representation of a transient object. More...

StatusCode	updateRepRefs (IOpaqueAddress pAddress, DataObject pObject) override
	Update the references of an already converted object. More...

	Converter (long storage_type, const CLID &class_type, ISvcLocator *svc=0)
	Standard Constructor. More...

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

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

SmartIF< IService >	service (const std::string &name, const bool createIf=true) const
	Return a pointer to the service identified by name (or "type/name") More...

Public Member Functions inherited from implements< IConverter >
void *	i_cast (const InterfaceID &tid) const override
	Implementation of IInterface::i_cast. More...

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

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

	implements ()=default
	Default constructor. More...

	implements (const implements &)
	Copy constructor (zero the reference count) More...

implements &	operator= (const implements &)
	Assignment operator (do not touch the reference count). More...

unsigned long	addRef () override
	Reference Interface instance More...

unsigned long	release () override
	Release Interface instance More...

unsigned long	refCount () const override
	Current reference count More...

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

SmartIF< IMessageSvc > &	msgSvc () const
	Retrieve pointer to message service. More...

SmartIF< IDataManagerSvc > &	dataManager () const
	Get Data Manager service. More...

Private Member Functions
StatusCode	service_i (const std::string &svcName, bool createIf, const InterfaceID &iid, void **ppSvc) const
	implementation of legacy service method More...

StatusCode	service_i (const std::string &svcType, const std::string &svcName, const InterfaceID &iid, void **ppSvc) const

Private Attributes
long	m_storageType
	Storage type. More...

const CLID	m_classType
	Class type the converter can handle. More...

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

SmartIF< IDataProviderSvc >	m_dataProvider
	Pointer to data provider service. More...

SmartIF< IDataManagerSvc >	m_dataManager
	Pointer to data manager service. More...

SmartIF< IConversionSvc >	m_conversionSvc
	Pointer to the connected conversion service. More...

SmartIF< ISvcLocator >	m_svcLocator
	Service Locator reference. More...

SmartIF< IMessageSvc >	m_messageSvc
	MessageSvc reference. More...

Additional Inherited Members
Protected Attributes inherited from implements< IConverter >
std::atomic_ulong	m_refCount
	Reference counter More...

Detailed Description

Converter base class. See interface for detailed description, arguments and return values

Author: Markus Frank

Version: 1.0

Definition at line 34 of file Converter.h.

Member Typedef Documentation

◆ Factory

using Converter::Factory = Gaudi::PluginService::Factory<IConverter*( ISvcLocator* )>

Definition at line 36 of file Converter.h.

Constructor & Destructor Documentation

◆ Converter()

Converter::Converter	(	long	storage_type,
		const CLID &	class_type,
		ISvcLocator *	svc = `0`
	)

Standard Constructor.

Definition at line 114 of file Converter.cpp.

115 : m_storageType( storage_type ), m_classType( class_type ), m_svcLocator( svc ) {}

Member Function Documentation

◆ addressCreator()

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

override

Retrieve address creator facility.

Access the transient store.

Definition at line 99 of file Converter.cpp.

99 { return m_addressCreator; }

◆ conversionSvc()

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

override

Get conversion service the converter is connected to.

Get data conversion service the converter is connected to.

Definition at line 90 of file Converter.cpp.

90 { return m_conversionSvc; }

◆ createObj()

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

override

Create the transient representation of an object.

Definition at line 29 of file Converter.cpp.

29 { return StatusCode::SUCCESS; }

◆ createRep()

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

override

Convert the transient object to the requested representation.

Definition at line 41 of file Converter.cpp.

41 { return StatusCode::SUCCESS; }

◆ dataManager()

SmartIF< IDataManagerSvc > & Converter::dataManager ( ) const

protected

Get Data Manager service.

Get data manager service.

Definition at line 81 of file Converter.cpp.

81 { return m_dataManager; }

◆ dataProvider()

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

override

Get Data provider service.

Get data provider service.

Definition at line 78 of file Converter.cpp.

78 { return m_dataProvider; }

◆ fillObjRefs()

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

override

Resolve the references of the created transient object.

Definition at line 32 of file Converter.cpp.

32 { return StatusCode::SUCCESS; }

◆ fillRepRefs()

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

override

Resolve the references of the converted object.

Definition at line 44 of file Converter.cpp.

44 { return StatusCode::SUCCESS; }

◆ finalize()

StatusCode Converter::finalize ( )

override

Initialize the converter.

Finalize the converter.

Definition at line 60 of file Converter.cpp.

                                {
   // release services
   m_messageSvc     = nullptr;
   m_dataManager    = nullptr;
   m_dataProvider   = nullptr;
   m_conversionSvc  = nullptr;
   m_addressCreator = nullptr;
   return StatusCode::SUCCESS;
 }

◆ i_repSvcType()

long Converter::i_repSvcType ( ) const

virtual

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

Definition at line 26 of file Converter.cpp.

26 { return m_storageType; }

◆ initialize()

StatusCode Converter::initialize ( )

override

Initialize the converter.

Definition at line 53 of file Converter.cpp.

                                  {
   // Get a reference to the Message Service
   if ( !msgSvc() ) { return StatusCode::FAILURE; }
   return StatusCode::SUCCESS;
 }

◆ msgSvc()

SmartIF< IMessageSvc > & Converter::msgSvc ( ) const

protected

Retrieve pointer to message service.

— Retrieve pointer to message service

Definition at line 105 of file Converter.cpp.

                                               {
   if ( !m_messageSvc ) {
     m_messageSvc = serviceLocator();
     if ( !m_messageSvc ) { throw GaudiException( "Service [MessageSvc] not found", "Converter", StatusCode::FAILURE ); }
   }
   return m_messageSvc;
 }

◆ objType()

const CLID & Converter::objType ( ) const

override

Retrieve the class type of objects the converter produces.

Definition at line 23 of file Converter.cpp.

23 { return m_classType; }

◆ service() [1/3]

SmartIF< IService > Converter::service	(	const std::string &	name,
		const bool	createIf = `true`
	)		const

Return a pointer to the service identified by name (or "type/name")

Definition at line 139 of file Converter.cpp.

                                                                                        {
   SmartIF<INamedInterface> cnvsvc( conversionSvc() );
   SmartIF<IService>        svc;
   if ( cnvsvc ) {
     const ServiceLocatorHelper helper( *serviceLocator(), "Converter", cnvsvc->name() );
     svc = helper.service( name, false, createIf );
   }
   return svc;
 }

◆ service() [2/3]

template<class T >

StatusCode Converter::service	(	const std::string &	name,
		T *&	psvc,
		bool	createIf = `false`
	)		const

inline

Access a service by name, creating it if it doesn't already exist.

Definition at line 99 of file Converter.h.

                                                                           {
     return service_i( name, createIf, T::interfaceID(), (void**)&psvc );
   }

◆ service() [3/3]

template<class T >

StatusCode Converter::service	(	const std::string &	type,
		const std::string &	name,
		T *&	psvc
	)		const

inline

Access a service by name, type creating it if it doesn't already exist.

Definition at line 106 of file Converter.h.

                                                                           {
     return service_i( type, name, T::interfaceID(), reinterpret_cast<void**>( &psvc ) );
   }

◆ service_i() [1/2]

StatusCode Converter::service_i	(	const std::string &	svcName,
		bool	createIf,
		const InterfaceID &	iid,
		void **	ppSvc
	)		const

private

implementation of legacy service method

Definition at line 117 of file Converter.cpp.

                                                       {
   // Check for name of conversion service
   SmartIF<INamedInterface> cnvsvc( conversionSvc() );
   if ( cnvsvc ) {
     const ServiceLocatorHelper helper( *serviceLocator(), "Converter", cnvsvc->name() );
     return helper.getService( svcName, createIf, iid, ppSvc );
   }
   return StatusCode::FAILURE;
 }

◆ service_i() [2/2]

StatusCode Converter::service_i	(	const std::string &	svcType,
		const std::string &	svcName,
		const InterfaceID &	iid,
		void **	ppSvc
	)		const

private

Definition at line 128 of file Converter.cpp.

                                                       {
   // Check for name of conversion service
   SmartIF<INamedInterface> cnvsvc( conversionSvc() );
   if ( cnvsvc ) {
     const ServiceLocatorHelper helper( *serviceLocator(), "Converter", cnvsvc->name() );
     return helper.createService( svcType, svcName, iid, ppSvc );
   }
   return StatusCode::FAILURE;
 }

◆ serviceLocator()

SmartIF< ISvcLocator > & Converter::serviceLocator ( ) const

protected

Retrieve pointer to service locator.

— Retrieve pointer to service locator

Definition at line 102 of file Converter.cpp.

102 { return m_svcLocator; }

◆ setAddressCreator()

StatusCode Converter::setAddressCreator ( IAddressCreator * creator )

override

Set address creator facility.

Definition at line 93 of file Converter.cpp.

                                                                   {
   m_addressCreator = creator;
   return StatusCode::SUCCESS;
 }

◆ setConversionSvc()

StatusCode Converter::setConversionSvc ( IConversionSvc * svc )

override

Set conversion service the converter is connected to.

Definition at line 84 of file Converter.cpp.

                                                             {
   m_conversionSvc = svc;
   return StatusCode::SUCCESS;
 }

◆ setDataProvider()

StatusCode Converter::setDataProvider ( IDataProviderSvc * svc )

override

Set Data provider service.

Set data provider service.

Definition at line 71 of file Converter.cpp.

                                                              {
   m_dataProvider = svc;
   m_dataManager  = svc;
   return StatusCode::SUCCESS;
 }

◆ updateObj()

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

override

Update the transient object from the other representation.

Definition at line 35 of file Converter.cpp.

35 { return StatusCode::SUCCESS; }

◆ updateObjRefs()

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

override

Update the references of an updated transient object.

Definition at line 38 of file Converter.cpp.

38 { return StatusCode::SUCCESS; }

◆ updateRep()

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

override

Update the converted representation of a transient object.

Definition at line 47 of file Converter.cpp.

47 { return StatusCode::SUCCESS; }

◆ updateRepRefs()

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

override

Update the references of an already converted object.

Definition at line 50 of file Converter.cpp.

50 { return StatusCode::SUCCESS; }

Member Data Documentation

◆ m_addressCreator

SmartIF<IAddressCreator> Converter::m_addressCreator

mutableprivate

Pointer to the address creation service interface.

Definition at line 127 of file Converter.h.

◆ m_classType

const CLID Converter::m_classType

private

Class type the converter can handle.

Definition at line 125 of file Converter.h.

◆ m_conversionSvc

SmartIF<IConversionSvc> Converter::m_conversionSvc

mutableprivate

Pointer to the connected conversion service.

Definition at line 133 of file Converter.h.

◆ m_dataManager

SmartIF<IDataManagerSvc> Converter::m_dataManager

mutableprivate

Pointer to data manager service.

Definition at line 131 of file Converter.h.

◆ m_dataProvider

SmartIF<IDataProviderSvc> Converter::m_dataProvider

mutableprivate

Pointer to data provider service.

Definition at line 129 of file Converter.h.

◆ m_messageSvc

SmartIF<IMessageSvc> Converter::m_messageSvc

mutableprivate

MessageSvc reference.

Definition at line 137 of file Converter.h.

◆ m_storageType

long Converter::m_storageType

private

Storage type.

Definition at line 123 of file Converter.h.

◆ m_svcLocator

SmartIF<ISvcLocator> Converter::m_svcLocator

mutableprivate

Service Locator reference.

Definition at line 135 of file Converter.h.

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

GaudiKernel/include/GaudiKernel/Converter.h
GaudiKernel/src/Lib/Converter.cpp

Public Types

Public Member Functions

Protected Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ Factory

Constructor & Destructor Documentation

◆ Converter()

Member Function Documentation

◆ addressCreator()

◆ conversionSvc()

◆ createObj()

◆ createRep()

◆ dataManager()

◆ dataProvider()

◆ fillObjRefs()

◆ fillRepRefs()

◆ finalize()

◆ i_repSvcType()

◆ initialize()

◆ msgSvc()

◆ objType()

◆ service() [1/3]

◆ service() [2/3]

◆ service() [3/3]

◆ service_i() [1/2]

◆ service_i() [2/2]

◆ serviceLocator()

◆ setAddressCreator()

◆ setConversionSvc()

◆ setDataProvider()

◆ updateObj()

◆ updateObjRefs()

◆ updateRep()

◆ updateRepRefs()

Member Data Documentation

◆ m_addressCreator

◆ m_classType

◆ m_conversionSvc

◆ m_dataManager

◆ m_dataProvider

◆ m_messageSvc

◆ m_storageType

◆ m_svcLocator