#include <src/RNTupleContainer.h>

Inheritance diagram for pool::RNTupleContainer:

Collaboration diagram for pool::RNTupleContainer:

Classes
struct	FieldDesc
	Definition of a field info structure. More...

Public Member Functions
	RNTupleContainer ()
	Standard constructor. More...

virtual	~RNTupleContainer ()

virtual DbStatus	close () override final
	Close the container and deallocate resources. More...

virtual DbStatus	open (DbDatabase &dbH, const std::string &nam, const DbTypeInfo *info, DbAccessMode mod) override final
	Open the container for object access. More...

virtual DbStatus	getOption (DbOption &opt) override final
	Access options. More...

virtual DbStatus	setOption (const DbOption &opt) override final
	Set options. More...

virtual DbStatus	isShapeSupported (const DbTypeInfo *typ) const override final
	Ask if a given shape is supported. More...

virtual uint64_t	size () override final
	Number of entries within the container. More...

const std::string &	getName () const
	Return the name of the container. More...

bool	isDirty () const
	Return true if this branch container was updated and it's TTree needs to be Filled. More...

void	clearDirty ()
	Clear the dirty status (used after containing TTree was Filled) More...

virtual DbStatus	loadObject (void **ptr, ShapeH shape, Token::OID_t &oid) override final
	Find object by object identifier and load it into memory. More...

virtual DbStatus	writeObject (ActionList::value_type &) override final
	Commit single entry to container. More...

virtual uint64_t	nextRecordId () override final
	Number of next record in the container (=size if no delete is allowed) More...

virtual void	useNextRecordId (uint64_t nextID) override final
	Suggest next Record ID for tbe next object written - used only with synced indexes. More...

virtual DbStatus	select (DbSelect &criteria) override final
	Define selection criteria. More...

virtual DbStatus	fetch (DbSelect &sel) override final
	Fetch next object address of the selection to set token. More...

virtual DbStatus	transAct (Transaction::Action action) override final
	Execute transaction action. More...

virtual DbStatus	fetch (DbSelect &sel) override
	Equivalent to next() More...

virtual DbStatus	fetch (const Token::OID_t &linkH, Token::OID_t &stmt)
	Equivalent to next() More...

virtual void	release () override
	Release instance (Abstract interfaces do not expose destructor!) More...

virtual std::string	name () const override
	Get container name. More...

virtual void *	allocate (unsigned long siz, DbContainer &cntH, ShapeH shape) override
	In place allocation of raw memory for the transient object. More...

virtual DbStatus	allocate (DbContainer &cntH, const void *object, ShapeH shape, Token::OID_t &oid) override
	In place allocation of object location. More...

virtual DbStatus	free (void *ptr, DbContainer &cntH) override
	In place deletion of raw memory. More...

virtual DbStatus	update (DbSelect &) override
	Perform UPDATE statement. More...

virtual DbStatus	update (DbContainer &cntH, const void *object, ShapeH shape, const Token::OID_t &linkH) override
	Update existing object in the container. More...

virtual DbStatus	update (DbContainer &cntH, const void *object, ShapeH shape, const DbObjectHandle< DbObject > &objH) override
	Update existing object in the container. More...

virtual DbStatus	destroy (DbSelect &) override
	Perform DELETE statement. More...

virtual DbStatus	destroy (const Token::OID_t &lnkH) override
	Add the specified object to the delete stack. More...

virtual DbStatus	fetch (const Token::OID_t &linkH, Token::OID_t &stmt)
	Fetch refined object address. Default implementation returns identity. More...

virtual DbStatus	save (DbObjectHandle< DbObject > &objH) override
	Add single entry to container. More...

virtual DbStatus	save (DbContainer &cntH, const void *object, ShapeH shape, Token::OID_t &linkH) override
	Save new object in the container and return its handle. More...

virtual DbStatus	load (void **ptr, ShapeH shape, const Token::OID_t &lnkH, Token::OID_t &oid, bool any_next) override
	Find object within the container and load it into memory. More...

virtual DbStatus	clearStack ()
	Clear Transaction stack containing transaction requests. More...

Protected Types
typedef std::vector< DbAction >	ActionList

Protected Member Functions
int	stackType () const
	Access accumulated stack entry types. More...

size_t	stackSize () const
	Access stack size. More...

virtual bool	updatesPending () const override
	Query the pending transaction stack. More...

ActionList::value_type *	stackEntry (size_t which)
	Internal: get access to stack entry. More...

virtual DbStatus	destroyObject (ActionList::value_type &)
	Destroy persistent object in the container; does not touch transient! More...

