oracle.odi.missingref

Interface IMissingRefService

All Known Implementing Classes:

MissingRefServiceImpl

public interface IMissingRefService

This interface provide all the method needed to manage missing references.

Since:

11.1.1.3.0

Method Summary

Modifier and Type	Method and Description
java.util.Collection	findMissingReferences(java.lang.Class pOdiEntityClass, java.io.Serializable pOdiEntityId, boolean pApplyToChildren) Query the missing references for the given entity type and identifier.
void	markAsFixed(java.util.Collection pMissingRefs) Mark the given missing references collection as fixed.
void	markAsFixed(IMissingRef pMissingRef) Mark the given missing reference as fixed.

Method Detail

markAsFixed

void markAsFixed(IMissingRef pMissingRef)

Mark the given missing reference as fixed. This will basically remove the related information from the repository. You should have already repaired the broken relationship described by the given IMissinRef instance.

This method needs to be called within a surrounding transaction. If no transaction is started, this method will throw an IllegalTransactionStateException.

Parameters:

pMissingRef - The missing reference that has been corrected and therefore no longer exist

Throws:

java.lang.IllegalArgumentException - if the given missing ref is null

IllegalTransactionStateException - if no transaction is started

See Also:

markAsFixed(Collection)

markAsFixed

void markAsFixed(java.util.Collection pMissingRefs)

Mark the given missing references collection as fixed.

Parameters:

pMissingRefs - the collection of missing refs that have been corrected and therefore no longer exist

Throws:

java.lang.IllegalArgumentException - if the given collection is null

IllegalTransactionStateException - if no transaction is started

See Also:

markAsFixed(IMissingRef)

findMissingReferences

java.util.Collection findMissingReferences(java.lang.Class pOdiEntityClass,
                                           java.io.Serializable pOdiEntityId,
                                           boolean pApplyToChildren)

Query the missing references for the given entity type and identifier.

Returns an empty collection if no missing ref was found.

This method doesn't need to be called within a surrounding transaction.

Parameters:

pOdiEntityClass - the entity java class

pOdiEntityId - the entity internal identifier

pApplyToChildren - true to apply the query to children of the entity, false otherwise

Returns:

the collection of missing references for the given entity

Throws:

java.lang.IllegalArgumentException - if the given class is null

java.lang.IllegalArgumentException - if the given entity id is null