public interface LogEntryLookupSession extends OsidSession
This session provides methods for retrieving log entries.
This session defines views that offer differing behaviors when retrieving multiple objects.
Modifier and Type | Method and Description |
---|---|
boolean |
canReadLog()
Tests if this user can read the log.
|
Log |
getLog()
Gets the
Log associated with this session. |
LogEntryList |
getLogEntries()
Gets all log entries.
|
LogEntryList |
getLogEntriesByDate(DateTime start,
DateTime end)
Gets a
LogEntryList corresponding to the given time
interval inclusive. |
LogEntryList |
getLogEntriesByDateForResource(Id resourceId,
DateTime start,
DateTime end)
Gets a
LogEntryList corresponding to the given time
interval inclusive for an agent associated with the given resource. |
LogEntryList |
getLogEntriesByGenusType(Type logEntryGenusType)
Gets a
LogEntryList corresponding to the given log
entry genus Type which doe snot include entries of
genus types derived form the specified Type. |
LogEntryList |
getLogEntriesByIds(IdList logEntryIds)
Gets a
LogEntryList corresponding to the given
IdList. |
LogEntryList |
getLogEntriesByParentGenusType(Type logEntryGenusType)
Gets a
LogEntryList corresponding to the given log
entry genus Type and include any additional entries
with genus types derived from the specified Type. |
LogEntryList |
getLogEntriesByPriorityType(Type priorityType)
Gets a
LogEntryList filtering the list to log entries
including and above the given priority Type. |
LogEntryList |
getLogEntriesByPriorityTypeAndDate(Type priorityType,
DateTime start,
DateTime end)
Gets a
LogEntryList corresponding to the given time
interval inclusive filtering the list to log entries including and
above the given priority Type. |
LogEntryList |
getLogEntriesByPriorityTypeAndDateForResource(Id resourceId,
Type priorityType,
DateTime start,
DateTime end)
Gets a
LogEntryList corresponding to the given time
interval inclusive for an agent associated with the given resource
filtering the list to log entries including and above the given
priority Type. |
LogEntryList |
getLogEntriesByRecordType(Type logEntryGenusType)
Gets a
LogEntryList containing the given log entry
record Type. |
LogEntryList |
getLogEntriesForResource(Id resourceId)
Gets a
LogEntryList for an agent associated with the
given resource. |
LogEntry |
getLogEntry(Id logEntryId)
Gets the
LogEntry specified by its Id. |
Id |
getLogId()
Gets the
Log Id associated with this
session. |
void |
useComparativeLogEntryView()
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 |
useFederatedLogView()
Federates the view for methods in this session.
|
void |
useIsolatedLogView()
Isolates the view for methods in this session.
|
void |
usePlenaryLogEntryView()
A complete view of the
LogEntry returns is desired. |
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
Id getLogId()
Log
Id
associated with this
session. Log Id
associated with this sessionmandatory
- This method must be implemented. Log getLog() throws OperationFailedException, PermissionDeniedException
Log
associated with this session.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. boolean canReadLog()
PERMISSION_DENIED.
This is intended as a hint to an
application that may opt not to offer reading operations. false
if reading methods are not authorized,
true
otherwisemandatory
- This method must be implemented. void useComparativeLogEntryView()
mandatory
- This method is must be implemented. void usePlenaryLogEntryView()
LogEntry
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. void useFederatedLogView()
mandatory
- This method is must be implemented. void useIsolatedLogView()
mandatory
- This method is must be implemented. LogEntry getLogEntry(Id logEntryId) throws NotFoundException, OperationFailedException, PermissionDeniedException
LogEntry
specified by its Id.
In plenary mode, the exact Id
is found or a
NOT_FOUND
results. Otherwise, the returned LogEntry
may have a different Id
than requested, such as
the case where a duplicate Id
was assigned to a
LogEntry
and retained for compatibility.logEntryId
- the Id
of the LogEntry
to retrieve LogEntry
NotFoundException
- no LogEntry
found
with the given Id
NullArgumentException
- logEntryId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. LogEntryList getLogEntriesByIds(IdList logEntryIds) throws NotFoundException, OperationFailedException, PermissionDeniedException
LogEntryList
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 logentries may be omitted from the list and may present
the elements in any order including returning a unique set.logEntryIds
- the list of Ids
to retrieve LogEntry list
NotFoundException
- an Id was
not foundNullArgumentException
- logEntryIds
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. LogEntryList getLogEntriesByGenusType(Type logEntryGenusType) throws OperationFailedException, PermissionDeniedException
LogEntryList
corresponding to the given log
entry genus Type
which doe snot include entries of
genus types derived form 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 sessionlogEntryGenusType
- a log entry genus type LogEntry
listNullArgumentException
- logEntryGenusType
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. LogEntryList getLogEntriesByParentGenusType(Type logEntryGenusType) throws OperationFailedException, PermissionDeniedException
LogEntryList
corresponding to the given log
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.logEntryGenusType
- a log entry genus type LogEntry
listNullArgumentException
- logEntryGenusType
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. LogEntryList getLogEntriesByRecordType(Type logEntryGenusType) throws OperationFailedException, PermissionDeniedException
LogEntryList
containing the given log entry
record Type.
In plenary mode, the returned list
contains all known log entries or an error results. Otherwise, the
returned list may contain only those log entries that are accessible
through this session.logEntryGenusType
- a log entry genus type LogEntry
listNullArgumentException
- logEntryGenusType
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. LogEntryList getLogEntriesByPriorityType(Type priorityType) throws OperationFailedException, PermissionDeniedException
LogEntryList
filtering the list to log entries
including and above the given priority 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.priorityType
- a log entry priority type LogEntry
listNullArgumentException
- priorityType
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. LogEntryList getLogEntriesByDate(DateTime start, DateTime end) throws OperationFailedException, PermissionDeniedException
LogEntryList
corresponding to the given time
interval inclusive.
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.start
- a starting timeend
- a starting time LogEntry
listInvalidArgumentException
- start
is
greater than end
NullArgumentException
- start
or
end
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. LogEntryList getLogEntriesByPriorityTypeAndDate(Type priorityType, DateTime start, DateTime end) throws OperationFailedException, PermissionDeniedException
LogEntryList
corresponding to the given time
interval inclusive filtering the list to log entries including and
above the given priority 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.priorityType
- a log entry priority typestart
- a starting timeend
- a starting time LogEntry
listInvalidArgumentException
- start
is
greater than end
NullArgumentException
- priorityType, start
or end
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. LogEntryList getLogEntriesForResource(Id resourceId) throws OperationFailedException, PermissionDeniedException
LogEntryList
for an agent associated with the
given resource. 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.resourceId
- a resource Id
LogEntry
listNullArgumentException
- resourceId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. LogEntryList getLogEntriesByDateForResource(Id resourceId, DateTime start, DateTime end) throws OperationFailedException, PermissionDeniedException
LogEntryList
corresponding to the given time
interval inclusive for an agent associated with the given resource.
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.resourceId
- a resource Id
start
- a starting timeend
- a starting time LogEntry
listInvalidArgumentException
- start
is
greater than end
NullArgumentException
- resourceId, start
or end
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. LogEntryList getLogEntriesByPriorityTypeAndDateForResource(Id resourceId, Type priorityType, DateTime start, DateTime end) throws OperationFailedException, PermissionDeniedException
LogEntryList
corresponding to the given time
interval inclusive for an agent associated with the given resource
filtering the list to log entries including and above the given
priority 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.resourceId
- a resource Id
priorityType
- a log entry priority typestart
- a starting timeend
- a starting time LogEntry
listInvalidArgumentException
- start
is
greater than end
NullArgumentException
- resourceId,
priorityType, start
or end
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. LogEntryList getLogEntries() throws OperationFailedException, PermissionDeniedException
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented.