de.aristaflow.adept2.base.security.callbackhandler

Class CallbackHandlerWrapper

java.lang.Object

de.aristaflow.adept2.base.security.callbackhandler.CallbackHandlerWrapper

All Implemented Interfaces:

AFCallbackHandler

public class CallbackHandlerWrapper
extends java.lang.Object
implements AFCallbackHandler

A wrapper for CallbackHandler treated as AFCallbackHandler. This only works locally, that is the wrapped callback handler cannot be remote. However, this wrapper can be used remotely.

Author:

Ulrich Kreher

Field Summary

Fields

Modifier and Type	Field and Description
protected javax.security.auth.callback.CallbackHandler	handler The handler to which all callback requests are forwarded.

Constructor Summary

Constructors

Constructor and Description
CallbackHandlerWrapper(javax.security.auth.callback.CallbackHandler handler) Creates a new AFCallbackHandler that wraps the designated CallbackHandler appropriately.

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

handler

protected final javax.security.auth.callback.CallbackHandler handler

The handler to which all callback requests are forwarded.

Constructor Detail

CallbackHandlerWrapper

public CallbackHandlerWrapper(javax.security.auth.callback.CallbackHandler handler)

Creates a new AFCallbackHandler that wraps the designated CallbackHandler appropriately.

Parameters:

handler - The handler to which all callback requests are forwarded.

Method Detail

handle

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

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:

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

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.