主要内容

matlab.net.http.HTTPOptions类

包裹:matlab.net.http

选项控制HTTP消息交换

描述

使用httpoptions.类以创建HTTP请求消息的选项。使用此对象指定多个请求中常量的选项。

创建

描述

obj = matlab.net.http.HTTPOptions使用默认属性值创建HTTP选项。

例子

obj = matlab.net.http.HTTPOptions(名称、值)使用一个或多个名称值对参数指定的其他属性创建HTTP选项。姓名属性名称和价值是相应的价值。您可以以任何顺序指定多个名称值对参数Name1, Value1,…,的家.未指定属性设置为其默认值。

特性

展开全部

凭据是否用于身份验证,指定为真正的错误的

如果认证为,然后实现服务器或代理请求的受支持的身份验证方法。金宝app身份验证基于证书属性和在MATLAB中设置的代理用户名和密码®网络偏好,如果有的话。有关MATLAB身份验证支持的信息,请参阅金宝app服务器身份验证

当存在任何这些条件时,响应消息包含服务器或代理身份验证挑战。

  • 认证是假的。

  • 不合适证书找到此请求的属性。

  • 身份验证失败。

属性:

Getaccess.
公共
setaccess.
公共

数据类型:逻辑

文件名称为字符串标量或字符向量,表示包含根证书的文件的名称和位置。该文件必须是隐私增强邮件(PEM)格式。该位置必须位于当前文件夹中,在MATLAB路径上的文件夹中,或文件的完整或相对路径。此文件中包含的证书用于验证HTTPS连接的服务器证书。由于HTTPS连接的安全性取决于此文件的完整性,因此请妥善保护它。MATLAB不管理证书或证书文件,但有用于管理PEM文件的第三方工具。

默认情况下,未指定选项时,MATLAB使用系统提供的证书存储验证服务器证书。这也是行为证书文件名被设定为“默认”

如果证书文件名是空的 (''),则关闭服务器证书的验证。MATLAB只验证服务器证书的域名与服务器的域名是否匹配。

如果您遇到服务器证书验证失败使用“默认”,然后使用系统浏览器检查连接。

如果您遇到连接问题,请考虑以下问题:

  • 服务器证书过期或被吊销,请联系网站所有者或服务器管理员处理。

  • 对于缺少的root ca证书,您可以选择以下选项之一:

    • 将根CA证书添加到表示的文件中证书文件名

    • 通过设置禁用证书验证证书文件名清空 ('')。

  • 如果服务器证书的域名和服务器的域名不匹配,可以通过创建matlab.net.http.requestmessage.对象和设置matlab.net.http.httpoptions.verifyServername.财产错误的

笔记

这些选项是临时解决方案,MathWorks强烈建议您使用有效/正确的服务器证书来解决任何服务器证书验证失败的根本原因。

属性:

Getaccess.
公共
setaccess.
公共

数据类型:char|细绳

等待初始服务器连接的秒数,指定为整数。如果涉及代理,则超时适用于与代理的连接;否则它适用于与服务器的连接。

默认是10秒。如果超过了超时时间,则ConnectTimeout抛出错误。禁用超时,设置ConnectTimeoutINF.

ConnectTimeout确定在抛出错误之前需要等待多长时间才能使用服务器或代理完成连接尝试。此超时不限制接收完整响应所需的时间。

当通过代理向服务器发送请求时,考虑使用响应次数限制等待时间。

有些操作系统有系统强制的最大超时。即使值为,该超时也会生效ConnectTimeout大于最大值。例如,在Windows上®10,这个超时是21秒。

属性:

Getaccess.
公共
setaccess.
公共

如何处理从服务器收到的原始有效负载答复遗产,指定为真正的错误的

如果Chilltresponse.是真的,那么

  • 如果一个contentConsumer.指定,然后是uint8.有效负载被传递到contentConsumer.为了进一步处理。

  • 否则,MATLAB将转换有效载荷转换为MessageBody。有效载荷基于响应消息中的内容类型的MATLAB数据到MATLAB数据。看看数据属性用于转换规则。如果转换成功,则数据包含转换后的数据和有效载荷是空的。

