网络编程 -- HttpURLConnection

一、概念

HttpURLConnection用于实现基于HTTP URL的请求、响应功能，每个HttpURLConnection实例都可用于生成单个网络请求，支持GET、POST、PUT、DELETE等方式，最常用的也就是GET和POST。

二、使用

1.基本流程

1.在Manifest文件中添加网络访问权限：

2.获取HttpURLConnection实例。
3.设置请求报头。
4.设置请求数据，POST方法需要此步骤，如果含有请求数据，那么实例需要调用setDoOutPut(true)，通过写入getOutputStream()返回的流来传输数据。
5.读取响应数据，包括响应报头及响应报文，响应报文通过getInputStream()返回的流中读取。
6.断开连接，调用disconnect()方法。

2.GET方法使用

private void testGet(String requestUrl) {
    Log.d(TAG, "zwm, testGet, requestUrl: " + requestUrl);
    try {
        //URL对象
        URL url = new URL(requestUrl);
        //获取HttpURLConnection实例
        HttpURLConnection mConnection = (HttpURLConnection) url.openConnection();
        //设置GET请求方法
        mConnection.setRequestMethod("GET");
        //建立连接
        mConnection.connect(); //注意：可以不调用connect方法
        //根据响应码判断连接是否成功
        if (mConnection.getResponseCode() == HttpURLConnection.HTTP_OK){
            //将响应流转换成字符串
            BufferedReader reader = new BufferedReader(new InputStreamReader(mConnection.getInputStream()));
            //接收响应报文
            StringBuilder response = new StringBuilder("response：" + "\n");
            String line = "";
            while ((line = reader.readLine())!=null){
                response.append(line);
            }
            Log.d(TAG, "zwm, print " + response);
        }
    } catch (Exception e) {
        e.printStackTrace();
    }
}

注意事项：
1.HttpURLConnection是同步的请求，必须放在子线程。
2.对请求行、请求报头的设置必须放在connection.connect()前。
3.connection.getInputStream()得到一个流对象，而不是数据，从这个流对象中只能读取一次数据，第二次读取时将会得到空数据。
4.子线程不能直接更新UI，可以通过runOnUiThread()、Handler等进行更新。

3.POST方法使用

private void testPost(String requestUrl){
    Log.d(TAG, "zwm, testPost, requestUrl: " + requestUrl);
    try {
        URL url = new URL(requestUrl);
        HttpURLConnection mConnection = (HttpURLConnection) url.openConnection();
        //设置链接超时时间
        mConnection.setConnectTimeout(10000);
        //设置读取超时时间
        mConnection.setReadTimeout(15000);
        //设置请求方法
        mConnection.setRequestMethod("POST");
        //添加Header
        mConnection.setRequestProperty("Connection","keep-Alive");
        //接受输入流
        mConnection.setDoInput(true);
        //有请求数据时，必须开启此项！
        mConnection.setDoOutput(true);
        //POST不支持缓存
        mConnection.setUseCaches(false);
        //建立连接
        mConnection.connect(); //注意：可以不调用connect方法
        //传输'请求数据'
        String body = "userName=whdalive&password=123456";
        BufferedWriter writer = new BufferedWriter(new OutputStreamWriter(mConnection.getOutputStream(),"UTF-8"));
        writer.write(body);
        writer.flush();
        writer.close();

        if (mConnection.getResponseCode() == HttpURLConnection.HTTP_OK){
            InputStream inputStream = mConnection.getInputStream();
            BufferedReader reader = new BufferedReader(new InputStreamReader(inputStream));
            StringBuilder response = new StringBuilder("response: " + "\n");
            String line = "";
            while ((line=reader.readLine())!=null){
                response.append(line);
            }
            Log.d(TAG, "zwm, print " + response.toString());
        }
    } catch (Exception e) {
        e.printStackTrace();
    }
}

注意事项：
1.同GET方法使用注意事项。
2.POST方式不支持缓存，必须调mConnection.setUseCaches(false)。
3.有请求数据时，必须调用mConnection.setDoOutput(true)。
4.POST传输JSON数据，在请求头中设置参数类型是JSON格式，并传入JSON格式的字符串到body即可。
5.POST上传文件，在请求头中设置参数类型是FILE类型，并将文件封装成一个流传入body即可。
6.POST方式传递参数/JSON/文件等数据的本质，是从连接中得到一个输出流，通过输出流把相应数据写到服务器。

4.Cookie使用

public class CookieManagerDemo {

    //打印cookie信息
    public static void printCookie(CookieStore cookieStore){
        List listCookie = cookieStore.getCookies();
        listCookie.forEach(httpCookie -> {
            System.out.println("--------------------------------------");
            System.out.println("class      : "+httpCookie.getClass());
            System.out.println("comment    : "+httpCookie.getComment());
            System.out.println("commentURL : "+httpCookie.getCommentURL());
            System.out.println("discard    : "+httpCookie.getDiscard());
            System.out.println("domain     : "+httpCookie.getDomain());
            System.out.println("maxAge     : "+httpCookie.getMaxAge());
            System.out.println("name       : "+httpCookie.getName());
            System.out.println("path       : "+httpCookie.getPath());
            System.out.println("portlist   : "+httpCookie.getPortlist());
            System.out.println("secure     : "+httpCookie.getSecure());
            System.out.println("value      : "+httpCookie.getValue());
            System.out.println("version    : "+httpCookie.getVersion());
            System.out.println("httpCookie : "+httpCookie);
        });
    }

    public static void requestURL() throws Exception{
        URL url = new URL("http://192.168.3.249:9000/webDemo/index.jsp");
        HttpURLConnection conn = (HttpURLConnection)url.openConnection();
        String basic = Base64.getEncoder().encodeToString("infcn:123456".getBytes());
        conn.setRequestProperty("Proxy-authorization", "Basic " + basic);
        BufferedReader br = new BufferedReader(new InputStreamReader(conn.getInputStream()));
        String line = null;
        while((line=br.readLine())!=null){
            System.out.println(line);
        }
        br.close();
    }

    public static void main(String[] args) throws Exception {
        
        CookieManager manager = new CookieManager();
        //设置cookie策略，只接受与你对话服务器的cookie，而不接收Internet上其它服务器发送的cookie
        manager.setCookiePolicy(CookiePolicy.ACCEPT_ORIGINAL_SERVER);
        CookieHandler.setDefault(manager);
        
        printCookie(manager.getCookieStore());
        //第一次请求
        requestURL();

        printCookie(manager.getCookieStore());
        //第二次请求
        requestURL();
    }
    
}

5.例子

private void downloadPicture(String requestUrl){
    try {
        //获取网络图片的URL
        URL url = new URL(requestUrl);
        //获取HttpURLConnection实例
        HttpURLConnection mConnection = (HttpURLConnection) url.openConnection();
        //设置POST方式
        //下载图片这个场景中，POST和GET都可以
        mConnection.setRequestMethod("POST");
        //接受输入流
        mConnection.setDoInput(true);
        //有请求数据时，必须开启此项！
        mConnection.setDoOutput(true);
        //POST方式不支持缓存
        mConnection.setUseCaches(false);
        //建立连接
        mConnection.connect(); //注意：可以不调用connect方法
        //获取响应流
        InputStream in = mConnection.getInputStream();
        //将响应流转换成Bitmap
        final Bitmap bitmap = BitmapFactory.decodeStream(in);
        //子线程更新UI，显示图片
        runOnUiThread(new Runnable() {
            @Override
            public void run() {
                mImageView.setImageBitmap(bitmap);
            }
        });
    } catch (Exception e){
        e.printStackTrace();
    }
}