Database external interface. More...

#include <database_iface.h>

Inheritance diagram for fairport::db_context:

Collaboration diagram for fairport::db_context:

Public Member Functions
virtual	~db_context ()
virtual bool	is_pst () const =0
	Is this database a PST?
Lookup functions
virtual node	lookup_node (node_id nid)=0
	Open a node.
virtual node_info	lookup_node_info (node_id nid)=0
	Lookup information about a node.
virtual block_info	lookup_block_info (block_id bid)=0
	Lookup information about a block.
Page factory functions
virtual std::tr1::shared_ptr < bbt_page >	read_bbt_root ()=0
	Get the root of the BBT of this context.
virtual std::tr1::shared_ptr < nbt_page >	read_nbt_root ()=0
	Get the root of the NBT of this context.
virtual std::tr1::shared_ptr < bbt_page >	read_bbt_page (const page_info &pi)=0
	Open a BBT page.
virtual std::tr1::shared_ptr < nbt_page >	read_nbt_page (const page_info &pi)=0
	Open a NBT page.
virtual std::tr1::shared_ptr < nbt_leaf_page >	read_nbt_leaf_page (const page_info &pi)=0
	Open a NBT leaf page.
virtual std::tr1::shared_ptr < bbt_leaf_page >	read_bbt_leaf_page (const page_info &pi)=0
	Open a BBT leaf page.
virtual std::tr1::shared_ptr < nbt_nonleaf_page >	read_nbt_nonleaf_page (const page_info &pi)=0
	Open a NBT nonleaf page.
virtual std::tr1::shared_ptr < bbt_nonleaf_page >	read_bbt_nonleaf_page (const page_info &pi)=0
	Open a BBT nonleaf page.
Block factory functions
std::tr1::shared_ptr< block >	read_block (block_id bid)
	Open a block in this context.
std::tr1::shared_ptr< data_block >	read_data_block (block_id bid)
	Open a data_block in this context.
std::tr1::shared_ptr < extended_block >	read_extended_block (block_id bid)
	Open a extended_block in this context.
std::tr1::shared_ptr < external_block >	read_external_block (block_id bid)
	Open a external_block in this context.
std::tr1::shared_ptr < subnode_block >	read_subnode_block (block_id bid)
	Open a subnode_block in this context.
std::tr1::shared_ptr < subnode_leaf_block >	read_subnode_leaf_block (block_id bid)
	Open a subnode_leaf_block in this context.
std::tr1::shared_ptr < subnode_nonleaf_block >	read_subnode_nonleaf_block (block_id bid)
	Open a subnode_nonleaf_block in this context.
virtual std::tr1::shared_ptr < block >	read_block (const shared_db_ptr &parent, block_id bid)=0
	Open a block in the specified context.
virtual std::tr1::shared_ptr < data_block >	read_data_block (const shared_db_ptr &parent, block_id bid)=0
	Open a data_block in the specified context.
virtual std::tr1::shared_ptr < extended_block >	read_extended_block (const shared_db_ptr &parent, block_id bid)=0
	Open an extended_block in the specified context.
virtual std::tr1::shared_ptr < external_block >	read_external_block (const shared_db_ptr &parent, block_id bid)=0
	Open a external_block in the specified context.
virtual std::tr1::shared_ptr < subnode_block >	read_subnode_block (const shared_db_ptr &parent, block_id bid)=0
	Open a subnode_block in the specified context.
virtual std::tr1::shared_ptr < subnode_leaf_block >	read_subnode_leaf_block (const shared_db_ptr &parent, block_id bid)=0
	Open a subnode_leaf_block in the specified context.
virtual std::tr1::shared_ptr < subnode_nonleaf_block >	read_subnode_nonleaf_block (const shared_db_ptr &parent, block_id bid)=0
	Open a subnode_nonleaf_block in the specified context.
std::tr1::shared_ptr< block >	read_block (const block_info &bi)
	Open a block in this context.
std::tr1::shared_ptr< data_block >	read_data_block (const block_info &bi)
	Open a data_block in this context.
std::tr1::shared_ptr < extended_block >	read_extended_block (const block_info &bi)
	Open a extended_block in this context.
