casa::TableSyncData Class Reference
[Tables_internal_classes]

#include <TableSyncData.h>

Collaboration diagram for casa::TableSyncData:

[legend]List of all members.

---

Detailed Description

Class to hold table synchronization data.

Intended use:

Internal

Review Status

Reviewed By:

UNKNOWN

Date Reviewed:

before2004/08/25

Test programs:

tTable

Prerequisite

• class TableLockData

Synopsis

This class keeps counters to synchronize the table data when a table is locked or unlocked.
A few counters are kept by this class:

• The numbers of rows in the table.
• The number of columns in the table.
• The table change counter.
• A change counter per data manager.

When a lock on the table is acquired, it reads the sync data from the lock file and determines if anything has changed. If so, the necessary steps are taken to reread the table data when needed.
When a lock on the table is released, it updates and writes the sync data which tells if table data have changed.

This class can also be used for the synchronization of tables and external fillers (see class ExternalLockSync ). For this purpose it is sufficient to store the number of rows.

Definition at line 78 of file TableSyncData.h.

Public Member Functions
	TableSyncData ()
	~TableSyncData ()
void	write (uInt nrrow, uInt nrcolumn, Bool tableChanged, const Block< Bool > &dataManChanged)
	Update the synchronization data and write it into the MemoryIO object.
void	write (uInt nrrow)
	Update the synchronization data and write it into the MemoryIO object.
Bool	read (uInt &nrrow, uInt &nrcolumn, Bool &tableChanged, Block< Bool > &dataManChanged)
	Read the synchronization data from the MemoryIO object.
MemoryIO &	memoryIO ()
	Get the MemoryIO object.
uInt	getModifyCounter () const
	Get the modify counter.
Private Member Functions
	TableSyncData (const TableSyncData &that)
	Copy constructor is forbidden.
TableSyncData &	operator= (const TableSyncData &that)
	Assignment is forbidden.
Private Attributes
uInt	itsNrrow
Int	itsNrcolumn
uInt	itsModifyCounter
uInt	itsTableChangeCounter
Block< uInt >	itsDataManChangeCounter
MemoryIO	itsMemIO
AipsIO	itsAipsIO

---

Constructor & Destructor Documentation

casa::TableSyncData::TableSyncData

(

)

casa::TableSyncData::~TableSyncData

(

)

casa::TableSyncData::TableSyncData

(

const TableSyncData &

that

)

[private]

Copy constructor is forbidden.

---

Member Function Documentation

void casa::TableSyncData::write	(	uInt	nrrow,
		uInt	nrcolumn,
		Bool	tableChanged,
		const Block< Bool > &	dataManChanged
	)

Update the synchronization data and write it into the MemoryIO object.

This function is called when a table flush is done to reflect if anything has changed compared to the previous flush.

Referenced by casa::ExternalLockSync::doReleaseCallBack().

void casa::TableSyncData::write

(

uInt

nrrow

)

Update the synchronization data and write it into the MemoryIO object.

This function should be used by an external filler when it flushes its data.

Bool casa::TableSyncData::read	(	uInt &	nrrow,
		uInt &	nrcolumn,
		Bool &	tableChanged,
		Block< Bool > &	dataManChanged
	)

Read the synchronization data from the MemoryIO object.

This function is called when a lock is acquired to see if table data has to be reread.
It returns False when the MemoryIO object is empty.

MemoryIO & casa::TableSyncData::memoryIO

(

)

[inline]

Get the MemoryIO object.

This is used to let LockFile read or write the synchronization data into it.

Definition at line 132 of file TableSyncData.h.

References itsMemIO.

Referenced by casa::ExternalLockSync::doReleaseCallBack().

uInt casa::TableSyncData::getModifyCounter

(

)

const [inline]

Get the modify counter.

Definition at line 136 of file TableSyncData.h.

References itsModifyCounter.

TableSyncData& casa::TableSyncData::operator=

(

const TableSyncData &

that

)

[private]

Assignment is forbidden.

---

Member Data Documentation

uInt casa::TableSyncData::itsNrrow [private]

Definition at line 121 of file TableSyncData.h.

Int casa::TableSyncData::itsNrcolumn [private]

Definition at line 122 of file TableSyncData.h.

uInt casa::TableSyncData::itsModifyCounter [private]

Definition at line 123 of file TableSyncData.h.

Referenced by getModifyCounter().

uInt casa::TableSyncData::itsTableChangeCounter [private]

Definition at line 124 of file TableSyncData.h.

Block<uInt> casa::TableSyncData::itsDataManChangeCounter [private]

Definition at line 125 of file TableSyncData.h.

MemoryIO casa::TableSyncData::itsMemIO [private]

Definition at line 126 of file TableSyncData.h.

Referenced by memoryIO().

AipsIO casa::TableSyncData::itsAipsIO [private]

Definition at line 127 of file TableSyncData.h.

---

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

• tables/implement/Tables/TableSyncData.h

---