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

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

Программисты должны реализовать интерфейс 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.

    }
});