HTTPClient

Gói này cung cấp một thư viện http client hoàn tất. Nó hiện đang thực hiện hầu hết các bộ phận có liên quan của các HTTP / 1.0 và HTTP / 1.1 giao thức, bao gồm các phương pháp yêu cầu HEAD, GET, POST và PUT, và xử lý tự động được uỷ quyền, yêu cầu chuyển hướng, cookies.
Hơn nữa lớp Codecs bao gồm lập trình chứa và giải mã cho các base64, trích dẫn-in, URL mã hóa, chửi rủa và các bảng mã multipart / form-data. Toàn bộ sự việc là miễn phí, và cấp phép theo Lesser GNU General Public License (LGPL) (lưu ý rằng điều này là không giống như các GPL).
Sau đây là các bộ dụng cụ và tài liệu hướng dẫn cho các httpclient Version 0,3-3. Nếu bạn có bất kỳ vấn đề, lỗi, đề nghị, ý kiến, vv xem các thông tin về các vấn đề báo cáo và gỡ lỗi. Một phiên bản cũ của các trang này cũng có sẵn trong tiếng Nhật, nhờ sự nỗ lực của lòng Yuji Kumasaka.
Sử dụng httpclient nên khá đơn giản. Đầu tiên thêm việc nhập khẩu báo cáo nhập khẩu httpclient. *; đến tập tin của bạn (s). Tiếp theo bạn tạo một thể hiện của HttpConnection (bạn sẽ cần một cho mỗi máy chủ mà bạn muốn nói chuyện với). Yêu cầu sau đó có thể được gửi bằng một trong những phương pháp Head (), Get (), Post (), vv trong HttpConnection.
Những phương pháp này tất cả trở về một thể hiện của HttpResponse đó có phương pháp để truy cập vào các tiêu đề phản ứng (getHeader (), getHeaderAsInt (), vv), thông tin phản hồi khác nhau (getStatusCode (), getReasonLine (), vv), các phản ứng dữ liệu (getData () , gettext (), và getInputStream ()) và bất kỳ trailers mà có thể đã được gửi đi (getTrailer (), getTrailerAsInt (), vv). Sau đây là một số ví dụ để bắt đầu.
Để lấy các tập tin từ các URL "http://www.myaddr.net/my/file" bạn có thể sử dụng một cái gì đó như sau:
    thử
    {
        HttpConnection con = HttpConnection mới ("www.myaddr.net");
        HttpResponse RSP = con.Get ("/ my / file");
        if (rsp.getStatusCode ()> = 300)
        {
            System.err.println ("Received Error:" + rsp.getReasonLine ());
            System.err.println (rsp.getText ());
        }
        khác
            data = rsp.getData ();
        RSP = con.Get ("/ another_file");
        if (rsp.getStatusCode ()> = 300)
        {
            System.err.println ("Received Error:" + rsp.getReasonLine ());
            System.err.println (rsp.getText ());
        }
        khác
            other_data = rsp.getData ();
    }
    catch (IOException IOE)
    {
        System.err.println (ioe.toString ());
    }
    catch (ParseException pe)
    {
        System.err.println ("Lỗi phân tích cú pháp Content-Type:" + pe.toString ());
    }
    catch (ModuleException tôi)
    {
        System.err.println ("Lỗi xử lý yêu cầu:" + me.getMessage ());
    }
Điều này sẽ có được các tập tin "/ my / file" và "/ another_file" và đặt nội dung của họ vào byte [] 's có thể truy cập thông qua getData (). Lưu ý rằng bạn cần phải chỉ tạo ra một HttpConnection mới khi gửi yêu cầu đến một máy chủ mới (giao thức khác nhau, máy chủ hoặc cổng); mặc dù bạn có thể tạo ra một HttpConnection mới cho mỗi yêu cầu cho cùng một máy chủ này không được khuyến khích, như các thông tin khác nhau về các máy chủ được lưu trữ sau khi yêu cầu đầu tiên (để tối ưu hóa các yêu cầu tiếp theo) và kết nối liên tục được sử dụng bất cứ khi nào có thể (xem cũng Advanced Info).
POST dữ liệu mẫu từ một applet lại cho máy chủ của bạn, bạn có thể sử dụng một cái gì đó như thế này (giả sử bạn có hai lĩnh vực được gọi tên và e-mail, mà nội dung được lưu trữ trong các tên biến và email):
    thử
    {
        NVPair form_data [] = new NVPair [2];
        form_data [0] = NVPair mới ("name", tên);
        form_data [1] = NVPair mới ("e-mail", email);
        // Lưu ý các nhà xây dựng thuận tiện cho các applet
        HttpConnection con = new HttpConnection (này);
        HttpResponse RSP = con.Post ("/ cgi-bin / my_script", form_data);
        if (rsp.getStatusCode ()> = 300)
        {
            System.err.println ("Received Error:" + rsp.getReasonLine ());
            System.err.println (rsp.getText ());
        }
        khác
            dòng = rsp.getInputStream ();
    }
    catch (IOException IOE)
    {
        System.err.println (ioe.toString ());
    }
    catch (ModuleException tôi)
    {
        System.err.println ("Lỗi xử lý yêu cầu:" + me.getMessage ());
    }
Ở đây dữ liệu đáp ứng được đọc tại giải trí thông qua một InputStream thay vì tất cả cùng một lúc vào một byte [].
Một ví dụ khác, nếu bạn muốn tải lên một tài liệu vào một URL (và các máy chủ hỗ trợ http PUT), bạn có thể làm một cái gì đó như sau:
    thử
    {
        URL url = URL mới ("http://www.mydomain.us/test/my_file");
        HttpConnection con = new HttpConnection (url);
        HttpResponse RSP = con.Put (url.getFile (), "Hello World");
        if (rsp.getStatusCode ()> = 300)
        {
            System.err.println ("Received Error:" + rsp.getReasonLine ());
            System.err.println (rsp.getText ());
        }
        khác
            text = rsp.getText ();
    }
    catch (IOException IOE)
    {
        System.err.println (ioe.toString ());
    }
    catch (ModuleException tôi)
    {
        System.err.println ("Lỗi xử lý yêu cầu:" + me.getMessage ());
    }