Exponenta Banner
exponenta event banner

полный

Класс: matlab.net.http.io.ContentProvider
Пакет: matlab.net.http.io

Завершить заголовок HTTP для ContentProvider

развернуть все на странице

Синтаксис

complete(provider,URI)

Описание

complete(provider,URI) дополняет заголовок сообщения полями заголовка, требуемыми этим поставщиком. RequestMessage.send и RequestMessage.complete методы вызывают этот метод перед проверкой заголовка или добавлением полей по умолчанию, а также перед вызовом других методов в этом классе, кроме expectedContentLength.

Здесь подклассы могут добавлять в заголовок любые поля, зависящие от содержимого, например Content-Type. См. описание Header для получения дополнительной информации.

RequestMessage методы не вызывают этот метод, если сообщение уже завершено (то есть если RequestMessage.Completed является true). Однако последующее изменение сообщения после завершения сбрасывает RequestMessage.Completed , позволяя этим методам повторно вызывать этот метод. Поэтому провайдеры должны быть готовы к более чем одному вызову complete перед вызовом на start. Однажды start был вызван, MATLAB ® не возобновляет работуcomplete в этом поставщике, если reusable прибыль true указывает, что этот поставщик может быть повторно использован для другого сообщения.

A ContentProvider которая расширяет другое ContentProvider должен сначала вызвать свой суперкласс complete метод добавления полей заголовка к Header требуется суперкласс, а затем, по возвращении, при необходимости измените эти поля.

Поведение этого метода по умолчанию ничего не делает, но создает исключение, если поставщик был запущен и не может использоваться повторно. Поставщики, которые переопределяют этот метод, всегда должны вызывать свой суперкласс.

Если этот поставщик не является делегатом, состоящим из нескольких частей, и требуется включить в сообщение поле Content-Length (избегая тем самым кодирования передачи по частям), следует вернуть непустое значение в expectedContentLength или реализовать этот метод для вставки поля Content-Length в Header.

Этот метод не вызывается для сообщений с Completed свойство имеет значение true, что обычно означает, что этот метод вызывается только один раз для каждого сообщения, даже если это сообщение повторяется несколько раз. Поэтому реализации этого метода должны выполнять любую инициализацию, которая должна выполняться только один раз для каждого сообщения. Дорогостоящая инициализация, которую не требуется выполнять до тех пор, пока данные не будут готовы к отправке, должна выполняться в start способ.

Входные аргументы

развернуть все

Поставщик контента, указанный как matlab.net.http.io.ContentProvider объект.

Унифицированный идентификатор ресурса, указанный как matlab.net.URI объект.

Признаки

Accessprotected

Примеры

развернуть все

Ниже приведен шаблон кодирования для ContentProvider которая расширяет SuperclassProvider и добавляет HeaderField myField .

function complete(obj, uri)
            complete@SuperclassProvider(obj, uri);
            field = obj.Header.getFields('My-Field');
            if isempty(field)
                myField = HeaderField('My-Field', value);
                obj.Header = obj.Header.addFields(myField);
            end

См. также

| | | | |

Представлен в R2018a

Документация MATLAB

Поддержка