HttpURLConnection学习
转自:http://mobile.51cto.com/abased-448264.htm
最常用的Http请求无非是get和post,get请求可以获取静态页面,也可以把参数放在URL字串后面,传递给servlet,post与get的不同之处在于post的参数不是放在URL字串里面,而是放在http请求的正文内。
在Java中可以使用HttpURLConnection发起这两种请求,了解此类,对于了解soap,和编写servlet的自动测试代码都有很大的帮助。
下面的代码简单描述了如何使用HttpURLConnection发起这两种请求,以及传递参数的方法:
- public class HttpInvoker {
- public static final String GET_URL = " http://localhost:8080/welcome1 " ;
- public static final String POST_URL = " http://localhost:8080/welcome1 " ;
- public static void readContentFromGet() throws IOException {
- // 拼凑get请求的URL字串,使用URLEncoder.encode对特殊和不可见字符进行编码
- String getURL = GET_URL + " ?username= "
- + URLEncoder.encode( " fat man " , " utf-8 " );
- URL getUrl = new URL(getURL);
- // 根据拼凑的URL,打开连接,URL.openConnection函数会根据URL的类型,
- // 返回不同的URLConnection子类的对象,这里URL是一个http,因此实际返回的是HttpURLConnection
- HttpURLConnection connection = (HttpURLConnection) getUrl
- .openConnection();
- // 进行连接,但是实际上get request要在下一句的connection.getInputStream()函数中才会真正发到
- // 服务器
- connection.connect();
- // 取得输入流,并使用Reader读取
- BufferedReader reader = new BufferedReader( new InputStreamReader(
- connection.getInputStream()));
- System.out.println( " ============================= " );
- System.out.println( " Contents of get request " );
- System.out.println( " ============================= " );
- String lines;
- while ((lines = reader.readLine()) != null ) {
- System.out.println(lines);
- }
- reader.close();
- // 断开连接
- connection.disconnect();
- System.out.println( " ============================= " );
- System.out.println( " Contents of get request ends " );
- System.out.println( " ============================= " );
- }
- public static void readContentFromPost() throws IOException {
- // Post请求的url,与get不同的是不需要带参数
- URL postUrl = new URL(POST_URL);
- // 打开连接
- HttpURLConnection connection = (HttpURLConnection) postUrl
- .openConnection();
- // Output to the connection. Default is
- // false, set to true because post
- // method must write something to the
- // connection
- // 设置是否向connection输出,因为这个是post请求,参数要放在
- // http正文内,因此需要设为true
- connection.setDoOutput( true );
- // Read from the connection. Default is true.
- connection.setDoInput( true );
- // Set the post method. Default is GET
- connection.setRequestMethod( " POST " );
- // Post cannot use caches
- // Post 请求不能使用缓存
- connection.setUseCaches( false );
- // This method takes effects to
- // every instances of this class.
- // URLConnection.setFollowRedirects是static函数,作用于所有的URLConnection对象。
- // connection.setFollowRedirects(true);
- // This methods only
- // takes effacts to this
- // instance.
- // URLConnection.setInstanceFollowRedirects是成员函数,仅作用于当前函数
- connection.setInstanceFollowRedirects( true );
- // Set the content type to urlencoded,
- // because we will write
- // some URL-encoded content to the
- // connection. Settings above must be set before connect!
- // 配置本次连接的Content-type,配置为application/x-www-form-urlencoded的
- // 意思是正文是urlencoded编码过的form参数,下面我们可以看到我们对正文内容使用URLEncoder.encode
- // 进行编码
- connection.setRequestProperty( " Content-Type " ,
- " application/x-www-form-urlencoded " );
- // 连接,从postUrl.openConnection()至此的配置必须要在connect之前完成,
- // 要注意的是connection.getOutputStream会隐含的进行connect。
- connection.connect();
- DataOutputStream out = new DataOutputStream(connection
- .getOutputStream());
- // The URL-encoded contend
- // 正文,正文内容其实跟get的URL中'?'后的参数字符串一致
- String content = " firstname= " + URLEncoder.encode( " 一个大肥人 " , " utf-8 " );
- // DataOutputStream.writeBytes将字符串中的16位的unicode字符以8位的字符形式写道流里面
- out.writeBytes(content);
- out.flush();
- out.close(); // flush and close
- BufferedReader reader = new BufferedReader( new InputStreamReader(
- connection.getInputStream()));
- String line;
- System.out.println( " ============================= " );
- System.out.println( " Contents of post request " );
- System.out.println( " ============================= " );
- while ((line = reader.readLine()) != null ) {
- System.out.println(line);
- }
- System.out.println( " ============================= " );
- System.out.println( " Contents of post request ends " );
- System.out.println( " ============================= " );
- reader.close();
- connection.disconnect();
- }
- /** *//**
- * @param args
- */
- public static void main(String[] args) {
- // TODO Auto-generated method stub
- try {
- readContentFromGet();
- readContentFromPost();
- } catch (IOException e) {
- // TODO Auto-generated catch block
- e.printStackTrace();
- }
- }
- }
上面的readContentFromGet()函数产生了一个get请求,传给servlet一个username参数,值为"fat man"。
readContentFromPost()函数产生了一个post请求,传给servlet一个firstname参数,值为"一个大肥人"。
HttpURLConnection.connect函数,实际上只是建立了一个与服务器的tcp连接,并没有实际发送http请求。无论是post还是get,http请求实际上直到HttpURLConnection.getInputStream()这个函数里面才正式发送出去。
在readContentFromPost() 中,顺序是重中之重,对connection对象的一切配置(那一堆set函数)都必须要在connect()函数执行之前完成。而对 outputStream的写操作,又必须要在inputStream的读操作之前。这些顺序实际上是由http请求的格式决定的。
http 请求实际上由两部分组成,一个是http头,所有关于此次http请求的配置都在http头里面定义,一个是正文content,在connect()函数里面,会根据HttpURLConnection对象的配置值生成http头,因此在调用connect函数之前,就必须把所有的配置准备好。
紧接着http头的是http请求的正文,正文的内容通过outputStream写入,实际上outputStream不是一个网络流,充其量是个字符串流,往里面写入的东西不会立即发送到网络,而是在流关闭后,根据输入的内容生成http正文。
至此,http请求的东西已经准备就绪。在getInputStream()函数调用的时候,就会把准备好的http请求正式发送到服务器了,然后返回一个输入流,用于读取服务器对于此次http请求的返回信息。由于http请求在getInputStream的时候已经发送出去了(包括http头和正文),因此在getInputStream()函数之后对connection对象进行设置(对http头的信息进行修改)或者写入 outputStream(对正文进行修改)都是没有意义的了,执行这些操作会导致异常的发生
上节说道,post请求的OutputStream实际上不是网络流,而是写入内存,在getInputStream中才真正把写道流里面的内容作为正文与根据之前的配置生成的http request头合并成真正的http request,并在此时才真正向服务器发送。
HttpURLConnection.setChunkedStreamingMode 函数可以改变这个模式,设置了ChunkedStreamingMode后,不再等待OutputStream关闭后生成完整的http request一次过发送,而是先发送http request头,正文内容则是网路流的方式实时传送到服务器。实际上是不告诉服务器http正文的长度,这种模式适用于向服务器传送较大的或者是不容易获取长度的数据,如文件。
- public static void readContentFromChunkedPost() throws IOException {
- URL postUrl = new URL(POST_URL);
- HttpURLConnection connection = (HttpURLConnection) postUrl
- .openConnection();
- connection.setDoOutput( true );
- connection.setDoInput( true );
- connection.setRequestMethod( " POST " );
- connection.setUseCaches( false );
- connection.setInstanceFollowRedirects( true );
- connection.setRequestProperty( " Content-Type " ,
- " application/x-www-form-urlencoded " );
- /** //*
- * 与readContentFromPost()最大的不同,设置了块大小为5字节
- */
- connection.setChunkedStreamingMode( 5 ); //设置该值后,如果网络中断,会自动重新请求,如果不想自动重新请求,可设置为0
- connection.connect();
- /** //*
- * 注意,下面的getOutputStream函数工作方式于在readContentFromPost()里面的不同
- * 在readContentFromPost()里面该函数仍在准备http request,没有向服务器发送任何数据
- * 而在这里由于设置了ChunkedStreamingMode,getOutputStream函数会根据connect之前的配置
- * 生成http request头,先发送到服务器。
- */
- DataOutputStream out = new DataOutputStream(connection
- .getOutputStream());
- String content = " firstname= " + URLEncoder.encode( " 一个大肥人 " +
- " " +
- " asdfasfdasfasdfaasdfasdfasdfdasfs " , " utf-8 " );
- out.writeBytes(content);
- out.flush();
- out.close(); // 到此时服务器已经收到了完整的http request了,而在readContentFromPost()函数里,要等到下一句服务器才能收到http请求。
- BufferedReader reader = new BufferedReader( new InputStreamReader(
- connection.getInputStream()));
- out.flush();
- out.close(); // flush and close
- String line;
- System.out.println( " ============================= " );
- System.out.println( " Contents of post request " );
- System.out.println( " ============================= " );
- while ((line = reader.readLine()) != null ) {
- System.out.println(line);
- }
- System.out.println( " ============================= " );
- System.out.println( " Contents of post request ends " );
- System.out.println( " ============================= " );
- reader.close();
- connection.disconnect();
- }