matlab.net.http.ProtocolVersion Class

Namespace: matlab.net.http

HTTP protocol version

Description

If you use 'HTTP/1.1', you do not need to create a protocol version. To use a different protocol, use the ProtocolVersion class to create the protocol version and add it to the request line of a request message.

The server returns a ProtocolVersion object in the status line of a response message.

Class Attributes

Sealed

true

For information on class attributes, see Class Attributes.

Creation

Description

obj = matlab.net.http.ProtocolVersion(name,major,minor) creates the protocol version with the specified properties. This constructor enforces proper syntax of the parameters. For test purposes, create a ProtocolVersion object in a request message. Then use the isequal method to compare this value with the value returned by the server in the response message.

obj = matlab.net.http.ProtocolVersion(str) creates the version from str.

Input Arguments

str — Protocol version

string | character vector

Protocol version, specified as a string or a character vector acceptable to the ProtocolVersion constructor. str should have the syntax of name plus major and minor version numbers, but no error occurs if it does not.

Properties

Name — Protocol name

HTTP (default) | string | character vector

Protocol name, specified as a string or character vector.

Example: 'HTTP'

Attributes:

GetAccess	public
SetAccess	public
Dependent	true

Major — Major version number

1 (default) | integer 0–9

Major version number, specified as an integer value from 0 through 9.

Example: 1

Attributes:

GetAccess	public
SetAccess	public
Dependent	true

Minor — Minor version number

1 (default) | integer 0–9

Minor version number, specified as an integer value from 0 through 9.

Example: 1

Attributes:

GetAccess	public
SetAccess	public
Dependent	true

Methods

Specialized Operators and Functions

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

eq, isequal	true if protocol versions are functionally equivalent. The comparison ignores the case of the Name property and uses numeric comparisons for the Major and Minor properties.
string	Protocol version as string
char	Protocol version as character vector

Examples

Display Protocol Version in Response Message

Send an HTTP request message to mathworks.com using default values. Display the protocol version in the response message.

request = matlab.net.http.RequestMessage;
uri = matlab.net.URI('https://www.mathworks.com');
response = send(request,uri);
version = string(response.StatusLine.ProtocolVersion)

version = 

    "HTTP/1.1"

Version History

Introduced in R2016b