HTTP消息中的文件的消费者- MATLAB - MathWorks Benelux - 金宝app,下载188bet金宝搏,金宝搏官方网站

创建

描述

消费者= FileConsumer(文件名，许可，machineformat，编码）构造一个FileConsumer它使用来自服务器的响应的有效负载创建或覆盖文件。参数的含义与打开外部文件函数，所有都是可选的。

消费者= FileConsumer(支撑材）设置FileIdentifier财产支撑材并写入该文件。支撑材必须是要写入时打开的文件的标识符。MATLAB在当前位置指示符处写入文件，因此如果使用“+”权限，例如MATLAB追加到文件。传输完成后，MATLAB将位置指示符留在文件的末尾，不关闭文件。

输入参数

全部展开

`文件名`- - - - - -文件或文件夹名称
特征向量|字符串标量

文件或文件夹名称，包括完整路径和可选扩展名，指定为字符向量或字符串标量。要确定MATLAB创建的文件的名称，请参阅文件名财产。

如果文件名指定现有文件夹中的一个文件，然后MATLAB:

使用以下命令打开文件fopen(文件名,许可,…)．
如果许可未指定，然后使用fopen(文件名,“w +”)．
如果文件名不包含扩展名，则MATLAB根据接收到的消息中的Content-Type和/或Content-Disposition报头字段或请求URI中的文件名扩展名(如果有)添加一个扩展名。

如果文件名指定一个现有的、可写的文件夹，然后MATLAB在该文件夹中创建一个文件，该文件的名称来自响应中的Content-Disposition报头字段或URI，如果该名称不包含Content-Type，则可能添加一个基于Content-Type的扩展。

如果文件名缺失或为空，则MATLAB在当前文件夹中创建一个文件。这相当于文件名= '。'．当前文件夹是此时的文件夹FileConsumer创建时，而不是此消费者在发送请求。

例子:“myTextFile.txt”

数据类型:字符|字符串

`许可`- - - - - -文件访问类型
`w +`(默认)|`u +`|`u`|`T`|允许的值`打开外部文件`函数

文件访问类型，以字符串形式指定。如果许可时，它必须允许写访问。默认值为“w +”，它打开或创建一个文件进行读写，并丢弃现有的内容(如果有的话)。

许可方法允许的任何值打开外部文件函数。的下列附加值许可支持:金宝app

“u +”，“u”

一样' w '而且“w +”，但如果文件存在，则创建一个具有惟一名称的文件文件名论点。新文件的名称有一个连字符和一个序列号附加到其名称的部分，不包括扩展名。

例如，如果文件名是“MyFile.txt”但是文件存在，然后MATLAB创建文件myfile - 1. - txt．的文件名属性包含新文件的完整路径名称。

“T”

当附加到权限时，行为类似于文本模式“t”但仅当数据的Content-Type指示它是基于字符的时才使用文本模式。这包括指定字符集参数的任何类型或MATLAB知道的基于字符的类型，例如“application / json”．

在所有情况下，为' w '而且“w +”权限(或如果许可没有指定)，MATLAB不会覆盖现有的文件，除非文件名完全等于文件名．

例子:“一个”“w + T”

数据类型:字符|字符串

`machineformat`- - - - - -读取或写入字节或位的顺序
允许的任何值`打开外部文件`

类所允许的任意值指定的读取或写入字节或位的顺序打开外部文件函数。

数据类型:字符|字符串

`编码`- - - - - -字符编码
允许的任何值`打开外部文件`

属性所允许的任意值指定的字符编码打开外部文件函数。

数据类型:字符|字符串

属性

全部展开

公共属性

`FileIdentifier`- - - - - -文件标识符
双

正在写入的文件标识符(FID)，指定为double。如果消费者是用FID参数构造的，那么这个属性就是标识符。数据被写入与此标识符关联的当前文件位置指示符，因此子类在使用此标识符时应注意不要意外更改位置。在传输结束时，文件保持打开状态，位置保持在文件的末尾。

如果使用文件名参数，或不带参数，则此属性是该文件的只读文件标识符。这允许子类在传输过程中读取文件，而不会干扰用于写入的位置指示器。在传输结束时，该标识符关闭。

属性:

`GetAccess`	`公共`
`SetAccess`	`私人`

`文件名`- - - - - -文件路径名称
`string.empty`(默认)|字符串

正在写入的文件的完整路径名称，指定为字符串。如果使用者是用FID参数构造的，那么这个属性就是文件的名称。否则，此值可能直到MATLAB在接收响应消息期间开始写入文件时才会设置，因为在接收到所有头信息之前不一定能确定文件名。使用此属性可确定写入的文件。文件名也存储在Response.Body.Data财产。

属性:

`GetAccess`	`公共`
`SetAccess`	`私人`

`AllocationLength`- - - - - -建议缓冲区大小
`uint64`

建议的缓冲区大小，指定为uint64．MATLAB集AllocationLength传递到的数据缓冲区的预期大小putData．实际大小可能更小，也可能更大。为了提高性能，使用者可以使用这个值预分配空间来处理数据。

函数调用之前，MATLAB设置此属性开始方法，以方便子类。

属性:

`GetAccess`	`公共`
`SetAccess`	`公共`

`ContentLength`- - - - - -预期有效载荷长度
`uint64`|空

有效载荷的预期长度，指定为uint64．属性通常是价值的属性matlab.net.http.field.ContentLengthField在头财产。

如果ContentLength是空的，那么长度是不知道的。当负载结束时putData (uint8.empty)被称为。

MATLAB在调用之前设置此属性初始化，以方便子类，这些子类可能受益于知道数据的长度。

如果这ContentConsumer是顶级消费者的委托，那么的值ContentLength可能不同于ContentLength顶级使用者的值。

例子:元素个数(someData)在哪里someData是类型uint8

属性:

`GetAccess`	`公共`
`SetAccess`	`公共`

`ContentType`- - - - - -有效载荷的媒体类型
`matlab.net.http.MediaType`|空

有效负载的媒体类型，指定为matlab.net.http.MediaType对象。属性通常是价值的属性matlab.net.http.field.ContentTypeField在头财产。如果ContentType属性为空，则ContentTypeField为空或不存在。

MATLAB在调用之前设置此属性初始化类的子类可能需要检查MediaType．子类可以设置此属性，如果它们从数据中确定它是不同的MediaType．

在传输结束时，MATLAB将此值复制到Response.Body.ContentType财产。

例子:的应用程序/八进制

属性:

`GetAccess`	`公共`
`SetAccess`	`公共`

`头`- - - - - -当前正在处理有效载荷的报头
`matlab.net.http.HeaderField`

当前正在处理的有效负载的头，指定为matlab.net.http.HeaderField对象。

使用者使用此报头来确定如何处理发送给他们的有效负载。对于顶级使用者，此值与响应。头．对于委托，值可能不同。类处理的多部分消息中MultipartConsumer，它是这个委托正在处理的部分的头。委托仍然可以进行检查响应。头用于原始消息的标题。

MATLAB在调用之前设置此属性初始化，以方便子类。

属性:

`GetAccess`	`公共`
`SetAccess`	`公共`

`请求`- - - - - -完成`RequestMessage`这是发送的
`matlab.net.http.RequestMessage`

完成的RequestMessage发送的，指定为amatlab.net.http.RequestMessage对象。这是期末考试RequestMessage经过所有重定向，这是completedrequest返回的值。发送方法。

MATLAB在调用之前设置此属性初始化，以方便子类。

属性:

`GetAccess`	`公共`
`SetAccess`	`公共`

`响应`- - - - - -`ResponseMessage`正在处理
`matlab.net.http.ResponseMessage`

的ResponseMessage正在处理，指定为matlab.net.http.ResponseMessage对象。

MATLAB设置响应属性。初始化．取值为ResponseMessage在接收报头之后，但在接收任何有效负载之前。在响应消息处理的开始(或多部分消息的一个部分的开始)时ResponseMesssage。身体属性是一个MessageBody对象为空数据而且有效载荷属性。要存储接收到的数据，使用者可以修改响应而且MessageBody。数据属性。通常情况下，消费者处理并存储数据集Response.Body.Data到它们处理的有效负载，尽管这不是必需的。在转换完成时，MATLAB返回这个响应给打电话的人发送．消费者不应修改其他响应属性，例如头或状态栏的调用者返回这些更改发送．

的Response.Body.Payload属性在传输期间为空，使用者不应试图修改它。如果HTTPOptions。SavePayload属性设置，然后MATLAB设置有效载荷到接收到的有效负载的消息或部分的传输结束后(调用到putData (uint8.empty))或发生异常时。

如果在消息处理期间消费者中发生异常，则MATLAB将抛出异常textbox对象。的历史属性包含以下内容响应价值。

如果使用者是处理多部分消息的一部分的委托，则响应。头包含整个消息的头，而有效载荷而且数据的属性响应。身体调用ContentConsumer对于每个部分。在每个部分的结论，一个新的ResponseMessage添加到数组的末尾ResponseMessage初始响应中的对象的身体。数据包含头从这个对象和身体从这个性质。下一个委托看到一个fresh响应空的MessageBody，而不是前一个委托的MessageBody．

属性:

`GetAccess`	`公共`
`SetAccess`	`公共`
`依赖`	`真正的`

`URI`- - - - - -正在处理的请求的目的地
`matlab.net.URI`

正在处理的请求的目的地，指定为matlab.net.URI对象。此值是由确定的原始目标URI发送．它不是代理的URI，也不是重定向后的最终URI。

MATLAB在调用之前设置此属性初始化，以方便子类。

属性:

`GetAccess`	`公共`
`SetAccess`	`公共`

受保护的属性

`AppendFcn`- - - - - -由`putData`附加附加数据
函数处理

函数，指定为函数句柄，由putData方法附加附加数据。的putData方法调用AppendFcn函数中附加接收到的数据数据参数指向响应消息中的现有数据。函数必须具有以下签名:

newdata AppendFcn(消费者)

在哪里newdata数据是否被追加到数组consumer.Response.Body.Data．更新是该方法的责任消费者。CurrentLength以反映新的长度数据．如果newdata为空，这表示流的结束，那么函数应该更新Response.Body.Data到它的最终值。

如果此属性为空，则默认行为使用内部函数处理数据类型的任意值的数组金宝apphorzcat函数。它能有效地增加newdata通过预分配空间，维护CurrentLength为所存储数据的实际长度。在消息的末尾，它截断Response.Body.Data来CurrentLength．

子类可以更改此属性，如果horzcat不适合附加进程。例如，当一个StringConsumer生成标量字符串时，它将使用+功能而不是horzcat．

不调用的子类ContentConsumer.putData附加数据，或者满足的数据horzcat行为，可以忽略此属性。

例子:@customAppend在哪里@customAppend是由消费者定义的

属性:

`GetAccess`	`受保护的`
`SetAccess`	`受保护的`

`CurrentDelegate`- - - - - -`ContentConsumer`这个消费者正在委托给它
`matlab.net.http.io.ContentConsumer`|`［］`

的ContentConsumer此使用者委托给的对象，指定为matlab.net.http.io.ContentConsumer对象。的delegateTo方法的调用方(委托方)设置CurrentDelegate财产。如果没有当前委托，则值为［］．

MATLAB集CurrentDelegate来［］在调用之前初始化．

属性:

`GetAccess`	`受保护的`
`SetAccess`	`受保护的`

`CurrentLength`- - - - - -当前数据的长度`Response.Body.Data`
`uint64.empty`(默认)|`uint64`

对象中当前数据的长度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.empty)防止数据被截断。

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

属性:

`GetAccess`	`受保护的`
`SetAccess`	`受保护的`

`MyDelegator`- - - - - -`ContentConsumer`委托给这个消费者
`matlab.net.http.io.ContentConsumer`|空

的ContentConsumer委托给该使用者的，指定为matlab.net.http.io.ContentConsumer对象。如果此使用者是由另一个使用者调用的委托，例如GenericConsumer或MultipartConsumer，那么这是打电话的消费者。在调用中指定的顶级使用者中为空发送．

委托可以使用此属性访问其委托方的属性，例如，确定委托给它们的是哪个消费者。

属性:

`GetAccess`	`受保护的`
`SetAccess`	`受保护的`

方法

全部展开

公共方法

`初始化`	为新的HTTP有效负载准备使用者
`开始`	开始向FileConsumer传输文件
`putData`	为FileConsumer保存下一个数据缓冲区到文件
`delegateTo`	委托给另一个消费者

另请参阅

matlab.net.http.io.FileConsumer类

描述

创建

描述

输入参数

文件名- - - - - -文件或文件夹名称特征向量|字符串标量

许可- - - - - -文件访问类型w +(默认)|u +|u|T|允许的值打开外部文件函数

machineformat- - - - - -读取或写入字节或位的顺序允许的任何值打开外部文件

编码- - - - - -字符编码允许的任何值打开外部文件

属性

公共属性

FileIdentifier- - - - - -文件标识符双

属性:

文件名- - - - - -文件路径名称string.empty(默认)|字符串

属性:

AllocationLength- - - - - -建议缓冲区大小uint64

属性:

ContentLength- - - - - -预期有效载荷长度uint64|空

属性:

ContentType- - - - - -有效载荷的媒体类型matlab.net.http.MediaType|空

属性:

头- - - - - -当前正在处理有效载荷的报头matlab.net.http.HeaderField

属性:

请求- - - - - -完成RequestMessage这是发送的matlab.net.http.RequestMessage

属性:

响应- - - - - -ResponseMessage正在处理matlab.net.http.ResponseMessage

属性:

URI- - - - - -正在处理的请求的目的地matlab.net.URI

属性:

受保护的属性

AppendFcn- - - - - -由putData附加附加数据函数处理

属性:

CurrentDelegate- - - - - -ContentConsumer这个消费者正在委托给它matlab.net.http.io.ContentConsumer|［］

属性:

CurrentLength- - - - - -当前数据的长度Response.Body.Datauint64.empty(默认)|uint64

属性:

MyDelegator- - - - - -ContentConsumer委托给这个消费者matlab.net.http.io.ContentConsumer|空

属性:

方法

公共方法

更多关于

类层次结构

另请参阅

MATLAB的文档

金宝app

用MATLAB介绍深度学习

`文件名`- - - - - -文件或文件夹名称
特征向量|字符串标量

`许可`- - - - - -文件访问类型
`w +`(默认)|`u +`|`u`|`T`|允许的值`打开外部文件`函数

`machineformat`- - - - - -读取或写入字节或位的顺序
允许的任何值`打开外部文件`

`编码`- - - - - -字符编码
允许的任何值`打开外部文件`

`FileIdentifier`- - - - - -文件标识符
双

`文件名`- - - - - -文件路径名称
`string.empty`(默认)|字符串

`AllocationLength`- - - - - -建议缓冲区大小
`uint64`

`ContentLength`- - - - - -预期有效载荷长度
`uint64`|空

`ContentType`- - - - - -有效载荷的媒体类型
`matlab.net.http.MediaType`|空

`头`- - - - - -当前正在处理有效载荷的报头
`matlab.net.http.HeaderField`

`请求`- - - - - -完成`RequestMessage`这是发送的
`matlab.net.http.RequestMessage`

`响应`- - - - - -`ResponseMessage`正在处理
`matlab.net.http.ResponseMessage`

`URI`- - - - - -正在处理的请求的目的地
`matlab.net.URI`

`AppendFcn`- - - - - -由`putData`附加附加数据
函数处理

`CurrentDelegate`- - - - - -`ContentConsumer`这个消费者正在委托给它
`matlab.net.http.io.ContentConsumer`|`［］`

`CurrentLength`- - - - - -当前数据的长度`Response.Body.Data`
`uint64.empty`(默认)|`uint64`

`MyDelegator`- - - - - -`ContentConsumer`委托给这个消费者
`matlab.net.http.io.ContentConsumer`|空