matlab.net.http.LogRecord - HTTP history log record - MATLAB (original) (raw)

Namespace: matlab.net.http

Description

A vector of LogRecord objects represents a history of request-response message pairs exchanged between client and server during an HTTP operation, such asRequestMessage.send. The send method returns history as an output argument. When an error occurs, the HTTPException object contains aHistory property.

Use the LogRecord class for debugging.

Properties

expand all

URI of the request, specified as a matlab.net.URI object.

Attributes:

Request message, specified as a matlab.net.http.RequestMessage object. Request contains a value if MATLAB® attempted to send the header of the request message, even if an exception occurs in the process of sending the payload. If an exception occurs, then theException property contains the MException.

The Request.Body property contains the body of the request message, if any. The Request.Body.Payload property is set only if you specify the SavePayload property in an HTTPOptions object.

Attributes:

Start and end times of a request message, specified as a pair ofdatetime objects. RequestTime contains a value only if the Request property is set.

The RequestTime values are an approximation of the times when the first and last bytes, including the payload, of a request message were sent. If an exception occurs during transmission, then the end time is the time of the exception, and the Exception property contains theMException.

Attributes:

Data Types: datetime

Response message, specified as a matlab.net.http.ResponseMessage object. Response contains a value only if the complete header of the response is received successfully, even if an exception occurs receiving the payload. If an exception occurs while trying to send the request or during receipt of the header, then Response might be empty. If an exception occurs, then the Exception property contains the MException object.

The Response.Body property is set if you specify theSavePayload property in an HTTPOptions object and the response has a body. If Response.Body is set, then theResponse.Body.Payload property is also set.

Attributes:

Start and end times of the response message, specified as a pair ofdatetime objects. ResponseTime contains a value only if the Response property is set.

The ResponseTime values are an approximation of the times when the first and last bytes of the response message are received. If an exception occurs during receipt, then the end time is the time of the exception, and theException property contains the MException object.

Attributes:

Data Types: datetime

Disposition of the exchange, specified as a matlab.net.http.Disposition enumeration, indicating the result of the exchange. If the Disposition value is Done, then the Exception property is empty and all fields of theLogRecord contain their final values.

Some values of Disposition imply that an exception was saved in the Exception property. If an exception occurs, theResponse or Request properties might not be set. When these values are set depends on whether the exception occurs before or during the transmission of the headers or the payload.

Attributes:

Exception, specified as an MException object that occurred during processing of the exchange. If an error occurred during the transmission, receipt, or processing of the response, this property is the MException containing the exception. The value of the Disposition property determines whether this property is set.

Attributes:

Methods

expand all

Version History

Introduced in R2016b