org.jasig.portal.services
Class PersonDirectory

java.lang.Object
  org.jasig.portal.services.PersonDirectory

Deprecated. If possible classes that need access to the IPersonAttributeDao should be Spring managed beans themselves and just have the dependency injected directly. This class should only be used by non Spring managed code.

@Deprecated
public class PersonDirectory
extends Object

PersonDirectory is a static lookup mechanism for a singleton instance of IPersonAttributeDao. It is configurable via a Spring beans.dtd compliant configuration file in the properties directory called personDirectory.xml (as referenced by applicationContext.xml - that is, you could choose to declare the underlying IPersonAttributesDao backing your PersonDirectory directly in applicationContext.xml, or elsewhere. PersonDirectory looks for an IPersonAttributeDao instance named 'personAttributeDao'. This class serves as the lookup mechanism for clients to obtain a reference to the singleton IPersonAttributeDao instance. Via legacy methods, PersonDirectory also serves as the interface by which client code accesses user attributes. These deprecated legacy methods are a facade to the PersonAttributeDao. The default configuration of that file implements the legacy behavior of using the PersonDirs.xml file for configuration. It is expected that PersonDirs.xml offers the flexibility necessary to support most uPortal installations.

Version:

$Revision: 19776 $ $Date: 2010-01-14 16:17:21 -0600 (Thu, 14 Jan 2010) $

Author:

Howard Gilbert, andrew.petro@yale.edu, Eric Dalquist edalquist@unicon.net

Constructor Summary

PersonDirectory()
Deprecated.

Method Summary

static org.jasig.services.persondir.IPersonAttributeDao

getPersonAttributeDao() Deprecated. Static lookup for a the configured IPersonAttributeDao implementation available from PortalApplicationContextFacade.

Methods inherited from class java.lang.Object

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

Constructor Detail

PersonDirectory

public PersonDirectory()

Deprecated.

Method Detail

getPersonAttributeDao

public static org.jasig.services.persondir.IPersonAttributeDao getPersonAttributeDao()

Deprecated.

Static lookup for a the configured IPersonAttributeDao implementation available from PortalApplicationContextFacade.
Clients of this method SHOULD NOT hold on to references of the returned IPersonAttributeDao. This method should be called each time the dao is needed (within reason, one call for the lifetime of a method is OK). This ensures that the object changing due to a context reload will not cause problems.

Returns:

The PortalApplicationContextFacade configured IPersonAttributeDao implementation.

Throws:

IllegalStateException - If WebApplicationContext does not supply the IPersonAttributeDao instance.