Main Content

matlab.net.http.RequestLine 类

命名空间: matlab.net.http
超类: matlab.net.http.StartLine

HTTP 请求消息的第一行

描述

RequestLine 类代表请求消息的第一行。当您发送或完成一条消息时,会自动创建请求行。您也可以创建一个请求行并将其传递给 RequestMessage.send 方法,以代替 URI 参数。

类属性

Sealed
true

有关类属性的信息,请参阅类属性

创建对象

描述

示例

obj = matlab.net.http.RequestLine(method,requestTarget,protocolVersion) 创建具有指定属性的请求行。您可以省略尾部参数,并使用 [] 指定任何占位符。

obj = matlab.net.http.RequestLine(str) 通过解析 str 来创建请求行。

输入参数

全部展开

请求行,指定为字符串或字符向量。str 包括 1 到 3 个部分,分别用来指定 MethodRequestTargetProtocolVersion 属性,各部分之间以空白分隔。

属性

全部展开

请求方法,指定为 matlab.net.http.RequestMethod 枚举或者代表请求方法的字符串或字符向量。要发送消息,请设置 RequestMessage.Method 属性或 RequestLine.Method 属性。

示例: 'GET'

属性:

GetAccess
public
SetAccess
public
Dependent
true

协议版本,指定为 matlab.net.http.ProtocolVersion 对象或者可被构造函数接受的字符串。

示例: 'HTTP/1.1'

属性:

GetAccess
public
SetAccess
public
Dependent
true

目标 URI,指定为 matlab.net.URI 对象或者可被构造函数接受的字符串或字符向量。RequestTarget 值必须与您在请求消息 sendcomplete 方法中指定的 URI 一致。

RequestTarget 至少会为 Path 属性包含一个前导正斜杠 (/),即使路径是相对路径或为空也是如此。

当使用代理时,RequestTarget 是具有 SchemeAuthority 属性的完整 URI。当不使用代理时,RequestTarget 必须是具有可选 Query 属性的绝对路径。您可以在 HTTPOptions 对象中指定代理。

示例: 'http://heritage.stsci.edu/2007/14/images/p0714aa.jpg'

属性:

GetAccess
public
SetAccess
public
Dependent
true

方法

全部展开

示例

全部折叠

创建向 Hubble Heritage Project 网站索取图像的 HTTP 请求行。

import matlab.net.http.RequestLine
url = 'http://heritage.stsci.edu/2007/14/images/p0714aa.jpg';
reqline = RequestLine('get',url,'HTTP/1.1');
string(reqline)
ans = 
"GET http://heritage.stsci.edu/2007/14/images/p0714aa.jpg HTTP/1.1"

版本历史记录

在 R2016b 中推出