com.canto.cumulus.server.esp.modules.dbmirror

Class DBRebuild

java.lang.Object

com.canto.cumulus.server.esp.modules.dbmirror.DBRebuild

public class DBRebuild
extends java.lang.Object

This class allows your DBMirror esp to rebuild a Cumulus database. You will get an instance of this class via the DBMirrorWorker.rebuild(DBRebuild) method. The order in which the rebuild needs to happen is:

• Rebuild the MASTER_TABLE
• Rebuild the MISC_TABLE
• Rebuild all Cue Tables

Rebuilding a table has several steps:

• Call beginTable(int, String, int) to let the Cumulus server know about a new table
• Call addTableEntry(String, com.canto.cumulus.utils.JPack) (for Named Tables) or addTableEntry(int, com.canto.cumulus.utils.JPack) (for Cue Tables) for all table entries
• Call endTable() to let the Cumulus server know that a table is completely processed.

After all tables have been processed this method is left and all the needed resources are freed.

Method Summary

Methods

Modifier and Type	Method and Description
void	addTableEntry(int recordID, JPack pack) Rebuild an entry of a Cue Table.
void	addTableEntry(java.lang.String recordName, JPack pack) Rebuild an entry of a Named Table.
void	beginTable(int tableType, java.lang.String name, int expectedEntries) Needs to be called before any entry of a table can be sent to the Cumulus server.
void	endTable() Needs to be called after all entries of a table have been rebuild.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

beginTable

public void beginTable(int tableType,
              java.lang.String name,
              int expectedEntries)

Needs to be called before any entry of a table can be sent to the Cumulus server.

Parameters:

tableType - type of the table. Can be one of the following: MirroringTask.TABLE_TYPE_CUE_TABLE, MirroringTask.TABLE_TYPE_MASTER_TABLE or MirroringTask.TABLE_TYPE_MISC_TABLE.

name - name of the table. only relevant for Cue Tables. Can be null in case of a Named Table.

expectedEntries - only relevant for Cue Tables but should be set to the number of entries that will be added to the table. Can be 0 in case of a Named Table.

addTableEntry

public void addTableEntry(java.lang.String recordName,
                 JPack pack)

Rebuild an entry of a Named Table.

Parameters:

recordName - primary key of the entry in the Named Table currently being processed

pack - value of the entry in the Named Table

addTableEntry

public void addTableEntry(int recordID,
                 JPack pack)

Rebuild an entry of a Cue Table.

Parameters:

recordID - primary key of the entry

pack - data of the entry

endTable

public void endTable()

Needs to be called after all entries of a table have been rebuild.