URLDownloadSubmit

URLDownloadSubmit[url, file]

提交指定的 URL，异步下载到给定的文件.

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

提交指定的 URL,，用名称 parami 和值 vali 添加元素.

URLDownloadSubmit[obj,…]

提交云对象 obj.

URLDownloadSubmit[HTTPRequest[…],…]

提交指定的 HTTP 请求.

更多信息和选项

  • 在 URLDownloadSubmit[url,…] 中，url 可以是字符串、URL 对象或云对象.
  • URLDownloadSubmit[assoc] 等价于 URLDownloadSubmit[HTTPRequest[assoc]].
  • URLDownloadSubmit 返回一个异步任务的符号表示.
  • URLDownloadSubmit 接受以下选项：
  • AuthenticationNone发送认证信息
    CharacterEncodingAutomatic请求的字符编码
    CookieFunction Automatic应用于每个收到的 cookie 的函数
    FollowRedirectsTrue是否遵循 HTTP 重定向
    HandlerFunctions<||>如何处理产生的事件
    HandlerFunctionsKeysAutomatic什么参数提供给句柄函数
    TimeConstraintInfinity等待响应的时间
    VerifySecurityCertificatesTrue是否验证 SSL 安全证书
  • TimeConstraint->t 允许最多 t 秒连接 URL 并读取之.
  • TimeConstraint-><|"Connecting"->tc,"Reading"->tr|> 分别指定连接 URL 和读取的超时.
  • 在异步执行 URLDownloadSubmit 时，可产生以下事件：
  • "ConnectionFailed"URL 连接失败
    "CookiesReceived"成功收到 cookies
    "HeadersReceived"成功收到标题
    "TaskFinished"已完成任务
    "TaskProgress"任务已取得可观的的进展
    "TaskStatusChanged"任务变换的状态
  • 当规范为 HandlerFunctions-><|…,"eventi"->fi,…|>，当产生 eventi 时会计算 fi[assoc]. assoc 的元素有由 HandlerFunctionsKeys 设置指定的键
  • 由 HandlerFunctionsKeys 指定的可能键包括：
  • "Headers"在响应中收到的标头列表
    "Cookies"在响应中收到的 cookies 列表
    "ContentType"内容类型标头
    "StatusCode"由服务器返回的状态代码
    "StatusCodeDescription"状态代码的纯文本说明
    "File"下载的内容位置
    "ByteCountDownloaded"到目前为止下载的字节数
    "ByteCountTotal"下载的字节总数
    "FractionComplete"到目前为止全部下载的比例
    "Task"由 URLDownloadSubmit 产生的任务对象
    "TaskStatus""Running"、"Suspended"、"Finished"
    "TaskType"任务类型
    "TaskUUID"唯一的任务识别器
    "EventName"被处理的事件名称
  • 还没有收到的值以 Missing["NotAvailable"] 形式给出.
  • 如果合适的标头没有出现在已下载的 URL 中， "ByteCountTotal" 和 "FractionComplete" 会被给成 Missing["NotAvailable"].
  • 当给定参数，对于值 vali，例如，数值和短字符串的简单形式，URLDownloadSubmit 会执行 GET 请求，其中 parami 指定查询字符串中的参数. 在其他情况下，它执行 POST 请求.
  • vali 可以是字符串或数字，或下列特殊格式：
  • None,Null,Missing""
    True"true"
    False"false"
    {e1,e2,…}e1, e2, …
    image默认格式的图像
    ExportForm[expr,form]以指定形式导出的任何表达式
    File["file"]文件的内容

范例

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

基本范例  (5)

发送请求，当任务完成时获取通知：

发送带有参数的请求：

获取状态代码和内容类型：

根据分量构建 URL：

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

范围  (4)

以字符串形式接收响应正文：

以字节列表形式接收响应正文：

以 ByteArray 形式接收响应正文：

当任务完成时，接收通知：

当任务状态改变时，接收 cookies、标头和任务状态：

当收到标头时，获取状态代码和说明：

当收到标头时，获取状态代码和说明：

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

选项  (1)

CookieFunction  (1)

属性和关系  (2)

完全支持 URL 和 CloudObject：

使用 URLRead 执行异步请求：

使用 URLDownloadSubmit 异步赋值变量：

Wolfram Research (2017)，URLDownloadSubmit，Wolfram 语言函数，https://reference.wolfram.com/language/ref/URLDownloadSubmit.html.

文本

Wolfram Research (2017)，URLDownloadSubmit，Wolfram 语言函数，https://reference.wolfram.com/language/ref/URLDownloadSubmit.html.

CMS

Wolfram 语言. 2017. "URLDownloadSubmit." Wolfram 语言与系统参考资料中心. Wolfram Research. https://reference.wolfram.com/language/ref/URLDownloadSubmit.html.

APA

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

BibTeX

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

BibLaTeX

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