概要
Webブラウザと同じ感覚でWebサーバに要求するための種類です。この種類ではCookieが自動的に管理され、BASIC認証/Digest認証にも対応しています。またヘッダを設定してリクエストすることもできます。
作成する方法
【名前】というウェブクライアントを作る
手順
自分で【アドレス】を【送信内容：文字列】をダウンロードする
指定したアドレスにあるファイルを保存先へダウンロードします。
自分で【アドレス】を【保存先ファイル名】へダウンロード開始する：文字列
指定したアドレスにあるファイルを保存先へダウンロードします。ダウンロードは非同期で実行されます。ダウンロードを途中でキャンセルできます。
自分で【アドレス】へ【引数:辞書】をアップロードする：文字列
指定した【アドレス】へファイルや値をアップロードします。
【引数】には、アップロードするフィールド値(値やファイル)を辞書で指定します。辞書の見出しの先頭に@を付けると、その値に指定された場所にあるファイルをアップロードします。
ファイルをアップロードする
クライアントというウェブクライアントを作る パラメータ(「@upfile」)は「image.png」 クライアントで「https://xxxxxx/upload.php」へパラメータをアップロードして内容とする 内容を報告する
自分で【アドレス】を取得する：文字列
指定した【アドレス】の内容をGET形式でサーバへ問い合わせます。
なお、ログインなど認証が必要なページでは、ログインしていない状態のページが取得される場合があります。
自分で【アドレス】へ〈【引数:辞書】を〉送信する：文字列
指定した【アドレス】に対して【引数】をフィールド値にしてPOST形式で送ります。
自分へ【ヘッダ名】という【値】をヘッダへ設定する
指定した名前と値を、ヘッダへ設定します。
自分へ【cookie:HTTPクッキー】を設定する
指定したクッキーを登録します。アドレスとパスに合致するアドレスへリクエストした時に、そのCookieが使用されます。
自分から【アドレス】でクッキーを取得する：HTTPクッキーの配列
指定したアドレスに合致する登録済みのCookieの一覧を取得します。
自分をキャンセルする
「ダウンロード開始する」手順で実行中のダウンロードを中止します。
設定項目
| 設定項目 | 型 | 説明 | |
|---|---|---|---|
| 文字コード | エンコード | ◎ | HTTP通信で文字列として使用する文字コード |
| ステータスコード | 整数 | ◎ | 最後に実行したリクエストのステータスコードを返します |
| ユーザ名 | 文字列 | ◎ | Basic認証/Digest認証で送信するユーザ名 |
| パスワード | 文字列 | ◎ | Basic認証/Digest認証で送信するパスワード |
実行される手順
| 手順名 | 説明 | 情報 |
|---|---|---|
| ダウンロードが進捗した | ダウンロードが進捗した時 | あり |
| ダウンロードが完了した | ダウンロードが完了した時 |
サンプルコード
進捗を確認しながらファイルをダウンロードする
Webクライアントを使ってファイルをダウンロードします。
クライアントというウェブクライアントを作る クライアントのダウンロードが進捗した時の手順は、ダウンロード進捗 クライアントのダウンロードが完了した時の手順は、ダウンロード完了 クライアントで「https://produ.irelang.jp/images/produire-title.gif」を「[デスクトップ]produire-title.gif」へダウンロードする ダウンロード進捗の手順 「[この時の受信バイト数]/[この時の総バイト数]([この時の割合]%)」を報告する 終わり ダウンロード完了の手順 この時のエラーメッセージが無でなければこの時のエラーメッセージを報告する 終わり