org.cristalise.kernel.lookup

Interface LookupManager

All Superinterfaces:

Lookup

public interface LookupManager
extends Lookup

The LookupManager interface contains all of the directory modifying methods of the Lookup. This allows read-only Lookup implementations. Server processes will attempt to cast their Lookups into LookupManagers, and fail to start up if this is not possible.

Nested Class Summary

Nested classes/interfaces inherited from interface org.cristalise.kernel.lookup.Lookup

Lookup.PagedResult

Method Summary

Modifier and Type	Method and Description
void	add(Path newPath) Register a new a Path in the directory.
void	addRole(AgentPath agent, RolePath rolePath) Adds the given Agent to the given Role, if they both exist.
RolePath	createRole(RolePath role) Creates a new Role.
void	delete(Path path) Remove a Path from the directory.
void	initializeDirectory() Called when a server starts up.
void	removeRole(AgentPath agent, RolePath role) Remove the given Agent from the given Role.
void	setAgentPassword(AgentPath agent, String newPassword) Set permanent password of Agent's
void	setAgentPassword(AgentPath agent, String newPassword, boolean temporary) Set an Agent's password
void	setHasJobList(RolePath role, boolean hasJobList) Set the flag specifying whether Activities holding this Role should push Jobs its Agents.
void	setIOR(ItemPath item, String ior) Set the IOR of the Item
void	setPermission(RolePath role, String permission) Sets the permission of the given Role.
void	setPermissions(RolePath role, List<String> permissions) Sets the list of permission of the given Role.

Methods inherited from interface org.cristalise.kernel.lookup.Lookup

close, exists, getAgentName, getAgentPath, getAgents, getAgents, getChildren, getChildren, getIOR, getItemPath, getRolePath, getRoles, getRoles, hasRole, open, resolvePath, search, search, search, search, search, searchAliases, searchAliases

Method Detail

initializeDirectory

void initializeDirectory()
                  throws ObjectNotFoundException

Called when a server starts up. The Lookup implementation should ensure that the initial structure of its directory is valid, and create it on first boot.

Throws:

ObjectNotFoundException - When initialization data is not found

add

void add(Path newPath)
  throws ObjectCannotBeUpdated,
         ObjectAlreadyExistsException

Register a new a Path in the directory.

Parameters:

newPath - The path to add

Throws:

ObjectCannotBeUpdated - When there is an error writing to the directory

ObjectAlreadyExistsException - When the Path has already been registered

delete

void delete(Path path)
     throws ObjectCannotBeUpdated

Remove a Path from the directory.

Parameters:

path - The path to remove

Throws:

ObjectCannotBeUpdated - When an error occurs writing to the directory

createRole

RolePath createRole(RolePath role)
             throws ObjectAlreadyExistsException,
                    ObjectCannotBeUpdated

Creates a new Role. Checks if parent role exists or not and throws ObjectCannotBeUpdated if parent does not exist Called by the server predefined step 'CreateNewRole'

Parameters:

role - The new role path

Returns:

the RolePath representing the newly create Role

Throws:

ObjectAlreadyExistsException

ObjectCannotBeUpdated

addRole

void addRole(AgentPath agent,
             RolePath rolePath)
      throws ObjectCannotBeUpdated,
             ObjectNotFoundException

Adds the given Agent to the given Role, if they both exist.

Parameters:

agent - the path representing the given Agent

rolePath - the path representing the given Role

Throws:

ObjectCannotBeUpdated

ObjectNotFoundException

removeRole

void removeRole(AgentPath agent,
                RolePath role)
         throws ObjectCannotBeUpdated,
                ObjectNotFoundException

Remove the given Agent from the given Role. Does not delete the Role.

Parameters:

agent - the path representing the given Agent

role - the path representing the given Role

Throws:

ObjectCannotBeUpdated

ObjectNotFoundException

setAgentPassword

void setAgentPassword(AgentPath agent,
                      String newPassword)
               throws ObjectNotFoundException,
                      ObjectCannotBeUpdated,
                      NoSuchAlgorithmException

Set permanent password of Agent's

Parameters:

agent - The Agent

newPassword - The Agent's new password

Throws:

ObjectNotFoundException

ObjectCannotBeUpdated

NoSuchAlgorithmException

setAgentPassword

void setAgentPassword(AgentPath agent,
                      String newPassword,
                      boolean temporary)
               throws ObjectNotFoundException,
                      ObjectCannotBeUpdated,
                      NoSuchAlgorithmException

Set an Agent's password

Parameters:

agent - The Agent

newPassword - The Agent's new password

temporary - whether the new password is temporary or not

Throws:

ObjectNotFoundException

ObjectCannotBeUpdated

NoSuchAlgorithmException

setHasJobList

void setHasJobList(RolePath role,
                   boolean hasJobList)
            throws ObjectNotFoundException,
                   ObjectCannotBeUpdated

Set the flag specifying whether Activities holding this Role should push Jobs its Agents.

Parameters:

role - The role to modify

hasJobList - boolean flag

Throws:

ObjectNotFoundException

ObjectCannotBeUpdated

setIOR

void setIOR(ItemPath item,
            String ior)
     throws ObjectNotFoundException,
            ObjectCannotBeUpdated

Set the IOR of the Item

Parameters:

item - the Item to be updated

ior - the new ior

Throws:

ObjectNotFoundException - Item does not exists

ObjectCannotBeUpdated - there was a probelm updating the ior

setPermission

void setPermission(RolePath role,
                   String permission)
            throws ObjectNotFoundException,
                   ObjectCannotBeUpdated

Sets the permission of the given Role. Use blank string to clear the permissions

Parameters:

role - the RolePath to change

permission - String using WildcardPermission format of shiro

Throws:

ObjectNotFoundException - Role does not exists

ObjectCannotBeUpdated - there was a problem updating the permissions

setPermissions

void setPermissions(RolePath role,
                    List<String> permissions)
             throws ObjectNotFoundException,
                    ObjectCannotBeUpdated

Sets the list of permission of the given Role. Use empty list to clear the permissions

Parameters:

role - the RolePath to change

permissions - list of String using WildcardPermission format of shiro

Throws:

ObjectNotFoundException - Role does not exists

ObjectCannotBeUpdated - there was a problem updating the permissions