Пакет 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.

       }
   });