HTTPClient

Ce paquet fournit une bibliothèque de client http complète. Il met actuellement en œuvre la plupart des parties pertinentes de la HTTP / 1.0 et HTTP / 1.1 protocoles, y compris la demande méthodes HEAD, GET, POST et PUT et la gestion automatique de l'autorisation, les demandes de redirection, et les cookies.
En outre, la classe Codecs inclus contient codeurs et décodeurs pour la base64, quoted-printable, URL-encodage, chunked et les codages multipart / form-data. Le tout est gratuit et sous licence GNU Lesser General Public License (LGPL) (à noter que ce ne sont pas les mêmes que la GPL).
Voici les kits et de la documentation pour la version HTTPClient 0,3-3. Si vous avez des problèmes, bogues, suggestions, commentaires, etc, voir les informations sur le débogage et les problèmes de rapports. Une version plus ancienne de ces pages sont également disponibles en japonais, grâce aux efforts bienveillants de Yuji Kumasaka.
Utilisation de la HTTPClient devrait être assez simple. Première ajouter l'instruction import import HTTPClient. *; à votre fichier (s). Ensuite, vous créez une instance de HTTPConnection (vous aurez besoin d'un pour chaque serveur que vous souhaitez parler). Les demandes peuvent être envoyées en utilisant l'un des chef de méthodes (), get (), Post (), etc dans HTTPConnection.
Toutes ces méthodes retournent une instance de HTTPResponse qui possède des méthodes pour accéder aux têtes de réponse (getHeader (), getHeaderAsInt (), etc.), diverses informations de la réponse (getStatusCode (), getReasonLine (), etc.), les données de réponse (getData () , getText (), et getInputStream ()) et des remorques qui auraient pu être envoyés (getTrailer (), getTrailerAsInt (), etc.). Voici quelques exemples pour commencer.
Pour récupérer des fichiers à partir de l'URL "http://www.myaddr.net/my/file" vous pouvez utiliser quelque chose comme ce qui suit:
    essayer
    {
        HTTPConnection con = new HTTPConnection ("www.myaddr.net");
        HTTPResponse rsp = con.Get ("/ ma / fichier");
        if (rsp.getStatusCode ()> = 300)
        {
            System.err.println ("Error Received:" + rsp.getReasonLine ());
            System.err.println (rsp.getText ());
        }
        autre
            data = rsp.getData ();
        rsp = con.Get ("/ another_file");
        if (rsp.getStatusCode ()> = 300)
        {
            System.err.println ("Error Received:" + rsp.getReasonLine ());
            System.err.println (rsp.getText ());
        }
        autre
            other_data rsp.getData = ();
    }
    catch (IOException OIE)
    {
        System.err.println (ioe.toString ());
    }
    catch (ParseException pe)
    {
        System.err.println ("Erreur d'analyse Content-Type:" + pe.toString ());
    }
    catch (ModuleException moi)
    {
        System.err.println ("demande de traitement d'erreur:" + me.getMessage ());
    }
Cette obtiendrez les fichiers "/ ma / fichiers" et "/ another_file" et de mettre leur contenu dans l'octet [] s 'accessible via getData (). Notez que vous devez créer seulement une nouvelle HTTPConnection lors de l'envoi d'une demande d'un nouveau serveur (différent protocole, l'hôte ou port); bien que vous puissiez créer un nouveau HTTPConnection pour chaque demande au même serveur-ce pas recommandé, que différentes informations sur le serveur est mis en cache après la première demande (pour optimiser les requêtes ultérieures) et les connexions persistantes sont utilisés chaque fois que possible (voir aussi Advanced Info).
Pour publier des données de formulaire à partir d'une applet sur votre serveur, vous pouvez utiliser quelque chose comme ceci (en supposant que vous avez deux champs appelés nom et e-mail, dont le contenu est stocké dans le nom des variables et e-mail):
    essayer
    {
        NVPair form_data [] = new NVPair [2];
        form_data [0] = new NVPair («nom», nom);
        form_data [1] = new NVPair ("e-mail", email);
        // Notez le constructeur de commodité pour les applets
        HTTPConnection con = new HTTPConnection (this);
        HTTPResponse rsp = con.Post ("/ cgi-bin / my_script", form_data);
        if (rsp.getStatusCode ()> = 300)
        {
            System.err.println ("Error Received:" + rsp.getReasonLine ());
            System.err.println (rsp.getText ());
        }
        autre
            = flux rsp.getInputStream ();
    }
    catch (IOException OIE)
    {
        System.err.println (ioe.toString ());
    }
    catch (ModuleException moi)
    {
        System.err.println ("demande de traitement d'erreur:" + me.getMessage ());
    }
Voici les données de réponse est lu à loisir via un InputStream lieu de tout à la fois dans un byte [].
Comme autre exemple, si vous souhaitez télécharger un document vers une URL (et le serveur supporte les protocoles HTTP PUT), vous pourriez faire quelque chose comme ce qui suit:
    essayer
    {
        URL url = new URL ("http://www.mydomain.us/test/my_file");
        HTTPConnection con = new HTTPConnection (URL);
        HTTPResponse rsp = con.Put (url.getFile (), "Bonjour tout le monde");
        if (rsp.getStatusCode ()> = 300)
        {
            System.err.println ("Error Received:" + rsp.getReasonLine ());
            System.err.println (rsp.getText ());
        }
        autre
            text = rsp.getText ();
    }
    catch (IOException OIE)
    {
        System.err.println (ioe.toString ());
    }
    catch (ModuleException moi)
    {
        System.err.println ("demande de traitement d'erreur:" + me.getMessage ());
    }