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 个部分，分别用来指定 Method、RequestTarget 和 ProtocolVersion 属性，各部分之间以空白分隔。

属性

全部展开

请求方法，指定为 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 值必须与您在请求消息 send 或 complete 方法中指定的 URI 一致。

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

当使用代理时，RequestTarget 是具有 Scheme 和 Authority 属性的完整 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 中推出

另请参阅

| | |