Класс SocketHandler

java.util.logging.SocketHandler

public class SocketHandler extends StreamHandler

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

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

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

<имя-обработчика>.level задаёт уровень по умолчанию для Handler (по умолчанию Level.ALL).
<имя-обработчика>.filter указывает имя класса Filter для использования (по умолчанию нет Filter).
<имя-обработчика>.formatter указывает имя класса Formatter для использования (по умолчанию java.util.logging.XMLFormatter).
<имя-обработчика>.encoding — имя кодировки набора символов для использования (по умолчанию — кодировка по умолчанию платформы).
<имя-обработчика>.host задаёт имя целевого хоста для подключения (без значения по умолчанию).
<имя-обработчика>.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 String, используется localhost.

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

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

close

public void close()

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

Overrides:: close в классе StreamHandler

publish

public void publish(LogRecord record)

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

Overrides:: publish в классе StreamHandler
Parameters:: record - описание события регистрации. Null-значение игнорируется и не публикуется

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.logging/java/util/logging/SocketHandler.html