httpclient笔记（一）

Jakarta的httpclient3.1是最新版本，项目中需要用程序模拟浏览器的GET和POST动作。在使用过程中遇到不少问题。
1. 带附件的POST提交
    最开始都是使用MultipartPostMethod这个类，现在已经废弃这个类了。API说明：Deprecated. Use MultipartRequestEntity in conjunction with PostMethod instead.   使用PostMethod可以实现的功能，就没有必要再弄一个MultipartPostMethod了。下面是一段最简单的示例：

PostMethod post  =   new  PostMethod();
        NameValuePair[] pairs  =   new  NameValuePair[ 2 ];
        pairs[ 0 ]  =   new  NameValuePair( " para1 " ,  " value1 " );
        pairs[ 0 ]  =   new  NameValuePair( " para2 " ,  " value2 " );
        post.setRequestBody(pairs);
        HttpClient client  =   new  HttpClient();
         try   {
            client.executeMethod(post);
        }   catch  (HttpException e)  {
            e.printStackTrace();
        }   catch  (IOException e)  {
            e.printStackTrace();
        }

   这是针对一般的form形式的提交，而且这个form里面不带附件的。如果带附件，那么这种方法就不起作用，附件上传的参数和普通参数无法一同在服务器获取到。org.apache.commons.httpclient.methods.multipart 这个包就是为处理文件上传这种多形式参数的情况的。最主要的类是Part（代表一种post object），它有二个比较重要的子类：FilePart和StringPart，一个是文件的参数，另一个就是普通的文本参数。它的典型使用方法如下：

String url  =   " http://localhost:8080/HttpTest/Test " ;
         PostMethod postMethod  =   new  PostMethod(url);
         
         StringPart sp  =   new  StringPart( " TEXT " ,  " testValue " );
         FilePart fp  =   new  FilePart( " file " ,  " test.txt " ,  new  File( " ./temp/test.txt " ));
         
         MultipartRequestEntity mrp =   new  MultipartRequestEntity( new  Part[] {sp, fp} , postMethod
                 .getParams());
         postMethod.setRequestEntity(mrp);
         
          // 执行postMethod
         HttpClient httpClient  =   new  HttpClient();
          try   {
            httpClient.executeMethod(postMethod);
        }   catch  (HttpException e)  {
            e.printStackTrace();
        }   catch  (IOException e)  {
            e.printStackTrace();
        }

    在第二行PostMethod postMethod = new PostMethod();后面，有人说需要使用postMehtod.setRequestHeader("Content-type", "multipart/form-data"); Content-type的请求类型进行更改。但是我在使用过程没有加上这一句，查了一下httpCleint的默认Content-type是application/octet-stream。应该是没有影响的。对于MIME类型的请求，httpclient建议全用MulitPartRequestEntity进行包装，就是上面的用法。

2.  参数中文的处理问题
    httpclient的默认编码都是ISO-8859-1，那肯定就无法支持中文参数了。引用一下这篇文章：http://thinkbase.net/w/main/Wiki?HttpClient+POST+%E7%9A%84+UTF-8+%E7%BC%96%E7%A0%81%E9%97%AE%E9%A2%98 ，按照作者的说法，就可以正常解决中文编码的问题。其中最关键的是修改EncodingUtil这个类的一个方法实现。另外，FilePart和StringPart的构造方法都有一个带编码指定的参数，为了减少问题的出现，建议所有的都带上统一的编码，包括postMethod.getParams()。示例如下：

String url  =   " http://localhost:8080/HttpTest/Test " ;
         PostMethod postMethod  =   new  PostMethod(url);
         
         StringPart sp  =   new  StringPart( " TEXT " ,  " testValue " ,  " GB2312 " );
         FilePart fp  =   new  FilePart( " file " ,  " test.txt " ,  new  File( " ./temp/test.txt " ),  null ,  " GB2312 " );
         
         postMethod.getParams().setContentCharset( " GB2312 " );
         MultipartRequestEntity mrp =   new  MultipartRequestEntity( new  Part[] {sp, fp} , postMethod
                 .getParams());
         postMethod.setRequestEntity(mrp);
         
          // 执行postMethod
         HttpClient httpClient  =   new  HttpClient();
          try   {
            httpClient.executeMethod(postMethod);
        }   catch  (HttpException e)  {
            e.printStackTrace();
        }   catch  (IOException e)  {
            e.printStackTrace();
        }