org.jasig.services.persondir.support
Class CascadingPersonAttributeDao

java.lang.Object
  org.jasig.services.persondir.support.AbstractFlatteningPersonAttributeDao
      org.jasig.services.persondir.support.AbstractDefaultAttributePersonAttributeDao
          org.jasig.services.persondir.support.AbstractAggregatingDefaultQueryPersonAttributeDao
              org.jasig.services.persondir.support.CascadingPersonAttributeDao

All Implemented Interfaces:

org.jasig.services.persondir.IPersonAttributeDao

public class CascadingPersonAttributeDao
extends AbstractAggregatingDefaultQueryPersonAttributeDao

This IPersonAttributeDao implementation iterates through an ordered List of IPersonAttributeDao impls when getting user attributes.
The first DAO is queried using the seed Map passed to this class. The results of the query are merged into a general result map. After the first DAO this general result map used as the query seed for each DAO and each DAOs results are merged into it.
This behavior allows a DAO lower on the list to rely on attributes returned by a DAO higher on the list.
The default merger for the general result set is ReplacingAttributeAdder.
Note that most DAOs expect a Map of String->String. Some of the DAOs return a Map of String->Object or String->List. This may cause problems in the DAO if the key for an attribute with a non String value matches a key needed by the DAO for the query it is running.
It is highly recomended that the first DAO on the list for this class is the EchoPersonAttributeDaoImpl to ensure the seed gets placed into the general result map.

Since:

uPortal 2.5

Version:

$Revision: 43106 $ $Date: 2008-02-14 11:22:40 -0600 (Thu, 14 Feb 2008) $

Author:

Eric Dalquist

Field Summary

Fields inherited from class org.jasig.services.persondir.support.AbstractAggregatingDefaultQueryPersonAttributeDao

attrMerger, personAttributeDaos, recoverExceptions

Fields inherited from class org.jasig.services.persondir.support.AbstractFlatteningPersonAttributeDao

logger

Constructor Summary

CascadingPersonAttributeDao()

Method Summary

protected Map<String,List<Object>>

getAttributesFromDao(Map<String,List<Object>> seed, boolean isFirstQuery, org.jasig.services.persondir.IPersonAttributeDao currentlyConsidering, Map<String,List<Object>> resultAttributes) If this is the first call, isFirstQuery == true, the query run against the current IPersonAttributeDao is done using the seed Map.

Methods inherited from class org.jasig.services.persondir.support.AbstractAggregatingDefaultQueryPersonAttributeDao

getMerger, getMultivaluedUserAttributes, getPersonAttributeDaos, getPossibleUserAttributeNames, isRecoverExceptions, setMerger, setPersonAttributeDaos, setRecoverExceptions

Methods inherited from class org.jasig.services.persondir.support.AbstractDefaultAttributePersonAttributeDao

getDefaultAttributeName, getMultivaluedUserAttributes, setDefaultAttributeName

Methods inherited from class org.jasig.services.persondir.support.AbstractFlatteningPersonAttributeDao

flattenResults, getUserAttributes, getUserAttributes

Methods inherited from class java.lang.Object

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

Constructor Detail

CascadingPersonAttributeDao

public CascadingPersonAttributeDao()

Method Detail

getAttributesFromDao

protected Map<String,List<Object>> getAttributesFromDao(Map<String,List<Object>> seed,
                                                        boolean isFirstQuery,
                                                        org.jasig.services.persondir.IPersonAttributeDao currentlyConsidering,
                                                        Map<String,List<Object>> resultAttributes)

If this is the first call, isFirstQuery == true, the query run against the current IPersonAttributeDao is done using the seed Map. Otherwise the query is run using the resultAttributes Map.

Specified by:

getAttributesFromDao in class AbstractAggregatingDefaultQueryPersonAttributeDao

Parameters:

seed - The seed for the original query.

isFirstQuery - If this is the first query, this will stay true until a call to this method returns (does not throw an exception).

currentlyConsidering - The IPersonAttributeDao to execute the query on.

resultAttributes - The Map of results from all previous queries, may be null.

Returns:

The results from the call to the DAO, follows the same rules as IPersonAttributeDao.getUserAttributes(Map).

See Also:

AbstractAggregatingDefaultQueryPersonAttributeDao.getAttributesFromDao(java.util.Map, boolean, org.jasig.services.persondir.IPersonAttributeDao, java.util.Map)