Gaudi Framework, version v20r2
	Generated: 18 Jul 2008

PoolDbDataConnection Class Reference

#include <PoolDbDataConnection.h>

Collaboration diagram for PoolDbDataConnection:

[legend]List of all members.

---

Detailed Description

The DataConnection incanation for the usage in GaudiPoolDb.

This entity interacts with the IODataManager from the GaudiUtils package and allows to connect refereneces between objects stored in POOL files.

M.Frank

Version:

1.0

Date:

20/10/2007

Definition at line 29 of file PoolDbDataConnection.h.

Public Member Functions
	PoolDbDataConnection (IInterface *owner, const std::string &nam, int typ, int mode, pool::DbDomain &domH)
	Standard constructor.
virtual	~PoolDbDataConnection ()
	Standard destructor.
pool::DbDatabase &	database ()
	Access to POOL database handle.
pool::DbTransaction &	transaction ()
	Access to POOL transaction handle.
virtual bool	isConnected () const
	Check if connected to data source.
virtual StatusCode	connectRead ()
	Open data stream in read mode.
virtual StatusCode	connectWrite (IoType)
	Open data stream in write mode.
virtual StatusCode	disconnect ()
	Release data stream.
virtual StatusCode	read (void *const , size_t)
	Read raw byte buffer from input stream.
virtual StatusCode	write (const void *, int)
	Write raw byte buffer to output stream.
virtual long long int	seek (long long int, int)
	Seek on the file described by ioDesc. Arguments as in seek().
Protected Member Functions
virtual StatusCode	i_connect ()
	Internal connect call.
Protected Attributes
int	m_type
int	m_mode
	Datasource access mode.
pool::DbTransaction	m_transaction
	Transaction handle for this data source.
pool::DbDatabase	m_dbH
	Database handle for this data source.
pool::DbDomain	m_domH
	Domain handle specifying the storage domain.

---

Constructor & Destructor Documentation

PoolDbDataConnection::PoolDbDataConnection	(	IInterface *	owner,
		const std::string &	nam,
		int	typ,
		int	mode,
		pool::DbDomain &	domH
	)

Standard constructor.

Definition at line 30 of file PoolDbDataConnection.cpp.

References std::basic_string< _CharT, _Traits, _Alloc >::c_str(), pool::DbInstanceCount::Counter::increment(), m_name, and s_connectionCount.

: IDataConnection(own,nam), m_type(typ), m_mode(mode), m_domH(domH)
{
  s_connectionCount->increment();
  if ( typ == Gaudi::IIODataManager::FID && strncmp(nam.c_str(),"FID:",4) != 0 ) {
    m_name = "FID:"+nam;
  }
}

PoolDbDataConnection::~PoolDbDataConnection

(

)

[virtual]

Standard destructor.

Definition at line 40 of file PoolDbDataConnection.cpp.

References pool::DbInstanceCount::Counter::decrement(), and s_connectionCount.

                                                    {
  s_connectionCount->decrement();
}

---

Member Function Documentation

StatusCode PoolDbDataConnection::i_connect

(

)

[protected, virtual]

Internal connect call.

Definition at line 45 of file PoolDbDataConnection.cpp.

References pool::DbDatabase::close(), StatusCode::FAILURE, pool::DbDomain::find(), isEqualMode(), pool::DbStatus::isSuccess(), pool::DbHandleBase< T >::isValid(), m_dbH, m_domH, m_mode, pool::DbDatabase::open(), pool::DbDatabase::param(), pool::READ, StatusCode::SUCCESS, and pool::UPDATE.

Referenced by connectRead(), and connectWrite().

                                            {
  DbAccessMode mode = (DbAccessMode)m_mode;
  bool open_existing = isEqualMode(mode,pool::READ)||isEqualMode(mode,pool::UPDATE)||(1<<4);
  m_dbH = DbDatabase(m_domH.find(fid()));
  if ( !m_dbH.isValid() )  {
    std::string true_fid;
    pool::DbStatus sc = m_dbH.open(m_domH, pfn(), fid(), mode);
    if ( sc.isSuccess() && open_existing )  {
      m_dbH.param("FID",true_fid);
      if ( fid() == pfn() ) {
        m_fid = true_fid;
        m_dbH.close();
        sc = m_dbH.open(m_domH, pfn(), fid(), mode);
      }
      else if ( strcasecmp(true_fid.c_str(),fid().c_str()) != 0 )  {
        m_dbH.close();
        throw std::runtime_error("FID mismatch:\n\t\t\t\tFID="+
                                 fid()+" (catalog) <> \n\t\t\t\t"+
                                 true_fid+" (file) for PFN="+pfn());
        return BAD_DATA_CONNECTION;
      }
    }
    else if ( open_existing ) {
      return BAD_DATA_CONNECTION;
    }
    return sc.isSuccess() ? StatusCode::SUCCESS : StatusCode::FAILURE;
  }
  return StatusCode::SUCCESS;
}

