全パッケージ  クラス階層  このパッケージ  前項目  次項目  インデックス

クラス java.net.URLConnection

java.lang.Object
   |
   +----java.net.URLConnection

public class URLConnection

extends Object

allowUserInteraction

connected

doInput

doOutput

ifModifiedSince

url

useCaches

URLConnection(URL)

指定された URL への URLConnection を作成する。

connect()

URLConnection オブジェクトは、２つの段階を経る。

getAllowUserInteraction()

allowUserInteraction フラグの値を得る。

getContent()

URL で参照されるオブジェクトを得る。

getContentEncoding()

情報のコード化方式 (content-encoding) を得る。

getContentLength()

情報の長さ (content-length) を得る。

getContentType()

情報の種類 (content-type) を得る。

getDate()

オブジェクトの送信日時を得る。

getDefaultAllowUserInteraction()

defaultAllowUserInteraction フラグのデフォルト値を得る。

getDefaultRequestProperty(String)

接続要求に関する一般的なプロパティのデフォルト値を得る。

getDefaultUseCaches()

useCaches フラグのデフォルト値を得る。

getDoInput()

doInput フラグの値を得る。

getDoOutput()

doOutput フラグの値を得る。

getExpiration()

オブジェクトの有効期限 (expires) を得る。

getHeaderField(String)

指定された name のヘッダフィールドを得る。

getHeaderField(int)

n 番目のヘッダフィールドの値を返す。

getHeaderFieldDate(String, long)

指定された name のヘッダフィールドを得る。

getHeaderFieldInt(String, int)

指定された name のヘッダフィールドを得る。

getHeaderFieldKey(int)

n 番目のヘッダフィールドのフィールド名を返す。

getIfModifiedSince()

更新の基準となる日時を得る。

getInputStream()

オブジェクトを読む InputStream を得る。

getLastModified()

オブジェクトの最終更新日時を得る。

getOutputStream()

オブジェクトに書く OutputStream を得る。

getRequestProperty(String)

接続要求に関する一般的なプロパティを得る。

getURL()

接続している URL を得る。

getUseCaches()

useCaches フラグの値を得る。

guessContentTypeFromName(String)

オブジェクトの種類 (content-type) をその拡張子から決めるユーティリティ関数。

guessContentTypeFromStream(InputStream)

このメソッドはファイルを検査してファイルの種類を判定するために使用される。

setAllowUserInteraction(boolean)

URL 接続は、プロトコルによっては、ユーザとの対話が必要になることがある。

setContentHandlerFactory(ContentHandlerFactory)

ContentHandler のファクトリを設定する。

setDefaultAllowUserInteraction(boolean)

allowUserInteraction フラグのデフォルト値を設定する。

setDefaultRequestProperty(String, String)

接続要求に関する一般的なプロパティのデフォルト値を設定する。

setDefaultUseCaches(boolean)

useCaches フラグのデフォルト値を設定する。

setDoInput(boolean)

URL 接続は、入力と出力を同時にもしくはどちらかを使うことができる。

setDoOutput(boolean)

URL 接続は、入力と出力を同時にもしくはどちらかを使うことができる。

setIfModifiedSince(long)

プロトコルによっては、情報がある日時から更新されたときのみ 転送する機能をサポートしている。

setRequestProperty(String, String)

接続要求に関する一般的なプロパティを設定する。

setUseCaches(boolean)

プロトコルによっては、情報をキャッシュすることがある。

toString()

URL 接続の文字列表現を返す。

  protected URL url

  protected boolean doInput

  protected boolean doOutput

  protected boolean allowUserInteraction

  protected boolean useCaches

  protected long ifModifiedSince

  protected boolean connected

  protected URLConnection(URL url)

指定された URL への URLConnection を作成する。

パラメータ:

url - 接続先の URL

  public abstract void connect() throws IOException

URLConnection オブジェクトは、２つの段階を経る。 まずオブジェクトが作られ、それから接続が行われる。 オブジェクトが作られてから接続されるまでの間、doInput や useCaches のような様々はオプションを設定することができる。 接続後は、オプションの設定はエラーとなる。 getContentLength のような接続している時に行う操作は、必要ならば 暗黙に接続を行う。すでに接続しているときには接続しない。

  public URL getURL()

接続している URL を得る。

  public int getContentLength()

情報の長さ (content-length) を得る。不明のときは -1 。

  public String getContentType()

情報の種類 (content-type) を得る。不明のときは null を返す。

  public String getContentEncoding()

情報のコード化方式 (content-encoding) を得る。不明のときは null を返す。

  public long getExpiration()

オブジェクトの有効期限 (expires) を得る。不明のときは 0 を返す。

  public long getDate()

オブジェクトの送信日時を得る。不明のときは 0 を返す。

  public long getLastModified()

オブジェクトの最終更新日時を得る。不明のときは 0 を返す。

  public String getHeaderField(String name)

指定された name のヘッダフィールドを得る。不明のときは null を返す。

パラメータ:

name - ヘッダフィールドの名前

  public int getHeaderFieldInt(String name,
                               int Default)

指定された name のヘッダフィールドを得る。不明のときは Default を返す。 フィールドは整数として解釈される。 getHeaderField の形式は、いくつかの接続の種類（例えば、htt-ng）が あらかじめ解析してあるヘッダを持っているために存在する。 このメソッドをオーバーライドして解析を効率よくすることができる。

パラメータ:

name - ヘッダフィールドの名前

Default - フィールドが見付からないか書式が不正なときに返る値

  public long getHeaderFieldDate(String name,
                                 long Default)

指定された name のヘッダフィールドを得る。不明のときは Default を返す。 フィールドは日付として解釈される。 getHeaderField の形式は、いくつかの接続の種類（例えば、htt-ng）が あらかじめ解析してあるヘッダを持っているために存在する。 このメソッドをオーバーライドして解析を効率よくすることができる。

パラメータ:

name - ヘッダフィールドの名前

Default - フィールドが見付からないか書式が不正なときに返る値

  public String getHeaderFieldKey(int n)

n 番目のヘッダフィールドのフィールド名を返す。 フィールドが n 個より少ないときは null を返す。 このメソッドは、メッセージ中のすべてのヘッダを繰り返し処理するときに使う ことができる。

  public String getHeaderField(int n)

n 番目のヘッダフィールドの値を返す。 フィールドが n 個より少ないときは null を返す。 このメソッドは、getHeaderFieldKey メソッドと組み合わせて メッセージ中のすべてのヘッダを繰り返し処理するときに使うことができる。

  public Object getContent() throws IOException

URL で参照されるオブジェクトを得る。 例えば URL がイメージを参照している場合、返り値のオブジェクトは Image の サブクラスである。 どの種類のオブジェクトが返されたのかを判別するには、instanceof 演算子を用いる。

返り値:

転送されたオブジェクト

例外: UnknownServiceException

プロトコルがこのオブジェクトをサポートしていない

  public InputStream getInputStream() throws IOException

オブジェクトを読む InputStream を得る。 プロトコルの実装者は、適切ならばこのメソッドを使うべきである。

例外: UnknownServiceException

プロトコルが入力をサポートしていない

  public OutputStream getOutputStream() throws IOException

オブジェクトに書く OutputStream を得る。 プロトコルの実装者は、適切ならばこのメソッドを使うべきである。

例外: UnknownServiceException

プロトコルが出力をサポートしていない

  public String toString()

URL 接続の文字列表現を返す。

オーバーライド:

クラス Object の toString

  public void setDoInput(boolean doinput)

URL 接続は、入力と出力を同時にもしくはどちらかを使うことができる。 入力に使う場合は、doInput フラグを true に設定し、そうでなければ false に設定する。 doOutput フラグが明に true に設定されてる場合、 doInput フラグは false であり、 そうでないときは doInput フラグは true である。

  public boolean getDoInput()

doInput フラグの値を得る。

  public void setDoOutput(boolean dooutput)

URL 接続は、入力と出力を同時にもしくはどちらかを使うことができる。 出力に使う場合は、 doOutput フラグを true に設定し、そうでなければ false に設定する。デフォルトは false である。

  public boolean getDoOutput()

