matlab.net.http.ResponseMessage - HTTP response message - MATLAB (original) (raw)

Namespace: matlab.net.http
Superclasses: matlab.net.http.Message

Description

The ResponseMessage class formats HTTP response messages returned by a server.

Creation

The RequestMessage.send method creates a response message.

Properties

expand all

Status line from server, specified as a matlab.net.http.StatusLine object.

Attributes:

GetAccess	public
SetAccess	public
Dependent	true

HTTP status code, specified as a matlab.net.http.StatusCode object. Same as theStatusLine.StatusCode property.

Attributes:

GetAccess	public
SetAccess	immutable
Dependent	true

Message header, specified as a matlab.net.http.HeaderField object or a vector of HeaderField objects. When you set theHeader property, MATLAB® checks the fields of the header to ensure that they are appropriate for the message type. The RequestMessage send and complete methods fill in any required header fields for a properly formed request.

Attributes:

GetAccess	public
SetAccess	public

Message body, specified as a matlab.net.http.MessageBody object,matlab.net.http.io.ContentProvider, or data acceptable to theMessageBody constructor. By default, Body is empty (set to []). A request message containing aBody property must use a method such as'PUT' or 'POST', not the default value'GET'.

In a completed or received message, if the message has a ContentTypeField header field, then the MessageBody.ContentType property is set to that value. Otherwise, ContentType is unchanged or empty.

Attributes:

GetAccess	public
SetAccess	public

Whether message is completed, specified as true orfalse. A true value means that the message was completed. Methods that return messages set the Completed property to true when:

The Body or Body.Data properties are empty.
The Body.Payload property contains the raw data.

Attributes:

GetAccess	public
SetAccess	public
Transient	true

Data Types: logical

Methods

expand all

complete	Process or reprocess response payload Content-Type
addFields	Add fields to message header
changeFields	Change existing fields in message header
getFields	Return message header fields matching name or class
removeFields	Remove fields from message header
replaceFields	Change values in or add fields to message header
show	Display or return formatted version of message

These methods specialize standard MATLAB operators and functions for objects in this class.

string	Message Header, Body andStartLine properties, as string. For multiple messages, returns a string array.If Body contains binary data that cannot be converted to characters, then the method displays a message indicating the length of the data in bytes.The string is an approximate representation of what the message looks like when sent or received.Use for logging, diagnostics, or debugging.For a formatted version of messages, use show.
char	Same as string, except returns message as character vector.
isequal	Returns true if the visible public properties of all messages in the two message arrays are equal.

string

Message Header, Body andStartLine properties, as string. For multiple messages, returns a string array.If Body contains binary data that cannot be converted to characters, then the method displays a message indicating the length of the data in bytes.The string is an approximate representation of what the message looks like when sent or received.Use for logging, diagnostics, or debugging.For a formatted version of messages, use show.

char

Same as string, except returns message as character vector.

isequal

Returns true if the visible public properties of all messages in the two message arrays are equal.

Examples

collapse all

Send a message to the Hubble Heritage website requesting an image of Jupiter.

Format an HTTP request message and display the Content-Type of the response message body. The server returns a JPEG image.

request = matlab.net.http.RequestMessage; uri = matlab.net.URI('http://heritage.stsci.edu/2007/14/images/p0714aa.jpg'); r = send(request,uri); r.Body.ContentType

ans =

MediaType with properties:

      Type: "image"
   Subtype: "jpeg"
Parameters: []
 MediaInfo: "image/jpeg"
    Weight: []

Display the image using the imshow function. MATLAB resizes the image to fit on the screen.

warning('off','Images:initSize:adjustingMag'); imshow(r.Body.Data)

Version History

Introduced in R2016b