std::tr1::shared_ptr < external_block >	read_external_block (const block_info &bi)
	Open a block in this context.
std::tr1::shared_ptr < subnode_block >	read_subnode_block (const block_info &bi)
	Open a subnode_block in this context.
std::tr1::shared_ptr < subnode_leaf_block >	read_subnode_leaf_block (const block_info &bi)
	Open a subnode_leaf_block in this context.
std::tr1::shared_ptr < subnode_nonleaf_block >	read_subnode_nonleaf_block (const block_info &bi)
	Open a subnode_nonleaf_block in this context.
virtual std::tr1::shared_ptr < block >	read_block (const shared_db_ptr &parent, const block_info &bi)=0
	Open a block in the specified context.
virtual std::tr1::shared_ptr < data_block >	read_data_block (const shared_db_ptr &parent, const block_info &bi)=0
	Open a data_block in the specified context.
virtual std::tr1::shared_ptr < extended_block >	read_extended_block (const shared_db_ptr &parent, const block_info &bi)=0
	Open a extended_block in the specified context.
virtual std::tr1::shared_ptr < external_block >	read_external_block (const shared_db_ptr &parent, const block_info &bi)=0
	Open a external_block in the specified context.
virtual std::tr1::shared_ptr < subnode_block >	read_subnode_block (const shared_db_ptr &parent, const block_info &bi)=0
	Open a subnode_block in the specified context.
virtual std::tr1::shared_ptr < subnode_leaf_block >	read_subnode_leaf_block (const shared_db_ptr &parent, const block_info &bi)=0
	Open a subnode_leaf_block in the specified context.
virtual std::tr1::shared_ptr < subnode_nonleaf_block >	read_subnode_nonleaf_block (const shared_db_ptr &parent, const block_info &bi)=0
	Open a subnode_nonleaf_block in the specified context.

Detailed Description

Database external interface.

The db_context is the iterface which all components, NDB Layer and up, use to access the PST file. It is basically an object factory; given an address (or other relative context to help locate the physical piece of data) a db_context will produce an in memory version of that data structure, with all the Unicode vs. ANSI differences abstracted away.

Definition at line 118 of file database_iface.h.

Constructor & Destructor Documentation

virtual fairport::db_context::~db_context ( ) [inline, virtual]

Definition at line 121 of file database_iface.h.

Member Function Documentation

virtual bool fairport::db_context::is_pst ( ) const [pure virtual]

Is this database a PST?

Returns:: Returns true if this is PST, false if an OST or something else.

Implemented in fairport::database_impl< T >.

virtual block_info fairport::db_context::lookup_block_info ( block_id bid ) [pure virtual]

Lookup information about a block.

Exceptions:

key_not_found<block_id> if the specified block was not found

Parameters:

[in] bid The id of the block to lookup

Returns:: Information about the specified block

Implemented in fairport::database_impl< T >.

virtual node fairport::db_context::lookup_node ( node_id nid ) [pure virtual]

Open a node.

Exceptions:

key_not_found<node_id> if the specified node was not found

Parameters:

[in] nid The id of the node to lookup

Returns:: A node instance

Implemented in fairport::database_impl< T >.

virtual node_info fairport::db_context::lookup_node_info ( node_id nid ) [pure virtual]

Lookup information about a node.

Exceptions:

key_not_found<node_id> if the specified node was not found

Parameters:

[in] nid The id of the node to lookup

Returns:: Information about the specified node

Implemented in fairport::database_impl< T >.

virtual std::tr1::shared_ptr<bbt_leaf_page> fairport::db_context::read_bbt_leaf_page ( const page_info & pi ) [pure virtual]

Open a BBT leaf page.

Parameters:

[in] pi Information about the page to open

Exceptions:

unexpected_page	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the page appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the page trailer's signature appears incorrect
database_corrupt	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the page trailer's ptypeRepeat != ptype
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the page's CRC doesn't match the trailer

Returns:: The requested page

Implemented in fairport::database_impl< T >.

virtual std::tr1::shared_ptr<bbt_nonleaf_page> fairport::db_context::read_bbt_nonleaf_page ( const page_info & pi ) [pure virtual]

Open a BBT nonleaf page.

Parameters:

[in] pi Information about the page to open

Exceptions:

