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受信した各クッキーに適用する関数
    FollowRedirectsTrueHTTPリダイレクトを追跡するかどうか
    HandlerFunctions<||>生成されたイベントをどのように扱うか
    HandlerFunctionsKeysAutomaticハンドラ関数に渡すパラメータ
    TimeConstraintInfinity応答を待つ時間
    VerifySecurityCertificatesTrueSSLセキュリティ証明を検証するかどうか
  • TimeConstraint->t のときは，URLへの接続とそこからの読取りに最大 t 秒が許容される．
  • TimeConstraint-><|"Connecting"->tc,"Reading"->tr|>は，URLへの接続とそこからの読取りに別々の制限時間を指定する．
  • URLDownloadSubmitの非同期実行の間に，次のイベントを生成することができる．
  • "ConnectionFailed"URL接続の失敗
    "CookiesReceived"クッキーの成功裏の受信
    "HeadersReceived"ヘッダの成功裏の受信
    "TaskFinished"タスクの終了
    "TaskProgress"タスクの目に見える進捗
    "TaskStatusChanged"タスクのステータスの変更
  • HandlerFunctions-><|…,"eventi"->fi,…|>と指定すると，eventiが生成されるたびに fi[assoc]が評価される．assoc の要素はHandlerFunctionsKeysの設定で指定されたキーを持つ．
  • 次は，HandlerFunctionsKeysが指定可能なキーである．
  • "Headers"応答で受信したヘッダのリスト
    "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はクエリ文字列のパラメータを指定する paramiでGETリクエストを実行する．その他の場合はPOSTリクエストを実行する．
  • valiは，文字列または数でよく，次の特殊形式を使うこともできる．
  • None,Null,Missing""
    True"true"
    False"false"
    {e1,e2,…}e1, e2, …
    imageデフォルト形式の画像
    ExportForm[expr,form]指定の形式でエキスポートされた任意の式
    File["file"]ファイルのコンテンツ

例題

すべて開くすべて閉じる

例  (5)

リクエストを送信し，タスクの終了時に通知を受ける：

リクエストにパラメータを添えて送信する：

ステータスコードとコンテンツタイプを得る：

成分からURLを構築する：

より複雑なリクエストにはHTTPRequestを使うことができる：

スコープ  (4)

応答の本体を文字列として受け取る：

応答の本体をバイトリストとして受け取る：

応答の本体をByteArrayとして受け取る：

タスクの終了時に通知を受ける：

タスクのステータスが変わったときに，クッキー，ヘッダ，タスクのステータスを受け取る：

ヘッダの受信時に，ステータスコードと説明を得る：

ヘッダの受信時に，ステータスコードと説明を得る：

存在しないリソースのステータスコードを得る：

オプション  (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 Language. 2017. "URLDownloadSubmit." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/URLDownloadSubmit.html.

APA

Wolfram Language. (2017). URLDownloadSubmit. Wolfram Language & System Documentation Center. Retrieved from 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: 22-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: 22-November-2024 ]}