包:matlab.net.http
控制HTTP消息交换的选项
使用HTTPOptions
类创建HTTP请求消息的选项。使用此对象可指定跨多个请求的常量选项。
obj = matlab.net.http.HTTPOptions
创建带有默认属性值的HTTP选项。
obj = matlab.net.http.HTTPOptions(名称、值)
创建带有由一个或多个名称-值对参数指定的附加属性的HTTP选项。的名字
属性名和价值
为对应值。可以以任意顺序指定多个名称-值对参数Name1, Value1,…,的家
.未指定的属性被设置为默认值。
CertificateFilename
- - - - - -文件名称“默认”
(默认)|字符串|特征向量文件名,指定为字符串标量或字符向量,表示包含根证书的文件的名称和位置。文件必须是PEM (privacy-enhanced mail)格式。位置必须在当前文件夹中,在MATLAB路径中的一个文件夹中,或一个文件的完整或相对路径中。此文件中包含的证书用于验证HTTPS连接的服务器证书。由于HTTPS连接的安全性依赖于此文件的完整性,请适当保护它。MATLAB不管理证书或证书文件,但有第三方工具可用于管理PEM文件。
默认情况下,当未指定选项时,MATLAB使用系统提供的证书存储来验证服务器证书。这也是if的行为CertificateFilename
被设置为“默认”
.
如果CertificateFilename
是空的(''
),则关闭服务器证书的验证。MATLAB只验证服务器证书的域名与服务器的域名是否匹配。
如果使用时遇到服务器证书验证失败“默认”
,然后使用系统浏览器检查连接。
如果您遇到连接问题,请考虑以下问题:
服务器证书过期或被吊销,请联系网站所有者或服务器管理员处理。
对于缺失的根CA证书,您可以选择以下选项之一:
将根CA证书添加到表示的文件中CertificateFilename
.
通过设置禁用证书验证CertificateFilename
空(''
).
如果服务器证书的域名和服务器的域名不匹配,可以通过创建matlab.net.http.RequestMessage
对象,并设置matlab.net.http.HTTPOptions.VerifyServerName
财产假
.
请注意
这些选项是临时解决方案,MathWorks强烈建议您使用有效/正确的服务器证书来解决任何服务器证书验证失败的根本原因。
GetAccess |
公共
|
SetAccess |
公共
|
数据类型:字符
|字符串
ConnectTimeout
- - - - - -等待初始服务器连接的时间为几秒正
等待初始服务器连接的秒数,指定为整数。如果涉及代理,则超时应用于到代理的连接;否则,它将应用于到服务器的连接。
默认是10秒。如果超过了超时时间,则ConnectTimeout
抛出一个错误。要禁用超时,请设置ConnectTimeout
来正
.
ConnectTimeout
确定在抛出错误之前需要等待多长时间才能使用服务器或代理完成连接尝试。此超时不限制接收完整响应所需的时间。
当通过代理向服务器发送请求时,考虑使用ResponseTimeout以限制等待时间。
有些操作系统有系统强制的最大超时。即使值为,该超时也会生效ConnectTimeout
大于最大值。例如,在Windows上®10,这个超时是21秒。
GetAccess |
公共
|
SetAccess |
公共
|
ConvertResponse
- - - - - -如何处理来自服务器的原始有效负载真正的
(默认)|假
如何处理从服务器收到的原始有效负载ResponseMessage
,指定为真正的
或假
.
如果ConvertResponse
是真的,那么
如果一个ContentConsumer
,则uint8
有效负载被传递到ContentConsumer
进行进一步处理。
否则,MATLAB转换有效载荷在MessageBody。有效载荷
属性根据响应消息中的Content-Type设置为MATLAB数据。看到数据属性用于转换规则。如果转换成功,则数据
包含转换后的数据和有效载荷
是空的。
如果ConvertResponse
为false,则任意指定ContentConsumer
,行为取决于Content-Type是否指定字符数据。
如果Content-Type具有显式的或默认的字符集属性,则将有效负载转换为文本并存储在其中数据
没有进一步的处理。
如果Content-Type没有指定字符数据或没有字符集,并且MATLAB不支持Content-Type,则万博1manbetx数据
包含原始uint8
有效载荷。
在所有情况下有效载荷
属性将被删除,除非还设置SavePayload
财产真正的
.
ConvertResponse
如果消息被编码(压缩),则忽略:
解码失败
DecodeResponse
财产是错误的
GetAccess |
公共
|
SetAccess |
公共
|
数据类型:逻辑
DataTimeout
- - - - - -数据包之间等待的时间正
(默认)|整数网络上数据包之间等待的秒数,指定为整数。默认值为正
,意思是没有超时。一旦建立了初始连接,就强制执行此超时,这对于与可能较慢的服务器进行通信很有用。如果在等待发送或接收下一个期望的包时超过了这个超时,那么MATLAB关闭连接并抛出一个错误。在本例中,使用thematlab.net.http.HTTPException
历史
属性获取任何部分数据。
GetAccess |
公共
|
SetAccess |
公共
|
DecodeResponse
- - - - - -是否解码压缩数据真正的
(默认)|假
是否解码压缩数据,指定为真正的
或假
.解码是指在服务器返回压缩(编码)数据时解压缩(解码)响应负载。解码发生在基于Content-Type字段的转换之前。
当存在指定压缩算法的Content-Encoding字段时,将对响应进行编码。MATLAB支万博1manbetx持内容编码值gzip
,x-gzip
,缩小
.的值身份
意味着没有编码,这相当于消息没有Content-Encoding字段。如果MATLAB不支持内容编码类型,解万博1manbetx码不会发生即使DecodeResponse
是真的。
如果DecodeResponse
为false并对有效负载进行编码,则:
的MessageBody。有效载荷
属性包含未编码的原始有效负载。
的MessageBody。数据
房地产仍然是空的。
属性的设置如何,都不会发生转换ConvertResponse
财产。
如果您正在使用ContentConsumer
无法处理压缩数据,除非您还设置ConvertResponse
以虚假压制消费者使用。FileConsumer
和BinaryConsumer
是MATLAB提供的唯一能够处理压缩数据的消费者。
GetAccess |
公共
|
SetAccess |
公共
|
数据类型:逻辑
凭证
- - - - - -身份验证凭证matlab.net.http.Credentials
(默认)|向量的matlab.net.http.Credentials
对象|空身份验证凭据,指定为一个或多个matlab.net.http.Credentials
对象。默认值为defaultmatlab.net.http.Credentials
对象。使用默认的凭证
对象,以允许对Windows上的Kerberos和NTLM等方案进行身份验证。这些方案不需要指定用户名或密码。
凭证
仅当进行身份验证
房地产是正确的。您必须至少指定一个凭证
对象,以便进行身份验证。如果你设置凭证
为空,则不进行身份验证。
当您在会话期间多次访问同一服务器时,为了最大性能,请指定相同的参数凭证
向量或同一HTTPOptions
对象。凭证
包含加速后续身份验证的缓存信息。
如果您提供凭证
与代理一起使用,你想要这些凭证
中指定的不同用户名和密码Web的偏好,然后在。窗口中指定代理的主机和端口ProxyURI
财产的HTTPOptions
对象或清除使用带有身份验证的代理选项。
GetAccess |
公共
|
SetAccess |
公共
|
在
- - - - - -保持服务器连接打开的秒数正
(默认)|0
初始连接(指定为)后保持服务器连接打开的时间为几秒0
或正
.使用此属性可允许在同一连接上连续发送多个消息。一个正
值(默认值)启用持久连接,只要服务器可用,就保持连接打开。的值0
在每个消息之后关闭连接。不支持其他值。万博1manbetx
的在
属性对操作的成功没有影响。MATLAB总是保持连接打开足够长的时间,以从服务器获得预期的响应,除非超过其他超时。然而,一个0
值会严重影响向同一服务器发送许多短消息的性能。
GetAccess |
公共
|
SetAccess |
公共
|
MaxRedirects
- - - - - -允许重定向的数量正
允许的重定向数,为给定请求指定为整数。默认的重定向数是20。设置为0以禁用重定向。设置为正
允许无限重定向。
如果MaxRedirects
,则将每个重定向响应中从服务器接收的cookie复制到重定向消息中。后MaxRedirects
时,响应消息包含下一个重定向消息。
GetAccess |
公共
|
SetAccess |
公共
|
ProgressMonitorFcn
- - - - - -进度监控处理程序程序的进程监视器处理程序,指定为程序的函数句柄matlab.net.http.ProgressMonitor
对象。如果UseProgressMonitor
为真,那么MATLAB调用ProgressMonitor
函数,用于报告转移的进度。如果UseProgressMonitor
是假的或ProgressMonitorFcn
为空,则不报告任何进度。
GetAccess |
公共
|
SetAccess |
公共
|
数据类型:function_handle
ProxyURI
- - - - - -代理服务器地址matlab.net.URI
|字符串代理服务器地址,指定为matlab.net.URI
对象或窗体的字符串主持人:港口
或/ /主机:端口
.
ProxyURI
仅当UseProxy
房地产是正确的。ProxyURI
重写MATLAB Web Preferences中指定的代理和Windows系统设置中的任何代理设置。
GetAccess |
公共
|
SetAccess |
公共
|
ResponseTimeout
- - - - - -等待接收初始响应的秒数正
(默认)|整数发送请求的最后一个数据包后,等待从服务器接收初始响应(报头)的秒数,指定为整数。默认值为正
,意思是没有超时。如果超过了这个超时,MATLAB将关闭连接并抛出一个错误。
使用ResponseTimeout
为了限制通过代理向服务器发送请求时的等待时间,因为ConnectTimeout
仅适用于代理连接时间。
ResponseTimeout
等于超时
属性集的weboptions
.
GetAccess |
公共
|
SetAccess |
公共
|
SavePayload
- - - - - -有效载荷是否保存假
(默认)|真正的
是否保存Payload,指定为真正的
或假
.有效负载是从服务器接收或发送到服务器的原始字节,保存在MessageBody。有效载荷
财产。
在请求消息中,设置SavePayload
来真正的
保存数据转换后的有效负载。在响应消息中,字节在转换之前被保存。
使用SavePayload
作为调试工具。例如,服务器不能处理请求体,或者在将响应体转换为MATLAB类型时出现故障。设置SavePayload
来真正的
可能会消耗相当多的内存,因为有效负载至少等于转换数据的大小。
若要检索不进行转换的响应负载,请设置ConvertResponse
财产假
和阅读MessageBody。数据
代替。
如果一个textbox
在消息处理期间发生,然后在故障点之前接收到的有效负载HTTPException.History .Response.Body.Payload(结束)
.
如果RequestMessage。身体
是一个内容提供者
对象,然后MATLAB保存提供者的转换数据的身体。有效载荷
.
GetAccess |
公共
|
SetAccess |
公共
|
数据类型:逻辑
UseProgressMonitor
- - - - - -是否显示进度假
(默认)|真正的
是否显示进度,指定为真正的
或假
.集UseProgressMonitor
来真正的
使用指定的函数来报告传输的进度ProgressMonitorFcn
财产。
GetAccess |
公共
|
SetAccess |
公共
|
数据类型:逻辑
UseProxy
- - - - - -是否使用代理真正的
(默认)|假
是否使用指定为的代理真正的
或假
.
如果UseProxy
为真,然后MATLAB选择这些代理中的第一个。
的值ProxyURI
财产,如果任何。
在MATLAB Web Preferences中指定的代理(如果有的话)。
在您的系统首选项中指定的代理(仅限Windows)。
当下列任何一项为真时,所有请求将直接转到目标URI,而不需要代理。
UseProxy
是假的。
UseProxy
是真实的,但ProxyURI
为空,并且在首选项中没有设置代理。
MATLAB自动转换消息到代理时UseProxy
是真的。
GetAccess |
公共
|
SetAccess |
公共
|
数据类型:逻辑
VerifyServerName
- - - - - -服务器名称是否与证书匹配真正的
(默认)|假
服务器名称是否与指定的证书匹配真正的
或假
.
在安全连接中使用https
协议,MATLAB验证证书中的服务器名称是否与宿主
属性,或最新重定向请求的URI中。此验证确保您正在与预期的服务器通信。若要在服务器证书与用于访问它的URI不匹配的情况下禁用验证,请将此属性设置为false。例如,您希望使用IP地址或“localhost”访问服务器,并且您确信可以直接与预期的服务器通信。
GetAccess |
公共
|
SetAccess |
公共
|
数据类型:逻辑
将连接时间增加到20秒。
更改变量中指定的请求消息的默认超时选项请求
发送到变量中指定的服务器url
.
选择= matlab.net.http.HTTPOptions (“ConnectTimeout”, 20);响应= request.send (url选项);
你点击一个链接对应于这个MATLAB命令:
通过在MATLAB命令窗口中输入命令来运行命令。Web浏览器不支持MATLAB命令。万博1manbetx
你也可以从以下列表中选择一个网站:
选择中国网站(中文或英文)以获得最佳网站性能。其他MathWorks国家站点没有针对您所在位置的访问进行优化。