Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)
Android APIs
Added in API level 1
public interface

CallbackHandler

javax.security.auth.callback.CallbackHandler

Class Overview

Needs to be implemented by classes that want to handle authentication Callback s. A single method handle(Callback[]) must be provided that checks the type of the incoming Callback s and reacts accordingly. CallbackHandler s 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)

Added in API level 1

Handles the actual Callback . A CallbackHandler needs to implement this method. In the method, it is free to select which Callback s 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 Callback s that need handling
Throws
IOException if an I/O related error occurs
UnsupportedCallbackException if the CallbackHandler is not able to handle a specific Callback