com.goldencode.p2j.persist

Class AssociationSyncher.OneToManyHelper

java.lang.Object

com.goldencode.p2j.persist.AssociationSyncher.OneToManyHelper

All Implemented Interfaces:

AssociationSyncher.Helper

Enclosing class:

AssociationSyncher

protected final class AssociationSyncher.OneToManyHelper
extends java.lang.Object
implements AssociationSyncher.Helper

An implementation of the Helper interface which assumes a one-to-many association from a foreign DMO to zero or more local DMOs. This has implications for the methods used to retrieve and update the foreign record's reference to the local end of the association.

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.reflect.Method	getter Method used to retrieve set of local DMOs from foreign DMO
private RelationInfo	info Object containing information about the nature of the association
private java.lang.reflect.Method	setter Method used to set local DMO set into foreign DMO

Constructor Summary

Constructors

Constructor and Description
OneToManyHelper(RelationInfo info) Constructor.

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.

Methods inherited from class java.lang.Object

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

Field Detail

info

private final RelationInfo info

Object containing information about the nature of the association

getter

private final java.lang.reflect.Method getter

Method used to retrieve set of local DMOs from foreign DMO

setter

private java.lang.reflect.Method setter

Method used to set local DMO set into foreign DMO

Constructor Detail

OneToManyHelper

OneToManyHelper(RelationInfo info)

Constructor. Looks up reflective method used to get the set of local DMOs referenced by the foreign end of the association.

Parameters:

info - Object which contains information regarding the nature of the one-to-many, foreign association.

Method Detail

getLocalDMOs

public 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.

Specified by:

getLocalDMOs in interface AssociationSyncher.Helper

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

public 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.

Specified by:

replace in interface AssociationSyncher.Helper

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

public 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.

Specified by:

remove in interface AssociationSyncher.Helper

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.