to top
Android APIs
Since: API Level 1
public interface

CallbackHandler

javax.security.auth.callback.CallbackHandler

Class Overview

Needs to be implemented by classes that want to handle authentication Callbacks. A single method handle(Callback[]) must be provided that checks the type of the incoming Callbacks and reacts accordingly. CallbackHandlers can be installed per application. It is also possible to configure a system-default CallbackHandler by setting the auth.login.defaultCallbackHandler property in the standard security.properties file.

Summary

Public Methods
abstract void handle(Callback[] callbacks)
Handles the actual Callback.

Public Methods

public abstract void handle (Callback[] callbacks)

Since: API Level 1

Handles the actual Callback. A CallbackHandler needs to implement this method. In the method, it is free to select which Callbacks it actually wants to handle and in which way. For example, a console-based CallbackHandler might choose to sequentially ask the user for login and password, if it implements these Callback s, whereas a GUI-based one might open a single dialog window for both values. If a CallbackHandler is not able to handle a specific Callback, it needs to throw an UnsupportedCallbackException.

Parameters
callbacks the array of Callbacks that need handling
Throws
IOException if an I/O related error occurs
UnsupportedCallbackException if the CallbackHandler is not able to handle a specific Callback