HttpsRequest 类

包:

com.microsoft.azure.sdk.iot.device.transport.https

Maven 项目:

com.microsoft.azure.sdk.iot:iot-device-client-preview:1.2.0

• java.lang.Object
• • com.microsoft.azure.sdk.iot.device.transport.https.HttpsRequest

public class HttpsRequest

HTTPS 请求。

构造函数摘要

修饰符	构造函数	说明
protected	HttpsRequest()
	HttpsRequest(URL url, HttpsMethod method, byte[] body, String userAgentString)	构造函数。
	HttpsRequest(URL url, HttpsMethod method, byte[] body, String userAgentString, ProxySettings proxySettings)	构造函数。

方法摘要

修饰符和类型	方法和描述
byte[]	getBody()
java.lang.String	getHttpMethod()
java.lang.String	getRequestHeaders()
java.net.URL	getRequestUrl()
HttpsResponse	send() 执行 HTTPS 请求。
HttpsResponse	sendAsHttpRequest() 以 HTTP 请求的形式执行 HTTPS 请求。
HttpsRequest	setConnectTimeout(int timeout) 设置请求的连接超时（以毫秒为单位）。
HttpsRequest	setHeaderField(String field, String value) 将标头字段设置为给定值。
HttpsRequest	setReadTimeout(int timeout) 设置请求的读取超时（以毫秒为单位）。
HttpsRequest	setSSLContext(SSLContext sslContext) 设置此对象的 SSL 上下文

方法继承自 java.lang.Object

java.lang.Object.clone java.lang.Object.equals java.lang.Object.finalize java.lang.Object.getClass java.lang.Object.hashCode java.lang.Object.notify java.lang.Object.notifyAll java.lang.Object.toString java.lang.Object.wait java.lang.Object.wait java.lang.Object.wait

构造函数详细信息

HttpsRequest

protected HttpsRequest()

HttpsRequest

public HttpsRequest(URL url, HttpsMethod method, byte[] body, String userAgentString)

构造函数。 采用 URL 作为参数，并返回已准备好发送的 HTTPS 请求。

Parameters:

url - 请求的 URL。

method - HTTPS 请求方法 (即 GET) 。

body - 请求正文。 如果请求方法是 GET 或 DELETE，则必须是大小为 0 的数组。

userAgentString - 要附加到所有 http 通信的用户代理字符串

HttpsRequest

public HttpsRequest(URL url, HttpsMethod method, byte[] body, String userAgentString, ProxySettings proxySettings)

构造函数。 采用 URL 作为参数，并返回已准备好发送的 HTTPS 请求。

Parameters:

url - 请求的 URL。

method - HTTPS 请求方法 (即 GET) 。

body - 请求正文。 如果请求方法是 GET 或 DELETE，则必须是大小为 0 的数组。

userAgentString - 要附加到所有 http 通信的用户代理字符串

proxySettings - 连接时要使用的代理设置。 如果为 null，则不会使用代理

方法详细信息

getBody

public byte[] getBody()

getHttpMethod

public String getHttpMethod()

getRequestHeaders

public String getRequestHeaders()

getRequestUrl

public URL getRequestUrl()

send

public HttpsResponse send()

执行 HTTPS 请求。

Returns:

HTTPS 响应。

Throws:

TransportException - 如果无法建立连接，或者无法访问输入/输出流，则为 。

sendAsHttpRequest

public HttpsResponse sendAsHttpRequest()

以 HTTP 请求的形式执行 HTTPS 请求。 仅当用户提供的 URL 包含 HTTP 而不是 HTTPS 时，才应调用此方法。 目前，这仅发生在 HttpsHsmClient 某些边缘工作负载 URL 的 中。

Returns:

HTTPS 响应。

Throws:

TransportException - 如果无法建立连接，或者无法访问输入/输出流，则为 。

setConnectTimeout

public HttpsRequest setConnectTimeout(int timeout)

设置请求的连接超时（以毫秒为单位）。

Parameters:

timeout - 连接超时（以毫秒为单位）。

Returns:

本身，用于流畅设置。

setHeaderField

public HttpsRequest setHeaderField(String field, String value)

将标头字段设置为给定值。

Parameters:

field - 标头字段名称。

value - 标头字段值。

Returns:

本身，用于流畅设置。

setReadTimeout

public HttpsRequest setReadTimeout(int timeout)

设置请求的读取超时（以毫秒为单位）。 读取超时是服务器收到请求后以及服务器发送回数据之前的毫秒数。

Parameters:

timeout - 读取超时。

Returns:

本身，用于流畅设置。

setSSLContext

public HttpsRequest setSSLContext(SSLContext sslContext)

设置此对象的 SSL 上下文

Parameters:

sslContext - 用于设置此对象的 SSL 上下文的值

Returns:

本身，用于流畅设置。

Throws:

java.lang.IllegalArgumentException - 如果 sslContext 为 null，则为