pool::DbDatabase& PoolDbDataConnection::database

(

)

[inline]

Access to POOL database handle.

Definition at line 49 of file PoolDbDataConnection.h.

References m_dbH.

{     return m_dbH;                }

pool::DbTransaction& PoolDbDataConnection::transaction

(

)

[inline]

Access to POOL transaction handle.

Definition at line 51 of file PoolDbDataConnection.h.

References m_transaction.

{     return m_transaction;        }

virtual bool PoolDbDataConnection::isConnected

(

)

const [inline, virtual]

Check if connected to data source.

Definition at line 53 of file PoolDbDataConnection.h.

References m_dbH, and pool::DbHandleBase< T >::ptr().

{     return m_dbH.ptr() != 0;     }

virtual StatusCode PoolDbDataConnection::connectRead

(

)

[inline, virtual]

Open data stream in read mode.

Definition at line 55 of file PoolDbDataConnection.h.

References i_connect().

{     return i_connect();          }

virtual StatusCode PoolDbDataConnection::connectWrite

(

IoType

)

[inline, virtual]

Open data stream in write mode.

Definition at line 57 of file PoolDbDataConnection.h.

References i_connect().

{return i_connect();    }

StatusCode PoolDbDataConnection::disconnect

(

)

[virtual]

Release data stream.

Definition at line 76 of file PoolDbDataConnection.cpp.

References pool::DbDatabase::close(), StatusCode::FAILURE, pool::DbHandleBase< T >::isValid(), m_dbH, pool::POOL_StorageType, and StatusCode::SUCCESS.

                                             {
  if ( m_dbH.isValid() )  {
    m_dbH.close();
    m_dbH = DbDatabase(pool::POOL_StorageType);
    return StatusCode::SUCCESS;
  }
  return StatusCode::FAILURE;
}

virtual StatusCode PoolDbDataConnection::read	(	void *	const,
		size_t
	)			[inline, virtual]

Read raw byte buffer from input stream.

Definition at line 61 of file PoolDbDataConnection.h.

References StatusCode::FAILURE.

  {  return StatusCode::FAILURE;                                             }

virtual StatusCode PoolDbDataConnection::write	(	const void *	,
		int
	)			[inline, virtual]

Write raw byte buffer to output stream.

Definition at line 64 of file PoolDbDataConnection.h.

References StatusCode::FAILURE.

  {  return StatusCode::FAILURE;                                             }

virtual long long int PoolDbDataConnection::seek	(	long long	int,
		int
	)			[inline, virtual]

Seek on the file described by ioDesc. Arguments as in seek().

Definition at line 67 of file PoolDbDataConnection.h.

  {  return -1;                                                              }

---

Member Data Documentation

int PoolDbDataConnection::m_type [protected]

Definition at line 31 of file PoolDbDataConnection.h.

int PoolDbDataConnection::m_mode [protected]

Datasource access mode.

Definition at line 33 of file PoolDbDataConnection.h.

Referenced by i_connect().

pool::DbTransaction PoolDbDataConnection::m_transaction [protected]

Transaction handle for this data source.

Definition at line 35 of file PoolDbDataConnection.h.

Referenced by transaction().

pool::DbDatabase PoolDbDataConnection::m_dbH [protected]

Database handle for this data source.

Definition at line 37 of file PoolDbDataConnection.h.

Referenced by database(), disconnect(), i_connect(), and isConnected().

pool::DbDomain PoolDbDataConnection::m_domH [protected]

Domain handle specifying the storage domain.

Definition at line 39 of file PoolDbDataConnection.h.

Referenced by i_connect().

---

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

• /afs/cern.ch/sw/Gaudi/releases/GAUDI/GAUDI_v20r2/GaudiPoolDb/v4r0/GaudiPoolDb/PoolDbDataConnection.h
• /afs/cern.ch/sw/Gaudi/releases/GAUDI/GAUDI_v20r2/GaudiPoolDb/v4r0/src/PoolDbDataConnection.cpp

---