[HttpClient] 创建一个HTTP POST 请求 (from Jakarta Commons cookbook 11.7 )

[HttpClient] 创建一个HTTP POST 请求 (from Jakarta Commons cookbook 11.7 )

问题：
        你需要使用HTTP POST 方法来向一个servlet传递参数。

讨论：
        创建一个 PostMethod 对象，然后调用 setParameter() 或 addParameter() 方法设置参数。 PostMethod 对象将会传送一个 Content-Type 头为 application/x-www-form-urlencoded 的请求，并且参数将在请求body中被传送。在下列的例子中演示了用 PostMethod 对象传递参数的用法：

import  org.apache.commons.httpclient.HttpClient;
import  org.apache.commons.httpclient.HttpException;
import  org.apache.commons.httpclient.NameValuePair;
import  org.apache.commons.httpclient.methods.PostMethod;

HttpClient client  =   new  HttpClient( );

//  Create POST method
String url  =   " http://www.discursive.com/cgi-bin/jccook/param_list.cgi " ;
PostMethod method  =   new  PostMethod( url );

//  Set parameters on POST    
method.setParameter(  " test1 " ,  " Hello World "  );
method.addParameter(  " test2 " ,  " This is a Form Submission "  );
method.addParameter(  " Blah " ,  " Whoop "  );
method.addParameter(  new  NameValuePair(  " Blah " ,  " Whoop2 "  ) );

//  Execute and print response
client.executeMethod( method );
String response  =  method.getResponseBodyAsString( );
System.out.println( response );

method.releaseConnection( );

       param_list.cgi CGI脚本会对所以接收到的参数进行回显，从下面的输出中，你可以看到传递给CGI脚本的三个参数：

These are the parameters I received:

test1:
  Hello World
test2:
  This is a Form Submission
Blah:
  Whoop
  Whoop2

       有几种方法来在一个PostMethod对象中设置参数。最直接的方法就是调用setParameter()方法，并传递两个字符串给它：参数的名称和参数值。setParameter()方法将会替代任何已经存在的同名参数。但是，如果一个同名的参数已经存在一个PostMethod对象中，addParameter()将会加入另一个同名参数值；addParameter()方法同样接受两个String：参数名和参数值。另一种方法，这两个方法同样接受一个包装了参数名和参数值的NameValuePair对象。在前面的例子中，通过addParameter()方法，用参数名Blah传递了两个值，第一次用两个String作为参数，第二次用一个NameValuePair对象作为参数。