如果Chilltresponse.是假的,那么任何指定contentConsumer.忽略,行为取决于内容类型是指定字符数据。

  • 如果Content-Type具有显式或默认的Charset属性,则将有效载荷转换为文本并存储在数据没有进一步的处理。

  • 如果内容类型未指定字符数据或没有charset,则MATLAB不支持内容类型,那么金宝app数据包含原始uint8.有效载荷。

在所有情况下,有效载荷属性将被删除,除非还设置savepayload.财产真正的

Chilltresponse.如果消息被编码(压缩),则忽略:

  • 解码失败

  • 解码响应财产是错误的

属性:

Getaccess.
公共
setaccess.
公共

数据类型:逻辑

在网络上的数据包之间等待秒数,指定为整数。默认值为INF.,意思是没有超时。这次超时,强制执行初始连接,对于与潜在慢速服务器的通信非常有用。如果在等待发送或接收下一个预期数据包时超出此超时,则MATLAB关闭连接并抛出错误。在这种情况下,使用matlab.net.http.HTTPException历史属性获取任何部分数据。

属性:

Getaccess.
公共
setaccess.
公共

是否解码压缩数据,指定为真正的错误的.解码装置解压缩(解码)当服务器返回压缩(编码)的数据时的响应有效载荷。在基于内容类型字段转换之前发生解码。

当存在指定压缩算法的Content-Encoding字段时,将对响应进行编码。MATLAB支金宝app持内容编码值gzipX-GZIP,缩小.价值身份意味着没有编码,这相当于消息没有Content-Encoding字段。如果MATLAB不支持内容编码类型,解金宝app码不会发生即使解码响应是真的。

如果解码响应是假的,并且有效载荷被编码,然后:

  • MessageBody。有效载荷属性包含原始未偏向的有效载荷。

  • MessageBody.Data.房地产仍然是空的。

  • 无论设置如何,都不发生转换Chilltresponse.财产。

如果您使用的是,请勿将此值设置为FALSE以进行压缩响应contentConsumer.除非您还设置,否则无法处理压缩数据Chilltresponse.抑制消费者的使用。FileConsumerBinaryConsumer是MATLAB提供的唯一消费者,可以处理压缩数据。

属性:

Getaccess.
公共
setaccess.
公共

数据类型:逻辑

身份验证凭据,指定为一个或多个matlab.net.http.Credentials对象。默认值是默认值matlab.net.http.Credentials对象。使用默认的证书对象,以允许对Windows上的Kerberos和NTLM等方案进行身份验证。这些方案不需要指定用户名或密码。

证书仅在认证财产是真的。您必须至少指定一个证书进行身份验证的对象。如果你设置了证书为空,则不进行身份验证。

当您在会话期间多次访问同一服务器时,为了最大性能,请指定相同的参数证书向量或相同httpoptions.对象。证书包含加速后续身份验证的缓存信息。

如果你提供证书与代理一起使用,你想要那些证书覆盖在中指定的不同的用户名和密码网络偏好在“首选项”窗口中,然后指定代理的主机和端口Proxyuri.本财产的财产httpoptions.对象或清除使用具有身份验证的代理选项在“首选项”窗口中。

属性:

Getaccess.
公共
setaccess.
公共

在初始连接后打开服务器连接的秒数,指定为0.INF..使用此属性可在相同的连接上启用要发送的多个连续消息。一个INF.Value(默认值)启用持久连接,只要服务器能够保持连接即可打开。价值0.在每个消息之后关闭连接。不支持其他值。金宝app

属性对操作的成功没有影响。MATLAB总是保持连接打开足够长的时间,以从服务器获得预期的响应,除非超过其他超时。然而,一个0.值可以严重影响向同一服务器发送许多短消息的性能。

属性:

Getaccess.
公共
setaccess.
公共

允许的重定向数,为给定请求指定为整数。默认的重定向数是20。设置为0以禁用重定向。设置为INF.允许无限制重定向。

