Класс SocketHandler

java.util.logging.SocketHandler

public class SocketHandler extends StreamHandler

Простая сетевая регистрация Handler.

LogRecords публикуются в сетевом потоковом соединении. По умолчанию используется класс XMLFormatter для форматирования.

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

<handler-name>.level задаёт уровень по умолчанию для Handler (по умолчанию Level.ALL).
<handler-name>.filter задаёт имя класса Filter для использования (по умолчанию без Filter).
<handler-name>.formatter задаёт имя класса Formatter для использования (по умолчанию java.util.logging.XMLFormatter).
<handler-name>.encoding задаёт имя кодировки набора символов для использования (по умолчанию — кодировка по умолчанию платформы).
<handler-name>.host задаёт имя целевого хоста для подключения (по умолчанию нет).
<handler-name>.port задаёт целевой TCP-порт для использования (по умолчанию нет).

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

java.util.logging.SocketHandler.level=INFO
java.util.logging.SocketHandler.formatter=java.util.logging.SimpleFormatter

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

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

Поток вывода буферизован, но сбрасывается после записи каждого LogRecord.

Since:: 1.4

Краткое описание конструкторов

Конструктор	Описание
`SocketHandler()`	Создать `SocketHandler`, используя только свойства `LogManager` (или их значения по умолчанию).
`SocketHandler(String host, int port)`	Создать `SocketHandler` с указанным хостом и портом.

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`close()`	Закрыть этот поток вывода.
`void`	`publish(LogRecord record)`	Форматировать и опубликовать `LogRecord`.

Методы, унаследованные от класса java.util.logging.StreamHandler

flush, isLoggable, setEncoding, setOutputStream

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

Подробное описание конструкторов

SocketHandler

public SocketHandler() throws IOException

Создать SocketHandler, используя только свойства LogManager (или их значения по умолчанию).

Throws:: IllegalArgumentException - если хост или порт неверны или не указаны в свойствах LogManager.; IOException - если не удаётся подключиться к целевому хосту и порту.

SocketHandler

public SocketHandler(String host, int port) throws IOException

Создать SocketHandler с указанным хостом и портом. SocketHandler настраивается на основе свойств LogManager, за исключением использования указанных аргументов целевого хоста и порта. Если аргумент хоста пуст, но не null, используется локальный хост.

Parameters:: host - целевой хост.; port - целевой порт.
Throws:: IllegalArgumentException - если хост или порт неверны.; IOException - если не удаётся подключиться к целевому хосту и порту.

Подробное описание методов

close

public void close() throws SecurityException

Закрыть этот поток вывода.

Overrides:: close в классе StreamHandler
Throws:: SecurityException - если существует менеджер безопасности и у вызывающего объекта нет LoggingPermission("control").

publish

public void publish(LogRecord record)

Форматировать и опубликовать LogRecord.

Overrides:: publish в классе StreamHandler
Parameters:: record - описание события протоколирования. Нулевой объект протоколирования игнорируется и не публикуется

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.logging/java/util/logging/SocketHandler.html