java.util.logging

Класс StreamHandler

java.lang. Объект

java.util.logging. Обработчик

java.util.logging. StreamHandler

Прямые Известные Подклассы:

ConsoleHandler, FileHandler, SocketHandler

public class StreamHandler
extends Handler

Поток, базируемый, регистрируя Handler.

Это прежде всего предназначается как базовый класс или класс поддержки, который будет использоваться в реализации другого журналирования Handlers.

LogRecords публикуется к данному java.io.OutputStream.

Конфигурация: По умолчанию каждый StreamHandler инициализируется, используя следующие свойства конфигурации LogManager. Если свойства не определяются (или имейте недопустимые значения), тогда указанные значения по умолчанию используются.

• java.util.logging. StreamHandler.level определяет уровень по умолчанию для Handler (значения по умолчанию к Level.INFO).
• java.util.logging. StreamHandler.filter определяет имя класса Filter использования (значения по умолчанию ни к какому Filter).
• java.util.logging.StreamHandler.formatter определяет имя класса Formatter использования (значения по умолчанию к java.util.logging.SimpleFormatter).
• java.util.logging. StreamHandler.encoding имя кодирования набора символов, чтобы использовать (значения по умолчанию для кодирования платформы по умолчанию).

С тех пор:

1.4

Сводка конструктора

Конструкторы

Конструктор и Описание
StreamHandler() Создайте StreamHandler без потока текущей производительности.
StreamHandler(OutputStream out, Formatter formatter) Создайте StreamHandler с данным Formatter и потоком вывода.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
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 унаследованный от класса. Обработчик

getEncoding, getErrorManager, getFilter, getFormatter, getLevel, reportError, setErrorManager, setFilter, setFormatter, setLevel

Методы java.lang унаследованный от класса. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Деталь конструктора

StreamHandler

public StreamHandler()

Создайте StreamHandler без потока текущей производительности.

StreamHandler

public StreamHandler(OutputStream out,
             Formatter formatter)

Создайте StreamHandler с данным Formatter и потоком вывода.

Параметры:

out - целевой поток вывода

formatter - Средство форматирования, которое будет использоваться, чтобы отформатировать вывод

Деталь метода

setOutputStream

protected void setOutputStream(OutputStream out)
                        throws SecurityException

Измените поток вывода.

Если есть поток текущей производительности тогда, строка хвоста Formatter пишется, и поток сбрасывается и закрывается. Затем поток вывода заменяется новым потоком вывода.

Параметры:

out - Новый поток вывода., Возможно, не нуль.

Броски:

SecurityException - если менеджер безопасности существует и если у вызывающей стороны нет LoggingPermission("control").

setEncoding

public void setEncoding(String encoding)
                 throws SecurityException,
                        UnsupportedEncodingException

Набор (или изменение) кодировка символов используется этим Handler.

Кодирование должно быть установлено перед любым LogRecords пишутся Handler.

Переопределения:

setEncoding в классе Handler

Параметры:

encoding - Имя поддерживаемой кодировки символов. Может быть нуль, чтобы указать на кодирование платформы по умолчанию.

Броски:

SecurityException - если менеджер безопасности существует и если у вызывающей стороны нет LoggingPermission("control").

UnsupportedEncodingException - если именованное кодирование не поддерживается.

опубликовать

public void publish(LogRecord record)

Отформатируйте и опубликуйте LogRecord.

StreamHandler сначала проверяет, есть ли OutputStream и если у данного LogRecord есть, по крайней мере, необходимый уровень журнала. Если не это тихо возвращается. Если так, это вызывает, любой связал Filter, чтобы проверить, должна ли запись быть опубликована. Если так, это вызывает свой Formatter, чтобы отформатировать запись и затем пишет результат в поток текущей производительности.

Если это - первый LogRecord, который будет записан данному OutputStream, "главная" строка Formatter пишется потоку прежде, чем LogRecord будет записан.

Определенный:

publish в классе Handler

Параметры:

record - описание события журнала. Нулевая запись тихо игнорируется и не публикуется

isLoggable

public boolean isLoggable(LogRecord record)

Проверьте, зарегистрировал ли бы этот Handler фактически данный LogRecord.

Этот метод проверяет, есть ли у LogRecord соответствующий уровень и удовлетворяет ли это любой Filter. Это также возвратит false, если никакой поток вывода еще не был присвоен, или LogRecord является нулем.

Переопределения:

isLoggable в классе Handler

Параметры:

record - LogRecord

Возвраты:

истина, если LogRecord был бы зарегистрирован.

сброс

public void flush()

Сбросьте любые буферизованные сообщения.

Определенный:

flush в классе Handler

близко

public void close()
           throws SecurityException

Закройте поток текущей производительности.

Строка "хвоста" Formatter пишется потоку прежде, чем это будет закрыто. Кроме того, если "главная" строка Formatter еще не была записана потоку, она будет записана перед строкой "хвоста".

Определенный:

close в классе Handler

Броски:

SecurityException - если менеджер безопасности существует и если вызывающая сторона не имеет контроля LoggingPermission.