public interface EntryLookupSession extends EntryRetrievalSession
EntryLookupSession
is used to look up dictionary
entries. This session includes the methods defined in the
EntryRetrievalSession.
This session defines two views which offer differing behaviors when retrieving multiple objects.
Generally, the comparative view should be used for most applications as it permits operation even if there is data out of sync or there is an authorization block in a particular element.
Modifier and Type | Method and Description |
---|---|
EntryList |
getEntries()
Gets all the
Dictionary entries. |
EntryList |
getEntriesByGenusType(Type entryGenusType)
Gets an
EntryList corresponding to the given entry
genus Type which does not include entries of genus
types derived from the specified Type. |
EntryList |
getEntriesByIds(IdList entryIds)
Gets an
EntryList corresponding to the given
IdList. |
EntryList |
getEntriesByKeyAndKeyType(java.lang.Object key,
Type keyType)
Gets all the
Dictionary entries matching the given key
and key Type . |
EntryList |
getEntriesByKeyType(Type keyType)
Gets all the
Dictionary entries matching the given key
Type. |
EntryList |
getEntriesByKeyTypeAndValueType(Type keyType,
Type valueType)
Gets all the
Dictionary entries matching the given key
and value Type. |
EntryList |
getEntriesByParentGenusType(Type entryGenusType)
Gets an
EntryList corresponding to the given entry
genus Type and include any additional entries with
genus types derived from the specified Type. |
EntryList |
getEntriesByRecordType(Type entryyRecordType)
Gets an
EntryList containing the given entry record
Type. |
Entry |
getEntry(Id entryId)
Gets the
Entry specified by its Id. |
void |
useComparativeEntryView()
The returns from the lookup methods may omit or translate elements
based on this session, such as authorization, and not result in an
error.
|
void |
usePlenaryEntryView()
A complete view of the
Entry returns is desired. |
canLookupEntries, getDictionary, getDictionaryId, retrieveEntry, useFederatedDictionaryView, useIsolatedDictionaryView
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
void useComparativeEntryView()
mandatory
- This method is must be implemented. void usePlenaryEntryView()
Entry
returns is desired.
Methods will return what is requested or result in an error. This view
is used when greater precision is desired at the expense of
interoperability.mandatory
- This method is must be implemented. Entry getEntry(Id entryId) throws NotFoundException, OperationFailedException, PermissionDeniedException
Entry
specified by its Id.
The
identifier represents the union of the key, keyType and valueType.In
plenary mode, the exact Id
is found or a
NOT_FOUND
results. Otherwise, the returned Entry
may have a different Id
than requested, such as
the case where a duplicate Id
was assigned to an
Agency
and retained for compatibility.entryId
- Id
of the Entry
NotFoundException
- entryId
not foundNullArgumentException
- entryId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method is must be implemented. EntryList getEntriesByIds(IdList entryIds) throws NotFoundException, OperationFailedException, PermissionDeniedException
EntryList
corresponding to the given
IdList.
In plenary mode, the returned list contains all of the
entries specified in the Id
list, in the order of the
list, including duplicates, or an error results if an Id
in the supplied list is not found or inaccessible. Otherwise,
inaccessible Entry
elements may be omitted from the
list and may present the elements in any order including returning a
unique set.entryIds
- a list of Entry Ids
NotFoundException
- entryId
not foundNullArgumentException
- entryIds
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method is must be implemented. EntryList getEntriesByGenusType(Type entryGenusType) throws OperationFailedException, PermissionDeniedException
EntryList
corresponding to the given entry
genus Type
which does not include entries of genus
types derived from the specified Type.
In plenary mode,
the returned list contains all known entries or an error results.
Otherwise, the returned list may contain only those entries that are
accessible through this session.entryGenusType
- an entry genus type Entry list
NullArgumentException
- entryGenusType
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. EntryList getEntriesByParentGenusType(Type entryGenusType) throws OperationFailedException, PermissionDeniedException
EntryList
corresponding to the given entry
genus Type
and include any additional entries with
genus types derived from the specified Type.
In plenary
mode, the returned list contains all known entries or an error
results. Otherwise, the returned list may contain only those entries
that are accessible through this session.entryGenusType
- an entry genus type Entry list
NullArgumentException
- entryGenusType
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. EntryList getEntriesByRecordType(Type entryyRecordType) throws OperationFailedException, PermissionDeniedException
EntryList
containing the given entry record
Type.
In plenary mode, the returned list contains all
known entries or an error results. Otherwise, the returned list may
contain only those entries that are accessible through this session.entryyRecordType
- an entry record type Entry
listNullArgumentException
- entryRecordType
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. EntryList getEntriesByKeyType(Type keyType) throws OperationFailedException, PermissionDeniedException
Dictionary
entries matching the given key
Type.
In plenary mode, the returned list contains all
of the entries specified in the Id list, in the order of the list,
including duplicates, or an error results if an Id in the supplied
list is not found or inaccessible. Otherwise, inaccessible Entry
elements may be omitted from the list and may present the elements in
any order including returning a unique set.keyType
- the type of the key to match keyType
NullArgumentException
- keyType
is nullOperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. EntryList getEntriesByKeyTypeAndValueType(Type keyType, Type valueType) throws OperationFailedException, PermissionDeniedException
Dictionary
entries matching the given key
and value Type.
In plenary mode, the returned list
contains all of the entries specified in the Id list, in the order of
the list, including duplicates, or an error results if an Id in the
supplied list is not found or inaccessible. Otherwise, inaccessible
Entry elements may be omitted from the list and may present the
elements in any order including returning a unique set.keyType
- the type of the key to matchvalueType
- the type of the value to match keyType
NullArgumentException
- keyType
or
valueType
is nullOperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. EntryList getEntriesByKeyAndKeyType(java.lang.Object key, Type keyType) throws OperationFailedException, PermissionDeniedException
Dictionary
entries matching the given key
and key Type
. In plenary mode, the returned list
contains all of the entries specified in the Id list, in the order of
the list, including duplicates, or an error results if an Id in the
supplied list is not found or inaccessible. Otherwise, inaccessible
Entry elements may be omitted from the list and may present the
elements in any order including returning a unique set.key
- the key to matchkeyType
- the type of the value to match keyType
NullArgumentException
- key
or
keyType
is nullOperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. EntryList getEntries() throws OperationFailedException, PermissionDeniedException
Dictionary
entries. In plenary mode, the
returned list contains all of the entries specified in the Id list, in
the order of the list, including duplicates, or an error results if an
Id in the supplied list is not found or inaccessible. Otherwise,
inaccessible Entry elements may be omitted from the list and may
present the elements in any order including returning a unique set.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented.