Package org.osid.logging
The Open Service Interface Definitions for the org.osid.logging service.
The Logging OSID provides a means to read and wite to logs. A Log
represents a collection of log entries. Each log entry is composed of a
priority Type , timestamp, Agent , the agent's associated
Resource , and a record.
Logs can be organized into hierarchies for federation. A log that is a parent of another log makes visible the log entries of its children.
Example
LoggingSession out = manager.getLoggingSession();
out.log(warningLogEntryPriorityType, "hello world", stringLogEntryContentType);
LogReadingSession in = manager.getLogReadingSession();
LogEntryList entries = inn.getLogEntries();
while (entries.hasNext()) {
LogEntry entry = entries.getNextLogEntry();
printEntry(entry);
}
Copyright © 2002-2004, 2006-2008 Massachusetts Institute of Technology.
Copyright © 2011 Ingenescus. All Rights Reserved.
This Work is being provided by the copyright holder(s) subject to the following license. By obtaining, using and/or copying this Work, you agree that you have read, understand, and will comply with the following terms and conditions.
Permission to use, copy and distribute unmodified versions of this Work, for any purpose, without fee or royalty is hereby granted, provided that you include the above copyright notices and the terms of this license on ALL copies of the Work or portions thereof.
You may nodify or create Derivatives of this Work only for your internal purposes. You shall not distribute or transfer any such Derivative of this Work to any location or to any third party. For the purposes of this license, "Derivative" shall mean any derivative of the Work as defined in the United States Copyright Act of 1976, such as a translation or modification.
This Work and the information contained herein is provided on an "AS IS" basis WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE WORK OR THE USE OR OTHER DEALINGS IN THE WORK.
The export of software employing encryption technology may require a specific license from the United States Government. It is the responsibility of any person or organization contemplating export to obtain such a license before exporting this Work.
-
InterfacesClassDescriptionA
Logrepresents a collection of entries.This session creates, updates, and deletesLogs.A log entry consists of a time, an agent, and a priority type.This session creates, updates, and deletesLogEntries.This is the form for creating and updating log entries.Like allOsidLists,LogListprovides a means for accessingLogEntryelements sequentially either one at a time or many at a time.This session provides methods to re-assign log entries toLogs.This session provides methods to retrieveLogEntrytoLogmappings.This session provides methods for retrievingLogEntries.This session defines methods to receive notifications on new or deleted log entries.This is the query for searching log entries.This is the query inspector for examining log entry queries.This session provides methods for searching among log entries.The log entry receiver is the consumer supplied interface for receiving notifications pertaining to new log entries.The search interface for governing log entry searches.An interface for specifying the ordering of search results.This interface provides a means to capture results of a search.This session provides methods for searching among log entries.This session manages queries and sequencing to create "smart" dynamic catalogs.This is the form for creating and updatingLogs.The logging manager provides access to logging sessions and provides interoperability tests for various aspects of this service.The logging profile describes the interoperability among logging services.The logging manager provides access to logging sessions and provides interoperability tests for various aspects of this service.This session is used to log entries to a log.This session manages a hierarchy of logs.This session defines methods for traversing a hierarchy ofLogs.Like allOsidLists,LogListprovides a means for accessingLogelements sequentially either one at a time or many at a time.This session provides methods for retrievingLogs.This interface is a container for a partial hierarchy retrieval.Like allOsidLists,LogNodeListprovides a means for accessingLogNodeelements sequentially either one at a time or many at a time.This session defines methods to receive notifications on adds/changes toLogs.This is the query for searching for logs.This is the query inspector for examining log queries.This session provides methods for searchingLogs.The log receiver is the consumer supplied interface for receiving notifications pertaining to new, updated or deletedLogobjects.The search interface for governing log searches.An interface for specifying the ordering of search results.This interface provides a means to capture results of a search.This session provides methods for searchingLogs.