virtual DbStatus	updateObject (ActionList::value_type &)
	Update persistent object in the container. More...

virtual DbStatus	commitTransaction ()
	Execute object modification requests during a transaction. More...

Protected Attributes
const DbTypeInfo *	m_type {}
	reference to exact type description More...

std::vector< FieldDesc >	m_fieldDescs
	List of field descriptors. More...

DbDatabase	m_dbH
	Parent Database handle. More...

RootDatabase *	m_rootDb
	Root database file reference. More...

int	m_ioBytes
	Number of bytes written/read during last operation. Set to -1 if it failed. More...

bool	m_isDirty
	flag set on writing to prevent double writes in the same commit More...

uint64_t	m_index

uint64_t	m_indexSize

int64_t	m_indexBump

const uint32_t	m_indexMulti

RootStorageSvc::RNTupleWriterHelper *	m_ntupleWriter = nullptr
	Internal cache of the RNTupleWriterHelper. More...

RNTupleReader *	m_ntupleReader {}
	Internal cache of the native RNTupleReader. More...

std::string	m_name
	Container name. More...

bool	m_canUpdate
	Flag to indicate if object updates are supported. More...

bool	m_canDestroy
	Flag to indicate if object removals are supported. More...

Private Member Functions
DbStatus	initObjectFieldDesc (FieldDesc &dsc)
	Init a field description for an object (i.e. find TClass etc.) More...

Private Attributes
ActionList	m_stack
	Transaction fifo storage for writing. More...

size_t	m_size
	Current size of the transaction stack. More...

size_t	m_writeSize
	Number of objects to be written out during open transaction. More...

int	m_stackType
	Accumulated stack entry types. More...

Detailed Description

Description: RNTUPLE specific implementation of Database Container.

Definition at line 49 of file RNTupleContainer.h.

Member Typedef Documentation

◆ ActionList

typedef std::vector< DbAction > pool::DbContainerImp::ActionList

protectedinherited

Definition at line 63 of file DbContainerImp.h.

Constructor & Destructor Documentation

◆ RNTupleContainer()

pool::RNTupleContainer::RNTupleContainer ( )

Standard constructor.

◆ ~RNTupleContainer()

virtual pool::RNTupleContainer::~RNTupleContainer ( )

virtual

Member Function Documentation

◆ allocate() [1/2]

virtual DbStatus pool::DbContainerImp::allocate	(	DbContainer &	cntH,
		const void *	object,
		ShapeH	shape,
		Token::OID_t &	oid
	)

overridevirtualinherited

In place allocation of object location.

Implements pool::IDbContainer.

◆ allocate() [2/2]

virtual void* pool::DbContainerImp::allocate	(	unsigned long	siz,
		DbContainer &	cntH,
		ShapeH	shape
	)

overridevirtualinherited

In place allocation of raw memory for the transient object.

Implements pool::IDbContainer.

◆ clearDirty()

void pool::RNTupleContainer::clearDirty ( )

inline

Clear the dirty status (used after containing TTree was Filled)

Definition at line 165 of file RNTupleContainer.h.

165 { m_isDirty = false; }

◆ clearStack()

virtual DbStatus pool::DbContainerImp::clearStack ( )

virtualinherited

Clear Transaction stack containing transaction requests.

◆ close()

virtual DbStatus pool::RNTupleContainer::close ( )

finaloverridevirtual

Close the container and deallocate resources.

Reimplemented from pool::DbContainerImp.

◆ commitTransaction()

virtual DbStatus pool::DbContainerImp::commitTransaction ( )

protectedvirtualinherited

Execute object modification requests during a transaction.

◆ destroy() [1/2]

virtual DbStatus pool::DbContainerImp::destroy ( const Token::OID_t & lnkH )

overridevirtualinherited

Add the specified object to the delete stack.

Implements pool::IDbContainer.

◆ destroy() [2/2]

virtual DbStatus pool::DbContainerImp::destroy ( DbSelect & )

inlineoverridevirtualinherited

Perform DELETE statement.

Implements pool::IDbContainer.

Definition at line 155 of file DbContainerImp.h.

155 { return Error; }

◆ destroyObject()

virtual DbStatus pool::DbContainerImp::destroyObject ( ActionList::value_type & )

inlineprotectedvirtualinherited

Destroy persistent object in the container; does not touch transient!

Reimplemented in pool::RootKeyContainer.

Definition at line 97 of file DbContainerImp.h.

98 { return Error; }

◆ fetch() [1/4]

virtual DbStatus pool::DbContainerImp::fetch

Equivalent to next()

◆ fetch() [2/4]

