HttpURLConnection官方文档翻译

2024-06-04 22:18

本文主要是介绍HttpURLConnection官方文档翻译,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

本篇为翻译文章,原文地址在这里http://developer.android.com/intl/zh-cn/reference/java/net/HttpURLConnection.html

因为Android6.0已经放弃HttpClient,而Volley和okhttp需要导入第三方库,公司项目因条件比较特殊,不予许擅自导入第三方库,所以只能使用另一个原生网络连接类HttpURLConnection。虽然我一直觉得HttpClient比较好用。。。

网上查的HttpURLConnection讲的不是很全,大体都是讲边流程而已,而且大多都很老旧,这都2016年了喂大哥!所以干脆把最新的官方文档翻译一下吧~~


API Level: 23

public abstract class 公有抽象类

HttpURLConnection

extends URLConnection


java.lang.Object
↳ java.net.URLConnection
↳ java.net.HttpURLConnection
Known Direct Subclasses 已知的直接子类
HttpsURLConnection


类概述

一个为HTTP协议(RFC 2616)设计的URLConnection,被用来在网络上发送和接收数据。数据可能是任何类型,也可能是任何长度。这个类也可以被用在发送和接收那些提前并不知道长度的流数据上。

使用这个类应该遵循的模板:

  • 1 得到一个新的HttpURLConnection实例应该通过调用URL.openConnection()这个方法,然后把结果强制转换为HttpURLConnection。

  • 2 准备请求。请求的主要属性是它的URI。请求头也包括元数据,比如证书、首选内容类型和会话cookie。

  • 3 可选择地上传一个请求体。如果实例包含请求体,则必须配置setDoOutput(true)。通过写入流来传输数据,返回值在getOutputStream()中。

  • 4 读取响应(返回结果)。响应头通常包括元数据,比如响应体的内容类型和长度,修改日期和会话cookie。响应体可以通过getInputStream()将流读取出来。如果响应没有响应体,这个方法会返回一个空的流。

  • 5 断开连接。一旦响应体读取完成,这个HttpURLConnection就应该被断开,调用disconnect()方法断开。断开会释放connection所持有的资源,所以它们可能会被关闭或者重用。

例如,检索网页 http://www.android.com/

URL url = new URL("http://www.android.com/");
HttpURLConnection urlConnection = (HttpURLConnection) url.openConnection();
try {InputStream in = new BufferedInputStream(urlConnection.getInputStream());readStream(in);
finally {urlConnection.disconnect();}
}

通过 HTTPS进行安全通信

已”https”的方式在一个URL上调用openConnection()方法会返回一个HttpsURLConnection对象,这个对象允许去重写默认的HostnameVerifier(主机名验证)和SSLSocketFactory(安全套接字工厂)。通过SSLContext创建一个应用程序提供的SSLSockerFactory,它可以提供一个自定义的X509TrustManager,用来验证证书链;它还可以提供一个自定义的X509KeyManager,用来提供客户端证书。查看HttpsURLConnection,获取更多细节。


响应处理

HttpURLConnection遵循五个HTTP重定向。它从一个源服务器重定向到另一个。这个实现不会将HTTPS重定向到HTTP,反之亦然 。
如果这个HTTP响应表明有错误发生,getInoutStream()方法将会抛出一个IOException。使用getErrorStream()来读取错误响应信息。响应头可以使用getHeaderFields()方法来正常读取。


发布内容

要上传数据到服务端,使用setDoOutput(true)来配置connection的输出。
为了获得最佳的性能,当请求体长度事先已经知道的时候你应该使用setFixedLengthStreamingMode(int),事先不知道的时候使用setChunkedStreamingMode(int)。要不然的话这个HttpURLConnection会在传输完成之前被迫地把整个的请求体都缓冲在内存中,浪费(很可能会耗尽)堆和增加延迟。

例如,执行一个上传:

HttpURLConnection urlConnection = (HttpURLConnection) url.openConnection();
try {urlConnection.setDoOutput(true);urlConnection.setChunkedStreamingMode(0);OutputStream out = new BufferedOutputStream(urlConnection.getOutputStream());writeStream(out);InputStream in = new BufferedInputStream(urlConnection.getInputStream());readStream(in);
finally {urlConnection.disconnect();}
}

性能

通过这个类返回的输入流和输出流是没有缓冲的。大多数调用者应该用BufferedInputStream或者BufferedOutputStream将返回的流包裹起来。那些只做批量读取或写入的调用者们可以忽略缓冲操作。
当从服务端或者向服务端传输大量的数据时,要限制一次性在内存里可以存多少数据。除非你需要一下子把整个数据体都放在内存中,当成一个流(不是把整个数据体当做一个字节数组或者字符串来存储,而是流)来处理。

为了减少延迟,这个类可以为多个请求/响应重用相同的底层套接字。因此,HTTP连接能够被重新打开的功能就不再重要了。调用disconnect()方法会从连接套接字池中返回一个套接字。在任意HTTP请求发出之前,这种行为都可以通过将系统属性http.keepAlive设置为false来禁用。http.maxConnections属性可以用来控制连接每个服务器的空闲的connections的数量。

