Java Doc for StreamHandler.java in  » 6.0-JDK-Core » Collections-Jar-Zip-Logging-regex » java » util » logging » Java Source Code / Java DocumentationJava Source Code and Java Documentation

Home
Java Source Code / Java Documentation
1.6.0 JDK Core
2.6.0 JDK Modules
3.6.0 JDK Modules com.sun
4.6.0 JDK Modules com.sun.java
5.6.0 JDK Modules sun
6.6.0 JDK Platform
7.Ajax
8.Apache Harmony Java SE
9.Aspect oriented
10.Authentication Authorization
11.Blogger System
12.Build
13.Byte Code
14.Cache
15.Chart
16.Chat
17.Code Analyzer
18.Collaboration
19.Content Management System
20.Database Client
21.Database DBMS
22.Database JDBC Connection Pool
23.Database ORM
24.Development
25.EJB Server
26.ERP CRM Financial
27.ESB
28.Forum
29.Game
30.GIS
31.Graphic 3D
32.Graphic Library
33.Groupware
34.HTML Parser
35.IDE
36.IDE Eclipse
37.IDE Netbeans
38.Installer
39.Internationalization Localization
40.Inversion of Control
41.Issue Tracking
42.J2EE
43.J2ME
44.JBoss
45.JMS
46.JMX
47.Library
48.Mail Clients
49.Music
50.Net
51.Parser
52.PDF
53.Portal
54.Profiler
55.Project Management
56.Report
57.RSS RDF
58.Rule Engine
59.Science
60.Scripting
61.Search Engine
62.Security
63.Sevlet Container
64.Source Control
65.Swing Library
66.Template Engine
67.Test Coverage
68.Testing
69.UML
70.Web Crawler
71.Web Framework
72.Web Mail
73.Web Server
74.Web Services
75.Web Services apache cxf 2.2.6
76.Web Services AXIS2
77.Wiki Engine
78.Workflow Engines
79.XML
80.XML UI
Java Source Code / Java Documentation » 6.0 JDK Core » Collections Jar Zip Logging regex » java.util.logging 
Source Cross Reference  Class Diagram Java Document (Java Doc) 


java.lang.Object
   java.util.logging.Handler
      java.util.logging.StreamHandler

All known Subclasses:   java.util.logging.FileHandler,  java.util.logging.SocketHandler,  java.util.logging.ConsoleHandler,
StreamHandler
public class StreamHandler extends Handler (Code)
Stream based logging Handler.

This is primarily intended as a base class or support class to be used in implementing other logging Handlers.

LogRecords are published to a given java.io.OutputStream.

Configuration: By default each StreamHandler is initialized using the following LogManager configuration properties. If properties are not defined (or have invalid values) then the specified default values are used.

  • java.util.logging.StreamHandler.level specifies the default level for the Handler (defaults to Level.INFO).
  • java.util.logging.StreamHandler.filter specifies the name of a Filter class to use (defaults to no Filter).
  • java.util.logging.StreamHandler.formatter specifies the name of a Formatter class to use (defaults to java.util.logging.SimpleFormatter).
  • java.util.logging.StreamHandler.encoding the name of the character set encoding to use (defaults to the default platform encoding).

version:
   1.26, 05/05/07
since:
   1.4



Constructor Summary
public  StreamHandler()
     Create a StreamHandler, with no current output stream.
public  StreamHandler(OutputStream out, Formatter formatter)
     Create a StreamHandler with a given Formatter and output stream.

Method Summary
public synchronized  voidclose()
     Close the current output stream.

The Formatter's "tail" string is written to the stream before it is closed.

public synchronized  voidflush()
     Flush any buffered messages.
public  booleanisLoggable(LogRecord record)
     Check if this Handler would actually log a given LogRecord.

This method checks if the LogRecord has an appropriate level and whether it satisfies any Filter.

public synchronized  voidpublish(LogRecord record)
     Format and publish a LogRecord.

The StreamHandler first checks if there is an OutputStream and if the given LogRecord has at least the required log level. If not it silently returns.

public  voidsetEncoding(String encoding)
     Set (or change) the character encoding used by this Handler.
protected synchronized  voidsetOutputStream(OutputStream out)
     Change the output stream.

If there is a current output stream then the Formatter's tail string is written and the stream is flushed and closed. Then the output stream is replaced with the new output stream.
Parameters:
  out - New output stream.



Constructor Detail
StreamHandler
public StreamHandler()(Code)
Create a StreamHandler, with no current output stream.