virtual DbStatus pool::DbContainerImp::fetch	(	const Token::OID_t &	linkH,
		Token::OID_t &	stmt
	)

virtualinherited

Fetch refined object address. Default implementation returns identity.

Reimplemented in pool::RootTreeContainer, and pool::RootKeyContainer.

◆ fetch() [3/4]

virtual DbStatus pool::DbContainerImp::fetch

override

Equivalent to next()

◆ fetch() [4/4]

virtual DbStatus pool::RNTupleContainer::fetch ( DbSelect & sel )

finaloverridevirtual

Fetch next object address of the selection to set token.

Reimplemented from pool::DbContainerImp.

◆ free()

virtual DbStatus pool::DbContainerImp::free	(	void *	ptr,
		DbContainer &	cntH
	)

overridevirtualinherited

In place deletion of raw memory.

Implements pool::IDbContainer.

◆ getName()

const std::string& pool::RNTupleContainer::getName ( ) const

inline

Return the name of the container.

Definition at line 158 of file RNTupleContainer.h.

158 { return m_name; }

◆ getOption()

virtual DbStatus pool::RNTupleContainer::getOption ( DbOption & opt )

finaloverridevirtual

Access options.

Parameters

opt	[IN] Reference to option object.

Returns: DbStatus code indicating success or failure.

Reimplemented from pool::DbContainerImp.

◆ initObjectFieldDesc()

DbStatus pool::RNTupleContainer::initObjectFieldDesc ( FieldDesc & dsc )

private

Init a field description for an object (i.e. find TClass etc.)

◆ isDirty()

bool pool::RNTupleContainer::isDirty ( ) const

inline

Return true if this branch container was updated and it's TTree needs to be Filled.

Definition at line 162 of file RNTupleContainer.h.

162 { return m_isDirty; }

◆ isShapeSupported()

virtual DbStatus pool::RNTupleContainer::isShapeSupported ( const DbTypeInfo * typ ) const

finaloverridevirtual

Ask if a given shape is supported.

Implements pool::IDbContainer.

◆ load()

virtual DbStatus pool::DbContainerImp::load	(	void **	ptr,
		ShapeH	shape,
		const Token::OID_t &	lnkH,
		Token::OID_t &	oid,
		bool	any_next
	)

overridevirtualinherited

Find object within the container and load it into memory.

Parameters

ptr	[IN/OUT] ROOT-style address of the pointer to object
shape	[IN] Object type
linkH	[IN] Preferred object OID
oid	[OUT] Actual object OID
any_next	[IN] On selection, objects may be skipped. If objects are skipped, the actual oid will differ from the preferred oid.

Returns: Status code indicating success or failure.

Implements pool::IDbContainer.

Reimplemented in pool::RootKeyContainer.

◆ loadObject()

virtual DbStatus pool::RNTupleContainer::loadObject	(	void **	ptr,
		ShapeH	shape,
		Token::OID_t &	oid
	)

finaloverridevirtual

Find object by object identifier and load it into memory.

Parameters

ptr	[IN/OUT] address of the pointer to object
shape	[IN] Object Shape
oid	[OUT] Object OID

Returns: Status code indicating success or failure.

Implements pool::DbContainerImp.

◆ name()

virtual std::string pool::DbContainerImp::name ( ) const

inlineoverridevirtualinherited

Get container name.

Implements pool::IDbContainer.

Definition at line 115 of file DbContainerImp.h.

116 { return m_name; }

◆ nextRecordId()

virtual uint64_t pool::RNTupleContainer::nextRecordId ( )

finaloverridevirtual

Number of next record in the container (=size if no delete is allowed)

Reimplemented from pool::DbContainerImp.

◆ open()

virtual DbStatus pool::RNTupleContainer::open	(	DbDatabase &	dbH,
		const std::string &	nam,
		const DbTypeInfo *	info,
		DbAccessMode	mod
	)

finaloverridevirtual

Open the container for object access.

Implements pool::IDbContainer.

◆ release()

virtual void pool::DbContainerImp::release ( )

inlineoverridevirtualinherited

Release instance (Abstract interfaces do not expose destructor!)

Implements pool::IDbContainer.

Definition at line 111 of file DbContainerImp.h.

111 { delete this; }

◆ save() [1/2]

virtual DbStatus pool::DbContainerImp::save	(	DbContainer &	cntH,
		const void *	object,
		ShapeH	shape,
		Token::OID_t &	linkH
	)

overridevirtualinherited

Save new object in the container and return its handle.

Parameters

cntH	[IN] Handle to container object.
object	[IN] Data object
linkH	[OUT] Internal OID to identify object.

Returns: DbStatus code indicating success or failure.