在HttpURLConnection请求的实现里,服务器默认使用gzip压缩,当使用者调用getInputStream()时,它会自动将数据解压。内容编码和内容长度响应头在实例中被清除。可以通过在请求头中设置可接受的编码格式来禁用gzip压缩。

urlConnection.setRequestProperty("Accept-Encoding", "identity");

在请求头中设置可接受的编码格式可以显示的禁用自动解压缩,让响应头更完整。但是要求调用者必须根据响应的内容编码头来自行处理解压缩操作。

getContentLength()方法返回的传输的字节数,并不能被用来估计有多少字节可以用getInputStream()方法从压缩流中读取出来。相反的,它会一直读取流,直到当read()返回-1的时候。


这篇关于HttpURLConnection官方文档翻译的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!


原文地址:
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.chinasem.cn/article/1031277

相关文章

使用Python快速实现链接转word文档

《使用Python快速实现链接转word文档》这篇文章主要为大家详细介绍了如何使用Python快速实现链接转word文档功能,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 演示代码展示from newspaper import Articlefrom docx import

浅析如何使用Swagger生成带权限控制的API文档

《浅析如何使用Swagger生成带权限控制的API文档》当涉及到权限控制时,如何生成既安全又详细的API文档就成了一个关键问题,所以这篇文章小编就来和大家好好聊聊如何用Swagger来生成带有... 目录准备工作配置 Swagger权限控制给 API 加上权限注解查看文档注意事项在咱们的开发工作里,API

Mybatis官方生成器的使用方式

《Mybatis官方生成器的使用方式》本文详细介绍了MyBatisGenerator(MBG)的使用方法,通过实际代码示例展示了如何配置Maven插件来自动化生成MyBatis项目所需的实体类、Map... 目录1. MyBATis Generator 简介2. MyBatis Generator 的功能3

SpringBoot3集成swagger文档的使用方法

《SpringBoot3集成swagger文档的使用方法》本文介绍了Swagger的诞生背景、主要功能以及如何在SpringBoot3中集成Swagger文档,Swagger可以帮助自动生成API文档... 目录一、前言1. API 文档自动生成2. 交互式 API 测试3. API 设计和开发协作二、使用

基于C#实现将图片转换为PDF文档

《基于C#实现将图片转换为PDF文档》将图片(JPG、PNG)转换为PDF文件可以帮助我们更好地保存和分享图片,所以本文将介绍如何使用C#将JPG/PNG图片转换为PDF文档,需要的可以参考下... 目录介绍C# 将单张图片转换为PDF文档C# 将多张图片转换到一个PDF文档介绍将图片(JPG、PNG)转

活用c4d官方开发文档查询代码

当你问AI助手比如豆包,如何用python禁止掉xpresso标签时候,它会提示到 这时候要用到两个东西。https://developers.maxon.net/论坛搜索和开发文档 比如这里我就在官方找到正确的id描述 然后我就把参数标签换过来

计算机毕业设计 大学志愿填报系统 Java+SpringBoot+Vue 前后端分离 文档报告 代码讲解 安装调试

🍊作者:计算机编程-吉哥 🍊简介:专业从事JavaWeb程序开发,微信小程序开发,定制化项目、 源码、代码讲解、文档撰写、ppt制作。做自己喜欢的事,生活就是快乐的。 🍊心愿:点赞 👍 收藏 ⭐评论 📝 🍅 文末获取源码联系 👇🏻 精彩专栏推荐订阅 👇🏻 不然下次找不到哟~Java毕业设计项目~热门选题推荐《1000套》 目录 1.技术选型 2.开发工具 3.功能

论文翻译:arxiv-2024 Benchmark Data Contamination of Large Language Models: A Survey

Benchmark Data Contamination of Large Language Models: A Survey https://arxiv.org/abs/2406.04244 大规模语言模型的基准数据污染:一项综述 文章目录 大规模语言模型的基准数据污染:一项综述摘要1 引言 摘要 大规模语言模型(LLMs),如GPT-4、Claude-3和Gemini的快

论文翻译:ICLR-2024 PROVING TEST SET CONTAMINATION IN BLACK BOX LANGUAGE MODELS

PROVING TEST SET CONTAMINATION IN BLACK BOX LANGUAGE MODELS https://openreview.net/forum?id=KS8mIvetg2 验证测试集污染在黑盒语言模型中 文章目录 验证测试集污染在黑盒语言模型中摘要1 引言 摘要 大型语言模型是在大量互联网数据上训练的,这引发了人们的担忧和猜测,即它们可能已

Adblock Plus官方规则Easylist China说明与反馈贴(2015.12.15)

-------------------------------特别说明--------------------------------------- 视频广告问题:因Adblock Plus的局限,存在以下现象,优酷、搜狐、17173黑屏并倒数;乐视、爱奇艺播放广告。因为这些视频网站的Flash播放器被植入了检测代码,而Adblock Plus无法修改播放器。 如需同时使用ads