matlab.net.QueryParameter class

Пакет: matlab.net

Параметр в части запроса унифицированного идентификатора ресурса (URI)

Описание

Используйте QueryParameter класс для создания строки запроса URI формы:

name1=value1&name2=value2&name3=value3

где каждый name=value сегмент является QueryParameter объект, преобразованный в строку с помощью string способ. The string метод на векторе QueryParameter объекты присоединяются к результатам с помощью & символ. The string метод преобразует любые значения в строки и выполняет всю необходимую кодировку специальных символов в результате.

Атрибуты класса

Sealed
true

Для получения информации об атрибутах класса см. раздел «Атрибуты класса».

Создание

Описание

obj = matlab.net.QueryParameter создает пустой параметр запроса.

obj = matlab.net.QueryParameter(paramName,paramValue) создает вектор параметра запроса paramName, paramValue аргументы в виде пар. Можно задать несколько пар аргументов в любом порядке как paramName1,paramValue1,...,paramNameN,paramValueN.

пример

obj = matlab.net.QueryParameter(qStruct) создает вектор параметра запроса из структуры.

пример

obj = matlab.net.QueryParameter(queryStr) анализирует queryStr в запрос.

obj = matlab.net.QueryParameter(___,Format) задает формат, который будет использоваться для нескалярных значений, и может включать любой из входных параметров в предыдущих синтаксисах.

Входные параметры

расширить все

Имя параметра, заданное как строка или вектор символов.

Значение параметров, заданное как тип, требуемый paramName.

Названия и значения параметра, заданные как структура. Поля qStruct задайте названия и значения параметра.

Типы данных: struct

Названия и значения параметра, заданные как строка или вектор символов. The queryStr является завершенным, закодированным запросом, как это было бы в URI, с необязательным начальным ? символ.

queryStr разделяется на & символы в отдельные name=value параметры запроса. The Name для свойства задано значение name и Value для свойства задано значение value.

Триплет символов формы % и две шестнадцатеричные цифры представляют байт с процентным кодированием. Последовательность этих байтов обрабатывается как UTF-8 закодированные символы, которые декодируются, чтобы сформировать Name и Value свойства QueryParameters. Кроме того, любой знак плюс '+' в queryStr рассматривается как пространство '%20'. Когда QueryParameter преобразуется назад в строку, любая необходимая процентная кодировка выполняется только для символов, которые должны быть закодированы. Это действие выполняется независимо от того, были ли эти символы первоначально закодированы в queryStr, поэтому результат от string метод может точно не совпадать с queryStr. Значение, однако, то же самое при использовании в URI.

Для примера - UTF-8 кодировка знака евро является E2 82 AC.

q1 = matlab.net.QueryParameter('V=%e2%82%ac')
q1 = 

  QueryParameter with properties:

      Name: "V"
     Value: "€"
    Format: csv

The + и %20 символы рассматриваются как пространства.

q2 = matlab.net.QueryParameter('V=a+b%20c')
q2 = 

  QueryParameter with properties:

      Name: "V"
     Value: "a b c"
    Format: csv

The string метод реализует процентное кодирование на символах, которые требуют кодирования. Для примера, закодирован.

string(q1)
ans = V=%E2%82%AC

Однако символы в queryStr аргумент 'V=a+b%20c' не нужно кодировать.

q3 = string(q2)
q3 = V=a+b+c

Хотя результат от string метод не соответствует queryStrзначения идентичны при использовании в URI.

Свойства

расширить все

Имя параметра, заданное как строка или вектор символов.

Значение параметров, заданное как действительное число, логическое, datetime (со значением, отличным от NaT), строка, вектор символов или вектор вектора или камеры этих значений. Если Value является любым другим типом, тогда Value должен поддерживать string или char методы, которые преобразуют значение в вектор символов. Если пусто, Value рассматривается как пустая строка.

Формат кодировки, заданный как matlab.net.ArrayFormat перечисление, для использования для кодирования Value если это вектор.

Методы

расширить все

Примеры

свернуть все

Создайте имя поля структуры this и установите его в значение that.

qStruct.this = 'that';
QP = matlab.net.QueryParameter(qStruct)
QP = 
  QueryParameter with properties:

      Name: "this"
     Value: 'that'
    Format: csv

Создайте вектор символов с двумя запросами, this=that и one=2. The QueryParameter метод разделяет qStr на & символ в два QueryParameter объекты.

qStr = '?this=that&one=2';
QPs = matlab.net.QueryParameter(qStr);

The name=value пар в qStr задайте Name и Value свойства.

name1 = QPs(1).Name
name1 = 
"this"
value1 = QPs(1).Value
value1 = 
"that"
name2 = QPs(2).Name
name2 = 
"one"
value2 = QPs(2).Value
value2 = 
"2"
Введенный в R2016b