compact1, compact2, compact3

java.util.logging

Класс StreamHandler

java.lang. Объект

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

java.util.logging. StreamHandler

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

ConsoleHandler, FileHandler, SocketHandler

public class StreamHandler
extends Handler

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

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

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

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

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

Например, свойства для StreamHandler был бы:

• java.util.logging.StreamHandler.level=INFO
• java.util.logging.StreamHandler.formatter=java.util.logging.SimpleFormatter

Для пользовательского обработчика, например, com.foo. MyHandler, свойства были бы:

• com.foo. MyHandler.level=INFO
• com.foo.MyHandler.formatter=java.util.logging.SimpleFormatter

С тех пор:

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) Измените поток вывода.

Методы, наследованные от class java.util.logging. Обработчик

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

Методы, наследованные от class 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 в class Handler

Параметры:

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

Броски:

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

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

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

public void publish(LogRecord record)

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

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

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

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

publish в class Handler

Параметры:

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

isLoggable

public boolean isLoggable(LogRecord record)

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

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

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

isLoggable в class Handler

Параметры:

record - LogRecord

Возвраты:

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

сброс

public void flush()

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

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

flush в class Handler

близко

public void close()
           throws SecurityException

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

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

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

close в class Handler

Броски:

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