com.tailf.dp.annotations

Class AuthorizationCallbackProxy

Object

com.tailf.dp.annotations.AuthorizationCallbackProxy

All Implemented Interfaces:

DpAuthorizationCallback

public class AuthorizationCallbackProxy
extends Object
implements DpAuthorizationCallback

Callback proxy for Authorization Callbacks. Implements the DpAuthorizationCallback interface and delegates calls to the registered callback POJO with annotated methods

Field Summary

Fields inherited from interface com.tailf.dp.DpAuthorizationCallback

M_CHECK_CMD_ACCESS, M_CHECK_DATA_ACCESS

Constructor Summary

Constructors

Constructor and Description
AuthorizationCallbackProxy(Object backupObject) Constructor for Callback proxys.

Method Summary

Modifier and Type	Method and Description
void	addActionCapability(AuthorizationCBType authorizationCBType) Add action capability from annotated callType used to register capabilities on the server
void	addActionMethod(String name, Method method) Add callback action method to proxy
AuthorizationResult	checkCommandAccess(DpAuthorizationContext context, String[] commandTokens, AuthorizationOperCheck operation) This callback is invoked for command authorization, i.e.
AuthorizationResult	checkDataAccess(DpAuthorizationContext context, ConfObject[] kp, AuthorizationOperCheck operation, AuthorizationOperCheck how)
EnumSet<AuthorizationOperCheck>	commandFilter() Thus method can be used to prevent access checks from causing invocation of a checkCommandAccess callback even though it is registered.
EnumSet<AuthorizationOperCheck>	dataFilter() Thus method can be used to prevent access checks from causing invocation of a checkDataAccess callback even though it is registered.
static AuthorizationCallbackProxy[]	getAuthorizationCallbackProxys(Object obj) Get array of proxy objects from registered POJO callback.
Object	getBackupObject() Retrieve the callback POJO
int	mask() Mask of flags for each method that is supported by this callback: DpAuthorizationCallback.M_CHECK_CMD_ACCESS DpAuthorizationCallback.M_CHECK_DATA_ACCESS

Methods inherited from class Object

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

Constructor Detail

AuthorizationCallbackProxy

public AuthorizationCallbackProxy(Object backupObject)

Constructor for Callback proxys. Used internally.

Parameters:

backupObject - registered callback POJO

Method Detail

getBackupObject

public Object getBackupObject()

Retrieve the callback POJO

Returns:

Object registered callback object

addActionMethod

public void addActionMethod(String name,
                            Method method)

Add callback action method to proxy

Parameters:

name - canonical action name

method - registered callback method

addActionCapability

public void addActionCapability(AuthorizationCBType authorizationCBType)

Add action capability from annotated callType used to register capabilities on the server

Parameters:

authorizationCBType - action type

mask

public int mask()

Description copied from interface: DpAuthorizationCallback

Mask of flags for each method that is supported by this callback:

• DpAuthorizationCallback.M_CHECK_CMD_ACCESS
• DpAuthorizationCallback.M_CHECK_DATA_ACCESS

Specified by:

mask in interface DpAuthorizationCallback

checkCommandAccess

public AuthorizationResult checkCommandAccess(DpAuthorizationContext context,
                                              String[] commandTokens,
                                              AuthorizationOperCheck operation)
                                       throws DpCallbackException

Description copied from interface: DpAuthorizationCallback

This callback is invoked for command authorization, i.e. it corresponds to the rules under /aaa/authorization/cmdrules in the AAA data model. commandTokens is an String array of tokens representing the command to be checked, corresponding to the command leaf in the cmdrule list. If The operation parameter gives the operation, corresponding to the ops leaf in the cmdrule list.

Specified by:

checkCommandAccess in interface DpAuthorizationCallback

Parameters:

context - the authorization context

commandTokens - command represented as a string of tokens

operation - AuthorizationOperCheck describing the operatopn type

Returns:

AuthorizationResult

Throws:

DpCallbackException

checkDataAccess

public AuthorizationResult checkDataAccess(DpAuthorizationContext context,
                                           ConfObject[] kp,
                                           AuthorizationOperCheck operation,
                                           AuthorizationOperCheck how)
                                    throws DpCallbackException

Specified by:

checkDataAccess in interface DpAuthorizationCallback

Parameters:

context - the authorization context

kp - the data element represented by an array of ConfObject

operation - AuthorizationOperCheck describing the operatopn type

how - checking state INTERMEDIATE or FINAL

Returns:

AuthorizationResult

Throws:

DpCallbackException

commandFilter

public EnumSet<AuthorizationOperCheck> commandFilter()

Description copied from interface: DpAuthorizationCallback

Thus method can be used to prevent access checks from causing invocation of a checkCommandAccess callback even though it is registered. If we do not want any filtering this method should not be registered or return null. For checkCommandAccess callback values INTERMEDIATE and FINAL does not contain any meaning.

Specified by:

commandFilter in interface DpAuthorizationCallback

Returns:

EnumSet of AuthorizationOperCheck values

dataFilter

public EnumSet<AuthorizationOperCheck> dataFilter()

Description copied from interface: DpAuthorizationCallback

Thus method can be used to prevent access checks from causing invocation of a checkDataAccess callback even though it is registered. If we do not want any filtering this method should not be registered or return null.

Specified by:

dataFilter in interface DpAuthorizationCallback

Returns:

EnumSet of AuthorizationOperCheck values

getAuthorizationCallbackProxys

public static AuthorizationCallbackProxy[] getAuthorizationCallbackProxys(Object obj)
                                                                   throws DpCallbackException

Get array of proxy objects from registered POJO callback. Used internally at callback registration

Parameters:

obj - registered Callback POJO

Returns:

array of DBCallbackProxy

Throws:

DpCallbackException