URLSubmit

URLSubmit[url]

提交指定的将被异步执行的 URL.

URLSubmit[url,{"param1"val1,"param2"val2,…}]

提交指定的 URL，添加带有名字 parami 和值 vali 的元素.

URLSubmit[obj,…]

提交云对象 obj.

URLSubmit[HTTPRequest[…],…]

提交指定的 HTTP 请求.

更多信息和选项

  • 在 URLSubmit[url] 中，url 可以是字符串、URL 对象或云对象.
  • URLSubmit[assoc] 等价于 URLSubmit[HTTPRequest[assoc]].
  • URLSubmit 返回异步任务的符号表示.
  • 对于 vali 的简单形式，如数字和短字符串，URLSubmit 执行 GET 请求，并用 parami 指定查询字符串中的参数. 其他情况下，执行 POST 请求.
  • vali 可以是字符串或数字，或是下面的特殊形式：
  • None,Null,Missing""
    True"true"
    False"false"
    {e1,e2,…}e1、e2, …
    image缺省格式的图像
    ExportForm[expr,form]以指定形式导出的任意表达式
    File["file"]文件的内容
  • URLSubmit 采用和 URLRead 一样的选项，连同： [所有选项的列表]
  • HandlerFunctions<||>怎样处理产生的事件
    HandlerFunctionsKeysAutomatic向处理函数提供什么样的参数
  • 对于 URLSubmit，选项 Interactive 的缺省设置为 False.
  • 在 URLSubmit 的异步执行过程中，有可能产生下列事件：
  • "BodyReceived"成功收到的响应主体
    "BodyChunkReceived"收到的主体块
    "ConnectionFailed"失败的 URL 连接
    "CookiesReceived"成功收到的 cookie
    "HeadersReceived"成功收到的标头
    "TaskFinished"完成的任务
    "TaskStatusChanged"任务变动状态
  • 当规范设置为 HandlerFunctions-><|…,"eventi"->fi,…|> 时，一旦生成 eventi，就对 fi[assoc] 进行计算. assoc 的元素含有由 HandlerFunctionsKeys 的设置指定的键.
  • 由 HandlerFunctionsKeys 指定的可能的键包括：
  • "Body"字符串形式的响应的主体
    "BodyByteArray"字节数组形式的响应的原始主体
    "BodyBytes"字节值列表形式的响应的原始主体
    "BodyChunk"作为字符串的主体块
    "BodyChunkByteArray"作为字节数组的主体块
    "BodyChunkBytes"作为字节值列表的主体块
    "Headers"响应中收到的标头的列表
    "Cookies"响应中收到的 cookie 的列表
    "ContentType"内容类型的标头
    "StatusCode"服务器返回的状态码
    "StatusCodeDescription"状态码的纯文本描述
    "ByteCountDownloaded"目前已经下载的字节数
    "ByteCountTotal"要下载的总字节数
    "FractionComplete"目前已经下载的比例
    "Task"由 URLSubmit 生成的任务对象
    "TaskStatus""Running"、"Suspended"、"Finished"
    "EventName"正在处理的事件的名称
  • 以 Missing["NotAvailable"] 形式给出尚未收到的值.
  • 如果正在读取的 URL 中没有合适的标头可用，用 Missing["NotAvailable"] 给出 "ByteCountTotal" 和 "FractionComplete".

    • 所有选项的列表

范例

打开所有单元关闭所有单元

基本范例  (5)

发送一个请求，并在任务完成后得到通知：

发送含有参数的请求：

获取状态码和内容类型：

利用分量构建 URL：

对于更复杂的请求，可以使用 HTTPRequest：

范围  (5)

以字符串形式接收响应的主体：

以字节列表形式接收响应的主体：

以 ByteArray 形式接收响应的主体：

收到作为字符串的响应块：

收到作为字节列表的响应块：

收到作为字节数组的响应块：

任务完成后收到通知：

任务状态改变时收到 Cookie、标头和任务状态：

收到标头时获取状态码和描述：

收到标头时获取状态码和描述：

获取不存在的资源的状态码：

选项  (1)

CookieFunction  (1)

属性和关系  (2)

完全支持 URL 和 CloudObject：

用 URLRead 执行一个同步请求：

用 URLSubmit 异步分配变量：

Wolfram Research (2016)，URLSubmit，Wolfram 语言函数，https://reference.wolfram.com/language/ref/URLSubmit.html （更新于 2017 年）.

文本

Wolfram Research (2016)，URLSubmit，Wolfram 语言函数，https://reference.wolfram.com/language/ref/URLSubmit.html （更新于 2017 年）.

CMS

Wolfram 语言. 2016. "URLSubmit." Wolfram 语言与系统参考资料中心. Wolfram Research. 最新版本 2017. https://reference.wolfram.com/language/ref/URLSubmit.html.

APA

Wolfram 语言. (2016). URLSubmit. Wolfram 语言与系统参考资料中心. 追溯自 https://reference.wolfram.com/language/ref/URLSubmit.html 年

BibTeX

@misc{reference.wolfram_2024_urlsubmit, author="Wolfram Research", title="{URLSubmit}", year="2017", howpublished="\url{https://reference.wolfram.com/language/ref/URLSubmit.html}", note=[Accessed: 25-November-2024 ]}

BibLaTeX

@online{reference.wolfram_2024_urlsubmit, organization={Wolfram Research}, title={URLSubmit}, year={2017}, url={https://reference.wolfram.com/language/ref/URLSubmit.html}, note=[Accessed: 25-November-2024 ]}