Модуль jdk.httpserver

Определяет специфичный для JDK API HTTP-сервера и предоставляет инструмент jwebserver для запуска минимального HTTP-сервера.

Пакет com.sun.net.httpserver определяет API высокого уровня для создания серверов, поддерживающих HTTP и HTTPS. Класс SimpleFileServer реализует простой HTTP-только файловый сервер, предназначенный для тестирования, разработки и отладки. Представлено реализацию по умолчанию через инструмент jwebserver и основную точку входа модуля, который также может быть вызван с помощью java -m jdk.httpserver.

Пакет com.sun.net.httpserver.spi определяет интерфейс поставщика услуг (SPI) для поиска реализаций HTTP-сервера на основе API com.sun.net.httpserver.

Системные свойства, используемые API HTTP-сервера

Ниже приведен список системных свойств JDK, используемых реализацией HTTP-сервера по умолчанию в JDK. Любые свойства ниже, принимающие числовое значение, предполагают значение по умолчанию, если задано строковое значение, которое не может быть обработано как число.

• sun.net.httpserver.idleInterval (по умолчанию: 30 сек)
  Максимальная продолжительность в секундах, в течение которой открытое соединение бездействует. Этот таймер имеет специфичную для реализации гранулярность, которая может означать, что соединения бездействия закрываются позже, чем указанный интервал. Значения, меньшие или равные нулю, отображаются на значение по умолчанию.

• jdk.httpserver.maxConnections (по умолчанию: -1)
  Максимальное количество открытых соединений одновременно. Это включает активные и бездействующие соединения. Если ноль или отрицательное значение, то ограничение не применяется.

• sun.net.httpserver.maxIdleConnections (по умолчанию: 200)
  Максимальное количество бездействующих соединений одновременно. Если установлено значение ноль или отрицательное значение, соединения закрываются после использования.

• sun.net.httpserver.drainAmount (по умолчанию: 65536)
  Максимальное количество байтов, которое будет автоматически прочитано и отброшено из тела запроса, которое не было полностью потреблено его HttpHandler. Если количество оставшихся непрочитанных байтов меньше этого предела, то соединение будет помещено в кэш бездействующих соединений. Если нет, то оно будет закрыто.

• sun.net.httpserver.maxReqHeaders (по умолчанию: 200)
  Максимальное количество полей заголовков, принимаемых в запросе. Если этот предел превышен при чтении заголовков, то соединение завершается, и запрос игнорируется. Если значение меньше или равно нулю, используется значение по умолчанию.

• sun.net.httpserver.maxReqTime (по умолчанию: -1)
  Максимальное время в миллисекундах, разрешенное для получения заголовков и тела запроса. На практике фактическое время зависит от размера запроса, скорости сети и задержек обработки обработчика. Значение, меньшее или равное нулю, означает, что время не ограничено. Если предел превышен, соединение завершается, а обработчик получит IOException. Этот таймер имеет специфичную для реализации гранулярность, что может означать, что запросы прерываются позже, чем указанный интервал.

• sun.net.httpserver.maxRspTime (по умолчанию: -1)
  Максимальное время в миллисекундах, разрешенное для получения заголовков и тела ответа. На практике фактическое время зависит от размера ответа, скорости сети и задержек обработки обработчика. Значение, меньшее или равное нулю, означает, что время не ограничено. Если предел превышен, соединение завершается, а обработчик получит IOException. Этот таймер имеет специфичную для реализации гранулярность, что может означать, что ответы прерываются позже, чем указанный интервал.

• sun.net.httpserver.nodelay (по умолчанию: false)
  Булево значение, которое, если равно true, устанавливает сокет-опцию TCP_NODELAY для всех входящих соединений.