matlab.net.http.io. Класс MultipartFormProvider
Пакет: matlab.net.http.io
Суперклассы: matlab.net.http.io.MultipartProvider
ContentProvider, чтобы отправить сообщения multipart/form-data
Описание
Используйте этого провайдера, чтобы отправить многослойную форму в сервер. Многослойная форма является сообщением, содержащим серию частей, где каждая часть имеет "имя элемента управления" и его данные. Данные могут какой-либо иметь типы, допускал RequestMessage.Body.Data или другой ContentProvider.
Некоторые серверы требуют, чтобы несколько частей под тем же именем были во вложенной многослойной/смешанной части. Чтобы отправить вложенные части, перенесите части в MultipartProvider. Например, чтобы отправить сообщение, как описано в самом конце главы 17 спецификации HTML 4.01 для данных о форме:
fps = FileProvider(["file1.txt","file2.gif"]); % get array of providers
mp = MultipartProvider(fps);
formProvider = MultipartFormProvider("submit-name","Larry","files",mp);
req = RequestMessage('put',[],formProvider);
req.send(uri);Класс matlab.net.http.io.MultipartFormProvider является классом handle.
Создание
Описание
provider = MultipartFormProvider( создает содержимое Name,Part)"multipart/form-data", заданное одним или несколькими аргументами пары заглавной роли. Part является данными формы, содержащими Name и его содержимое. Аргументы Part могут какой-либо иметь типы, поддержанные MultipartProvider, включая другие объекты ContentProvider.
Если Part является массивом, это эквивалентно повторению Name,Part для каждого элемента массива. Например, оператор:
MultipartFormProvider("name",FileProvider(["file1" "file2"]))эквивалентно:
MultipartFormProvider("name",FileProvider("file1"),"name",FileProvider("file2"));Свойства
Общественные собственности
Names — Имена части
строка
Имена части, заданные как строка.
Атрибуты:
| GetAccess | общественность |
| SetAccess | общественность |
Parts — Части текста сообщения
cellArray
Части текста сообщения, заданного как массив ячеек одного или нескольких из этих значений:
Объект |
|
|
|
|
|
Массив | Это обрабатывает каждый элемент массива как часть. Не массив ячеек. |
Обработайте к методу | Этот метод должен иметь подпись |
Любой другой тип | Если тип не совпадает ни с одним из этих типов и не является указателем на функцию, то он обработан, как будто он присутствовал в свойстве |
Атрибуты:
| GetAccess | общественность |
| SetAccess | общественность |
| Зависимый | tRUE |
Поля Header — Header сообщения или части
matlab.net.http.HeaderField.empty (значение по умолчанию) | matlab.net.http.HeaderField
Поля заголовка сообщения или части, заданной как вектор одного или нескольких объектов matlab.net.http.HeaderField.
Это свойство только используется авторами подкласса. MATLAB устанавливает это свойство прежде, чем вызвать метод complete провайдера. Для немногослойных сообщений MATLAB инициализирует это свойство к содержимому Request.Header минус любой matlab.net.http.field.GenericFields или поля с пустым знаком. ContentProvider использует это свойство добавить поля заголовка, которые описывают данные, которые будут отправлены или добавят параметры в поля заголовка уже в сообщении. В делегате к MultipartProvider MATLAB инициализирует это свойство к полям заголовка, которые провайдер делегирования намеревается вставить для части. Делегаты могут изменить или изменить эти поля.
По возврату из метода complete провайдера, если это не многослойное сообщение, то MATLAB читает это свойство и объединяет его содержимое в заголовок Request. Поля в этом Header с Names, которые уже не появляются в Request.Header, добавляются в конец Request.Header. Если поле в этом Header имеет Name, который эквивалентен один в Request.Header, и у обоих есть непустой Values, то:
Если тем в
Request.HeaderявляетсяGenericField, то проигнорируйте тот вHeader.Если тем в
Request.Headerне являетсяGenericField, то замените его на тот вHeader.
Если один или оба из них имеет пустой Value, то поле удалено из Request.Header, и это не добавляется как часть нормального завершения сообщения.
Если это - делегат MultipartProvider, то целое содержимое этого Header используется в качестве заголовка части. Многослойные делегаты не должны принимать, что Request.Header содержит любые поля, имеющие отношение к их собственному Header. Провайдер может определить, является ли это многослойным делегатом путем проверки, является ли MyDelegator MultipartProvider, хотя этот тест вряд ли будет необходим.
MATLAB читает это свойство только по возврату из вызова метода complete провайдера. Изменения в этом массиве проигнорированы, если MATLAB вызывает start.
Авторы класса должны иметь в виду, что их подклассы могут добавить поля в этот Header (в их методе complete) прежде, чем вызвать complete в их суперклассе. Лучше сохранять такие поля а не добавлять поля с теми же именами. Однако добавление параметра к полю допустимо. Например, суперкласс может добавить параметр набора символов в существующее поле Content-Type, которое уже не имеет того.
Атрибуты:
| GetAccess | общественность |
| SetAccess | общественность |
ForceChunked — Укажите, обеспечить ли разделенное на блоки кодирование передачи
false (значение по умолчанию) | true
Укажите, обеспечить ли разделенное на блоки кодирование передачи, заданное как булевская переменная. Это свойство представляет интерес только, чтобы разделить авторов на подклассы и применимо только к провайдерам, которые не являются многослойными делегатами. Подклассы устанавливают ForceChunked управлять, должно ли содержимое быть отправлено с помощью разделенного на блоки кодирования передачи. Если false (значение по умолчанию), MATLAB решает, отправить ли разделенное на блоки содержимое, на основе того, знает ли это длину содержимого в то время, когда сообщение готово быть отправленным:
Если MATLAB знает длину содержимого (который имеет место, если сообщение содержит поле Content-Length, или если метод
expectedContentLengthэтого провайдера возвратил номер), то MATLAB решает, отправить ли разделенный на блоки или нет.Если MATLAB не знает длины содержимого (никакое поле Content-Length в заголовке и
expectedContentLength, возвращенном пустой), то MATLAB всегда отправляет разделенное на блоки сообщение.
Если ForceChunked является true, то MATLAB отправляет сообщение, разделенное на блоки независимо от того, знает ли это длину содержимого, если известная длина не меньше, чем размер фрагмента. Если этим свойством является true, то сообщение не должно содержать поле Content-Length, потому что HTTP не позволяет разделенному на блоки сообщению иметь поле Content-Length. Однако можно все еще возвратить ненулевое значение в методе expectedContentLength, если вы хотите, чтобы MATLAB проверил, что вы возвращаете ожидаемую длину данных.
Когда MATLAB принимает решение отправить разделенное на блоки сообщение, размер каждого фрагмента равен длине данных, возвращенных getData.
MATLAB читает это значение после вызова метода complete, прежде, чем вызвать start. Это не устанавливает это поле.
Атрибуты:
| GetAccess | общественность |
| SetAccess | общественность |
Request — Запросите сообщение отправить
matlab.net.http.RequestMessage
Запросите сообщение отправить, заданный как объект matlab.net.http.RequestMessage.
Это свойство используется только авторами подкласса. RequestMessage.send и методы RequestMessage.complete устанавливают это свойство на RequestMessage, в Body которого этот провайдер был помещен, прежде, чем вызвать любые другие методы в этом провайдере, и прежде, чем добавить любые дополнительные поля заголовка или подтвердить сообщение. Провайдер может исследовать это сообщение, чтобы видеть то, что содержалось в исходном запросе.
Делегаты видят то же значение для этого свойства как delegator. ContentProviders должен иметь в виду, что, если они - делегаты, они не обязательно обеспечивают целое тело сообщения запроса, таким образом, они не должны принимать, что поля заголовка в этом Запросе являются подходящими для данных, которые они обеспечивают. Обычно, делегаты должны проигнорировать поля заголовка в этом запросе, относящемся к данным, такие как Тип контента.
Если провайдер хочет добавить какие-либо поля заголовка в это сообщение или изменить существующие единицы, это должно сделать так в его методе complete путем добавления тех полей в свойство Header. Вызывающая сторона complete (RequestMessage или провайдер делегирования) определяет, что сделать с теми полями. RequestMessage.send и RequestMessage.complete всегда копируют эти поля в Header RequestMessage. Провайдер делегирования может скопировать поля в свое собственное свойство Header или вставить их в сообщение (как в случае MultipartProvider). Для получения дополнительной информации смотрите свойство Header.
Это свойство доступно только для чтения.
Атрибуты:
GetAccess | public |
SetAccess | matlab.net.http.RequestMessage |
Защищенные свойства
Подтип Подтип провайдера
"mixed" (значение по умолчанию) | строка
Подтип провайдера, заданный как строка. Значение по умолчанию "mixed" добавляет набор заголовка Типа контента в "multipart/mixed" к сообщению плюс соответствующие параметры. Подклассы могут изменить это значение в конструкторе или методе complete. Это значение появляется в Типе контента после "multipart/".
Атрибуты:
| GetAccess | защищенный |
| SetAccess | защищенный |
CurrentDelegate — ContentProvider, к которому этот провайдер делегирует
matlab.net.http.io.ContentProvider | пустой
ContentProvider, к которому этот провайдер делегирует, заданный как объект matlab.net.http.io.ContentProvider. Это свойство собирается в провайдере вызова (delegator) методом delegateTo указать на текущего делегированного провайдера. Если нет никакой текущей делегации, то значение пусто.
Методы complete устанавливают это свойство опустеть.
Атрибуты:
| GetAccess | защищенный |
| SetAccess | защищенный |
MyDelegator — ContentProvider, который делегировал к этому провайдеру
matlab.net.http.io.ContentProvider.empty (значение по умолчанию) | matlab.net.http.io.ContentProvider
ContentProvider, который делегировал к этому провайдеру, заданному как объект matlab.net.http.io.ContentProvider.
Если ContentProvider делегирует ответственность за отправку всех или фрагмента данных о сообщении к другому провайдеру, то это свойство идентифицирует провайдера делегирования делегату. Например, MultipartProvider делегирует части сообщения к другим провайдерам, таким образом, это вставляет указатель на себя в каждом делегате. В противном случае MyDelegator пуст. Метод delegateTo устанавливает это свойство в делегате.
Атрибуты:
| GetAccess | защищенный |
| SetAccess | защищенный |
Методы
Открытые методы
getData | Следующий буфер данных, который отправит в многослойном HTTP, запрашивает сообщение |
Специализированные операторы и функции
Эти методы специализируют стандартные операторы MATLAB и функции и унаследованные методы для объектов в этом классе.
string | Информация о провайдере как строка |
show | Отобразите информацию о провайдере |
Защищенные методы
complete | Полный HTTP-заголовок для MultipartProvider |
preferredBufferSize | Предпочтительный buffer size для ContentProvider |
expectedContentLength | Длина содержимого ContentProvider |
start | Запустите передачу данных с MultipartProvider |
restartable | Укажите, является ли ImageProvider прерываемым |
reusable | Укажите, является ли ImageProvider допускающим повторное использование |
delegateTo | Делегируйте к другому провайдеру |
Больше о
Иерархия классов
