HTTPClient

Denne pakke indeholder en komplet http klient biblioteket. Det i øjeblikket gennemfører de fleste af de relevante dele af HTTP / 1.0 og HTTP / 1.1-protokoller, herunder anmodningen metoder HEAD, GET, POST og PUT, og automatisk håndtering af tilladelsen, omdirigering anmodninger og cookies.
Desuden indeholdt Codecs klassen indeholder kodere og dekodere til base64, quoted-printable, URL-kodning, chunked og multipart / formular-data kodninger. Det hele er gratis, og udgivet under GNU Lesser General Public License (LGPL) (bemærk, at dette ikke er det samme som GPL).
Følgende er de kits og dokumentation for HTTPClient Version 0,3-3. Hvis du har nogen problemer, bugs, forslag, kommentarer, osv se info om debugging og rapportering problemer. En ældre version af disse sider er også tilgængelige på japansk, takket være venligt indsats fra Yuji Kumasaka.
Brug af HTTPClient bør være ganske enkel. Først tilføje import import erklæring HTTPClient *.; til din fil (er). Næste du oprette en instans af httpconnection (du skal bruge en for hver server, du ønsker at tale med). Anmodninger kan derefter sendes ved hjælp af en af ​​de metoder Head (), Get (), Post (), etc i httpconnection.
Disse metoder alle returnere en instans af HTTPResponse der har metoder til at få adgang til respons headers (getHeader (), getHeaderAsInt (), osv), diverse respons info (getStatusCode (), getReasonLine () osv), svardataene (getdata () , Gettext (), og getInputStream ()), og eventuelle trailere, der måske er blevet sendt (getTrailer (), getTrailerAsInt (), etc). Følgende er nogle eksempler for at komme i gang.
For at hente filer fra URL "http://www.myaddr.net/my/file" kan du bruge noget i retning af følgende:
    prøve
    {
        Httpconnection con = ny httpconnection ("www.myaddr.net");
        HTTPResponse RSP = con.Get ("/ min / fil");
        if (rsp.getStatusCode ()> = 300)
        {
            System.err.println ("Modtaget Fejl:" + rsp.getReasonLine ());
            System.err.println (rsp.getText ());
        }
        andet
            data = rsp.getData ();
        RSP = con.Get ("/ another_file");
        if (rsp.getStatusCode ()> = 300)
        {
            System.err.println ("Modtaget Fejl:" + rsp.getReasonLine ());
            System.err.println (rsp.getText ());
        }
        andet
            other_data = rsp.getData ();
    }
    fangst (IOException OIE)
    {
        System.err.println (ioe.toString ());
    }
    fangst (ParseException pe)
    {
        System.err.println ("Fejl parsing Content-Type:" + pe.toString ());
    }
    fangst (ModuleException mig)
    {
        System.err.println ("Fejlhåndtering anmodning:" + me.getMessage ());
    }
Dette vil få filerne "/ min / fil" og "/ another_file" og sætte deres indhold i byte [] 's tilgængelige via getdata (). Bemærk, at du skal kun oprette en ny httpconnection, når du sender en anmodning til en ny server (anden protokol, host eller port); selvom du måske oprette en ny httpconnection for hver anmodning til den samme server ikke anbefales, da forskellige oplysninger om serveren caches efter den første anmodning (for at optimere efterfølgende anmodninger) og vedvarende forbindelser bruges når det er muligt (se også Advanced Info).
At skrive formulardata fra en applet tilbage til din server du kunne bruge noget som dette (forudsat du har to felter kaldet navn og e-mail, hvis indhold gemmes i variable navn og email):
    prøve
    {
        NVPair form_data [] = new NVPair [2];
        form_data [0] = ny NVPair ("navn", navn);
        form_data [1] = nyt NVPair ("e-mail", e-mail);
        // Bemærk bekvemmelighed konstruktør for applets
        Httpconnection con = ny httpconnection (dette);
        HTTPResponse RSP = con.Post ("/ cgi-bin / my_script", form_data);
        if (rsp.getStatusCode ()> = 300)
        {
            System.err.println ("Modtaget Fejl:" + rsp.getReasonLine ());
            System.err.println (rsp.getText ());
        }
        andet
            stream = rsp.getInputStream ();
    }
    fangst (IOException OIE)
    {
        System.err.println (ioe.toString ());
    }
    fangst (ModuleException mig)
    {
        System.err.println ("Fejlhåndtering anmodning:" + me.getMessage ());
    }
Her svardataene aflæses ved fritid via en InputStream stedet for alle på én gang i en byte [].
Som et andet eksempel, hvis du ønsker at uploade et dokument til en URL (og serveren understøtter http PUT), du kunne gøre noget som følgende:
    prøve
    {
        URL url = ny URL ("http://www.mydomain.us/test/my_file");
        Httpconnection con = ny httpconnection (url);
        HTTPResponse RSP = con.Put (url.getFile (), "Hello World");
        if (rsp.getStatusCode ()> = 300)
        {
            System.err.println ("Modtaget Fejl:" + rsp.getReasonLine ());
            System.err.println (rsp.getText ());
        }
        andet
            text = rsp.getText ();
    }
    fangst (IOException OIE)
    {
        System.err.println (ioe.toString ());
    }
    fangst (ModuleException mig)
    {
        System.err.println ("Fejlhåndtering anmodning:" + me.getMessage ());
    }