如果MaxRedirects非零,然后在每个重定向响应中从服务器接收的cookie复制到重定向的消息中。后MaxRedirects时,响应消息包含下一个重定向消息。

属性:

Getaccess.
公共
setaccess.
公共

进度监视器处理程序,指定为函数句柄matlab.net.http.progressmonitor.对象。如果umermerprogressmonitor.是真的,那么matlab叫这个进步监测函数报告转移进度。如果umermerprogressmonitor.是假的ProgressMonitorfcn.为空,则不报告任何进度。

属性:

Getaccess.
公共
setaccess.
公共

数据类型:function_handle.

代理服务器地址,指定为amatlab.net.uri.对象或窗体的字符串主持人:港口//主机:端口

Proxyuri.仅当使用代理服务器财产是真的。Proxyuri.覆盖MATLAB Web首选项中指定的代理以及Windows系统设置中的任何代理。

属性:

Getaccess.
公共
setaccess.
公共

发送请求的最后一个数据包后,等待从服务器接收初始响应(报头)的秒数,指定为整数。默认值为INF.,意思是没有超时。如果超出此超时,则MATLAB关闭连接并抛出错误。

使用响应次数以通过代理向服务器向服务器发送请求时限制等待时间ConnectTimeout仅适用于代理连接时间。

响应次数相当于超时物业设定weboptions

属性:

Getaccess.
公共
setaccess.
公共

是否保存Payload,指定为真正的错误的.有效负载是从服务器接收或发送到服务器的原始字节,保存在MessageBody。有效载荷财产。

在请求消息中,设置savepayload.真正的数据转换后保存有效载荷。在响应消息中,在转换之前保存字节。

使用savepayload.作为调试工具。例如,服务器无法处理请求的主体,或者存在将响应主体转换为MATLAB类型的故障。环境savepayload.真正的可能会消耗相当量的内存,因为有效负载至少等于转换数据的大小。

要检索响应有效载荷而无需转换,请设置Chilltresponse.财产错误的和阅读MessageBody.Data.反而。

如果一个httpException.在消息处理期间发生,然后收到到故障点的有效载荷正在进行中HTTPException.History .Response.Body.Payload(结束)

如果RequestMessage。身体是A.内容提供商对象,然后matlab保存提供程序的转换数据Body.Payload.

属性:

Getaccess.
公共
setaccess.
公共

数据类型:逻辑

是否显示进度,指定为真正的错误的.集umermerprogressmonitor.真正的使用指定的功能报告转移的进度ProgressMonitorfcn.财产。

属性:

Getaccess.
公共
setaccess.
公共

数据类型:逻辑

是否使用代理,指定为真正的错误的

如果使用代理服务器为真,然后MATLAB选择这些代理中的第一个。

  • 价值Proxyuri.财产,如果任何。

  • 如果有的话,Matlab Web首选项中指定的代理。

  • 您的系统首选项中指定的代理(仅限Windows)。

当下列任何一项为真时,所有请求将直接转到目标URI,而不需要代理。

  • 使用代理服务器是假的。

  • 使用代理服务器是真实的,但Proxyuri.是空的,偏好中没有代理设置。

MATLAB自动将消息转移到代理时使用代理服务器是真的。

属性:

Getaccess.
公共
setaccess.
公共

数据类型:逻辑

服务器名称是否与指定的证书匹配真正的错误的

使用安全连接https.协议,MATLAB验证证书中的服务器名称是否与宿主属性,或最新重定向请求的URI中。此验证确保您正在与预期的服务器通信。若要在服务器证书与用于访问它的URI不匹配的情况下禁用验证,请将此属性设置为false。例如,您希望使用IP地址或“localhost”访问服务器,并且您确信可以直接与预期的服务器通信。

属性:

Getaccess.
公共
setaccess.
公共

数据类型:逻辑

例子

全部收缩

将连接时间提高到20秒。

更改变量中指定的请求消息的默认超时选项要求发送到变量中指定的服务器url

选项= matlab.net.http.http.httpoptions(“ConnectTimeout”20);response = request.send(URL,选项);
介绍在R2016B.