Referenz: javax.security.auth.login.LoginContext

Weitere aktuelle Java-Titel finden Sie bei dpunkt.

Klasse javax.security.auth.login.LoginContext

1.4

java.lang.Object
   |
   +--javax.security.auth.login.LoginContext

Deklaration

public class LoginContext extends java.lang.Object

Beschreibung

Diese Klasse stellt einen Kontext dar, auf den sich Login-Vorgänge beziehen. Zu einem Kontext gehört ein Subject, ein Modul-Konfigurationseintrag sowie ein CallbackHandler, der von den Modulen angeforderte Benutzerinteraktionen durchführt.

Konstruktoren
public	LoginContext(String name)
public	LoginContext(String name, CallbackHandler callbackHandler)
public	LoginContext(String name, Subject subject)
public	LoginContext(String name, Subject subject, CallbackHandler callbackHandler)

Methoden
public Subject	getSubject()
public void	login()
public void	logout()

Konstruktoren im Detail

public LoginContext(String name)

Erzeugt einen neuen Kontext für die durch name bezeichnete Modulkonfiguration. Falls es keinen Eintrag mit diesem Namen gibt, wird der Eintrag mit dem Namen "other" verwendet. Es wird ein neues Subject-Exemplar erzeugt und ein voreingesteller CallbackHandler benutzt.

Exception: LoginException

Falls es weder einen Eintrag mit diesem Namen gibt noch ein Eintrag other existiert.
Falls der voreingestellte CallbackHandler nicht geladen werden konnte.

public LoginContext(String name, CallbackHandler callbackHandler)

Erzeugt einen neuen Kontext für die durch name bezeichnete Modulkonfiguration. Falls es keinen Eintrag mit diesem Namen gibt, wird der Eintrag other verwendet. Es wird ein neues Subject-Exemplar erzeugt und der übergebene callbackHandler für Benutzerinteraktionen benutzt.

Exception: LoginException

Falls es weder einen Eintrag mit diesem Namen gibt noch ein Eintrag other existiert.
Falls callbackHandler null ist.

public LoginContext(String name, Subject subject)

Erzeugt einen neuen Kontext für die durch name bezeichnete Modulkonfiguration. Falls es keinen Eintrag mit diesem Namen gibt, wird der Eintrag other verwendet. Der neue Kontext bezieht sich auf subject. Es wird der voreingestellte CallbackHandler für Benutzerinteraktionen benutzt.

Exception: LoginException

Falls es weder einen Eintrag mit diesem Namen gibt noch ein Eintrag other existiert.
Falls der voreingestellte CallbackHandler nicht geladen werden konnte.

public LoginContext(String name, Subject subject, CallbackHandler callbackHandler)

Erzeugt einen neuen Kontext für die durch name bezeichnete Modulkonfiguration. Falls es keinen Eintrag mit diesem Namen gibt, wird der Eintrag other verwendet. Der neue Kontext bezieht sich auf subject. Es wird der übergebene callbackHandler für Benutzerinteraktionen benutzt.

Exception: LoginException

Falls es weder einen Eintrag mit diesem Namen gibt noch ein Eintrag other existiert.
Falls callbackHandler null ist.

Methoden im Detail

public Subject getSubject()
Liefert das Subject zurück, auf das sich der Kontext bezieht.

public void login()

Leitet den Login-Vorgang ein und trägt im Fall eines erfolgreichen Logins die erlangten Principals ein.

Exception: LoginException

Falls der Vorgang fehlschlägt.

public void logout()

Meldet das assoziierte Subject ab, wodurch die Principals wieder entfernt werden.

Exception: LoginException

Falls der Vorgang fehlschlägt.