BDB file for storing volumes registry. More...

#include <db/bdb/bdb_volumes.hpp>

Inheritance diagram for SVolumesDB:

Collaboration diagram for SVolumesDB:

Public Member Functions
	SVolumesDB ()

Public Member Functions inherited from CBDB_File
	CBDB_File (EDuplicateKeys dup_keys=eDuplicatesDisable, EDBType db_type=eBtree)

void	Open (const string &filename, EOpenMode open_mode, bool support_dirty_read=false, unsigned rec_len=0)
	Open file with specified access mode. More...

void	Open (const string &filename, const string &database, EOpenMode open_mode, bool support_dirty_read=false, unsigned rec_len=0)
	Open file with specified filename and database name. More...

void	Reopen (EOpenMode open_mode, bool support_dirty_read=false)
	Reopen the db file. More...

void	Attach (CBDB_File &db_file)
	Attach external Berkeley DB file. More...

EBDB_ErrCode	Fetch ()
	Fetches the record corresponding to the current key value. More...

EBDB_ErrCode	FetchForUpdate ()
	Fetche the record corresponding to the current key value. More...

EBDB_ErrCode	Insert (EAfterWrite write_flag=eDiscardData)
	Insert new record. More...

unsigned	Append (EAfterWrite write_flag=eDiscardData)
	Append record to the queue (works only for DB_QUEUE database type) More...

EBDB_ErrCode	Delete (EIgnoreError on_error=eThrowOnError)
	Delete record corresponding to the current key value. More...

EBDB_ErrCode	UpdateInsert (EAfterWrite write_flag=eDiscardData)
	Update record corresponding to the current key value. More...

void	BindKey (const char field_name, CBDB_Field key_field, size_t buf_size=0)

void	BindData (const char field_name, CBDB_Field data_field, size_t buf_size=0, ENullable is_null=eNullable)

void	DuplicateStructure (const CBDB_File &dbf)
	Create the same fieldset as in dbf and bind them to the current file. More...

const CBDB_BufferManager *	GetKeyBuffer () const
	Get Buffer manager for key section of the file. More...

const CBDB_BufferManager *	GetDataBuffer () const
	Get Buffer manager for data section of the file. More...

CBDB_BufferManager *	GetKeyBuffer ()
	Get Buffer manager for key section of the file. More...

CBDB_BufferManager *	GetDataBuffer ()
	Get Buffer manager for data section of the file. More...

void	SetFieldCompareLimit (unsigned int n_fields)
	Sets maximum number of key fields participating in comparison Should be less than total number of key fields. More...

DBT *	CloneDBT_Key ()
	Create new copy of m_DBT_Key. More...

void	SetLegacyStringsCheck (bool value)
	Set C-str detection. More...

TUnifiedFieldIndex	GetFieldIdx (const string &name) const
	Get field index by name. More...

const CBDB_Field &	GetField (TUnifiedFieldIndex idx) const
	Return field by field index. More...

CBDB_Field &	GetField (TUnifiedFieldIndex idx)

void	SetFieldOwnership (bool own_fields)
	Fields deletion is managed by the class when own_fields is TRUE. More...

bool	IsOwnFields () const
	Return fields ownership flag. More...

void	CopyFrom (const CBDB_File &dbf)
	Copy record (fields) from another BDB file (MUST have the same structure) More...

void	Verify (const char filename, const char database, FILE *backup)
	Run database verification (DB->verify) More...

void	EnablePrefixCompression ()
	Turn ON prefix compression. More...

Public Member Functions inherited from CBDB_RawFile
	CBDB_RawFile (EDuplicateKeys dup_keys=eDuplicatesDisable, EDBType db_type=eBtree)

virtual	~CBDB_RawFile ()

void	SetEnv (CBDB_Env &env)
	Associate file with environment. More...

CBDB_Env *	GetEnv ()
	Get pointer on file environment Return NULL if no environment has been set. More...

void	Open (const string &filename, EOpenMode open_mode, bool support_dirty_read=false, unsigned rec_len=0)
	Open file with specified access mode. More...

void	Open (const string &filename, const string &database, EOpenMode open_mode, bool support_dirty_read=false, unsigned rec_len=0)
	Open file with specified filename and database name. More...

void	Attach (CBDB_RawFile &bdb_file)
	Attach class to external BerkeleyDB file instance. More...

void	Close ()
	Close file. More...

void	Reopen (EOpenMode open_mode, bool support_dirty_read=false, unsigned rec_len=0)
	Reopen database file. (Should be already open). More...

