HTTPClient

Acest pachet oferă o bibliotecă completă client http. În prezent pune în aplicare cele mai multe dintre părțile relevante ale HTTP / 1.0 și HTTP / 1.1 protocoale, inclusiv șeful metode cerere, GET, POST și PUT, și manipularea automată a autorizației, cererile de redirecționare, și cookie-urile.
Mai mult, a inclus clasa Codecs conține codoare și decodoare pentru base64,, URL-codare citat-printable, chunked și codificări multipart / form-data. Totul este gratuit, și sub licența GNU Lesser General Public License (LGPL) (rețineți că acest lucru nu este la fel ca GPL).
În urma sunt kituri și documentația pentru versiunea HTTPClient 0.3-3. Dacă aveți probleme, bug-uri, sugestii, comentarii, etc. consultați informațiile privind depanare și problemele de raportare. O versiune mai veche a acestor pagini sunt disponibile și în limba japoneză, grație eforturilor amabile ale Yuji Kumasaka.
Utilizarea HTTPClient ar trebui să fie destul de simplu. În primul rând se adaugă importul declarația de import HTTPClient *.; la fișierul (e). Apoi creați o instanță de httpconnection (veți avea nevoie unul pentru fiecare server pe care doriți să vorbesc cu). Cererile pot fi apoi trimise folosind una șefului metode (), Ia (), post (), etc în httpconnection.
Aceste metode toate returna o instanță de HTTPResponse care are metode de accesare antetele de răspuns (getHeader (), getHeaderAsInt (), etc), diverse informatii răspuns (getStatusCode (), getReasonLine (), etc), datele de răspuns (GetData () , getText (), și getInputStream ()) și orice remorcile care ar fi putut fi expediate (getTrailer (), getTrailerAsInt (), etc.). În urma sunt câteva exemple pentru a începe.
Pentru a prelua fișiere de pe URL-ul "http://www.myaddr.net/my/file" puteți folosi ceva de genul următoarele:
    încerca
    {
        Httpconnection con = new httpconnection ("www.myaddr.net");
        HTTPResponse RSP = con.Get ("/ mea / file");
        dacă (rsp.getStatusCode ()> = 300)
        {
            System.err.println ("primite Eroare:" + rsp.getReasonLine ());
            System.err.println (rsp.getText ());
        }
        altfel
            date = rsp.getData ();
        RSP = con.Get ("/ another_file");
        dacă (rsp.getStatusCode ()> = 300)
        {
            System.err.println ("primite Eroare:" + rsp.getReasonLine ());
            System.err.println (rsp.getText ());
        }
        altfel
            other_data = rsp.getData ();
    }
    captură (IOException OIE)
    {
        System.err.println (ioe.toString ());
    }
    captură (ParseException pe)
    {
        System.err.println ("eroare de analiză Content-Type:" + pe.toString ());
    }
    captură (ModuleException mine)
    {
        System.err.println ("cerere de manipulare Eroare:" + me.getMessage ());
    }
Acest lucru va primi fisierele "/ mea / fișiere" și "/ another_file" și a pus conținutul lor în byte [] e accesibil prin getData (). Rețineți că aveți nevoie pentru a crea doar un nou httpconnection când trimite o cerere la un nou server (protocol diferit, gazda sau port); deși s-ar putea crea o nouă httpconnection pentru fiecare cerere același server nu recomandat, informații diverse despre serverul cache de la prima solicitare (pentru a optimiza cereri ulterioare) și conexiunile persistente sunt folosite ori de câte ori este posibil (a se vedea, de asemenea, informații Avansat).
Pentru a posta datele din formular la un applet înapoi la server-ul dvs. ați putea folosi ceva de genul asta (presupunând că aveți două domenii numite numele și e-mail, ale cărui conținut sunt stocate în numele variabilelor și e-mail):
    încerca
    {
        NVPair form_data [] = new NVPair [2];
        form_data [0] = new NVPair ("name", numele);
        form_data [1] = new NVPair ("e-mail", email);
        // Nota constructorul confort pentru applet
        Httpconnection con = httpconnection nou (acest lucru);
        HTTPResponse RSP = con.Post ("/ cgi-bin / my_script", form_data);
        dacă (rsp.getStatusCode ()> = 300)
        {
            System.err.println ("primite Eroare:" + rsp.getReasonLine ());
            System.err.println (rsp.getText ());
        }
        altfel
            flux = rsp.getInputStream ();
    }
    captură (IOException OIE)
    {
        System.err.println (ioe.toString ());
    }
    captură (ModuleException mine)
    {
        System.err.println ("cerere de manipulare Eroare:" + me.getMessage ());
    }
Aici datele de răspuns este citită la petrecere a timpului liber printr-un InputStream în loc de-o dată într-un octet [].
Ca un alt exemplu, în cazul în care doriți să încărcați un document la un URL (și serverul acceptă http PUT) ai putea face ceva de genul următoarele:
    încerca
    {
        URL url = new URL ("http://www.mydomain.us/test/my_file");
        Httpconnection con = new httpconnection (url);
        HTTPResponse RSP = con.Put (url.getFile (), "Hello World");
        dacă (rsp.getStatusCode ()> = 300)
        {
            System.err.println ("primite Eroare:" + rsp.getReasonLine ());
            System.err.println (rsp.getText ());
        }
        altfel
            text = rsp.getText ();
    }
    captură (IOException OIE)
    {
        System.err.println (ioe.toString ());
    }
    captură (ModuleException mine)
    {
        System.err.println ("cerere de manipulare Eroare:" + me.getMessage ());
    }