public interface LogSearchSession extends LogQuerySession
This session provides methods for searching Log
objects.
The search query is constructed using the LogQuery
. The
log record Type
also specifies the record for the log
query.
getLogsByQuery()
is the basic search method and returns
a list of Log
elements. A more advanced search may be
performed with getLogsBySearch().
It accepts a
LogSearch
in addition to the query for the purpose of specifying
additional options affecting the entire search, such as ordering.
getLogsBySearch()
returns a LogSearchResults
that
can be used to access the resulting LogList
or be used to
perform a search within the result set through LogSearch.
Logs may have a query record indicated by their respective record
types. The query record is accessed via the LogQuery.
The
returns in this session may not be cast directly to these interfaces.
Modifier and Type | Method and Description |
---|---|
LogQuery |
getLogQueryFromInspector(LogQueryInspector logQueryInspector)
Gets a log query from an inspector.
|
LogSearchResults |
getLogsBySearch(LogQuery logQuery,
LogSearch logSearch)
Gets the search results matching the given search.
|
LogSearch |
getLogSearch()
Gets a log search.
|
LogSearchOrder |
getLogSearchOrder()
Gets a log search order.
|
canSearchLogs, getLogQuery, getLogsByQuery
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
LogSearch getLogSearch()
mandatory
- This method must be implemented. LogSearchOrder getLogSearchOrder()
LogSearchOrder
is supplied
to a LogSearch
to specify the ordering of results.mandatory
- This method must be implemented. LogSearchResults getLogsBySearch(LogQuery logQuery, LogSearch logSearch) throws OperationFailedException, PermissionDeniedException
logQuery
- the log querylogSearch
- the log searchNullArgumentException
- logQuery
or
logSearch
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failureUnsupportedException
- logQuery
or
logSearch
is not of this servicemandatory
- This method must be implemented. LogQuery getLogQueryFromInspector(LogQueryInspector logQueryInspector)
LogSearchResults.
logQueryInspector
- a log query inspectorNullArgumentException
- logQueryInspector
is null
UnsupportedException
- logQueryInspector
is not of this servicemandatory
- This method must be implemented.