Класс 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 (или их значений по умолчанию), за исключением того, что используются предоставленные аргументы целевого хоста и порта. Если аргумент host пустой, но не null String, используется localhost.

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 - описание события регистрации. Null-запись игнорируется и не публикуется

© 1993, 2023, 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/21/docs/api/java.logging/java/util/logging/SocketHandler.html