StreamHandler
public StreamHandler(OutputStream out, Formatter formatter)(Code)
Create a StreamHandler with a given Formatter and output stream.


Parameters:
  out - the target output stream
Parameters:
  formatter - Formatter to be used to format output





Method Detail
close
public synchronized void close() throws SecurityException(Code)
Close the current output stream.

The Formatter's "tail" string is written to the stream before it is closed. In addition, if the Formatter's "head" string has not yet been written to the stream, it will be written before the "tail" string.
exception:
  SecurityException - if a security manager exists and ifthe caller does not have LoggingPermission("control").




flush
public synchronized void flush()(Code)
Flush any buffered messages.



isLoggable
public boolean isLoggable(LogRecord record)(Code)
Check if this Handler would actually log a given LogRecord.

This method checks if the LogRecord has an appropriate level and whether it satisfies any Filter. It will also return false if no output stream has been assigned yet or the LogRecord is Null.


Parameters:
  record - a LogRecord true if the LogRecord would be logged.




publish
public synchronized void publish(LogRecord record)(Code)
Format and publish a LogRecord.

The StreamHandler first checks if there is an OutputStream and if the given LogRecord has at least the required log level. If not it silently returns. If so, it calls any associated Filter to check if the record should be published. If so, it calls its Formatter to format the record and then writes the result to the current output stream.

If this is the first LogRecord to be written to a given OutputStream, the Formatter's "head" string is written to the stream before the LogRecord is written.
Parameters:
  record - description of the log event. A null record issilently ignored and is not published




setEncoding
public void setEncoding(String encoding) throws SecurityException, java.io.UnsupportedEncodingException(Code)
Set (or change) the character encoding used by this Handler.

The encoding should be set before any LogRecords are written to the Handler.
Parameters:
  encoding - The name of a supported character encoding.May be null, to indicate the default platform encoding.
exception:
  SecurityException - if a security manager exists and ifthe caller does not have LoggingPermission("control").
exception:
  UnsupportedEncodingException - if the named encoding isnot supported.




setOutputStream
protected synchronized void setOutputStream(OutputStream out) throws SecurityException(Code)
Change the output stream.

If there is a current output stream then the Formatter's tail string is written and the stream is flushed and closed. Then the output stream is replaced with the new output stream.
Parameters:
  out - New output stream. May not be null.
exception:
  SecurityException - if a security manager exists and ifthe caller does not have LoggingPermission("control").




Fields inherited from java.util.logging.Handler
boolean sealed(Code)(Java Doc)

Methods inherited from java.util.logging.Handler
void checkAccess() throws SecurityException(Code)(Java Doc)
abstract public void close() throws SecurityException(Code)(Java Doc)
abstract public void flush()(Code)(Java Doc)
public String getEncoding()(Code)(Java Doc)
public ErrorManager getErrorManager()(Code)(Java Doc)
public Filter getFilter()(Code)(Java Doc)
public Formatter getFormatter()(Code)(Java Doc)
public synchronized Level getLevel()(Code)(Java Doc)
public boolean isLoggable(LogRecord record)(Code)(Java Doc)
abstract public void publish(LogRecord record)(Code)(Java Doc)
protected void reportError(String msg, Exception ex, int code)(Code)(Java Doc)
public void setEncoding(String encoding) throws SecurityException, java.io.UnsupportedEncodingException(Code)(Java Doc)
public void setErrorManager(ErrorManager em)(Code)(Java Doc)
public void setFilter(Filter newFilter) throws SecurityException(Code)(Java Doc)
public void setFormatter(Formatter newFormatter) throws SecurityException(Code)(Java Doc)
public synchronized void setLevel(Level newLevel) throws SecurityException(Code)(Java Doc)

Methods inherited from java.lang.Object
native protected Object clone() throws CloneNotSupportedException(Code)(Java Doc)
public boolean equals(Object obj)(Code)(Java Doc)
protected void finalize() throws Throwable(Code)(Java Doc)
final native public Class getClass()(Code)(Java Doc)
native public int hashCode()(Code)(Java Doc)
final native public void notify()(Code)(Java Doc)
final native public void notifyAll()(Code)(Java Doc)
public String toString()(Code)(Java Doc)
final native public void wait(long timeout) throws InterruptedException(Code)(Java Doc)
final public void wait(long timeout, int nanos) throws InterruptedException(Code)(Java Doc)
final public void wait() throws InterruptedException(Code)(Java Doc)

www.java2java.com | Contact Us
Copyright 2009 - 12 Demo Source and Support. All rights reserved.
All other trademarks are property of their respective owners.