unexpected_page	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the page appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the page trailer's signature appears incorrect
database_corrupt	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the page trailer's ptypeRepeat != ptype
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the page's CRC doesn't match the trailer

Returns:: The requested page

Implemented in fairport::database_impl< T >.

virtual std::tr1::shared_ptr<bbt_page> fairport::db_context::read_bbt_page ( const page_info & pi ) [pure virtual]

Open a BBT page.

Exceptions:

unexpected_page	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the page appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the page trailer's signature appears incorrect
database_corrupt	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the page trailer's ptypeRepeat != ptype
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the page's CRC doesn't match the trailer

Returns:: The requested page

Implemented in fairport::database_impl< T >.

virtual std::tr1::shared_ptr<bbt_page> fairport::db_context::read_bbt_root ( ) [pure virtual]

Get the root of the BBT of this context.

Exceptions:

unexpected_page	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the page appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the page trailer's signature appears incorrect
database_corrupt	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the page trailer's ptypeRepeat != ptype
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the page's CRC doesn't match the trailer

Returns:: The requested page

Implemented in fairport::database_impl< T >.

std::tr1::shared_ptr<block> fairport::db_context::read_block ( block_id bid ) [inline]

Open a block in this context.

Parameters:

[in] bid The id of the block to open

Exceptions:

unexpected_block	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the block appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the block trailer's signature appears incorrect
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the block's CRC doesn't match the trailer

Returns:: The requested block

Definition at line 219 of file database_iface.h.

virtual std::tr1::shared_ptr<block> fairport::db_context::read_block	(	const shared_db_ptr &	parent,
		block_id	bid
	)		`[pure virtual]`

Open a block in the specified context.

Parameters:

[in]	parent	The context to open this block in. It must be either this context or a child context of this context.
[in]	bid	The id of the block to open

Exceptions:

unexpected_block	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the block appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the block trailer's signature appears incorrect
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the block's CRC doesn't match the trailer

Returns:: The requested block

Implemented in fairport::database_impl< T >.

std::tr1::shared_ptr<block> fairport::db_context::read_block ( const block_info & bi ) [inline]

Open a block in this context.

Parameters:

[in] bi Information about the block to open

Exceptions:

unexpected_block	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the block appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the block trailer's signature appears incorrect
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the block's CRC doesn't match the trailer

Returns:: The requested block

Definition at line 325 of file database_iface.h.

virtual std::tr1::shared_ptr<block> fairport::db_context::read_block	(	const shared_db_ptr &	parent,
		const block_info &	bi
	)		`[pure virtual]`

Open a block in the specified context.

Parameters:

[in]	parent	The context to open this block in. It must be either this context or a child context of this context.
[in]	bi	Information about the block to open

Exceptions:

unexpected_block	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the block appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the block trailer's signature appears incorrect
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the block's CRC doesn't match the trailer

Returns:: The requested block

Implemented in fairport::database_impl< T >.

std::tr1::shared_ptr<data_block> fairport::db_context::read_data_block ( block_id bid ) [inline]

Open a data_block in this context.

Parameters:

[in] bid The id of the block to open

Exceptions:

unexpected_block	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the block appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the block trailer's signature appears incorrect
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the block's CRC doesn't match the trailer

Returns:: The requested block

Definition at line 226 of file database_iface.h.

virtual std::tr1::shared_ptr<data_block> fairport::db_context::read_data_block	(	const shared_db_ptr &	parent,
		block_id	bid
	)		`[pure virtual]`

Open a data_block in the specified context.

Parameters:

[in]	parent	The context to open this block in. It must be either this context or a child context of this context.
[in]	bid	The id of the block to open

Exceptions:

unexpected_block	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the block appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the block trailer's signature appears incorrect
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the block's CRC doesn't match the trailer

Returns:: The requested block

Implemented in fairport::database_impl< T >.

std::tr1::shared_ptr<data_block> fairport::db_context::read_data_block ( const block_info & bi ) [inline]

Open a data_block in this context.

Parameters:

[in] bi Information about the block to open

Exceptions:

unexpected_block	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the block appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the block trailer's signature appears incorrect
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the block's CRC doesn't match the trailer

Returns:: The requested block