Implements pool::IDbContainer.

◆ save() [2/2]

virtual DbStatus pool::DbContainerImp::save ( DbObjectHandle< DbObject > & objH )

overridevirtualinherited

Add single entry to container.

Implements pool::IDbContainer.

◆ select()

virtual DbStatus pool::RNTupleContainer::select ( DbSelect & criteria )

finaloverridevirtual

Define selection criteria.

Implements pool::IDbContainer.

◆ setOption()

virtual DbStatus pool::RNTupleContainer::setOption ( const DbOption & opt )

finaloverridevirtual

Set options.

Parameters

opt	[IN] Reference to option object.

Returns: DbStatus code indicating success or failure.

Reimplemented from pool::DbContainerImp.

◆ size()

virtual uint64_t pool::RNTupleContainer::size ( )

finaloverridevirtual

Number of entries within the container.

Reimplemented from pool::DbContainerImp.

◆ stackEntry()

ActionList::value_type* pool::DbContainerImp::stackEntry ( size_t which )

inlineprotectedinherited

Internal: get access to stack entry.

Definition at line 94 of file DbContainerImp.h.

95 { return (which <= m_size) ? &(*(m_stack.begin()+which)) : 0; }

◆ stackSize()

size_t pool::DbContainerImp::stackSize ( ) const

inlineprotectedinherited

Access stack size.

Definition at line 88 of file DbContainerImp.h.

89 { return m_size; }

◆ stackType()

int pool::DbContainerImp::stackType ( ) const

inlineprotectedinherited

Access accumulated stack entry types.

Definition at line 85 of file DbContainerImp.h.

86 { return m_stackType; }

◆ transAct()

virtual DbStatus pool::RNTupleContainer::transAct ( Transaction::Action action )

finaloverridevirtual

Execute transaction action.

Reimplemented from pool::DbContainerImp.

◆ update() [1/3]

virtual DbStatus pool::DbContainerImp::update	(	DbContainer &	cntH,
		const void *	object,
		ShapeH	shape,
		const DbObjectHandle< DbObject > &	objH
	)

overridevirtualinherited

Update existing object in the container.

Parameters

cntH	[IN] Valid handle to container
object	[IN] Data object
objH	[IN] Object handle

Returns: Status code indicating success or failure.

Implements pool::IDbContainer.

◆ update() [2/3]

virtual DbStatus pool::DbContainerImp::update	(	DbContainer &	cntH,
		const void *	object,
		ShapeH	shape,
		const Token::OID_t &	linkH
	)

overridevirtualinherited

Update existing object in the container.

Parameters

cntH	[IN] Valid handle to container
object	[IN] Data object
linkH	[IN/OUT] Object identifier

Returns: Status code indicating success or failure.

Implements pool::IDbContainer.

◆ update() [3/3]

virtual DbStatus pool::DbContainerImp::update ( DbSelect & )

inlineoverridevirtualinherited

Perform UPDATE statement.

Implements pool::IDbContainer.

Definition at line 153 of file DbContainerImp.h.

153 { return Error; }

◆ updateObject()

virtual DbStatus pool::DbContainerImp::updateObject ( ActionList::value_type & )

inlineprotectedvirtualinherited

Update persistent object in the container.

Definition at line 100 of file DbContainerImp.h.

101 { return Error; }

◆ updatesPending()

virtual bool pool::DbContainerImp::updatesPending ( ) const

inlineoverrideprotectedvirtualinherited

Query the pending transaction stack.

Implements pool::IDbContainer.

Definition at line 91 of file DbContainerImp.h.

92 { return m_size > 0; }

◆ useNextRecordId()

virtual void pool::RNTupleContainer::useNextRecordId ( uint64_t )

finaloverridevirtual

Suggest next Record ID for tbe next object written - used only with synced indexes.

Reimplemented from pool::DbContainerImp.

◆ writeObject()

virtual DbStatus pool::RNTupleContainer::writeObject ( ActionList::value_type & )

finaloverridevirtual

Commit single entry to container.

Reimplemented from pool::DbContainerImp.

Member Data Documentation

◆ m_canDestroy

bool pool::DbContainerImp::m_canDestroy

protectedinherited

Flag to indicate if object removals are supported.

Definition at line 80 of file DbContainerImp.h.

◆ m_canUpdate

bool pool::DbContainerImp::m_canUpdate

protectedinherited

Flag to indicate if object updates are supported.

Definition at line 78 of file DbContainerImp.h.

◆ m_dbH

DbDatabase pool::RNTupleContainer::m_dbH

protected

Parent Database handle.

Definition at line 104 of file RNTupleContainer.h.

