public interface AddressQuerySession extends OsidSession
This session provides methods for searching Address
objects. The search query is constructed using the AddressQuery.
The address record Type
also specifies the record
for the address query.
Addresses may have a query record indicated by their respective record
types. The query record is accessed via the AddressQuery.
The returns in this session may not be cast directly to these interfaces.
Modifier and Type | Method and Description |
---|---|
boolean |
canSearchAddresses()
Tests if this user can perform
Address searches. |
AddressBook |
getAddressBook()
Gets the
AddressBook associated with this session. |
Id |
getAddressBookId()
Gets the
AddressBook Id associated with
this session. |
AddressList |
getAddressesByQuery(AddressQuery addressQuery)
Gets a list of
Addresses matching the given search. |
AddressQuery |
getAddressQuery()
Gets an address query.
|
void |
useFederatedAddressBookView()
Federates the view for methods in this session.
|
void |
useIsolatedAddressBookView()
Isolates the view for methods in this session.
|
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
Id getAddressBookId()
AddressBook
Id
associated with
this session. AddressBook Id
associated with this sessionmandatory
- This method must be implemented. AddressBook getAddressBook() throws OperationFailedException, PermissionDeniedException
AddressBook
associated with this session.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. boolean canSearchAddresses()
Address
searches. A
return of true does not guarantee successful authorization. A return
of false indicates that it is known all methods in this session will
result in a PERMISSION_DENIED.
This is intended as a
hint to an application that may opt not to offer search operations to
unauthorized users. false
if search methods are not authorized,
true
otherwisemandatory
- This method must be implemented. void useFederatedAddressBookView()
mandatory
- This method is must be implemented. void useIsolatedAddressBookView()
mandatory
- This method is must be implemented. AddressQuery getAddressQuery()
mandatory
- This method must be implemented. AddressList getAddressesByQuery(AddressQuery addressQuery) throws OperationFailedException, PermissionDeniedException
Addresses
matching the given search.addressQuery
- the address query AddressList
NullArgumentException
- addressQuery
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failureUnsupportedException
- addressQuery
is
not of this servicemandatory
- This method must be implemented.