Definition at line 332 of file database_iface.h.

virtual std::tr1::shared_ptr<data_block> fairport::db_context::read_data_block	(	const shared_db_ptr &	parent,
		const block_info &	bi
	)		`[pure virtual]`

Open a data_block in the specified context.

Parameters:

[in]	parent	The context to open this block in. It must be either this context or a child context of this context.
[in]	bi	Information about the block to open

Exceptions:

unexpected_block	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the block appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the block trailer's signature appears incorrect
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the block's CRC doesn't match the trailer

Returns:: The requested block

Implemented in fairport::database_impl< T >.

std::tr1::shared_ptr<extended_block> fairport::db_context::read_extended_block ( block_id bid ) [inline]

Open a extended_block in this context.

Parameters:

[in] bid The id of the block to open

Exceptions:

unexpected_block	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the block appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the block trailer's signature appears incorrect
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the block's CRC doesn't match the trailer

Returns:: The requested block

Definition at line 233 of file database_iface.h.

virtual std::tr1::shared_ptr<extended_block> fairport::db_context::read_extended_block	(	const shared_db_ptr &	parent,
		block_id	bid
	)		`[pure virtual]`

Open an extended_block in the specified context.

Parameters:

[in]	parent	The context to open this block in. It must be either this context or a child context of this context.
[in]	bid	The id of the block to open

Exceptions:

unexpected_block	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the block appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the block trailer's signature appears incorrect
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the block's CRC doesn't match the trailer

Returns:: The requested block

Implemented in fairport::database_impl< T >.

std::tr1::shared_ptr<extended_block> fairport::db_context::read_extended_block ( const block_info & bi ) [inline]

Open a extended_block in this context.

Parameters:

[in] bi Information about the block to open

Exceptions:

unexpected_block	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the block appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the block trailer's signature appears incorrect
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the block's CRC doesn't match the trailer

Returns:: The requested block

Definition at line 339 of file database_iface.h.

virtual std::tr1::shared_ptr<extended_block> fairport::db_context::read_extended_block	(	const shared_db_ptr &	parent,
		const block_info &	bi
	)		`[pure virtual]`

Open a extended_block in the specified context.

Parameters:

[in]	parent	The context to open this block in. It must be either this context or a child context of this context.
[in]	bi	Information about the block to open

Exceptions:

unexpected_block	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the block appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the block trailer's signature appears incorrect
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the block's CRC doesn't match the trailer

Returns:: The requested block

Implemented in fairport::database_impl< T >.

std::tr1::shared_ptr<external_block> fairport::db_context::read_external_block ( block_id bid ) [inline]

Open a external_block in this context.

Parameters:

[in] bid The id of the block to open

Exceptions:

unexpected_block	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the block appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the block trailer's signature appears incorrect
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the block's CRC doesn't match the trailer

Returns:: The requested block

Definition at line 240 of file database_iface.h.

virtual std::tr1::shared_ptr<external_block> fairport::db_context::read_external_block	(	const shared_db_ptr &	parent,
		block_id	bid
	)		`[pure virtual]`

Open a external_block in the specified context.

Parameters:

[in]	parent	The context to open this block in. It must be either this context or a child context of this context.
[in]	bid	The id of the block to open

Exceptions:

unexpected_block	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the block appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the block trailer's signature appears incorrect
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the block's CRC doesn't match the trailer

Returns:: The requested block

Implemented in fairport::database_impl< T >.

std::tr1::shared_ptr<external_block> fairport::db_context::read_external_block ( const block_info & bi ) [inline]

Open a block in this context.

Parameters:

[in] bi Information about the block to open

Exceptions:

unexpected_block	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the block appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the block trailer's signature appears incorrect
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the block's CRC doesn't match the trailer

Returns:: The requested block

Definition at line 346 of file database_iface.h.

virtual std::tr1::shared_ptr<external_block> fairport::db_context::read_external_block	(	const shared_db_ptr &	parent,
		const block_info &	bi
	)		`[pure virtual]`

Open a external_block in the specified context.

Parameters:

[in]	parent	The context to open this block in. It must be either this context or a child context of this context.
[in]	bi	Information about the block to open

Exceptions:

unexpected_block	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the block appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the block trailer's signature appears incorrect
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the block's CRC doesn't match the trailer

Returns:: The requested block

Implemented in fairport::database_impl< T >.

virtual std::tr1::shared_ptr<nbt_leaf_page> fairport::db_context::read_nbt_leaf_page ( const page_info & pi ) [pure virtual]

Open a NBT leaf page.

Parameters:

[in] pi Information about the page to open

Exceptions:

unexpected_page	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the page appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the page trailer's signature appears incorrect
database_corrupt	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the page trailer's ptypeRepeat != ptype
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the page's CRC doesn't match the trailer

Returns:: The requested page

Implemented in fairport::database_impl< T >.

virtual std::tr1::shared_ptr<nbt_nonleaf_page> fairport::db_context::read_nbt_nonleaf_page ( const page_info & pi ) [pure virtual]

Open a NBT nonleaf page.

Parameters:

[in] pi Information about the page to open

Exceptions:

unexpected_page	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the page appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the page trailer's signature appears incorrect
database_corrupt	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the page trailer's ptypeRepeat != ptype
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the page's CRC doesn't match the trailer

Returns:: The requested page

Implemented in fairport::database_impl< T >.

virtual std::tr1::shared_ptr<nbt_page> fairport::db_context::read_nbt_page ( const page_info & pi ) [pure virtual]

Open a NBT page.

Parameters:

[in] pi Information about the page to open

Exceptions:

unexpected_page	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the page appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the page trailer's signature appears incorrect
database_corrupt	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the page trailer's ptypeRepeat != ptype
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the page's CRC doesn't match the trailer

Returns:: The requested page

Implemented in fairport::database_impl< T >.

virtual std::tr1::shared_ptr<nbt_page> fairport::db_context::read_nbt_root ( ) [pure virtual]

Get the root of the NBT of this context.

Exceptions:

unexpected_page	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the page appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the page trailer's signature appears incorrect
database_corrupt	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the page trailer's ptypeRepeat != ptype
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the page's CRC doesn't match the trailer

Returns:: The requested page

Implemented in fairport::database_impl< T >.

std::tr1::shared_ptr<subnode_block> fairport::db_context::read_subnode_block ( block_id bid ) [inline]

Open a subnode_block in this context.

Parameters:

[in] bid The id of the block to open

Exceptions:

unexpected_block	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the block appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the block trailer's signature appears incorrect
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the block's CRC doesn't match the trailer

Returns:: The requested block

Definition at line 247 of file database_iface.h.

virtual std::tr1::shared_ptr<subnode_block> fairport::db_context::read_subnode_block	(	const shared_db_ptr &	parent,
		block_id	bid
	)		`[pure virtual]`

Open a subnode_block in the specified context.

Parameters:

[in]	parent	The context to open this block in. It must be either this context or a child context of this context.
[in]	bid	The id of the block to open

Exceptions:

unexpected_block	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the block appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the block trailer's signature appears incorrect
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the block's CRC doesn't match the trailer

Returns:: The requested block

Implemented in fairport::database_impl< T >.

std::tr1::shared_ptr<subnode_block> fairport::db_context::read_subnode_block ( const block_info & bi ) [inline]

Open a subnode_block in this context.

Parameters:

[in] bi Information about the block to open

Exceptions:

unexpected_block	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the block appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the block trailer's signature appears incorrect
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the block's CRC doesn't match the trailer

Returns:: The requested block

Definition at line 353 of file database_iface.h.

virtual std::tr1::shared_ptr<subnode_block> fairport::db_context::read_subnode_block	(	const shared_db_ptr &	parent,
		const block_info &	bi
	)		`[pure virtual]`

Open a subnode_block in the specified context.

Parameters:

[in]	parent	The context to open this block in. It must be either this context or a child context of this context.
[in]	bi	Information about the block to open

Exceptions:

unexpected_block	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the block appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the block trailer's signature appears incorrect
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the block's CRC doesn't match the trailer

Returns:: The requested block

Implemented in fairport::database_impl< T >.

std::tr1::shared_ptr<subnode_leaf_block> fairport::db_context::read_subnode_leaf_block ( block_id bid ) [inline]

Open a subnode_leaf_block in this context.

Parameters:

