HTTPClient

Цей пакет надає повний клієнтську бібліотеку HTTP. В даний час реалізує більшість відповідних частинах HTTP / 1.0 і HTTP / 1.1 протоколів, в тому числі методів запиту HEAD, GET, POST і PUT, і автоматична обробка запитів авторизації перенаправлення, і печиво.
Крім того включені класу кодеки містить кодери і декодери для base64, цитує-друку, URL-кодування, Chunked і кодувань многочастного / форм-даних. Все це безкоштовно, і ліцензується відповідно до GNU Lesser General Public License (LGPL) (зверніть увагу, що це не те ж саме, як GPL).
Нижче наведені комплекти і документація для HTTPClient Версія 0,3-3. Якщо у вас є які-небудь проблеми, помилки, пропозиції, коментарі і т.д. побачити інформацію про налагодження і проблем звітності. Стара версія цих сторінках також доступні на японській мові, завдяки зусиллям добрих Юдзи Kumasaka.
Використання HTTPClient повинно бути досить просто. Спочатку додайте імпорт імпорт заяву HTTPClient *. у файл (и). Далі ви створюєте екземпляр HttpConnection (ви повинні будете один для кожного сервера, який ви хочете поговорити с). Запити можуть бути відправлені з використанням одного з методів глави (), отримати (), повідомлення (), і т.д. в HttpConnection.
Всі ці методи повертають екземпляр HttpResponse який має методи для доступу до заголовків відповіді (getHeader (), getHeaderAsInt (), і т.д.), різні Інформація відповідь (getStatusCode (), getReasonLine () і т.д.), дані відповіді (GetData () , GetText (), і getInputStream ()) і будь причепи, які, можливо, були відправлені (getTrailer (), getTrailerAsInt (), і т.д.). Нижче наведені деякі приклади, щоб розпочати роботу.
Для вилучення файлів з URL "http://www.myaddr.net/my/file" ви можете використовувати щось на кшталт такого:
    намагатися
    {
        HttpConnection кін = новий HttpConnection ("www.myaddr.net");
        HttpResponse RSP = con.Get ("/ моя / файлу");
        якщо (rsp.getStatusCode ()> = 300)
        {
            System.err.println ("Надійшло Помилка:" + rsp.getReasonLine ());
            System.err.println (rsp.getText ());
        }
        ще
            Дані = rsp.getData ();
        RSP = con.Get ("/ another_file");
        якщо (rsp.getStatusCode ()> = 300)
        {
            System.err.println ("Надійшло Помилка:" + rsp.getReasonLine ());
            System.err.println (rsp.getText ());
        }
        ще
            other_data = rsp.getData ();
    }
    зловити (IOException МОР)
    {
        System.err.println (ioe.toString ());
    }
    вилов (ParseException PE)
    {
        System.err.println ("Помилка розбору Content-Type:" + pe.toString ());
    }
    вилов (ModuleException мене)
    {
        System.err.println ("Запит Обробка помилок:" + me.getMessage ());
    }
Це дозволить отримати файли "/ моя / файлів" і "/ another_file" і покласти їх вміст в байт [] 'и доступні через GetData (). Зверніть увагу, що вам потрібно тільки створити новий HttpConnection при відправці запиту на новий сервер (інший протокол, хост, порт); хоча ви можете створити нову HttpConnection для кожного запиту до сервера ж це не рекомендується, так як різна інформація про сервер кешируются після першого запиту (для оптимізації подальших запитів) і стійкі сполуки використовуються, коли це можливо (дивіться також Advanced Info).
Для відправки даних форми з аплету на ваш сервер можна використовувати щось на зразок цього (якщо у вас є два поля, звані ім'я та адресу електронної пошти, вміст якого зберігаються в змінних ім'я та адресу електронної пошти):
    намагатися
    {
        NVPair form_data [] = новий NVPair [2];
        form_data [0] = новий NVPair ("ім'я", ім'я);
        form_data [1] = новий NVPair ("E-MAIL", адреса електронної пошти);
        // Зверніть увагу, конструктор зручність для аплетів
        HttpConnection кін = новий HttpConnection (це);
        HttpResponse RSP = con.Post ("/ CGI-BIN / my_script", form_data);
        якщо (rsp.getStatusCode ()> = 300)
        {
            System.err.println ("Надійшло Помилка:" + rsp.getReasonLine ());
            System.err.println (rsp.getText ());
        }
        ще
            потік = rsp.getInputStream ();
    }
    зловити (IOException МОР)
    {
        System.err.println (ioe.toString ());
    }
    вилов (ModuleException мене)
    {
        System.err.println ("Запит Обробка помилок:" + me.getMessage ());
    }
Ось дані відповіді читається на дозвіллі за допомогою InputStream, а не все відразу в байт [].
Як інший приклад, якщо ви хочете, щоб завантажити документ на URL (і сервер підтримує HTTP PUT), Ви могли б зробити щось на кшталт такого:
    намагатися
    {
        URL URL = новий URL-адресу ("http://www.mydomain.us/test/my_file");
        HttpConnection кін = новий HttpConnection (URL);
        HttpResponse RSP = con.Put (url.getFile (), "Hello World");
        якщо (rsp.getStatusCode ()> = 300)
        {
            System.err.println ("Надійшло Помилка:" + rsp.getReasonLine ());
            System.err.println (rsp.getText ());
        }
        ще
            Текст = rsp.getText ();
    }
    зловити (IOException МОР)
    {
        System.err.println (ioe.toString ());
    }
    вилов (ModuleException мене)
    {
        System.err.println ("Запит Обробка помилок:" + me.getMessage ());
    }