Description |
Ensures that an address book context is present within
the current pageContext. This tag must appear, at least once, before all
other tags within the AddressBook taglib. If
config is not specified, then a search
for a useable configuration name is performed in the following fashion:
- Attempt to retrieve the current addressbook configuration name
from the page context. If that succeeds, use it. If the retrieval
fails...
- Attempt to retrieve the current addressbook configuration name
from the session. If that succeeds, store it on the page context and
use it. If the retrieval fails...
- From the list of all SSOAdapter configuration names, try to
find the first useable addressbook configuration name. If that succeeds,
store it in the session and page context and use it. If it is not possible
to find a useable addressbook configuration name, the
context tag will
fail.
Once a configuration name has been determined, an attempt is made to acquire
an appropriate addressbook context object. This is done in the following
fashion:
- Attempt to retrieve an addressbook
context from the page
context, and verify that it matches the configuration (using the previously acquired
configuration name). If that succeeds, use it. If that fails...
- Attempt to retrieve an addressbook
context from the user's
cache of addressbook contexts. If that succeeds, store it on the page
context and use it. If the retrieval fails...
- Create an SSOAdapter object using the previously acquired configuration
name. Create an addressbook
context, and bind it with the SSOAdapter
object. Store the addressbook context in the context cache as well as
the page context.
This way, if an addressbook context has been previously referenced
on a page, or within the session, then the
config
attribute may be omitted, and the most
recently referenced context will be retrieved. |