Пакет com.sun.net.httpserver

Предоставляет простой высокоуровневый API для HTTP-сервера, который можно использовать для создания встроенных HTTP-серверов. Поддерживаются как "http", так и "https". API предоставляет частичную реализацию RFC 2616 (HTTP 1.1) и RFC 2818 (HTTP через TLS). Любую функциональность HTTP, не предоставляемую этим API, можно реализовать кодом приложения, используя API.

Основные компоненты:

• класс HttpExchange, описывающий пару запроса и ответа,
• интерфейс HttpHandler для обработки входящих запросов, а также класс HttpHandlers, предоставляющий полезные реализации обработчиков,
• класс HttpContext, сопоставляющий путь URI с HttpHandler,
• класс HttpServer для прослушивания подключений и перенаправления запросов обработчикам,
• класс Filter, позволяющий выполнять предварительную и последующую обработку запросов.

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

Программисты должны реализовать интерфейс HttpHandler. Этот интерфейс предоставляет обратный вызов, который вызывается для обработки входящих запросов от клиентов. HTTP-запрос и его ответ известны как обмен. HTTP-обмены представлены классом HttpExchange. Класс HttpServer используется для прослушивания входящих TCP-подключений и перенаправления запросов по этим подключениям к обработчикам, которые были зарегистрированы на сервере.

Пример минимального HTTP-сервера показан ниже:

   class MyHandler implements HttpHandler {
       public void handle(HttpExchange t) throws IOException {
           InputStream is = t.getRequestBody();
           read(is); // .. read the request body
           String response = "This is the response";
           t.sendResponseHeaders(200, response.length());
           OutputStream os = t.getResponseBody();
           os.write(response.getBytes());
           os.close();
       }
   }
   ...

   HttpServer server = HttpServer.create(new InetSocketAddress(8000), 0);
   server.createContext("/applications/myapp", new MyHandler());
   server.setExecutor(null); // creates a default executor
   server.start();
   

В приведенном выше примере создается простой HttpServer, который использует поток вызывающего приложения для вызова метода handle() для входящих HTTP-запросов, направленных на порт 8000, и к пути /applications/myapp/.

Класс HttpExchange инкапсулирует все, что необходимо приложению для обработки входящих запросов и генерации соответствующих ответов.

Регистрация обработчика в HttpServer создает объект HttpContext, и объекты Filter могут быть добавлены в возвращаемый контекст. Фильтры используются для автоматической предварительной и последующей обработки обменов до их передачи обработчику обмена.

Для конфиденциальной информации можно использовать HttpsServer для обработки запросов "https", защищенных протоколами SSL или TLS. HttpsServer должен быть предоставлен объектом HttpsConfigurator, который содержит инициализированный объект SSLContext. HttpsConfigurator можно использовать для настройки наборов шифров и других параметров работы SSL. Простой пример SSLContext можно создать следующим образом:

   char[] passphrase = "passphrase".toCharArray();
   KeyStore ks = KeyStore.getInstance("JKS");
   ks.load(new FileInputStream("testkeys"), passphrase);

   KeyManagerFactory kmf = KeyManagerFactory.getInstance("SunX509");
   kmf.init(ks, passphrase);

   TrustManagerFactory tmf = TrustManagerFactory.getInstance("SunX509");
   tmf.init(ks);

   SSLContext ssl = SSLContext.getInstance("TLS");
   ssl.init(kmf.getKeyManagers(), tmf.getTrustManagers(), null);
   

В примере выше используется файл хранилища ключей "testkeys", созданный с помощью утилиты keytool, в качестве хранилища сертификатов для клиентских и серверных сертификатов. Следующий код демонстрирует, как SSLContext затем используется в HttpsConfigurator, и как SSLContext и HttpsConfigurator связаны с HttpsServer.

    server.setHttpsConfigurator (new HttpsConfigurator(sslContext) {
        public void configure (HttpsParameters params) {

        // get the remote address if needed
        InetSocketAddress remote = params.getClientAddress();

        SSLContext c = getSSLContext();

        // get the default parameters
        SSLParameters sslparams = c.getDefaultSSLParameters();
        if (remote.equals (...) ) {
            // modify the default set for client x
        }

        params.setSSLParameters(sslparams);
        // statement above could throw IAE if any params invalid.
        // eg. if app has a UI and parameters supplied by a user.

        }
    });