WebObjects 5.4.2

com.webobjects.foundation
Class NSLog.PrintStreamLogger

java.lang.Object
  extended by com.webobjects.foundation.NSLog.Logger
      extended by com.webobjects.foundation.NSLog.PrintStreamLogger
Enclosing class:
NSLog

public static class NSLog.PrintStreamLogger
extends NSLog.Logger

NSLog.PrintStreamLogger is a concrete subclass of NSLog.Logger. It logs output to a java.io.PrintStream which is contained by the logger. This PrintStream can be changed, which causes the logger to direct log messages somewhere else, such as a local file. NSLog.PrintStreamLogger provides additional method behavior for verbose logging.

By default, NSLog.out is an NSLog.PrintStreamLogger that points at System.out with verbose logging disabled. NSLog.err and NSLog.debug are NSLog.PrintStreamLoggers that point to System.err with verbose logging enabled.

Verbose logging produces output of the format: [Current Time] <Current Thread Name> output

See Also:
NSLog, NSLog.Logger

Field Summary
 
Fields inherited from class com.webobjects.foundation.NSLog.Logger
debugLevel, isEnabled, isVerbose
 
Constructor Summary
NSLog.PrintStreamLogger()
          Creates a new NSLog.PrintStreamLogger which directs output to System.out.
NSLog.PrintStreamLogger(PrintStream ps)
          Creates a new NSLog.PrintStreamLogger which directs output to ps.
 
Method Summary
 void appendln()
          Invokes println() and flush on printStream, if isEnabled returns true.
 void appendln(Object aValue)
          Writes the string representation of aValue to printStream, if isEnabled returns true.
 void appendln(Throwable aValue)
          Writes the stack trace of aValue to printStream, if isEnabled returns true.
 void flush()
          Invokes flush on printStream.
 PrintStream printStream()
          Provides the PrintStream wrapped by this NSLog.Logger instance.
 void setPrintStream(PrintStream aStream)
          Redirects all output for this NSLog.Logger instance to aStream.
 
Methods inherited from class com.webobjects.foundation.NSLog.Logger
allowedDebugLevel, appendln, appendln, appendln, appendln, appendln, appendln, appendln, appendln, appendln, appendln, isEnabled, isVerbose, setAllowedDebugLevel, setIsEnabled, setIsVerbose
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

NSLog.PrintStreamLogger

public NSLog.PrintStreamLogger()
Creates a new NSLog.PrintStreamLogger which directs output to System.out.

See Also:
NSLog.Logger

NSLog.PrintStreamLogger

public NSLog.PrintStreamLogger(PrintStream ps)
Creates a new NSLog.PrintStreamLogger which directs output to ps.

Parameters:
ps - the PrintStream that may accept output
Throws:
IllegalArgumentException - if ps is null
See Also:
NSLog.Logger
Method Detail

appendln

public void appendln()
Invokes println() and flush on printStream, if isEnabled returns true.

Specified by:
appendln in class NSLog.Logger
See Also:
NSLog.Logger.isEnabled, NSLog.PrintStreamLogger.printStream(), NSLog.Logger.appendln()

appendln

public void appendln(Throwable aValue)
Writes the stack trace of aValue to printStream, if isEnabled returns true. This is overridden here for efficiency.

Prefixes the stack trace if isVerbose returns true.

Overrides:
appendln in class NSLog.Logger
Parameters:
aValue - the exception to log
See Also:
NSLog.Logger.isEnabled, NSLog.Logger.isVerbose, NSLog.PrintStreamLogger.printStream(), NSLog.Logger.appendln(Throwable)

appendln

public void appendln(Object aValue)
Writes the string representation of aValue to printStream, if isEnabled returns true.

For example, a generic object passed to this method might output "java.lang.Object@67e5d". The toString method of aValue provides the string representation.

Prefixes the string representation if isVerbose returns true.

Specified by:
appendln in class NSLog.Logger
Parameters:
aValue - the object to log
See Also:
NSLog.Logger.isEnabled, NSLog.Logger.isVerbose, NSLog.PrintStreamLogger.printStream(), NSLog.Logger.appendln(Object)

flush

public void flush()
Invokes flush on printStream.

Specified by:
flush in class NSLog.Logger
See Also:
NSLog.Logger.flush()

printStream

public PrintStream printStream()
Provides the PrintStream wrapped by this NSLog.Logger instance.

Returns:
a java.io.PrintStream; never null
See Also:
NSLog.PrintStreamLogger.setPrintStream(java.io.PrintStream)

setPrintStream

public void setPrintStream(PrintStream aStream)
Redirects all output for this NSLog.Logger instance to aStream. No change is made if aStream is null.

Parameters:
aStream - the input print stream
See Also:
NSLog.PrintStreamLogger.printStream()

Last updated June 2008

Copyright © 2000-2008 Apple Inc.