Java プラットフォーム 1.2

java.net
クラス HttpURLConnection

java.lang.Object
  |
  +--java.net.URLConnection
        |
        +--java.net.HttpURLConnection
public abstract class HttpURLConnection
extends URLConnection

HTTP 特有の機能をサポートする URLConnection です。詳細は、「HTTP - Hypertext Transfer Protocol」を参照してください。

導入されたバージョン:
JDK1.1

フィールドの概要
static int HTTP_ACCEPTED
           
static int HTTP_BAD_GATEWAY
           
static int HTTP_BAD_METHOD
           
static int HTTP_BAD_REQUEST
          400 番台: クライアントエラーです。
static int HTTP_CLIENT_TIMEOUT
           
static int HTTP_CONFLICT
           
static int HTTP_CREATED
           
static int HTTP_ENTITY_TOO_LARGE
           
static int HTTP_FORBIDDEN
           
static int HTTP_GATEWAY_TIMEOUT
           
static int HTTP_GONE
           
static int HTTP_INTERNAL_ERROR
           
static int HTTP_LENGTH_REQUIRED
           
static int HTTP_MOVED_PERM
           
static int HTTP_MOVED_TEMP
           
static int HTTP_MULT_CHOICE
          300 番台: リロケーションまたはリダイレクトです。
static int HTTP_NO_CONTENT
           
static int HTTP_NOT_ACCEPTABLE
           
static int HTTP_NOT_AUTHORITATIVE
           
static int HTTP_NOT_FOUND
           
static int HTTP_NOT_MODIFIED
           
static int HTTP_OK
          200 番台: 通常は「OK」です。
static int HTTP_PARTIAL
           
static int HTTP_PAYMENT_REQUIRED
           
static int HTTP_PRECON_FAILED
           
static int HTTP_PROXY_AUTH
           
static int HTTP_REQ_TOO_LONG
           
static int HTTP_RESET
           
static int HTTP_SEE_OTHER
           
static int HTTP_SERVER_ERROR
          500 番台: サーバエラーです。
static int HTTP_UNAUTHORIZED
           
static int HTTP_UNAVAILABLE
           
static int HTTP_UNSUPPORTED_TYPE
           
static int HTTP_USE_PROXY
           
static int HTTP_VERSION
           
protected  String method
           
protected  int responseCode
           
protected  String responseMessage
           
 
クラス java.net.URLConnection から継承したフィールド
allowUserInteraction, connected, doInput, doOutput, ifModifiedSince, url, useCaches
 
コンストラクタの概要
protected HttpURLConnection(URL u)
          URLStreamHandler のためのコンストラクタです。
 
メソッドの概要
abstract  void disconnect()
          サーバへの接続を閉じます。
 InputStream getErrorStream()
          接続には失敗してもサーバが有効なデータを送ってきた場合に、エラーストリームを返します。
static boolean getFollowRedirects()
           
 Permission getPermission()
           
 String getRequestMethod()
          要求メソッドを取得します。
 int getResponseCode()
          次のような応答から HTTP 応答ステータスを取得します。
 String getResponseMessage()
          サーバからの応答コードに HTTP 応答メッセージが含まれている場合、これを返します。
static void setFollowRedirects(boolean set)
          このクラスが、HTTP リダイレクト (応答コード 300 番台の要求) に自動的に従うかどうかを設定します。
 void setRequestMethod(String method)
          URL 要求のメソッドを次のどれかに設定します。
abstract  boolean usingProxy()
          接続でプロキシを使用するかどうかを表します。
 
クラス java.net.URLConnection から継承したメソッド
connect, getAllowUserInteraction, getContent, getContentEncoding, getContentLength, getContentType, getDate, getDefaultAllowUserInteraction, getDefaultRequestProperty, getDefaultUseCaches, getDoInput, getDoOutput, getExpiration, getFileNameMap, getHeaderField, getHeaderField, getHeaderFieldDate, getHeaderFieldInt, getHeaderFieldKey, getIfModifiedSince, getInputStream, getLastModified, getOutputStream, getRequestProperty, getURL, getUseCaches, guessContentTypeFromName, guessContentTypeFromStream, setAllowUserInteraction, setContentHandlerFactory, setDefaultAllowUserInteraction, setDefaultRequestProperty, setDefaultUseCaches, setDoInput, setDoOutput, setFileNameMap, setIfModifiedSince, setRequestProperty, setUseCaches, toString
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

フィールドの詳細

method

protected String method

responseCode

protected int responseCode

responseMessage

protected String responseMessage

HTTP_OK

public static final int HTTP_OK
200 番台: 通常は「OK」です。

HTTP_CREATED

public static final int HTTP_CREATED

HTTP_ACCEPTED

public static final int HTTP_ACCEPTED

HTTP_NOT_AUTHORITATIVE

public static final int HTTP_NOT_AUTHORITATIVE

HTTP_NO_CONTENT

public static final int HTTP_NO_CONTENT

HTTP_RESET

public static final int HTTP_RESET

HTTP_PARTIAL

public static final int HTTP_PARTIAL

HTTP_MULT_CHOICE

public static final int HTTP_MULT_CHOICE
300 番台: リロケーションまたはリダイレクトです。

HTTP_MOVED_PERM

public static final int HTTP_MOVED_PERM

HTTP_MOVED_TEMP

public static final int HTTP_MOVED_TEMP

HTTP_SEE_OTHER

public static final int HTTP_SEE_OTHER

HTTP_NOT_MODIFIED

public static final int HTTP_NOT_MODIFIED

HTTP_USE_PROXY

public static final int HTTP_USE_PROXY

HTTP_BAD_REQUEST

public static final int HTTP_BAD_REQUEST
400 番台: クライアントエラーです。

HTTP_UNAUTHORIZED

public static final int HTTP_UNAUTHORIZED

HTTP_PAYMENT_REQUIRED

public static final int HTTP_PAYMENT_REQUIRED

HTTP_FORBIDDEN

public static final int HTTP_FORBIDDEN

HTTP_NOT_FOUND

public static final int HTTP_NOT_FOUND

HTTP_BAD_METHOD

public static final int HTTP_BAD_METHOD

HTTP_NOT_ACCEPTABLE

public static final int HTTP_NOT_ACCEPTABLE

HTTP_PROXY_AUTH

public static final int HTTP_PROXY_AUTH

HTTP_CLIENT_TIMEOUT

public static final int HTTP_CLIENT_TIMEOUT

HTTP_CONFLICT

public static final int HTTP_CONFLICT

HTTP_GONE

public static final int HTTP_GONE

HTTP_LENGTH_REQUIRED

public static final int HTTP_LENGTH_REQUIRED

HTTP_PRECON_FAILED

public static final int HTTP_PRECON_FAILED

HTTP_ENTITY_TOO_LARGE

public static final int HTTP_ENTITY_TOO_LARGE

HTTP_REQ_TOO_LONG

public static final int HTTP_REQ_TOO_LONG

HTTP_UNSUPPORTED_TYPE

public static final int HTTP_UNSUPPORTED_TYPE

HTTP_SERVER_ERROR

public static final int HTTP_SERVER_ERROR
500 番台: サーバエラーです。

HTTP_INTERNAL_ERROR

public static final int HTTP_INTERNAL_ERROR

HTTP_BAD_GATEWAY

public static final int HTTP_BAD_GATEWAY

HTTP_UNAVAILABLE

public static final int HTTP_UNAVAILABLE

HTTP_GATEWAY_TIMEOUT

public static final int HTTP_GATEWAY_TIMEOUT

HTTP_VERSION

public static final int HTTP_VERSION
コンストラクタの詳細

HttpURLConnection

protected HttpURLConnection(URL u)
URLStreamHandler のためのコンストラクタです。
メソッドの詳細

setFollowRedirects

public static void setFollowRedirects(boolean set)
このクラスが、HTTP リダイレクト (応答コード 300 番台の要求) に自動的に従うかどうかを設定します。デフォルトでは true です。アプレットは、この変数を変更できません。

セキュリティマネージャが存在する場合、このメソッドはまずセキュリティマネージャの checkSetFactory メソッドを呼び出すことにより、この操作が許可されていることを確認します。このメソッドの結果、SecurityException になることがあります。

例外:
SecurityException - セキュリティマネージャが存在し、セキュリティマネージャの checkSetFactory メソッドがこの操作を許可しない場合
関連項目:
SecurityManager.checkSetFactory()

getFollowRedirects

public static boolean getFollowRedirects()

setRequestMethod

public void setRequestMethod(String method)
                      throws ProtocolException
URL 要求のメソッドを次のどれかに設定します。 これらのメソッドのうち、どれが有効であるかはプロトコルの制限によって決まります。デフォルトのメソッドは GET です。
例外:
ProtocolException - メソッドをリセットできない場合、または要求したメソッドが HTTP で無効である場合

getRequestMethod

public String getRequestMethod()
要求メソッドを取得します。

getResponseCode

public int getResponseCode()
                    throws IOException
次のような応答から HTTP 応答ステータスを取得します。 
 HTTP/1.0 200 OK
 HTTP/1.0 401 Unauthorized
前述の応答からは整数 200 と 401 をそれぞれ取り出します。応答が識別できない (有効な HTTP でない) 場合は -1 を返します。
例外:
IOException - サーバへの接続でエラーが発生した場合

getResponseMessage

public String getResponseMessage()
                          throws IOException
サーバからの応答コードに HTTP 応答メッセージが含まれている場合、これを返します。応答コードの例を次に示します。 
 HTTP/1.0 200 OK
 HTTP/1.0 404 Not Found
「OK」と「Not Found」の部分の文字列をそれぞれ取り出します。応答コードが識別できない (有効な HTTP でない) 場合は null を返します。
例外:
IOException - サーバへの接続でエラーが発生した場合

disconnect

public abstract void disconnect()
サーバへの接続を閉じます。

usingProxy

public abstract boolean usingProxy()
接続でプロキシを使用するかどうかを表します。

getPermission

public Permission getPermission()
                         throws IOException
オーバーライド:
クラス URLConnection 内の getPermission

getErrorStream

public InputStream getErrorStream()
接続には失敗してもサーバが有効なデータを送ってきた場合に、エラーストリームを返します。よくある例は、HTTP サーバがコード 404 で応答したときに、接続に対しては FileNotFoundException がスローされたものの、サーバから対処策を指示する HTML ヘルプページが送信される場合です。

このメソッドは、接続を開始しません。接続が確立されていない場合、接続中にサーバでエラーが発生しなかった場合、あるいはサーバでエラーが発生してもエラーのデータが送られなかった場合には、このメソッドは null を返します。これがデフォルトの動作です。

戻り値:
エラーストリーム。エラーがなかった場合、接続が確立されていない場合、あるいはサーバから有効なデータが送られなかった場合は null
Java プラットフォーム 1.2
バグや機能要求の報告
新しい javadoc の表示についてのコメントやご提案
Java は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-1998 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.