de.aristaflow.adept2.base.security

Interface AFCallbackHandler

All Known Implementing Classes:

CallbackHandlerWrapper, NameAppNameHandler, NameHandler, NameOrgPosSesIDAppNameHandler, NamePasswordHandler, NameStoringHandler, PasswordHandler

public interface AFCallbackHandler

This interface is similar to CallbackHandler but it allows for remote callback handling by the annotation to prevent transferring the CallbackHandler but call it remotely. Additionally, the callbacks need to be transferred back to the caller and are thus returned.

Author:

Ulrich Kreher

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.

Method Detail

handle

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

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.

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.