de.aristaflow.adept2.base.security.callbackhandler

Class NamePasswordHandler

java.lang.Object

de.aristaflow.adept2.base.security.callbackhandler.NamePasswordHandler

All Implemented Interfaces:

AFCallbackHandler

public class NamePasswordHandler
extends java.lang.Object
implements AFCallbackHandler

A simple callback handler providing a name and a password to the appropriate callbacks (NameCallback and PasswordCallback) if required. Optionally an additional AFCallbackHandler can be provided to which all other Callbacks will be forwarded. If this is not provided and another callback is required, the callback handling will fail.

Author:

Ulrich Kreher

Field Summary

Fields

Modifier and Type	Field and Description
protected AFCallbackHandler	furtherHandling The callback handler for all other callbacks.
protected java.lang.String	name The name to provide in a NameCallback if required.
protected char[]	password The password to provide in a PasswordCallback if required.

Constructor Summary

Constructors

Constructor and Description
NamePasswordHandler(java.lang.String name, java.lang.String password) Creates a callback handler providing the designated name and password to the appropriate callbacks.
NamePasswordHandler(java.lang.String name, java.lang.String password, AFCallbackHandler furtherHandling) Creates a callback handler providing the designated name and password to the appropriate callbacks.

Method Summary

Modifier and Type	Method and Description
javax.security.auth.callback.Callback[]	handle(javax.security.auth.callback.Callback[] callbacks) This method is similar to CallbackHandler.handle(Callback[]) but returns the provided callbacks back to the caller.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

name

protected final java.lang.String name

The name to provide in a NameCallback if required.

password

protected final char[] password

The password to provide in a PasswordCallback if required.

furtherHandling

protected final AFCallbackHandler furtherHandling

The callback handler for all other callbacks.

Constructor Detail

NamePasswordHandler

public NamePasswordHandler(java.lang.String name,
                           java.lang.String password)

Creates a callback handler providing the designated name and password to the appropriate callbacks. If another Callback is required besides a NameCallback and a PasswordCallback, callback handling will fail.

Parameters:

name - The name to provide in a NameCallback if required.

password - The password to provide in a PasswordCallback if required.

NamePasswordHandler

public NamePasswordHandler(java.lang.String name,
                           java.lang.String password,
                           AFCallbackHandler furtherHandling)

Creates a callback handler providing the designated name and password to the appropriate callbacks. If another Callback is required besides a NameCallback and a PasswordCallback, these callbacks will be collected and provided to the designated AFCallbackHandler.

Parameters:

name - The name to provide in a NameCallback if required.

password - The password to provide in a PasswordCallback if required.

furtherHandling - The CallbackHandler to which all other callbacks will be forwarded. This may be null which equals NamePasswordHandler(String, String).

Method Detail

handle

public javax.security.auth.callback.Callback[] handle(javax.security.auth.callback.Callback[] callbacks)
                                               throws javax.security.auth.callback.UnsupportedCallbackException,
                                                      java.io.IOException

Description copied from interface: AFCallbackHandler

This method is similar to CallbackHandler.handle(Callback[]) but returns the provided callbacks back to the caller. This allows for calling this method remotely. Note that all callbacks need to be serialisable.
When called remotely, the provided callbacks are copies of the server-side objects. When changing these objects, the changes are not reflected on server side. Therefore these objects (or rather copies of them) need to be returned.

Specified by:

handle in interface AFCallbackHandler

Parameters:

callbacks - The callbacks to be handled by this callback handler.

Returns:

All the callbacks that should be handled by this callback handler. Just return the complete array of callbacks. Do not skip any callbacks, for instance the ones that the callback handler did not handle!

Throws:

javax.security.auth.callback.UnsupportedCallbackException - If the implementation of this method does not support one or more of the callbacks specified in the callbacks parameter, an UnsupportedCallbackException will be thrown.

java.io.IOException - If an input or output error occurs, an IOException will be thrown.