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