Класс 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.

Начиная с:: 1.4

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

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

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

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

Методы, объявленные в классе StreamHandler

flush, isLoggable, setEncoding, setOutputStream

Методы, объявленные в классе Handler

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

Методы, объявленные в классе Object

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

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

SocketHandler

public SocketHandler() throws IOException

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

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

SocketHandler

public SocketHandler(String host, int port) throws IOException

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

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

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

close

public void close()

Закрывает этот выходной поток.

Переопределяет:: close в классе StreamHandler

publish

public void publish(LogRecord record)

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

Переопределяет:: publish в классе StreamHandler
Требования к реализации:: Этот метод не синхронизирован, и подклассы не должны объявлять переопределённые методы publish() как synchronized, если они вызывают super.publish() или форматируют пользовательские аргументы. Дополнительные сведения см. в обсуждении в java.util.logging.Handler.
Параметры:: 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://docs.oracle.com/en/java/javase/25/docs/api/java.logging/java/util/logging/SocketHandler.html