Класс SimpleFileServer

public final class SimpleFileServer extends Object

Простой HTTP-сервер файлов и его компоненты (предназначены только для тестирования, разработки и отладки).

Простой файловый сервер состоит из трёх компонентов:

• HttpServer, привязанного к указанному адресу,
• HttpHandler, который предоставляет файлы из указанного каталога, и
• необязательного Filter, который выводит сообщения журнала, относящиеся к обменам, обрабатываемым сервером.

Отдельные компоненты сервера можно получить для повторного использования и расширения с помощью предоставленных статических методов.

Простой файловый сервер

Статический фабричный метод createFileServer возвращает HttpServer, представляющий собой готовый к использованию файловый сервер. Сервер поставляется с первоначальным обработчиком, который предоставляет файлы из указанного каталога (и его подкаталогов). Уровень вывода определяет, какие сообщения журнала, если таковые имеются, выводятся в System.out.

Пример простого файлового сервера:

   var addr = new InetSocketAddress(8080);
   var server = SimpleFileServer.createFileServer(addr, Path.of("/some/path"), OutputLevel.INFO);
   server.start();

Обработчик файлов

Статический фабричный метод createFileHandler возвращает HttpHandler, который предоставляет файлы и списки каталогов. Обработчик поддерживает только методы запросов HEAD и GET; для обработки запросов с другими методами можно добавить дополнительные обработчики на сервер или дополнить обработчик файлов, объединив его в единый обработчик с помощью HttpHandlers.handleOrElse(Predicate, HttpHandler, HttpHandler).

Пример объединения обработчиков в единый обработчик:

   var handler = HttpHandlers.handleOrElse(
       (req) -> req.getRequestMethod().equals("PUT"),
       (exchange) -> {
           // validate and handle PUT request
       },
       SimpleFileServer.createFileHandler(Path.of("/some/path")))
   );

Фильтр вывода

Статический фабричный метод createOutputFilter возвращает post-processing filter, который выводит сообщения журнала, относящиеся к обменам, обрабатываемым сервером. Формат вывода задаётся outputLevel.

Пример фильтра вывода:

   var filter = SimpleFileServer.createOutputFilter(System.out, OutputLevel.VERBOSE);
   var server = HttpServer.create(new InetSocketAddress(8080), 10, "/some/path/", new SomeHandler(), filter);
   server.start();

Инструмент jwebserver

Простая реализация HTTP-сервера файлов предоставляется с помощью инструмента jwebserver.