HttpsConnection Clase

Paquete:

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

Artefacto Maven:

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

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

public class HttpsConnection

Contenedor para la clase HttpsURLConnectionJava SE . Se usa para evitar problemas de compatibilidad al probar con el marco de trabajo ficticio JMockit, así como para evitar algunos efectos secundarios no documentados al usar HttpsURLConnection.

Java administra de forma transparente el subyacente HttpsURLConnection . Para reutilizar las conexiones, para cada vez connect() que se llama, los flujos de entrada (flujo de entrada o flujo de error, si el flujo de entrada no es accesible) deben leerse por completo. De lo contrario, los datos permanecen en la secuencia y la conexión no será reutilizable.

Resumen del constructor

Modificador	Constructor	Description
protected	HttpsConnection()
	HttpsConnection(URL url, HttpsMethod method)	Constructor.
	HttpsConnection(URL url, HttpsMethod method, ProxySettings proxySettings)	Constructor.
	HttpsConnection(URL url, HttpsMethod method, ProxySettings proxySettings, boolean isHttps)	Constructor.

Resumen del método

Modificador y tipo	Método y descripción
void	connect() Envía la solicitud a la dirección URL especificada en el constructor.
java.util.Map<java.lang.String,java.util.List<java.lang.String>>	getResponseHeaders() Devuelve los encabezados de respuesta como , Mapdonde la clave es el nombre del campo de encabezado y los valores son los valores asociados al nombre del campo de encabezado.
int	getResponseStatus() Devuelve el código de estado de respuesta.
byte[]	readError() Lee del flujo de errores y devuelve el motivo del error.
byte[]	readInput() Lee del flujo de entrada (flujo de respuesta) y devuelve la respuesta.
void	setConnectTimeout(int timeout) Establece el tiempo de espera de conexión en milisegundos.
void	setReadTimeout(int timeout) Establece el tiempo de espera de lectura en milisegundos.
void	setRequestHeader(String field, String value) Establece el campo de encabezado de solicitud en el valor especificado.
void	setRequestMethod(HttpsMethod method) Establece el método de solicitud (es decir,
void	writeOutput(byte[] body) Guarda el cuerpo que se va a enviar con la solicitud.

Métodos heredados de 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

Detalles del constructor

HttpsConnection

protected HttpsConnection()

HttpsConnection

public HttpsConnection(URL url, HttpsMethod method)

Constructor. Abre una conexión a la dirección URL especificada. Puede ser HTTPS o HTTP.

Parameters:

url - la dirección URL de la conexión HTTP/HTTPS.

method - el método HTTP (es decir, GET).

Throws:

TransportException - si no se pudo abrir la conexión.

HttpsConnection

public HttpsConnection(URL url, HttpsMethod method, ProxySettings proxySettings)

Constructor. Abre una conexión a la dirección URL especificada. Puede ser HTTPS o HTTP.

Parameters:

url - la dirección URL de la conexión HTTP/HTTPS.

method - el método HTTP (es decir, GET).

proxySettings - Configuración de proxy que se va a usar al conectarse. Si es null, no se usará ningún proxy.

Throws:

TransportException - si no se pudo abrir la conexión.

HttpsConnection

public HttpsConnection(URL url, HttpsMethod method, ProxySettings proxySettings, boolean isHttps)

Constructor. Abre una conexión a la dirección URL especificada. Puede ser HTTPS o HTTP.

Parameters:

url - la dirección URL de la conexión HTTP/HTTPS.

method - el método HTTP (es decir, GET).

proxySettings - Configuración de proxy que se va a usar al conectarse. Si es null, no se usará ningún proxy.

isHttps - si es true, esta solicitud es una solicitud https en lugar de una solicitud HTTP.

Throws:

TransportException - si no se pudo abrir la conexión.

Detalles del método

connect

public void connect()

Envía la solicitud a la dirección URL especificada en el constructor.

Throws:

TransportException - si no se pudo establecer la conexión o el servidor respondió con un código de estado incorrecto.

getResponseHeaders

public Map> getResponseHeaders()

Devuelve los encabezados de respuesta como , Mapdonde la clave es el nombre del campo de encabezado y los valores son los valores asociados al nombre del campo de encabezado.

Returns:

los encabezados de respuesta.

getResponseStatus

public int getResponseStatus()

Devuelve el código de estado de respuesta.

Returns:

el código de estado de respuesta.

Throws:

TransportException - si no se recibió ninguna respuesta.

readError

public byte[] readError()

Lee del flujo de errores y devuelve el motivo del error.

Returns:

el motivo del error.

Throws:

TransportException - si no se pudo acceder al flujo de entrada, por ejemplo, si no se pudo acceder al servidor.

readInput

public byte[] readInput()

Lee del flujo de entrada (flujo de respuesta) y devuelve la respuesta.

Returns:

el cuerpo de la respuesta.

Throws:

TransportException - si no se pudo acceder al flujo de entrada, por ejemplo, si no se pudo acceder al servidor.

setConnectTimeout

public void setConnectTimeout(int timeout)

Establece el tiempo de espera de conexión en milisegundos.

Parameters:

timeout - tiempo de espera de conexión en milisegundos.

setReadTimeout

public void setReadTimeout(int timeout)

Establece el tiempo de espera de lectura en milisegundos. El tiempo de espera de lectura es el número de milisegundos después de que el servidor reciba una solicitud y antes de que el servidor devuelva los datos.

Parameters:

timeout - tiempo de espera de lectura.

setRequestHeader

public void setRequestHeader(String field, String value)

Establece el campo de encabezado de solicitud en el valor especificado.

Parameters:

field - el nombre del campo de encabezado.

value - el valor del campo de encabezado.

setRequestMethod

public void setRequestMethod(HttpsMethod method)

Establece el método de solicitud (es decir, POST).

Parameters:

method - el método de solicitud.

Throws:

TransportException - si la solicitud tiene actualmente un cuerpo no vacío y el nuevo método no es POST o PUT. Esto se debe a que Java HttpsURLConnection convierte silenciosamente el método HTTPS en POST o PUT si se escribe un cuerpo en la solicitud.

writeOutput

public void writeOutput(byte[] body)

Guarda el cuerpo que se va a enviar con la solicitud.

Parameters:

body - el cuerpo de la solicitud.

Throws:

TransportException - si la solicitud no usa actualmente el método POST o PUT y el cuerpo no está vacío. Esto se debe a que Java HttpsURLConnection convierte silenciosamente el método HTTPS en POST o PUT si se escribe un cuerpo en la solicitud.