OSID Logo
OSID Specifications
logging package
Version 3.0.0
Release Candidate Preview
Interfaceosid.logging.LoggingManager
Implementsosid.OsidManager
osid.logging.LoggingProfile
Description

The logging manager provides access to logging sessions and provides interoperability tests for various aspects of this service. The sessions included in this manager are:

  • LoggingSession: a session to write to a log
  • LogEntryLookupSession: a session to read a log
  • LogEntryQuerySession: a session to search a log
  • LogEntrySearchSession: a session to search a log
  • LogEntryAdminSession: a session to manage log entries in a log
  • LogEntryNotificationSession: a session to subscribe to notifications of new log entries
  • LogEntryLogSession: a session to examine log entry to log mappings
  • LogEntryLogAssignmentSession: a session to manage log entry to log mappings
  • LogEntrySmartLogSession: a session to manage dynamic logs
  • LogLookupSession: a session to retrieve log objects
  • LogQuerySession: a session to search for logs
  • LogSearchSession: a session to search for logs
  • LogAdminSession: a session to create, update and delete logs
  • LogNotificationSession: a session to receive notifications for changes in logs
  • LogHierarchyTraversalSession: a session to traverse hierarchies of logs
  • LogHierarchyDesignSession: a session to manage hierarchies of logs

The logging manager also provides a profile for determing the supported search types supported by this service.

MethodgetLoggingSession
Description

Gets the OsidSession associated with the logging service.

Returnosid.logging.LoggingSessiona LoggingSession
ErrorsOPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsLogging() is false
ComplianceoptionalThis method must be implemented if supportsLogging() is true.
MethodgetLoggingSessionForLog
Description

Gets the OsidSession associated with the logging service for the given log.

Parametersosid.id.IdlogIdthe Id of the Log
Returnosid.logging.LoggingSessiona LoggingSession
ErrorsNOT_FOUNDno Log found by the given Id
NULL_ARGUMENT logId is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsLogging() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsLogging() and supportsVisibleFederation() are true
MethodgetLogEntryLookupSession
Description

Gets the OsidSession associated with the log reading service.

Returnosid.logging.LogEntryLookupSessiona LogEntryLookupSession
ErrorsOPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsLogEntryLookup() is false
ComplianceoptionalThis method must be implemented if supportsLogEntryLookup() is true.
MethodgetLogEntryLookupSessionForLog
Description

Gets the OsidSession associated with the log reading service for the given log.

Parametersosid.id.IdlogIdthe Id of the Log
Returnosid.logging.LogEntryLookupSessiona LogEntryLookupSession
ErrorsNOT_FOUNDno Log found by the given Id
NULL_ARGUMENT logId is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsLogEntryLookup() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsLogEntryLookup() and supportsVisibleFederation() are true
MethodgetLogEntryQuerySession
Description

Gets the OsidSession associated with the logging entry query service.

Returnosid.logging.LogEntryQuerySessiona LogEntryQuerySession
ErrorsOPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsLogEntryQuery() is false
ComplianceoptionalThis method must be implemented if supportsLogEntryQuery() is true.
MethodgetLogEntryQuerySessionForLog
Description

Gets the OsidSession associated with the log entry query service for the given log.

Parametersosid.id.IdlogIdthe Id of the Log
Returnosid.logging.LogEntryQuerySessiona LogEntryQuerySession
ErrorsNOT_FOUNDno Log found by the given Id
NULL_ARGUMENT logId is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsLogEntryQuery() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsLogEntryQuery() and supportsVisibleFederation() are true
MethodgetLogEntrySearchSession
Description

Gets the OsidSession associated with the logging entry search service.

Returnosid.logging.LogEntrySearchSessiona LogEntrySearchSession
ErrorsOPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsLogEntrySearch() is false
ComplianceoptionalThis method must be implemented if supportsLogEntrySearch() is true.
MethodgetLogEntrySearchSessionForLog
Description

Gets the OsidSession associated with the log entry search service for the given log.

Parametersosid.id.IdlogIdthe Id of the Log
Returnosid.logging.LogEntrySearchSessiona LogEntrySearchSession
ErrorsNOT_FOUNDno Log found by the given Id
NULL_ARGUMENT logId is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsLogEntrySearch() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsLogEntrySearch() and supportsVisibleFederation() are true
MethodgetLogEntryAdminSession
Description

Gets the OsidSession associated with the logging entry administrative service.

Returnosid.logging.LogEntryAdminSessiona LogEntryAdminSession
ErrorsOPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsLogEntryAdmin() is false
ComplianceoptionalThis method must be implemented if supportsLogEntryAdmin() is true.
MethodgetLogEntryAdminSessionForLog
Description

Gets the OsidSession associated with the log entry administrative service for the given log.

