public interface AddressBookSearchSession extends AddressBookQuerySession
This session provides methods for searching AddressBook
objects. The search query is constructed using the
AddressBookQuery.
The address book record Type
also
specifies the record for the address book query.
getAddressBooksByQuery()
is the basic search method and
returns a list of AddressBook
elements. A more advanced
search may be performed with getAddressBooksBySearch().
It
accepts an AddressBookSearch
in addition to the query for
the purpose of specifying additional options affecting the entire search,
such as ordering. getAddressBooksBySearch()
returns an
AddressBookSearchResults
that can be used to access the
resulting AddressBookList
or be used to perform a search
within the result set through AddressBookSearch.
AddressBooks may have a query record indicated by their respective
record types. The query record is accessed via the
AddressBookQuery.
The returns in this session may not be cast
directly to these interfaces.
Modifier and Type | Method and Description |
---|---|
AddressBookQuery |
getAddressBookQueryFromInspector(AddressBookQueryInspector addressBookQueryInspector)
Gets an address book query from an inspector.
|
AddressBookSearchResults |
getAddressBooksBySearch(AddressBookQuery addressBookQuery,
AddressBookSearch addressBookSearch)
Gets the search results matching the given search.
|
AddressBookSearch |
getAddressBookSearch()
Gets an address book search.
|
AddressBookSearchOrder |
getAddressBookSearchOrder()
Gets an address book search order.
|
canSearchAddressBooks, getAddressBookQuery, getAddressBooksByQuery
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
AddressBookSearch getAddressBookSearch()
mandatory
- This method must be implemented. AddressBookSearchOrder getAddressBookSearchOrder()
AddressBookSearchOrder
is supplied to an AddressBookSearch
to specify
the ordering of results.mandatory
- This method must be implemented. AddressBookSearchResults getAddressBooksBySearch(AddressBookQuery addressBookQuery, AddressBookSearch addressBookSearch) throws OperationFailedException, PermissionDeniedException
addressBookQuery
- the address book queryaddressBookSearch
- the address book searchNullArgumentException
- addressBookQuery
or address books earch
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failureUnsupportedException
- addressBookQuery
or address books earch
is not of this servicemandatory
- This method must be implemented. AddressBookQuery getAddressBookQueryFromInspector(AddressBookQueryInspector addressBookQueryInspector)
AddressBookSearchResults.
addressBookQueryInspector
- an address book query inspectorNullArgumentException
-
addressBookQueryInspector
is null
UnsupportedException
- addressBookQueryInspector
is not of this servicemandatory
- This method must be implemented.