Модуль jdk.httpserver

Определяет API HTTP-сервера, специфичный для JDK, и предоставляет инструмент 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.maxReqHeaderSize (по умолчанию: 393216 или 384kB)
  Максимальный размер секции полей заголовка, который сервер готов принять. Он вычисляется как сумма размера имени заголовка, размера значения заголовка и дополнительных 32 байтов для каждой строки секции полей. Строка запроса считается первой строкой секции полей: имя в ней пустое, а значение — вся строка. Если это ограничение превышено во время чтения заголовков, соединение прерывается, а запрос игнорируется. Если значение меньше или равно нулю, ограничение не устанавливается.

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

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

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

• sun.net.httpserver.pathMatcher (по умолчанию: pathPrefix)
  Схема сопоставления путей, используемая для маршрутизации запросов к обработчикам контекста. Для свойства можно задать одно из следующих значений:

  pathPrefix (по умолчанию)

  Путь запроса должен начинаться с пути контекста, а все совпадающие сегменты пути должны быть идентичны. Например, путь контекста /foo будет соответствовать путям запроса /foo, /foo/ и /foo/bar, но не /foobar.

  stringPrefix

  Строка пути запроса должна начинаться со строки пути контекста. Например, путь контекста /foo будет соответствовать путям запроса /foo, /foo/, /foo/bar и /foobar.

  Если значение пустое или недопустимое, используется значение по умолчанию.

  Это свойство и возможность восстановить поведение сопоставления по префиксу строки могут быть удалены в одном из будущих выпусков.