JavaTM Platform
Standard Ed. 6

java.util.logging
�� StreamHandler

java.lang.Object
  �̳��� java.util.logging.Handler
      �̳��� java.util.logging.StreamHandler
ֱ����֪���ࣺ
ConsoleHandler, FileHandler, SocketHandler

public class StreamHandler
extends Handler

����������־ Handler��

������Ҫ��Ϊ����,��֧��ʵ��������־ Handlers ���õ��ࡣ

�� LogRecords ���������� java.io.OutputStream��

���ã�Ĭ������£�ÿ�� SocketHandler ����ʹ������ StreamHandler ��������ִ�г�ʼ���ġ����δ�������ԣ��������Ծ�����Чֵ������ʹ��ָ����Ĭ��ֵ��

�����°汾��ʼ��
1.4

���췽��ժҪ
StreamHandler()
          ����������ǰ������� StreamHandler��
StreamHandler(OutputStream out, Formatter formatter)
          ���������� Formatter ��������� StreamHandler��
 
����ժҪ
 void close()
          �رյ�ǰ�������
 void flush()
          ˢ�����л�����Ϣ��
 boolean isLoggable(LogRecord record)
          ���� Handler �Ƿ�ʵ�ʼ�¼������ LogRecord��
 void publish(LogRecord record)
          ��ʽ�������� LogRecord��
 void setEncoding(String encoding)
          ���ã�����ģ��� Handler ���õ��ַ����롣
protected  void setOutputStream(OutputStream out)
          �����������
 
���� java.util.logging.Handler �̳еķ���
getEncoding, getErrorManager, getFilter, getFormatter, getLevel, reportError, setErrorManager, setFilter, setFormatter, setLevel
 
���� java.lang.Object �̳еķ���
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

���췽����ϸ��Ϣ

StreamHandler

public StreamHandler()
����������ǰ������� StreamHandler��


StreamHandler

public StreamHandler(OutputStream out,
                     Formatter formatter)
���������� Formatter ��������� StreamHandler��

������
out - Ŀ�������
formatter - ���ڸ�ʽ������� Formatter
������ϸ��Ϣ

setOutputStream

protected void setOutputStream(OutputStream out)
                        throws SecurityException
�����������

������ڵ�ǰ����������д Formatter ��β���ַ�����ˢ�²��ر�����Ȼ��ʹ���µ�������滻���������

������
out - �������������Ϊ null��
�׳���
SecurityException - ������ڰ�ȫ���������ҵ����߲����� LoggingPermission("control")��

setEncoding

public void setEncoding(String encoding)
                 throws SecurityException,
                        UnsupportedEncodingException
���ã�����ģ��� Handler ���õ��ַ����롣

Ӧ�����κ� LogRecords д�� Handler ֮ǰ���ñ��롣

���ǣ�
�� Handler �е� setEncoding
������
encoding - ��֧���ַ���������ơ�����Ϊ null����ָʾĬ�ϵ�ƽ̨���롣
�׳���
SecurityException - ������ڰ�ȫ���������ҵ����߲����� LoggingPermission("control")��
UnsupportedEncodingException - �����֧��ָ���ı��롣

publish

public void publish(LogRecord record)
��ʽ�������� LogRecord��

StreamHandler ���ȼ���Ƿ���� OutputStream �Լ������� LogRecord �Ƿ��������������־�������û����Ĭ�Ϸ��ء�����У���������й����� Filter ������Ƿ�Ӧ�÷����ü�¼�����Ӧ�÷���������� Formatter ����ʽ���ü�¼��Ȼ�󽫽��д�뵱ǰ�������

�������Ҫд����� OutputStream �ĵ�һ�� LogRecord������д�� LogRecord ֮ǰ���Ƚ� Formatter ��“ͷ��”�ַ���д������

ָ���ߣ�
�� Handler �е� publish
������
record - ����־�¼���������Ĭ�Ϻ��� null ��¼�����Ҳ����з�����

isLoggable

public boolean isLoggable(LogRecord record)
���� Handler �Ƿ�ʵ�ʼ�¼������ LogRecord��

�÷������ LogRecord �Ƿ�����ʵ��ļ����Լ��Ƿ��������� Filter�������δ�����κ�������� LogRecord Ϊ Null���򷵻� false��

���ǣ�
�� Handler �е� isLoggable
������
record - һ�� LogRecord
���أ�
���Ҫ��¼ LogRecord���򷵻� true��

flush

public void flush()
ˢ�����л�����Ϣ��

ָ���ߣ�
�� Handler �е� flush

close

public void close()
           throws SecurityException
�رյ�ǰ�������

�ڹر�ǰ���� Formatter ��“β��”�ַ���д���������⣬�����δ�� Formatter ��“ͷ��”�ַ���д����������д��“β��”�ַ���֮ǰ��

ָ���ߣ�
�� Handler �е� close
�׳���
SecurityException - ������ڰ�ȫ���������ҵ����߲����� LoggingPermission("control")��
SecurityException - ������ڰ�ȫ���������ҵ����߲����� LoggingPermission("control")��

JavaTM Platform
Standard Ed. 6

�ύ��������
�йظ���� API �ο����ϺͿ�����Ա�ĵ�������� Java SE ������Ա�ĵ������ĵ���������ϸ�ġ����򿪷���Ա���������Լ�������������ﶨ�塢ʹ�ü��ɺ͹�������ʾ����

��Ȩ���� 2007 Sun Microsystems, Inc. ��������Ȩ���� ����������֤��������������ĵ����·ַ�������