Package javax.security.auth.callback

Interface CallbackHandler

public interface CallbackHandler
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.

  • Method Summary

    Modifier and Type Method Description
    void handle​(Callback[] callbacks)
    Handles the actual Callback.

  • Method Details

    • handle

      void handle​(Callback[] callbacks) throws IOException, UnsupportedCallbackException
      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