Skip navigation links

Oracle Fusion Middleware Java API Reference for Oracle Extension SDK
11g Release 2 (11.1.2.3.0)

E17493-04


oracle.ide.db.transfer
Interface TransferPolicy


public interface TransferPolicy

Interface for the classes which copy objects for transfer.

Given the source DBObjectProvider, target DBObjectProvider and array of source object descriptors it has to:

  1. Find existing objects in target
  2. Copy existing objects
  3. Set up the copy for transfer.
    This step sets the ID's so that they can be reconciled with the existing objects.

Method Summary
 SystemObject[] copyForTransfer(TransferDescriptor td, SystemObject[] existingObjects)
          Copy the objects for transfer.
 Difference filterDiff(TransferDescriptor td, Difference diff)
          Filter the differences to remove any which are not applicable to the transfer policy.
 SystemObject[] findExistingObjects(TransferDescriptor td)
          Find any existing objects in the transfer target.
 ResultSet getDifferences(TransferDescriptor td, SystemObject[] existingObjects, SystemObject[] copiedObjects)
          Get a ResultSet describing the differences between any existing objects and the objects which have been copied for transfer.

 

Method Detail

findExistingObjects

SystemObject[] findExistingObjects(TransferDescriptor td)
                                   throws TransferFailedException
Find any existing objects in the transfer target.
Parameters:
td - the descriptor for the transfer
Returns:
an array of existing objects that matches up to the array of descriptors in the TransferDescriptor
Throws:
TransferFailedException - if there is a problem finding the existing objects that is unrecoverable

copyForTransfer

SystemObject[] copyForTransfer(TransferDescriptor td,
                               SystemObject[] existingObjects)
                               throws TransferFailedException
Copy the objects for transfer. The copy policy used will endeavour to set the copy IDs to match any existing IDs. The copy policy will build a Map of the original ids and the copy ids
Parameters:
td - the descriptor for the transfer
existingObjects - the objects that exist in the target as discovered by findExistingObjects
Returns:
an array of objects ready to be given to the transfer target.
Throws:
TransferFailedException - if the copy operation fails

getDifferences

ResultSet getDifferences(TransferDescriptor td,
                         SystemObject[] existingObjects,
                         SystemObject[] copiedObjects)
Get a ResultSet describing the differences between any existing objects and the objects which have been copied for transfer.
Parameters:
existingObjects - the objects already in the transfer target
copiedObjects - the objects that have been prepared to be transfered to the target
Returns:
a ResultSet containing the differences between the two sets of objects

filterDiff

Difference filterDiff(TransferDescriptor td,
                      Difference diff)
Filter the differences to remove any which are not applicable to the transfer policy.
Parameters:
td -
diff - a ResultSet containing the differences between the two sets of objects
Returns:

Skip navigation links

Oracle Fusion Middleware Java API Reference for Oracle Extension SDK
11g Release 2 (11.1.2.3.0)

E17493-04


Copyright © 1997, 2012, Oracle. All rights reserved.