void	Remove (const string &filename, const string &database=kEmptyStr)
	Remove the database specified by the filename and database arguments. More...

unsigned int	Truncate ()
	Empty the database. Return number of records removed. More...

unsigned int	SafeTruncate ()
	Workaround for truncate of large databases. More...

void	Rename (const string &fname, const string &old_name, const string &new_name)
	Rename a database. NOTE: This cannot be called on an opened file. More...

void	Compact (ECompact compact_type=eCompactNoFree, int target_fill_pct=0)
	Compact the database. More...

void	CompactEx (FContinueCompact compact_callback, ECompact compact_type=eCompactNoFree, int target_fill_pct=0)

void	SetPageSize (unsigned int page_size)

unsigned int	GetPageSize ()

void	SetCacheSize (unsigned int cache_size)
	Set Berkeley DB memory cache size for the file (default is 256K). More...

void	RevSplitOff ()
	Turn OFF reverse splitting. More...

void	DisableCmpOverride ()
	Disable BTREE comparison override. More...

void	SetCachePriority (ECachePriority priority)

const string &	FileName () const

const string &	Database () const

virtual void	SetHash (DB *)
	Set hash function. More...

bool	IsOpen () const
	Return TRUE if the file is open. More...

bool	IsAttached () const

bool	IsByteSwapped () const
	Return TRUE if the if the underlying database files were created on an architecture of the different byte order. More...

bool	DuplicatesAllowed () const
	Return TRUE if file can contain duplicate keys. More...

EDuplicateKeys	GetDupKeysMode () const
	Return the key duplicate mode value. More...

const string &	GetFileName () const
	Return file name. More...

EOpenMode	GetOpenMode () const
	Return the file open mode. More...

void	Sync ()
	Flush any cached information to disk. More...

unsigned	CountRecs (bool bFast=false)
	Compute database statistic, return number of records. More...

void	PrintStat (CNcbiOstream &out)
	Print database statistics. More...

virtual void	SetTransaction (ITransaction *trans)
	Establish transaction association. More...

