Get

Description

説明

Gets a file from a URL. When the verbose option is "on", this task displays a '.' for every 100 Kb retrieved. Any URL schema supported by the runtime is valid here, including http:, ftp: and jar:; https: is only valid if the appropriate support is added to the pre-1.4 Java runtimes.

URLよりファイルを取得します。 verbose オプションが "on" の場合、 このタスクは 100Kb 取り込む毎に '.' を表示します。 http:、ftp:、jar:など、 ランタイムがサポートする全てのURLスキーマが使用可能です。 https: は、 Java 1.4 以前のランタイムに適切にHTTPSをサポートするよう設定されている場合にのみ有効です。

This task should be preferred above the CVS task when fetching remote content. CVS is significantly slower than loading a compressed archive compared to http/ftp.

リモートコンテンツを取り込む場合には、 このタスクはCVSタスクよりも優れています。 CVSは、HTTPやFTPに比べて圧縮アーカイブをロードするのがかなり遅いです。

The usetimestamp option enables you to control downloads so that the remote file is only fetched if newer than the local copy. If there is no local copy, the download always takes place. When a file is downloaded, the timestamp of the downloaded file is set to the remote timestamp, if the JVM is Java1.2 or later. NB: This timestamp facility only works on downloads using the HTTP protocol.

usetimestamp オプションにより、 ローカルコピーよりもリモートファイルが新しい時のみダウンロードするように、 ダウンロードを制御できるようになります。 ローカルコピーが無い場合、常にダウンロードは行われます。 JVM が Java 1.2 以降の場合、 あるファイルがダウンロードがされた時、 ダウンロードしたファイルのタイムスタンプはリモートファイルのタイムスタンプが設定されます。 注意: このタイムスタンプ機能は HTTP プロトコルを用いてダウンロードした場合にのみ動作します。

A username and password can be specified, in which case basic 'slightly encoded plain text' authentication is used. This is only a secure authentication mechanism over an HTTPS link.

BASIC 'わずかにエンコードされたプレーンテキスト' 認証が使われた場合、 ユーザ名とパスワードを指定可能です。 これは、HTTPS で接続されている場合にのみ安全な認証メカニズムです。

Parameters

パラメータ

Attribute Description Required
src the URL from which to retrieve a file. Yes
dest the file where to store the retrieved file. Yes
verbose show verbose progress information ("on"/"off"). No; default "false"
ignoreerrors Log errors but don't treat as fatal. No; default "false"
usetimestamp conditionally download a file based on the timestamp of the local copy. HTTP only No; default "false"
username username for 'BASIC' http authentication if password is set
password password: required if username is set
属性 説明 必須
src 取得するファイルのURL Yes
dest 取得したファイルを保存先のファイル Yes
verbose 取得状況の詳細なメッセージを表示します。 ("on"/"off") No; デフォルトは "false"
ignoreerrors エラー時にログは取るが致命的として扱わない No; デフォルト "false"
usetimestamp ローカルコピーのタイムスタンプに基き条件付きでダウンロードする。 HTTP のみ No; デフォルト "false"
username HTTP BASIC 認証のユーザ名 password が設定された場合
password 必要となるパスワード username が設定された場合

Examples

  <get src="http://jakarta.apache.org/" dest="help/index.html"/>

Gets the index page of http://jakarta.apache.org/, and stores it in the file help/index.html.

http://jakarta.apache.org/ のインデックスページを取得し、 help/index.htmlのファイルに保存します。

  <get src="http://jakarta.apache.org/builds/tomcat/nightly/ant.zip" 
    dest="optional.jar" 
    verbose="true"
    usetimestamp="true"/>

Gets the nightly ant build from the tomcat distribution, if the local copy is missing or out of date. Uses the verbose option for progress information.

ローカルコピーが無いか、古い場合、 Tomcat ディストリビューションよりナイト Ant ビルドを取得します。 取得状況のために verbose オプションを使います。

  <get src="https://insecure-bank.org/statement/user=1214" 
    dest="statement.html" 
    username="1214";
    password="secret" />

Fetches some file from a server with access control. Because https is being used the fact that basic auth sends passwords in plaintext is moot.

アクセス制限のあるサーバーからファイルを取得します。 HTTPS が使われているので、 ベーシック認証がプレーンテキストでパスワードを送るという事は、 議論の余地があります。


Copyright © 2000-2002 Apache Software Foundation. All rights Reserved.

[訳注:これは漆島賢二が翻訳しました。日本語訳に対するコメントがあれば report@jajakarta.orgに送ってください]