public interface FamilySearchSession extends FamilyQuerySession
This session provides methods for searching Family
objects. The search query is constructed using the FamilyQuery.
The family record Type
also specifies the record
for the family query.
getFamiliesByQuery()
is the basic search method and
returns a list of Family
elements. A more advanced search
may be performed with getFamiliesBySearch().
It accepts a
FamilySearch
in addition to the query for the purpose of
specifying additional options affecting the entire search, such as
ordering. getFamiliesBySearch()
returns a
FamilySearchResults
that can be used to access the resulting
FamilyList
or be used to perform a search within the result
set through FamilySearch.
Families may have a query record indicated by their respective record
types. The query record is accessed via the FamilyQuery.
The returns in this session may not be cast directly to these interfaces.
Modifier and Type | Method and Description |
---|---|
FamilySearchResults |
getFamiliesBySearch(FamilyQuery familyQuery,
FamilySearch familySearch)
Gets the search results matching the given search.
|
FamilyQuery |
getFamilyQueryFromInspector(FamilyQueryInspector familyQueryInspector)
Gets a family query from an inspector.
|
FamilySearch |
getFamilySearch()
Gets a family search.
|
FamilySearchOrder |
getFamilySearchOrder()
Gets a family search order.
|
canSearchFamilies, getFamiliesByQuery, getFamilyQuery
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
FamilySearch getFamilySearch()
mandatory
- This method must be implemented. FamilySearchOrder getFamilySearchOrder()
FamilySearchOrder
is
supplied to a FamilySearch
to specify the ordering of
results.mandatory
- This method must be implemented. FamilySearchResults getFamiliesBySearch(FamilyQuery familyQuery, FamilySearch familySearch) throws OperationFailedException, PermissionDeniedException
familyQuery
- the family queryfamilySearch
- the family searchNullArgumentException
- familyQuery
or
familySearch
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failureUnsupportedException
- familyQuery
or
familySearch
is not of this servicemandatory
- This method must be implemented. FamilyQuery getFamilyQueryFromInspector(FamilyQueryInspector familyQueryInspector)
FamilySearchResults.
familyQueryInspector
- a family query inspectorNullArgumentException
- familyQueryInspector
is null
UnsupportedException
- familyQueryInspector
is not of this servicemandatory
- This method must be implemented.