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, Lookup.SearchConstraints

Method Summary

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

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

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

Method Detail

initializeDirectory

void initializeDirectory(TransactionKey transactionKey)
                  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. This method can be used in server side code or Script to find uncommitted changes during the active transaction.

Parameters:

transactionKey - identifier of the active transaction

Throws:

ObjectNotFoundException - When initialization data is not found

add

default 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

add

void add(Path newPath,
         TransactionKey transactionKey)
  throws ObjectCannotBeUpdated,
         ObjectAlreadyExistsException

Register a new a Path in the directory. This method can be used in server side code or Script to find uncommitted changes during the active transaction.

Parameters:

newPath - The path to add

transactionKey - identifier of the active transaction

Throws:

ObjectCannotBeUpdated - When there is an error writing to the directory

ObjectAlreadyExistsException - When the Path has already been registered

delete

default 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

delete

void delete(Path path,
            TransactionKey transactionKey)
     throws ObjectCannotBeUpdated

Remove a Path from the directory. This method can be used in server side code or Script to find uncommitted changes during the active transaction.

Parameters:

path - The path to remove

transactionKey - identifier of the active transaction

Throws:

ObjectCannotBeUpdated - When an error occurs writing to the directory

createRole

default 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

createRole

RolePath createRole(RolePath role,
                    TransactionKey transactionKey)
             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' This method can be used in server side code or Script to find uncommitted changes during the active transaction.

Parameters:

role - The new role path

transactionKey - identifier of the active transaction

Returns:

the RolePath representing the newly create Role

Throws:

ObjectAlreadyExistsException

ObjectCannotBeUpdated

addRole

default 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

addRole

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

Adds the given Agent to the given Role, if they both exist. This method can be used in server side code or Script to find uncommitted changes during the active transaction.

Parameters:

agent - the path representing the given Agent

rolePath - the path representing the given Role

transactionKey - identifier of the active transaction

Throws:

ObjectCannotBeUpdated

ObjectNotFoundException

removeRole

default 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

removeRole

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

Remove the given Agent from the given Role. Does not delete the Role. This method can be used in server side code or Script to find uncommitted changes during the active transaction.

Parameters:

agent - the path representing the given Agent

role - the path representing the given Role

transactionKey - identifier of the active transaction

Throws:

ObjectCannotBeUpdated

ObjectNotFoundException

setAgentPassword

default 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

default 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

setAgentPassword

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

Set an Agent's password This method can be used in server side code or Script to find uncommitted changes during the active transaction.

Parameters:

agent - The Agent

newPassword - The Agent's new password

temporary - whether the new password is temporary or not

transactionKey - identifier of the active transaction

Throws:

ObjectNotFoundException

ObjectCannotBeUpdated

NoSuchAlgorithmException

setHasJobList

default 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

setHasJobList

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

Set the flag specifying whether Activities holding this Role should push Jobs its Agents. This method can be used in server side code or Script to find uncommitted changes during the active transaction.

Parameters:

role - The role to modify

hasJobList - boolean flag

transactionKey - identifier of the active transaction

Throws:

ObjectNotFoundException

ObjectCannotBeUpdated

setIOR

default 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

setIOR

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

Set the IOR of the Item This method can be used in server side code or Script to find uncommitted changes during the active transaction.

Parameters:

item - the Item to be updated

ior - the new ior

transactionKey - identifier of the active transaction

Throws:

ObjectNotFoundException - Item does not exists

ObjectCannotBeUpdated - there was a probelm updating the ior

setPermission

default 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

transactionKey - identifier of the active transaction

Throws:

ObjectCannotBeUpdated - there was a problem updating the permissions

ObjectNotFoundException

setPermission

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

Sets the permission of the given Role. Use blank string to clear the permissions This method can be used in server side code or Script to find uncommitted changes during the active transaction.

Parameters:

role - the RolePath to change

permission - String using WildcardPermission format of shiro

transactionKey - identifier of the active transaction

Throws:

ObjectNotFoundException - Role does not exists

ObjectCannotBeUpdated - there was a problem updating the permissions

setPermissions

default 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

setPermissions

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

Sets the list of permission of the given Role. Use empty list to clear the permissions This method can be used in server side code or Script to find uncommitted changes during the active transaction.

Parameters:

role - the RolePath to change

permissions - list of String using WildcardPermission format of shiro

transactionKey - identifier of the active transaction

Throws:

ObjectNotFoundException - Role does not exists

ObjectCannotBeUpdated - there was a problem updating the permissions

postStartServer

void postStartServer()

postBoostrap

void postBoostrap()