com.goldencode.p2j.persist

Interface AssociationSyncher.Helper

All Known Implementing Classes:

AssociationSyncher.OneToManyHelper, AssociationSyncher.OneToOneHelper

Enclosing class:

AssociationSyncher

protected static interface AssociationSyncher.Helper

An interface which abstracts a helper API for managing a foreign DMO. The abstraction hides the implementation differences between DMOs which participate in a one-to-one association versus those that participate in a one-to-many (many-to-one) association.

Method Summary

Modifier and Type	Method and Description
java.util.Set<Record>	getLocalDMOs(Record foreignDMO) Retrieve the set of local DMOs stored in a foreign DMO for this association.
void	remove(Record foreignDMO, Record localDMO) Remove the given local DMO from the set of local DMOs stored in a foreign DMO for this association.
void	replace(Record foreignDMO, java.util.Set<Record> localDMOs) Replace the set of local DMOs stored in a foreign DMO for this association.

Method Detail

getLocalDMOs

java.util.Set<Record> getLocalDMOs(Record foreignDMO)
                            throws java.lang.IllegalAccessException,
                                   java.lang.reflect.InvocationTargetException

Retrieve the set of local DMOs stored in a foreign DMO for this association.

Parameters:

foreignDMO - Foreign DMO from which to extract the set of local DMOs.

Returns:

Set of local DMOs referenced by the given foreign DMO. The set may be empty, but it will not be null.

Throws:

java.lang.IllegalAccessException - if an access error occurs while invoking a method using reflection.

java.lang.reflect.InvocationTargetException - if a method invoked using reflection throws an exception.

replace

void replace(Record foreignDMO,
             java.util.Set<Record> localDMOs)
      throws java.lang.IllegalAccessException,
             java.lang.reflect.InvocationTargetException

Replace the set of local DMOs stored in a foreign DMO for this association.

Parameters:

foreignDMO - Foreign DMO which stores a reference to local DMOs.

localDMOs - The set of local DMOs which must replace the existing set.

Throws:

java.lang.IllegalAccessException - if an access error occurs while invoking a method using reflection.

java.lang.reflect.InvocationTargetException - if a method invoked using reflection throws an exception.

remove

void remove(Record foreignDMO,
            Record localDMO)
     throws java.lang.IllegalAccessException,
            java.lang.reflect.InvocationTargetException

Remove the given local DMO from the set of local DMOs stored in a foreign DMO for this association.

Parameters:

foreignDMO - Foreign DMO which stores a reference to local DMOs.

localDMO - The local DMO to be removed from the existing set.

Throws:

java.lang.IllegalAccessException - if an access error occurs while invoking a method using reflection.

java.lang.reflect.InvocationTargetException - if a method invoked using reflection throws an exception.