com.bea.ales.management
Class ActionManager

java.lang.Object
  |
  +--com.bea.ales.management.ActionManager

public class ActionManager

extends java.lang.Object

This class manages actions. It provides methods to create, delete, rename and find actions.

Method Summary

Action	create(java.lang.String name) Create an action using the specified name.
Action	get(java.lang.String name) Find an action with the specified name.
ActionQueryResult	getActions(java.lang.String filter) Find actions whose names match the specified filter.
void	remove(Action act) Delete the specified action.
void	remove(java.util.Collection actionNames) Removes all the actions in the given Collection of action names.
void	remove(java.lang.String name) Delete an action by name.
void	rename(java.lang.String oldName, java.lang.String newName) Rename an action.

Methods inherited from class java.lang.Object

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

Method Detail

create

public Action create(java.lang.String name)
              throws ManagementException

Create an action using the specified name.

Parameters:

name - name of new action.

Returns:

instance of the action created.

Throws:

ManagementException - if the operation fails.

java.lang.IllegalArgumentException - if name is null or empty.

remove

public void remove(java.lang.String name)
            throws ManagementException

Delete an action by name. The action with the specified name will be deleted.

Parameters:

name - name of action to be deleted.

Throws:

ManagementException - if the operation fails.

java.lang.IllegalArgumentException - if name is null or empty.

remove

public void remove(Action act)
            throws ManagementException

Delete the specified action.

Parameters:

act - the action to be deleted.

Throws:

ManagementException - if the operation fails.

java.lang.IllegalArgumentException - if act is null.

remove

public void remove(java.util.Collection actionNames)
            throws ManagementException

Removes all the actions in the given Collection of action names.
If transaction has not been started for the RBAC_Context associated with this ActionManager, a local transaction for the remove operation for all the actions is started.

Parameters:

actionNames - The Collection of action name Strings to remove. The current identity must have privilege to remove all the actions in this Collection or else this method will not remove ANY actions.

Throws:

ManagementException - Exception while removing the actions. When encountered, further processing of the remove collection is stopped and any local transaction started by this method is rolled back.

rename

public void rename(java.lang.String oldName,
                   java.lang.String newName)
            throws ManagementException

Rename an action. The action with oldName will be renamed to newName.

Parameters:

oldName - original name of the action.

newName - new name of the action.

Throws:

ManagementException - if the operation fails.

java.lang.IllegalArgumentException - if oldName or newName is null or empty.

get

public Action get(java.lang.String name)
           throws ManagementException

Find an action with the specified name.

Parameters:

name - name of the action.

Returns:

the action whose name is name, null if not found.

Throws:

ManagementException - if the operation fails.

getActions

public ActionQueryResult getActions(java.lang.String filter)
                             throws ManagementException

Find actions whose names match the specified filter.

Parameters:

filter - filter condition.

Returns:

an ActionQueryResult object which contains the matched actions.

Throws:

ManagementException - if the operation fails.