Zeta Components - high quality PHP components

This interface declares methods common for handlers that support bulk data transfers.

Description:

There are two handler participating in bulk data transfer: source and destination. Each of the handlers must implement ezcDbSchemaHandlerDataTransfer interface.

The source handler implements transfer() method. This method transfers all the tables in storage one-by-one.

For each of the tables we transfer data of, the source handler calls setTableBeingTransferred() method on the destination handler.

For each row being transferred, the source handler calls saveRow() method on the destination handler.

Besides, when the transfer starts, we call destination handler's openTransferDestination() method, and when the transfer finishes, we call destination handler's closeTransferDestination() method.

Here is a typical implementation of transfer() method:

1.  class SomeSchemaHandler
2.  {
3.      public function transfer(  $storage, $storageType, $dstHandler )
4.      {
5.          $tables = $this->getTablesList();
6.          foreach ( $tables as $tableName )
7.          {
8.              $tableFields = $this->getTableFields( $tableName );
9.              $dstHandler->setTableBeingTransferred( $tableName, $tableFields );
10.  
11.              $tableData = $this->getTableData( $tableName );
12.              foreach ( $tableData as $row )
13.                  $dstHandler->saveRow( $row );
14.          }
15.      }
16.  }

The destination handler should implement the following methods:

• openTransferDestination()
• setTableBeingTransferred()
• saveRow()
• closeTransferDestination()