public interface LogEntryLogSession extends OsidSession
This session provides methods to retrieve LogEntry
to
Log
mappings. An entry may appear in multiple Logs.
Each Log
may have its own authorizations governing
who is allowed to look at it.
This lookup session defines several views:
Modifier and Type | Method and Description |
---|---|
boolean |
canLookupLogEntryLogMappings()
Tests if this user can perform lookups of logEntry/log mappings.
|
LogList |
getLogByLogEntry(Id logEntryId)
Gets the list of
Log objects mapped to a
LogEntry. |
LogEntryList |
getLogEntrieByLog(IdList logIds)
Gets the list of log entries corresponding to a list of
Log. |
LogEntryList |
getLogEntriesByLog(Id logId)
Gets the list of log entries associated with a
Log. |
IdList |
getLogEntryIdsByLog(Id logId)
Gets the list of
LogEntry Ids associated
with a Log. |
IdList |
getLogEntryIdsByLog(IdList logIds)
Gets the list of
LogEntry Ids corresponding to a list
of Log objects. |
IdList |
getLogIdsByLogEntry(Id logEntryId)
Gets the list of
Log Ids mapped to a
LogEntry. |
void |
useComparativeLogView()
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 |
usePlenaryLogView()
A complete view of the
LogEntry and Log
returns is desired. |
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
void useComparativeLogView()
mandatory
- This method is must be implemented. void usePlenaryLogView()
LogEntry
and Log
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. boolean canLookupLogEntryLogMappings()
PERMISSION_DENIED.
This is intended as
a hint to an application that may opt not to offer lookup operations
to unauthorized users. false
if looking up mappings is not authorized,
true
otherwisemandatory
- This method must be implemented. IdList getLogEntryIdsByLog(Id logId) throws NotFoundException, OperationFailedException, PermissionDeniedException
LogEntry
Ids
associated
with a Log.
logId
- Id
of a Log
Ids
NotFoundException
- logId
is not foundNullArgumentException
- logId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. LogEntryList getLogEntriesByLog(Id logId) throws NotFoundException, OperationFailedException, PermissionDeniedException
Log.
logId
- Id
of a Log
NotFoundException
- logId
is not foundNullArgumentException
- logId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. IdList getLogEntryIdsByLog(IdList logIds) throws OperationFailedException, PermissionDeniedException
LogEntry Ids
corresponding to a list
of Log
objects.logIds
- list of log Ids
Ids
NullArgumentException
- logIds
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. LogEntryList getLogEntrieByLog(IdList logIds) throws OperationFailedException, PermissionDeniedException
Log.
logIds
- list of log Ids
NullArgumentException
- logIds
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. IdList getLogIdsByLogEntry(Id logEntryId) throws NotFoundException, OperationFailedException, PermissionDeniedException
Log
Ids
mapped to a
LogEntry.
logEntryId
- Id
of a LogEntry
Ids
NotFoundException
- logEntryId
is not
foundNullArgumentException
- logEntryId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. LogList getLogByLogEntry(Id logEntryId) throws NotFoundException, OperationFailedException, PermissionDeniedException
Log
objects mapped to a
LogEntry.
logEntryId
- Id
of a LogEntry
NotFoundException
- logEntryId
is not
foundNullArgumentException
- logEntryId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented.