|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object java.net.Authenticator
public abstract class Authenticator
Authenticator クラスは、ネットワーク接続に必要な認証を取得するためのオブジェクトを表します。通常は、ユーザに情報の入力を求めることにより、認証を行います。
アプリケーションは、サブクラスで getPasswordAuthentication()
をオーバーライドすることでこのクラスを使用します。このメソッドは、通常、さまざまな getXXX() アクセス用メソッドを使用して、認証を要求しているエンティティに関する情報を取得します。次に、ユーザとの対話、またはその他の対話以外の方法で、ユーザ名とパスワードを取得する必要があります。その後、PasswordAuthentication
の戻り値として、資格が返されます。
次に、setDefault(Authenticator)
を呼び出すことで、この具象サブクラスのインスタンスがシステムに登録されます。認証が必要な場合、システムは requestPasswordAuthentication() メソッドの 1 つを呼び出し、これが登録されたオブジェクトの getPasswordAuthentication() メソッドを呼び出します。
認証を要求するメソッドはすべて、失敗に終わるデフォルト実装を持っています。
setDefault(java.net.Authenticator)
,
getPasswordAuthentication()
入れ子のクラスの概要 | |
---|---|
static class |
Authenticator.RequestorType
認証を要求しているエンティティのタイプ |
コンストラクタの概要 | |
---|---|
Authenticator()
|
メソッドの概要 | |
---|---|
protected PasswordAuthentication |
getPasswordAuthentication()
パスワード認証が必要な場合に呼び出されます。 |
protected String |
getRequestingHost()
認証を要求しているサイトまたはプロキシの hostname を取得します。 |
protected int |
getRequestingPort()
要求された接続に使うポート番号を取得します。 |
protected String |
getRequestingPrompt()
要求者が入力したプロンプト文字列を取得します。 |
protected String |
getRequestingProtocol()
接続を要求しているプロトコルを返します。 |
protected String |
getRequestingScheme()
要求者が使用している方式 (たとえば、HTTP ファイアウォールの場合は HTTP 方式) |
protected InetAddress |
getRequestingSite()
許可を要求しているサイトの InetAddress を取得します。 |
protected URL |
getRequestingURL()
この認証要求の結果である URL を返します。 |
protected Authenticator.RequestorType |
getRequestorType()
要求者がプロキシかサーバかを返します。 |
static PasswordAuthentication |
requestPasswordAuthentication(InetAddress addr,
int port,
String protocol,
String prompt,
String scheme)
システムに登録されているオーセンティケータに、パスワードを要求します。 |
static PasswordAuthentication |
requestPasswordAuthentication(String host,
InetAddress addr,
int port,
String protocol,
String prompt,
String scheme)
システムに登録されているオーセンティケータにパスワードを要求します。 |
static PasswordAuthentication |
requestPasswordAuthentication(String host,
InetAddress addr,
int port,
String protocol,
String prompt,
String scheme,
URL url,
Authenticator.RequestorType reqType)
システムに登録されているオーセンティケータに、パスワードを要求します。 |
static void |
setDefault(Authenticator a)
オーセンティケータを設定します。 |
クラス java.lang.Object から継承されたメソッド |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
コンストラクタの詳細 |
---|
public Authenticator()
メソッドの詳細 |
---|
public static void setDefault(Authenticator a)
セキュリティマネージャが存在する場合、最初にセキュリティマネージャの checkPermission
メソッドが、アクセス権 NetPermission("setDefaultAuthenticator")
を指定して呼び出されます。この結果、java.lang.SecurityException になることがあります。
a
- 設定されるオーセンティケータ。null
の場合、以前に設定されたオーセンティケータはすべて削除される
SecurityException
- セキュリティマネージャが存在し、セキュリティマネージャの checkPermission
メソッドが、デフォルトのオーセンティケータを設定することを許可しない場合SecurityManager.checkPermission(java.security.Permission)
,
NetPermission
public static PasswordAuthentication requestPasswordAuthentication(InetAddress addr, int port, String protocol, String prompt, String scheme)
セキュリティマネージャが存在する場合、最初にセキュリティマネージャの checkPermission
メソッドが、アクセス権 NetPermission("requestPasswordAuthentication")
を指定して呼び出されます。この結果、java.lang.SecurityException になることがあります。
addr
- 許可を要求しているサイトの InetAddress。InetAddress が不明の場合は nullport
- 要求された接続に使うポート番号protocol
- 接続を要求しているプロトコル (getRequestingProtocol()
)prompt
- ユーザに表示されるプロンプト文字列scheme
- 認証方式
SecurityException
- セキュリティマネージャが存在し、セキュリティマネージャの checkPermission
メソッドが、パスワード認証要求を許可しない場合SecurityManager.checkPermission(java.security.Permission)
,
NetPermission
public static PasswordAuthentication requestPasswordAuthentication(String host, InetAddress addr, int port, String protocol, String prompt, String scheme)
セキュリティマネージャが存在する場合、最初にセキュリティマネージャの checkPermission
メソッドが、アクセス権 NetPermission("requestPasswordAuthentication")
を指定して呼び出されます。この結果、java.lang.SecurityException になることがあります。
host
- 認証を要求しているサイトのホスト名addr
- 認証を要求しているサイトの InetAddress。InetAddress が不明の場合は nullport
- 要求された接続に使うポート番号protocol
- 接続を要求しているプロトコル (getRequestingProtocol()
)prompt
- 認証領域を識別する、ユーザに表示されるプロンプト文字列scheme
- 認証方式
SecurityException
- セキュリティマネージャが存在し、セキュリティマネージャの checkPermission
メソッドが、パスワード認証要求を許可しない場合SecurityManager.checkPermission(java.security.Permission)
,
NetPermission
public static PasswordAuthentication requestPasswordAuthentication(String host, InetAddress addr, int port, String protocol, String prompt, String scheme, URL url, Authenticator.RequestorType reqType)
セキュリティマネージャが存在する場合、最初にセキュリティマネージャの checkPermission
メソッドが、アクセス権 NetPermission("requestPasswordAuthentication")
を指定して呼び出されます。この結果、java.lang.SecurityException になることがあります。
host
- 認証を要求しているサイトのホスト名addr
- 許可を要求しているサイトの InetAddress。InetAddress が不明の場合は nullport
- 要求された接続に使うポート番号protocol
- 接続を要求しているプロトコル (getRequestingProtocol()
)prompt
- ユーザに表示されるプロンプト文字列scheme
- 認証方式url
- 認証を発生させた要求元の URLreqType
- 認証を要求しているエンティティのタイプ (サーバまたはプロキシ)
SecurityException
- セキュリティマネージャが存在し、セキュリティマネージャの checkPermission
メソッドが、パスワード認証要求を許可しない場合SecurityManager.checkPermission(java.security.Permission)
,
NetPermission
protected final String getRequestingHost()
hostname
を取得します。hostname が使用できない場合は null
が返されます。
protected final InetAddress getRequestingSite()
InetAddress
を取得します。InetAddress が使用できない場合は null
が返されます。
protected final int getRequestingPort()
int
protected final String getRequestingProtocol()
URL.getProtocol()
protected final String getRequestingPrompt()
protected final String getRequestingScheme()
protected PasswordAuthentication getPasswordAuthentication()
protected URL getRequestingURL()
protected Authenticator.RequestorType getRequestorType()
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。