[in] bid The id of the block to open

Exceptions:

unexpected_block	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the block appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the block trailer's signature appears incorrect
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the block's CRC doesn't match the trailer

Returns:: The requested block

Definition at line 254 of file database_iface.h.

virtual std::tr1::shared_ptr<subnode_leaf_block> fairport::db_context::read_subnode_leaf_block	(	const shared_db_ptr &	parent,
		block_id	bid
	)		`[pure virtual]`

Open a subnode_leaf_block in the specified context.

Parameters:

[in]	parent	The context to open this block in. It must be either this context or a child context of this context.
[in]	bid	The id of the block to open

Exceptions:

unexpected_block	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the block appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the block trailer's signature appears incorrect
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the block's CRC doesn't match the trailer

Returns:: The requested block

Implemented in fairport::database_impl< T >.

std::tr1::shared_ptr<subnode_leaf_block> fairport::db_context::read_subnode_leaf_block ( const block_info & bi ) [inline]

Open a subnode_leaf_block in this context.

Parameters:

[in] bi Information about the block to open

Exceptions:

unexpected_block	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the block appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the block trailer's signature appears incorrect
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the block's CRC doesn't match the trailer

Returns:: The requested block

Definition at line 360 of file database_iface.h.

virtual std::tr1::shared_ptr<subnode_leaf_block> fairport::db_context::read_subnode_leaf_block	(	const shared_db_ptr &	parent,
		const block_info &	bi
	)		`[pure virtual]`

Open a subnode_leaf_block in the specified context.

Parameters:

[in]	parent	The context to open this block in. It must be either this context or a child context of this context.
[in]	bi	Information about the block to open

Exceptions:

unexpected_block	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the block appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the block trailer's signature appears incorrect
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the block's CRC doesn't match the trailer

Returns:: The requested block

Implemented in fairport::database_impl< T >.

std::tr1::shared_ptr<subnode_nonleaf_block> fairport::db_context::read_subnode_nonleaf_block ( block_id bid ) [inline]

Open a subnode_nonleaf_block in this context.

Parameters:

[in] bid The id of the block to open

Exceptions:

unexpected_block	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the block appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the block trailer's signature appears incorrect
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the block's CRC doesn't match the trailer

Returns:: The requested block

Definition at line 261 of file database_iface.h.

virtual std::tr1::shared_ptr<subnode_nonleaf_block> fairport::db_context::read_subnode_nonleaf_block	(	const shared_db_ptr &	parent,
		block_id	bid
	)		`[pure virtual]`

Open a subnode_nonleaf_block in the specified context.

Parameters:

[in]	parent	The context to open this block in. It must be either this context or a child context of this context.
[in]	bid	The id of the block to open

Exceptions:

unexpected_block	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the block appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the block trailer's signature appears incorrect
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the block's CRC doesn't match the trailer

Returns:: The requested block

Implemented in fairport::database_impl< T >.

std::tr1::shared_ptr<subnode_nonleaf_block> fairport::db_context::read_subnode_nonleaf_block ( const block_info & bi ) [inline]

Open a subnode_nonleaf_block in this context.

Parameters:

[in] bi Information about the block to open

Exceptions:

unexpected_block	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the block appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the block trailer's signature appears incorrect
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the block's CRC doesn't match the trailer

Returns:: The requested block

Definition at line 367 of file database_iface.h.

virtual std::tr1::shared_ptr<subnode_nonleaf_block> fairport::db_context::read_subnode_nonleaf_block	(	const shared_db_ptr &	parent,
		const block_info &	bi
	)		`[pure virtual]`

Open a subnode_nonleaf_block in the specified context.

Parameters:

[in]	parent	The context to open this block in. It must be either this context or a child context of this context.
[in]	bi	Information about the block to open

Exceptions:

unexpected_block	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the parameters of the block appear incorrect
sig_mismatch	(FAIRPORT_VALIDATION_LEVEL_WEAK) If the block trailer's signature appears incorrect
crc_fail	(FAIRPORT_VALIDATION_LEVEL_FULL) If the block's CRC doesn't match the trailer

Returns:: The requested block

Implemented in fairport::database_impl< T >.

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

fairport/ndb/database_iface.h

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation