matlab.net.http.Disposition 类

命名空间: matlab.net.http

HTTP 日志记录中的结果

描述

Disposition 枚举类在类型 matlab.net.http.logRecord 的 HTTP 日志记录中提供结果。

枚举成员名称描述

枚举成员名称	描述
`ConversionError`	转换响应数据时发生错误。已收到请求，但尝试自动转换响应的有效负载时出错。这种情况表明 `LogRecord.Response` 的 `MessageBody.Payload` 属性包含原始有效负载，而 `Data` 属性为空。异常信息包含在 `LogRecord.Exception` 属性中。如果涉及 `ContentConsumer`，则不会发生此错误。
`Done`	请求和响应均已成功发送和接收。`Done` 表明日志记录中同时包含 `RequestMessage` 和 `ResponseMessage`。但它并不隐含关于响应中 `StatusCode` 的任何信息。
`TransmissionError`	发送或接收消息时发生错误。失败可能是由于输入/输出错误，如断开连接或超时、`ContentProvider` 或 `ContentConsumer` 中的故障，或尝试在传出或传入数据与 MATLAB 数据之间转换时出错。`LogRecord.Exception` 属性包含发生的异常。如果发送请求时发生错误，`LogRecord.Request` 中将包含已完成的 `RequestMessage` 对象，而 `LogRecord.Response` 属性为空。如果接收响应时发生错误，若未收到完整的标头，`LogRecord.Response` 可能为空。若收到标头但不能读取有效负载，则 `ResponseMessage` 对象包含标头，并且可能包含全部或部分收到的有效负载。

ConversionError

转换响应数据时发生错误。已收到请求，但尝试自动转换响应的有效负载时出错。这种情况表明 LogRecord.Response 的 MessageBody.Payload 属性包含原始有效负载，而 Data 属性为空。异常信息包含在 LogRecord.Exception 属性中。

如果涉及 ContentConsumer，则不会发生此错误。

Done

请求和响应均已成功发送和接收。Done 表明日志记录中同时包含 RequestMessage 和 ResponseMessage。但它并不隐含关于响应中 StatusCode 的任何信息。

TransmissionError

发送或接收消息时发生错误。失败可能是由于输入/输出错误，如断开连接或超时、ContentProvider 或 ContentConsumer 中的故障，或尝试在传出或传入数据与 MATLAB 数据之间转换时出错。LogRecord.Exception 属性包含发生的异常。

如果发送请求时发生错误，LogRecord.Request 中将包含已完成的 RequestMessage 对象，而 LogRecord.Response 属性为空。

如果接收响应时发生错误，若未收到完整的标头，LogRecord.Response 可能为空。若收到标头但不能读取有效负载，则 ResponseMessage 对象包含标头，并且可能包含全部或部分收到的有效负载。

版本历史记录

在 R2016b 中推出

全部展开

R2024a: Ctrl+C 键停止执行 MATLAB 命令

在执行 MATLAB^®HTTP 接口中的 MATLAB 函数时按下 Ctrl+C，会停止执行 MATLAB 命令。此行为与其他 MATLAB 功能处理 Ctrl+C 的方式一致，如使用键盘快捷方式导航 MATLAB 中所述。

以前，这些函数会引发自定义异常，用户可以在 try/catch 代码块中捕获该异常。如果您的代码包含 try/catch 代码块，您可以通过删除它们来更新代码。

下表显示在 R2024a 之前和从 R2024a 开始按下 Ctrl+C 键时不同结果的示例。此代码依赖这些 import 语句和由 <a_customer_URI> 表示的 URI。

import matlab.net.*;  
import matlab.net.http.*; 
import matlab.net.http.field.*;  
import matlab.net.http.io.*;

更新前	更新后
uri = URI('<a_customer_URI>'); r = RequestMessage('GET'); try [resp, req, hist] = r.send(uri); % User presses Ctrl+C catch ME rethrow(ME); % ME contains History for the communication end K>> ME ME = HTTPException with properties: Request: [1×1 matlab.net.http.RequestMessage] URI: [1×1 matlab.net.URI] History: [1×1 matlab.net.http.LogRecord] identifier: 'MATLAB:webservices:OperationTerminatedByUser' message: 'Web service operation terminated by user while accessing URL '<a_customer_URI>'.' cause: {[1×1 MException]} stack: [5×1 struct] Correction: []	uri = URI('<a_customer_URI>'); r = RequestMessage('GET'); [resp, req, hist] = r.send(uri); % User presses Ctrl+C Operation terminated by user during matlab.internal.webservices.HTTPConnector/copyContentToByteArray

更新前

更新后

uri = URI('<a_customer_URI>'); 
r = RequestMessage('GET'); 
try 
    [resp, req, hist] = r.send(uri); % User presses Ctrl+C 
catch ME 
    rethrow(ME); % ME contains History for the communication 
end

K>> ME 

ME = 
  HTTPException with properties: 

       Request: [1×1 matlab.net.http.RequestMessage] 
           URI: [1×1 matlab.net.URI] 
       History: [1×1 matlab.net.http.LogRecord] 
    identifier: 'MATLAB:webservices:OperationTerminatedByUser' 
       message: 'Web service operation terminated by user 
                while accessing URL '<a_customer_URI>'.' 
         cause: {[1×1 MException]} 
         stack: [5×1 struct] 
    Correction: []

uri = URI('<a_customer_URI>'); 
r = RequestMessage('GET');
[resp, req, hist] = r.send(uri); 
% User presses Ctrl+C

Operation terminated by user during 
matlab.internal.webservices.HTTPConnector/copyContentToByteArray

此外，matlab.net.http.Disposition 枚举类不再支持 Interrupt 枚举成员。以前，如果用户通过按 Ctrl+C 键中断了命令，matlab.net.http.Disposition.Interrupt 会创建一个 HTTP 历史日志记录 matlab.net.http.LogRecord。

另请参阅

LogRecord | RequestMessage | ResponseMessage | StatusCode | MessageBody

matlab.net.http.Disposition 类

描述

版本历史记录

R2024a: Ctrl+C 键停止执行 MATLAB 命令

另请参阅

WeChat