Parametersosid.id.IdlogIdthe Id of the Log
Returnosid.logging.LogEntryAdminSessiona LogEntryAdminSession
ErrorsNOT_FOUNDno Log found by the given Id
NULL_ARGUMENT logId is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsLogEntryAdmin() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsLogEntryAdmin() and supportsVisibleFederation() are true
MethodgetLogEntryNotificationSession
Description

Gets the OsidSession associated with the logging entry notification service.

Parametersosid.logging.LogEntryReceiverlogEntryReceiverthe receiver
Returnosid.logging.LogEntryNotificationSessiona LogEntryNotificationSession
ErrorsNULL_ARGUMENT logEntryReceiver is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsLogEntryNotification() is false
ComplianceoptionalThis method must be implemented if supportsLogEntryNotification() is true.
MethodgetLogEntryNotificationSessionForLog
Description

Gets the OsidSession associated with the log entry notification service for the given log.

Parametersosid.logging.LogEntryReceiverlogEntryReceiverthe receiver
osid.id.IdlogIdthe Id of the Log
Returnosid.logging.LogEntryNotificationSessiona LogEntryNotificationSession
ErrorsNOT_FOUNDno Log found by the given Id
NULL_ARGUMENT logEntryReceiver or logId is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsLogEntryNotification() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsLogEntryNotification() and supportsVisibleFederation() are true
MethodgetLogEntryLogSession
Description

Gets the session for retrieving log entry to log mappings.

Returnosid.logging.LogEntryLogSessiona LogEntryLogSession
ErrorsOPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsLogEntryLog() is false
ComplianceoptionalThis method must be implemented if supportsLogEntryLog() is true.
MethodgetLogEntryLogAssignmentSession
Description

Gets the session for assigning log entry to logs mappings.

Returnosid.logging.LogEntryLogAssignmentSessiona LogEntryLogAssignmentSession
ErrorsOPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsLogEntryLogAssignment() is false
ComplianceoptionalThis method must be implemented if supportsLogEntryLogAssignment() is true.
MethodgetLogEntrySmartLogSession
Description

Gets the session for managing dynamic logEntry log.

Parametersosid.id.IdlogIdthe Id of the log
Returnosid.logging.LogEntrySmartLogSessiona LogEntrySmartLogSession
ErrorsNOT_FOUND logId not found
NULL_ARGUMENT logId is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsLogEntrySmartLog() is false
ComplianceoptionalThis method must be implemented if supportsLogEntrySmartLog() is true.
MethodgetLogLookupSession
Description

Gets the OsidSession associated with the log lookup service.

Returnosid.logging.LogLookupSessiona LogLookupSession
ErrorsOPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsLogLookup() is false
ComplianceoptionalThis method must be implemented if supportsLogLookup() is true.
MethodgetLogQuerySession
Description

Gets the OsidSession associated with the log query service.

Returnosid.logging.LogQuerySessiona LogQuerySession
ErrorsOPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsLogQuery() is false
ComplianceoptionalThis method must be implemented if supportsLogQuery() is true.
MethodgetLogSearchSession
Description

Gets the OsidSession associated with the log search service.

Returnosid.logging.LogSearchSessiona LogSearchSession
ErrorsOPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsLogSearch() is false
ComplianceoptionalThis method must be implemented if supportsLogSearch() is true.
MethodgetLogAdminSession
Description

Gets the OsidSession associated with the log administrative service.

Returnosid.logging.LogAdminSessiona LogAdminSession
ErrorsOPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsLogAdmin() is false
ComplianceoptionalThis method must be implemented if supportsLogAdmin() is true.
MethodgetLogNotificationSession
Description

Gets the OsidSession associated with the log notification service.

Parametersosid.logging.LogReceiverlogReceiverthe receiver
Returnosid.logging.LogNotificationSessiona LogNotificationSession
ErrorsNULL_ARGUMENT logReceiver is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsLogNotification() is false
ComplianceoptionalThis method must be implemented if supportsLogNotification() is true.
MethodgetLogHierarchySession
Description

Gets the OsidSession associated with the log hierarchy service.

Returnosid.logging.LogHierarchySessiona LogHierarchySession for logs
ErrorsOPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsLogHierarchy() is false
ComplianceoptionalThis method must be implemented if supportsLogHierarchy() is true.
MethodgetLogHierarchyDesignSession
Description

Gets the OsidSession associated with the log hierarchy design service.

Returnosid.logging.LogHierarchyDesignSessiona HierarchyDesignSession for logs
ErrorsOPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsLogHierarchyDesign() is false
ComplianceoptionalThis method must be implemented if supportsLogHierarchyDesign() is true.
MethodgetLoggingBatchManager
Description

Gets a LoggingBatchManager.

Returnosid.logging.batch.LoggingBatchManagera LoggingBatchManager
ErrorsOPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsLoggingBatch() is false
ComplianceoptionalThis method must be implemented if supportsLoggingBatch() is true.