initialize

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

Подготовьте потребителя к новой полезной нагрузке HTTP

Синтаксис

OK = initialize(consumer)

Описание

OK = initialize(consumer) готовит ContentConsumer для использования с новой полезной нагрузкой HTTP.

MATLAB® вызывает initialize после получения заголовка ResponseMessage та сила содержит полезную нагрузку, чтобы подготовить потребителя к той полезной нагрузке. Это не вызывается для сообщений, которые, как не ожидают, будут содержать полезную нагрузку, такую как те с явной Довольной Длиной 0, или в ошибочных случаях, где полный заголовок не был получен.

delegateTo метод в потребителе делегата также вызывает initialize.

Если вы разделяете на подклассы ContentConsumer, затем необходимо, по крайней мере, проверять свойство ContentType проверить, что ответ имеет тип, который вы готовы обработать. Можно заменить этот метод к, например:

  • Инициализируйте свои собственные свойства

  • Определите, хотите ли вы обработать полезную нагрузку

  • Обработайте полезную нагрузку, которая имеет Response.StatusCode кроме OK

Вам решать, ли выполнить какие-либо последующие инициализации в этом методе или задержать их до start метод.

Даже если initialize называется, MATLAB не может вызвать start потребителя метод, если сообщение не имеет никакой полезной нагрузки.

Реализация по умолчанию возвращает true если Response.StatusCode OK и false в противном случае. Подклассы, которые заменяют этот метод, должны вызвать этот метод суперкласса сначала и проверять возвращаемое значение, если они не хотят обработать сообщения с состоянием кроме OK. Подклассы, которые вызывают putData в этом классе должен вызвать этот метод.

Потребительские подклассы должны быть готовы быть снова использованными для последующих сообщений. MATLAB вызывает initialize перед каждым сообщением и затем start для каждого сообщения, которое имеет непустую полезную нагрузку. Если MATLAB вызывает start, это не вызывает initialize пока сообщение не закончилось, исключение было выдано, или прерывание произошло во время обработки сообщения. Все эти случаи обозначаются вызовом putData(uint8.empty).

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

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

Потребитель содержимого, заданный как matlab.net.http.io.ContentConsumer объект.

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

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

Укажите, принимает ли потребитель или отклоняет полезную нагрузку сообщения, возвращенного как true или false.

  • Если код статуса ResponseMessage StatusCode.OK, затем значением по умолчанию является true.

  • Если OK true, затем потребитель принял сообщение и обрабатывает полезную нагрузку, если таковые имеются. MATLAB затем вызывает start потребителя метод, когда первый байт полезной нагрузки прибывает, сопровождаемый одним или несколькими вызовами putData, передача буфера данных по каждому вызову.

  • Если OK false, затем потребитель не хочет обрабатывать сообщение, в этом случае MATLAB обрабатывает полезную нагрузку, как будто никакой потребитель не был задан (который может означать преобразование по умолчанию полезной нагрузки к данным).

Если вы заменяете initialize метод и отклонение сообщение и вы хотите прервать получение сообщения вместо того, чтобы обработать его способом по умолчанию, затем выдать ошибку из этого метода вместо того, чтобы возвратить false.

Атрибуты

Accessprotected

Введенный в R2018a