◆ m_fieldDescs

std::vector<FieldDesc> pool::RNTupleContainer::m_fieldDescs

protected

List of field descriptors.

Definition at line 102 of file RNTupleContainer.h.

◆ m_index

uint64_t pool::RNTupleContainer::m_index

protected

Definition at line 112 of file RNTupleContainer.h.

◆ m_indexBump

int64_t pool::RNTupleContainer::m_indexBump

protected

Definition at line 114 of file RNTupleContainer.h.

◆ m_indexMulti

const uint32_t pool::RNTupleContainer::m_indexMulti

protected

Definition at line 115 of file RNTupleContainer.h.

◆ m_indexSize

uint64_t pool::RNTupleContainer::m_indexSize

protected

Definition at line 113 of file RNTupleContainer.h.

◆ m_ioBytes

int pool::RNTupleContainer::m_ioBytes

protected

Number of bytes written/read during last operation. Set to -1 if it failed.

Definition at line 108 of file RNTupleContainer.h.

◆ m_isDirty

bool pool::RNTupleContainer::m_isDirty

protected

flag set on writing to prevent double writes in the same commit

Definition at line 110 of file RNTupleContainer.h.

◆ m_name

std::string pool::DbContainerImp::m_name

protectedinherited

Container name.

Definition at line 76 of file DbContainerImp.h.

◆ m_ntupleReader

RNTupleReader* pool::RNTupleContainer::m_ntupleReader {}

protected

Internal cache of the native RNTupleReader.

Definition at line 121 of file RNTupleContainer.h.

◆ m_ntupleWriter

RootStorageSvc::RNTupleWriterHelper* pool::RNTupleContainer::m_ntupleWriter = nullptr

protected

Internal cache of the RNTupleWriterHelper.

Definition at line 118 of file RNTupleContainer.h.

◆ m_rootDb

RootDatabase* pool::RNTupleContainer::m_rootDb

protected

Root database file reference.

Definition at line 106 of file RNTupleContainer.h.

◆ m_size

size_t pool::DbContainerImp::m_size

privateinherited

Current size of the transaction stack.

Definition at line 69 of file DbContainerImp.h.

◆ m_stack

ActionList pool::DbContainerImp::m_stack

privateinherited

Transaction fifo storage for writing.

Definition at line 67 of file DbContainerImp.h.

◆ m_stackType

int pool::DbContainerImp::m_stackType

privateinherited

Accumulated stack entry types.

Definition at line 73 of file DbContainerImp.h.

◆ m_type

const DbTypeInfo* pool::RNTupleContainer::m_type {}

protected

reference to exact type description

Definition at line 100 of file RNTupleContainer.h.

◆ m_writeSize

size_t pool::DbContainerImp::m_writeSize

privateinherited

Number of objects to be written out during open transaction.

Definition at line 71 of file DbContainerImp.h.

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

RNTupleContainer.h

Classes

Public Member Functions

Protected Types

Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Detailed Description

Member Typedef Documentation

◆ ActionList

Constructor & Destructor Documentation

◆ RNTupleContainer()

◆ ~RNTupleContainer()

Member Function Documentation

◆ allocate() [1/2]

◆ allocate() [2/2]

◆ clearDirty()

◆ clearStack()

◆ close()

◆ commitTransaction()

◆ destroy() [1/2]

◆ destroy() [2/2]

◆ destroyObject()

◆ fetch() [1/4]

◆ fetch() [2/4]

◆ fetch() [3/4]

◆ fetch() [4/4]

◆ free()

◆ getName()

◆ getOption()

◆ initObjectFieldDesc()

◆ isDirty()

◆ isShapeSupported()

◆ load()

◆ loadObject()

◆ name()

◆ nextRecordId()

◆ open()

◆ release()

◆ save() [1/2]

◆ save() [2/2]

◆ select()

◆ setOption()

◆ size()

◆ stackEntry()

◆ stackSize()

◆ stackType()

◆ transAct()

◆ update() [1/3]

◆ update() [2/3]

◆ update() [3/3]

◆ updateObject()

◆ updatesPending()

◆ useNextRecordId()

◆ writeObject()

Member Data Documentation

◆ m_canDestroy

◆ m_canUpdate

◆ m_dbH

◆ m_fieldDescs

◆ m_index

◆ m_indexBump

◆ m_indexMulti

◆ m_indexSize

◆ m_ioBytes

◆ m_isDirty

◆ m_name

◆ m_ntupleReader

◆ m_ntupleWriter

◆ m_rootDb

◆ m_size

◆ m_stack

◆ m_stackType

◆ m_type

◆ m_writeSize