主要内容

matlab.net.http.io.stringconsumer类

包裹:matlab.net.http.io.
超类:matlab.net.http.io.contentConsumer.

用于HTTP有效载荷的字符串消费者

描述

一种stringConsumer.将字符数据存储在响应消息中,根据Charset基于Content-Type在响应主体中解码。您可以在发送时直接指定此消费者要求询问为具有某些参数指定数据的字符串转换。

对于一个子类化这个消费者的示例,请参阅Pricesstreamer.班上在图窗口中显示流式数据

matlab.net.http.io.stringconsumer.班级是A.处理班级。

创建

描述

消费者= stringConsumer.构造一个消费者,它使用消息中的内容类型中指定的字符集将输入转换为标量字符串。

fourceer = stringconsumer(名称,价值构建一个由一个或多个指定的选项的消费者名称,价值对论点。姓名属性名称是Charset.或者TextType.价值是相应的价值。您可以以任何顺序指定名称值对参数name1,value1,name2,value2

如果您未指定一个Charset.属性,那么这个消费者试图从中派生内容类型物业,Matlab®基于内容类型字段设置回复stringConsumer.如果是知道charset内容类型具有显式的Charset参数,或者如果它是Matlab了解默认Charset的类型之一:

  • “文本/*”- US-ASCII或UTF-8取决于子类型。

  • “应用/*”- UTF-8用于子类型:JSON,XML,JavaScript,CSS,X-WWW-Form-Urlencoded;不为人知。

如果此消费者无法从中确定字符集内容类型在消息中,此消费者拒绝该消息,并且不会转换。在这种情况下,recommentemessage.Body.仅包含uint8有效载荷。如果要将具有未知密钥的消息转换为邮件,则设置Charset.在将它应用于消息之前在此消费者(或者,如果您是子类作者,则在调用之前初始化方法)。良好的使用是UTF-8,因为这是美国 - ASCII和一些其他CHARSET的超集。

特性

展开全部

公共属性

用于转换数据的字符集,指定为字符串。此值最初为空。如果您将其留空,则根据消息的内容类型字段中的指定或默认查询,在收到消息时设置此值。如果要使用不同的Charset强制转换,那么您可以通过指定Charset来执行此操作stringConsumer.构造函数,或直接设置此属性。子类可以随时设置此属性,包括在消息的中间。如果在调用后更改此值Putdata.,然后在后续调用中使用新值Putdata.。现有内容response.body.data.没有改变。

当接收到响应开始时,如果此属性最初留空,则Matlab根据内容类型将此属性设置为所选的Charset。如果重复使用此消费者以获取不同的消息,则可以选择新的Charset。如果将此属性设置为非空值,则Matlab永远不会更改它。

属性:

Getaccess.
民众
setaccess.
民众
依赖
真的

要返回的数据类型,指定为“细绳”或者“char”。该值来自“TextType”参数到构造函数。默认为“字符串”。如果在数据存储后更改此值response.body.data.,然后将数据转换为新类型。

属性:

Getaccess.
民众
setaccess.
民众
依赖
真的

建议缓冲区大小,指定为UINT64。Matlab套装AllozerLength.到预期的数据缓冲区大小传递给Putdata.。实际尺寸可能更小或更大。为了提高性能,消费者可以使用此值来预配空间来处理数据。

Matlab在召唤之前设置这个属性开始用于方便亚类的方法。

属性:

Getaccess.
民众
setaccess.
民众

有效载荷的预期长度,指定为UINT64。属性通常是价值财产的财产matlab.net.http.field.contentLengthField.在里面标题财产。

如果ContentLength.是空的,那么长度不知道。有效载荷在何时结束Putdata(Uint8.Preme)叫做。

Matlab在呼叫之前设置这个属性初始化,为了方便可能从知识数据的长度中受益的子类。

如果这contentConsumer.是顶级消费者的代表,那么值ContentLength.可能与...不同ContentLength.顶级消费者的价值。

例子:numel(somedata)在哪里一些数据是类型uint8.

属性:

Getaccess.
民众
setaccess.
民众

媒体类型的有效载荷,指定为amatlab.net.http.mediatype.目的。属性通常是价值财产的财产matlab.net.http.field.contenttypefield.在里面标题财产。如果是内容类型财产是空的,那么ContentTypefield.是空的或不存在的。

Matlab在呼叫之前设置这个属性初始化为了方便可能想要检查的子类媒体类型。如果它们从其与不同的数据确定,子类可以设置此属性媒体类型

在转移结束时,Matlab将此值复制到response.body.contenttype.财产。

例子:'申请/八元门流'

属性:

Getaccess.
民众
setaccess.
民众

当前正在处理的有效载荷的标题,指定为amatlab.net.http.headerfield.headerfield.目的。

消费者使用此标题来确定如何处理发送给它们的有效负载。对于顶级消费者,此值与回复。对于委托,值可能不同。例如,在由a处理的多部分消息中multipartconsumer.,这是该委托正在处理的部分的标题。委托仍然可以检查回复对于原始信息的标题。

Matlab在呼叫之前设置这个属性初始化,为了方便亚类。

属性:

Getaccess.
民众
setaccess.
民众

完成了要求询问已发送,指定为amatlab.net.http.requestmessage.目的。这是最终的要求询问毕竟重定向,这是完成了雷斯特返回值来自发送方法。

Matlab在呼叫之前设置这个属性初始化,为了方便亚类。

属性:

Getaccess.
民众
setaccess.
民众

答复遗产被处理,指定为amatlab.net.http.responsemessage.目的。

Matlab设置了回复在呼叫前的财产初始化。价值是答复遗产收到标题后但在收到任何有效载荷之前。在响应消息的开始时(或多级消息的零件的开始),resplyemesssage.Body.物业是A.邮件正文空对象空数据有效载荷特性。要存储收到的数据,消费者可以修改回复MessageBody.Data.数据传输过程中的属性。通常,消费者处理然后存储数据集response.body.data.到他们的加工有效载荷,但这不是必需的。在完成转移时,Matlab返回此回复给呼叫者发送。消费者不应该修改其他回复属性,如标题或者状态线,因为这些更改返回给呼叫者发送

Response.Body.Payload.在转移期间,财产是空的,消费者不应该试图修改它。如果是httpoptions.savepayload.属性设置,然后matlab套装有效载荷到消息结束时收到的有效载荷或部分(呼叫后)Putdata(Uint8.Preme))或发生异常时。

如果在邮件处理期间消费者发生异常,则Matlab抛出httpException.目的。这历史属性包含此问题回复价值。

如果消费者是正在处理多部分消息的一部分的委托,则回复包含整个消息的标题,以及有效载荷数据属性响应在调用之前被清除contentConsumer.每个部分。在每个部分结束时,一个新的答复遗产添加到阵列的末尾答复遗产原始响应中的对象body.data.包含这一点标题来自这个对象和身体从这个财产。下一位代表看到了一个新鲜的回复空的邮件正文,不是以前的代表邮件正文

属性:

Getaccess.
民众
setaccess.
民众
依赖
真的

正在处理的请求的目的地,指定为amatlab.net.uri.目的。该值是由此确定的原始目的地URI发送。它不是重定向后代理的URI或最终URI。

Matlab在呼叫之前设置这个属性初始化,为了方便亚类。

属性:

Getaccess.
民众
setaccess.
民众

受保护的属性

函数,指定为函数句柄,由此调用Putdata.追加附加数据的方法。这Putdata.此类中的方法调用Appendfcn.函数要附加其收到的数据数据响应消息中现有数据的参数。该函数必须具有签名:

Appendfcn(消费者,NewData)

在哪里新数据数据是否要附加到阵列fourceer.response.body.data.。这种方法有责任更新消费者.CurrentLength.反映新的长度数据。如果新数据是空的,表示流的末尾,那么函数应该更新response.body.data.到最终价值。

默认行为(如果此属性为空),则使用处理的内部函数数据作为支持的任意值阵列金宝app霍罗斯卡特功能。它有效地补充说新数据通过预分配空间,保持CurrentLength.作为存储的数据的实际长度。在消息的末尾,它截断了response.body.data.CurrentLength.

子类可以更改此属性霍罗斯卡特不适合附加过程。例如,当一个stringConsumer.构建标量字符串,它会使用它添加到字符串功能而不是霍罗斯卡特

不援引的子类contentconsumer.putdata.putdata.put.追加数据,或满意霍罗斯卡特追加数据时的行为,可以忽略此属性。

例子:@customappend.在哪里@customappend.由消费者定义

属性:

Getaccess.
保护
setaccess.
保护

contentConsumer.这个消费者是委派的,指定为amatlab.net.http.io.contentConsumer.目的。这德比托调用消费者(委托)的方法设置CurrentDelegate.财产。如果没有当前委托,则该值是[]

Matlab套装CurrentDelegate.[]在打电话之前初始化

属性:

Getaccess.
保护
setaccess.
保护

目前的数据长度response.body.data.财产,指定为UINT64

此属性用于何时使用response.body.data.已被预先曝为大于当前存储的实际数据量的大小,以指示存储数据的长度。如果此属性为空,那么这意味着全部response.body.data.包含存储的数据或该数据contentConsumer.子类是以某种方式处理数据,而不是存储它response.body.data.

此属性用于和设置Putdata.该基类的方法Appendfcn.财产是空的。这是为了呼叫的子类的好处Putdata.并希望检查已经存储的数据和/或任何实现Appendfcn.保持结果response.body.data.

使用的子类Putdata.还可以修改此属性以重置存储数据的缓冲区中的位置。例如,默认情况下Appendfcn.使用功能,一个处理全部的子类response.body.data.每次打电话Putdata.可能不再有原始数据使用,所以它可以重置CurrentLength.属性到1所以下一个Putdata.呼叫将缓冲区覆盖具有新数据。在新数据结束时,无法清除缓冲区中的元素。

不打电话的子类Putdata.可以使用此属性跟踪自己的数据,或者可以将其未设置(空)。MATLAB不会对可以在此处设置的值上的任何约束,而不是用于确定默认值的任何目的Appendfcn.应该存储下一个缓冲区的数据,以及在邮件结尾截断数据的位置。将此属性设置为在最终通话前空Putdata(Uint8.Preme)防止截断数据。

MATLAB将此属性设置为在每次调用之前都空初始化

属性:

Getaccess.
保护
setaccess.
保护

contentConsumer.委派给这个消费者,指定为amatlab.net.http.io.contentConsumer.目的。如果这个消费者是另一个消费者调用的委托,例如agenericconsumer或者multipartconsumer.,那是呼叫消费者。它在呼叫中指定的顶级消费者中是空的发送

委托可以使用此属性来访问其委派器的属性,例如,以确定委派哪些消费者委托给他们。

属性:

Getaccess.
保护
setaccess.
保护

方法

展开全部

更多关于

展开全部

在R2018A介绍