virtual void	RemoveTransaction (ITransaction *trans)
	Remove transaction association (must be established by SetTransaction. More...

virtual ITransaction *	GetTransaction ()
	Get current transaction. More...

CBDB_Transaction *	GetBDBTransaction ()
	Get current transaction. More...

unsigned	GetRecLen () const
	Get record length Works for fixed length record DBs only (Queue) More...

void	SetHashFillFactor (unsigned h_ffactor)
	Set hash table density (fill factor) More...

void	SetHashNelem (unsigned h_nelem)
	Set an estimate of hash table final size. More...

void	DisableHashOverride ()
	Disable hash method override (Berkeley DB will use it's own default hashing method) More...

void	SetBtreeMinKeysPerPage (unsigned int keys_per_page)
	Set the minimum number of keys per page (BTREE access methods only) More...

unsigned int	GetBtreeMinKeysPerPage ()

void	SetCompressor (ICompression *compressor, EOwnership own=eTakeOwnership)
	Set record compressor. More...

Public Member Functions inherited from ITransactional
virtual	~ITransactional ()

Public Attributes
CBDB_FieldUint4	volume_id
	Volume ID. More...

CBDB_FieldUint4	type
	Volume type. More...

CBDB_FieldUint4	status
	Volume status. More...

CBDB_FieldUint4	raw_status
	Raw data status. More...

CBDB_FieldUint4	lock
	Volume lock counter. More...

CBDB_FieldUint4	version
	Volume version. More...

CBDB_FieldUint4	date_from
	Date interval. More...

CBDB_FieldUint4	date_to
	Date interval. More...

CBDB_FieldUint4	mtimestamp
	Modification date. More...

CBDB_FieldUint4	relo_volume_id
	Modification date. More...

CBDB_FieldString	location
	Mount point for the volume. More...

CBDB_FieldString	backup_loc
	Location of volume backup. More...

Private Member Functions
	SVolumesDB (const SVolumesDB &)

SVolumesDB &	operator= (const SVolumesDB &)

Additional Inherited Members
Public Types inherited from CBDB_File
enum	EAfterWrite { eKeepData , eDiscardData }

typedef int	TUnifiedFieldIndex
	CBDB_File keeps data in two buffers (key buffer and data buffer). More...

Public Types inherited from CBDB_RawFile
enum	EOpenMode { eReadWrite , eReadOnly , eCreate , eReadWriteCreate }
	BDB file open mode. More...

enum	EDBType { eBtree , eQueue , eHash }
	Berkeley DB database type. More...

enum	EReallocMode { eReallocAllowed , eReallocForbidden }
	BLOB read mode, controld data buffer reallocation when there is not enough space in buffer. More...

enum	EDuplicateKeys { eDuplicatesDisable , eDuplicatesEnable }
	Control key duplicates in Btree. More...

enum	EIgnoreError { eIgnoreError , eThrowOnError }

enum	ECompact { eCompactNoFree , eCompactFreeExisting , eCompactFreeAll }
	BerkeleyDB compaction methods and flags. More...

enum	ECachePriority { eCache_Lowest , eCache_Low , eCache_Default , eCache_High , eCache_Highest }
	Set the priority for this database's pages in the buffer cache This is generally a temporary advisement, and works only if an environment is used. More...

typedef CSimpleBuffer	TBuffer
	typedef for raw buffer operations More...

typedef bool(*	FContinueCompact) (void)
	Extended version of compact This version performs iterative compacting and uses a callback to request an exit. More...

Static Public Member Functions inherited from CBDB_File
static void	DestroyDBT_Clone (DBT *dbt)
	Free the DBT structure created by CloneDBT_Key. More...

Static Public Attributes inherited from CBDB_RawFile
static const char	kDefaultDatabase [] = "_table"

Protected Member Functions inherited from CBDB_File
void	Discard ()
	Unpack internal record buffers. More...

virtual void	SetCmp (DB *)
	Set comparison function. More...

EBDB_ErrCode	ReadCursor (DBC *dbc, unsigned int bdb_flag)
	Read DB cursor. More...

EBDB_ErrCode	ReadCursor (DBC dbc, unsigned int bdb_flag, void *buf, size_t buf_size, EReallocMode allow_realloc)
	Read DB cursor (BLOB) More...

EBDB_ErrCode	ReadCursor (DBC dbc, unsigned int bdb_flag, TBuffer buf)
	Read DB cursor (BLOB) More...

EBDB_ErrCode	ReadCursor (DBC dbc, unsigned int bdb_flag, CBDB_MultiRowBuffer multirow_buf, bool multirow_only)
	Multiple-row read into a buffer Buffer is to be traversed using DB_MULTIPLE_KEY_NEXT (BerkeleyDB) More...

EBDB_ErrCode	WriteCursor (DBC *dbc, unsigned int bdb_flag, EAfterWrite write_flag)
	Write DB cursor. More...

EBDB_ErrCode	WriteCursor (const void data, size_t size, DBC dbc, unsigned int bdb_flag, EAfterWrite write_flag)
	Write BLOB to DB cursor. More...

EBDB_ErrCode	DeleteCursor (DBC *dbc, EIgnoreError)
	Delete DB cursor. More...

void	CheckNullDataConstraint () const
	Check if all NOT NULL fields are assigned. More...

void	DisableDataBufProcessing ()
	Function disables processing of m_DBT_data. More...

void	DisableNull ()
	Disable NULL/not NULL in data fields (Performance tweak, call before BindData) More...

void	DisableDataPacking ()
	Disable packing of variable length fields in the data buffer (Call after BindData) More...

EBDB_ErrCode	x_Fetch (unsigned int flags)
	Wrapper around get operation. More...

virtual void	x_SetByteSwapped (bool bswp)
	Set byte order swapping. More...

Protected Member Functions inherited from CBDB_RawFile
void	x_Open (const char filename, const char database, EOpenMode open_mode, bool support_dirty_read, unsigned rec_len)

void	x_Create (const char filename, const char database)

void	x_Close (EIgnoreError close_mode)

void	x_CreateDB (unsigned rec_len)
	Create m_DB member, set page, cache parameters. More...

void	x_SetTransaction (CBDB_Transaction *trans)
	Set current transaction. More...

void	x_RemoveTransaction (CBDB_Transaction *trans)

DB_TXN *	GetTxn ()
	Get transaction handler. More...

DBC *	CreateCursor (CBDB_Transaction *trans=0, unsigned int flags=0) const
	Create DB cursor. More...

int	x_DB_Fetch (DBT key, DBT data, unsigned flags)
	Internal override for DB->get(...) This method overrides destination buffer and uses compressor: Should only be used with DB_DBT_USERMEM flag. More...

int	x_DBC_Fetch (DBC dbc, DBT key, DBT *data, unsigned flags)
	Internal override for DBC->c_get(...) This method overrides destination buffer and uses compressor: Should only be used with DB_DBT_USERMEM flag. More...

int	x_DB_Put (DBT key, DBT data, unsigned flags)
	Override for DB->put(...) Handles compression. More...

int	x_DB_CPut (DBC dbc, DBT key, DBT *data, unsigned flags)
	Override for DBC->c_put(...) Handles compression. More...

int	x_FetchBufferDecompress (DBT data, void usr_data)

Protected Attributes inherited from CBDB_RawFile
EDBType	m_DB_Type

DB *	m_DB

DBT *	m_DBT_Key

DBT *	m_DBT_Data

CBDB_Env *	m_Env

CBDB_Transaction *	m_Trans

int	m_TransAssociation

unsigned	m_RecLen

unsigned	m_H_ffactor

unsigned	m_H_nelem

unsigned	m_BT_minkey

AutoPtr< ICompression >	m_Compressor
	Record compressor. More...

TBuffer	m_CompressBuffer

Detailed Description

BDB file for storing volumes registry.

Definition at line 46 of file bdb_volumes.hpp.

Constructor & Destructor Documentation

◆ SVolumesDB() [1/2]

SVolumesDB::SVolumesDB ( )

inline

Definition at line 63 of file bdb_volumes.hpp.

References backup_loc, CBDB_File::BindData(), CBDB_File::BindKey(), date_from, date_to, CBDB_File::DisableNull(), location, lock, mtimestamp, raw_status, relo_volume_id, status, version, and volume_id.

◆ SVolumesDB() [2/2]

SVolumesDB::SVolumesDB ( const SVolumesDB & )

private

Member Function Documentation

◆ operator=()

SVolumesDB& SVolumesDB::operator= ( const SVolumesDB & )

private

Member Data Documentation

◆ backup_loc

CBDB_FieldString SVolumesDB::backup_loc

Location of volume backup.

Definition at line 60 of file bdb_volumes.hpp.

Referenced by SVolumesDB().

◆ date_from

CBDB_FieldUint4 SVolumesDB::date_from

Date interval.

Definition at line 55 of file bdb_volumes.hpp.

Referenced by SVolumesDB().

◆ date_to

CBDB_FieldUint4 SVolumesDB::date_to

Date interval.

Definition at line 56 of file bdb_volumes.hpp.

Referenced by SVolumesDB().

◆ location

CBDB_FieldString SVolumesDB::location

Mount point for the volume.

Definition at line 59 of file bdb_volumes.hpp.

Referenced by CBDB_Volumes::SortVolumes(), and SVolumesDB().

◆ lock

CBDB_FieldUint4 SVolumesDB::lock

Volume lock counter.

Definition at line 53 of file bdb_volumes.hpp.

Referenced by SVolumesDB().

◆ mtimestamp

CBDB_FieldUint4 SVolumesDB::mtimestamp

Modification date.

Definition at line 57 of file bdb_volumes.hpp.

Referenced by SVolumesDB().

◆ raw_status

CBDB_FieldUint4 SVolumesDB::raw_status

Raw data status.

Definition at line 52 of file bdb_volumes.hpp.

Referenced by SVolumesDB().

◆ relo_volume_id

CBDB_FieldUint4 SVolumesDB::relo_volume_id

Modification date.

Definition at line 58 of file bdb_volumes.hpp.

Referenced by SVolumesDB().

◆ status

CBDB_FieldUint4 SVolumesDB::status

Volume status.

Definition at line 51 of file bdb_volumes.hpp.

Referenced by SVolumesDB().

◆ type

CBDB_FieldUint4 SVolumesDB::type

Volume type.

Definition at line 50 of file bdb_volumes.hpp.

◆ version

CBDB_FieldUint4 SVolumesDB::version

Volume version.

Definition at line 54 of file bdb_volumes.hpp.

Referenced by SVolumesDB().

◆ volume_id

CBDB_FieldUint4 SVolumesDB::volume_id

Volume ID.

Definition at line 48 of file bdb_volumes.hpp.

Referenced by SVolumesDB().

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

include/db/bdb/bdb_volumes.hpp

Public Member Functions

Public Attributes

Private Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ SVolumesDB() [1/2]

◆ SVolumesDB() [2/2]

Member Function Documentation

◆ operator=()

Member Data Documentation

◆ backup_loc

◆ date_from

◆ date_to

◆ location

◆ lock

◆ mtimestamp

◆ raw_status

◆ relo_volume_id

◆ status

◆ type

◆ version

◆ volume_id