Top Description Fields Constructors Methods
org.eclipse.jetty.security.jaas.callback

public Class DefaultCallbackHandler

extends AbstractCallbackHandler
Class Inheritance
Imports
java.io.IOException, javax.security.auth.callback.Callback, .NameCallback, .PasswordCallback, .UnsupportedCallbackException, org.eclipse.jetty.server.FormFields, .Request, org.eclipse.jetty.util.ExceptionUtil, .Fields

DefaultCallbackHandler An implementation of the JAAS CallbackHandler. Users can provide their own implementation instead and set the name of its class on the JAASLoginService.

Field Summary

Modifier and TypeField and Description
private Request
Inherited from org.eclipse.jetty.security.jaas.callback.AbstractCallbackHandler:
_credential_userName

Constructor Summary

AccessConstructor and Description
public

Method Summary

Modifier and TypeMethod and Description
public void
handle(Callback[]
an array of Callback objects provided by an underlying security service which contains the information requested to be retrieved or displayed.
callbacks
)

Overrides org.eclipse.jetty.security.jaas.callback.AbstractCallbackHandler.handle.

Implements javax.security.auth.callback.CallbackHandler.handle.

Retrieve or display the information requested in the provided Callbacks.

public void
Inherited from org.eclipse.jetty.security.jaas.callback.AbstractCallbackHandler:
getCredentialgetUserNamesetCredentialsetUserName

Field Detail

_requestback to summary
private Request _request

Constructor Detail

DefaultCallbackHandlerback to summary
public DefaultCallbackHandler()

Method Detail

handleback to summary
public void handle(Callback[] callbacks) throws IOException, UnsupportedCallbackException

Overrides org.eclipse.jetty.security.jaas.callback.AbstractCallbackHandler.handle.

Implements javax.security.auth.callback.CallbackHandler.handle.

Doc from javax.security.auth.callback.CallbackHandler.handle.

Retrieve or display the information requested in the provided Callbacks.

The handle method implementation checks the instance(s) of the Callback object(s) passed in to retrieve or display the requested information. The following example is provided to help demonstrate what an handle method implementation might look like. This example code is for guidance only. Many details, including proper error handling, are left out for simplicity.

public void handle(Callback[] callbacks)
throws IOException, UnsupportedCallbackException {

  for (int i = 0; i < callbacks.length; i++) {
     if (callbacks[i] instanceof TextOutputCallback) {

         // display the message according to the specified type
         TextOutputCallback toc = (TextOutputCallback)callbacks[i];
         switch (toc.getMessageType()) {
         case TextOutputCallback.INFORMATION:
             System.out.println(toc.getMessage());
             break;
         case TextOutputCallback.ERROR:
             System.out.println("ERROR: " + toc.getMessage());
             break;
         case TextOutputCallback.WARNING:
             System.out.println("WARNING: " + toc.getMessage());
             break;
         default:
             throw new IOException("Unsupported message type: " +
                                 toc.getMessageType());
         }

     } else if (callbacks[i] instanceof NameCallback) {

         // prompt the user for a username
         NameCallback nc = (NameCallback)callbacks[i];

         // ignore the provided defaultName
         System.err.print(nc.getPrompt());
         System.err.flush();
         nc.setName((new BufferedReader
                 (new InputStreamReader(
                         System.in,
                         System.getProperty("stdin.encoding")))).readLine());

     } else if (callbacks[i] instanceof PasswordCallback) {

         // prompt the user for sensitive information
         PasswordCallback pc = (PasswordCallback)callbacks[i];
         System.err.print(pc.getPrompt());
         System.err.flush();
         pc.setPassword(readPassword(System.in));

     } else {
         throw new UnsupportedCallbackException
                 (callbacks[i], "Unrecognized Callback");
     }
  }
}

// Reads user password from given input stream.
private char[] readPassword(InputStream in) throws IOException {
   // insert code to read a user password from the input stream
}
Parameters
callbacks:Callback[]

an array of Callback objects provided by an underlying security service which contains the information requested to be retrieved or displayed.

Annotations
@Override
Exceptions
IOException:
if an input or output error occurs.
UnsupportedCallbackException:
if the implementation of this method does not support one or more of the Callbacks specified in the callbacks parameter.
setRequestback to summary
public void setRequest(Request request)