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