doOutput フラグの値を得る。

  public void setAllowUserInteraction(boolean allowuserinteraction)

URL 接続は、プロトコルによっては、ユーザとの対話が必要になることがある。 例えば、HTTP は認証のためのダイアログを表示することがある。 しかしこのような対話は、ユーザがその場にいて アプリケーションを動かしているときのみ意味がある。 allowUserInteraction フラグが true のとき、ユーザとの対話を許可する。 false のときは対話は許されず、例外が起こる。 フラグの値は setAllowUserInteraction メソッドで設定することができる。 デフォルトは false である。

  public boolean getAllowUserInteraction()

allowUserInteraction フラグの値を得る。

  public static void setDefaultAllowUserInteraction(boolean defaultallowuserinteraction)

allowUserInteraction フラグのデフォルト値を設定する。 デフォルトは "sticky" である。つまり、すべての URLConnection の静的な状態の一部であるということである。 このフラグは、設定したあとに作られるすべての URLConnection オブジェクトに適用される。

  public static boolean getDefaultAllowUserInteraction()

defaultAllowUserInteraction フラグのデフォルト値を得る。

  public void setUseCaches(boolean usecaches)

プロトコルによっては、情報をキャッシュすることがある。 キャッシュを無視して情報を必ず転送することが必要になることがある （例えば、ブラウザの "reload" ボタンなど）。 userCaches フラグが true のときは、この URLConnection では可能ならキャッシュを使用する。false のときは キャッシュを無視する。 デフォルト値は DefaultUseCache により設定され、これは true である。

  public boolean getUseCaches()

useCaches フラグの値を得る。

  public void setIfModifiedSince(long ifmodifiedsince)

プロトコルによっては、情報がある日時から更新されたときのみ 転送する機能をサポートしている。このメソッドでその日時を設定する。

  public long getIfModifiedSince()

更新の基準となる日時を得る。

  public boolean getDefaultUseCaches()

useCaches フラグのデフォルト値を得る。 この値は "sticky" である。つまり、すべての URLConnection の静的な状態の一部であるということである。 このフラグは、設定したあとに作られるすべての URLConnection オブジェクトに適用される。

  public void setDefaultUseCaches(boolean defaultusecaches)

useCaches フラグのデフォルト値を設定する。

  public void setRequestProperty(String key,
                                 String value)

接続要求に関する一般的なプロパティを設定する。

パラメータ:

key - 要求のためのキーワード ("accept" のような)

value - 関連付ける値

  public String getRequestProperty(String key)

接続要求に関する一般的なプロパティを得る。

パラメータ:

key - 要求のためのキーワード ("accept" のような)

  public static void setDefaultRequestProperty(String key,
                                               String value)

接続要求に関する一般的なプロパティのデフォルト値を設定する。 URLConnection オブジェクトが作られたときに ここで設定したプロパティを持つように初期化される。

パラメータ:

key - 要求のためのキーワード ("accept" のような)

value - 関連付ける値

  public static String getDefaultRequestProperty(String key)

接続要求に関する一般的なプロパティのデフォルト値を得る。

パラメータ:

key - 要求のためのキーワード ("accept" のような)

  public static synchronized void setContentHandlerFactory(ContentHandlerFactory fac)

ContentHandler のファクトリを設定する。

パラメータ:

fac - 設定したいファクトリ

例外: Error

すでにファクトリが設定されている。

  protected static String guessContentTypeFromName(String fname)

オブジェクトの種類 (content-type) をその拡張子から決めるユーティリティ関数。

  protected static String guessContentTypeFromStream(InputStream is) throws IOException

このメソッドはファイルを検査してファイルの種類を判定するために使用される。 ファイルの最初の数バイトを簡単に検査する。 理想的な状態ではこのルーチンは必要ないが、現実には情報の種類や 拡張子が標準だと嘘をつく HTTP サーバがある。 データそのものを検査することは、システムをより堅牢にする。 ストリームはマークをサポートしていなければならない (BufferedInputStream など)。

全パッケージ  クラス階層  このパッケージ  前項目  次項目  インデックス