com.dtolabs.rundeck.core.common

Class FrameworkBase

java.lang.Object

com.dtolabs.rundeck.core.common.FrameworkBase

All Implemented Interfaces:

IFramework, IFrameworkNodes, IFrameworkServices

Direct Known Subclasses:

Framework

public class FrameworkBase
extends java.lang.Object
implements IFramework

Manages the elements of the Ctl framework. Provides access to the various kinds of framework resource managers like FrameworkProjectMgr, Authorization.
User: alexh Date: Jun 4, 2004 Time: 8:16:42 PM

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	FRAMEWORK_GLOBALS_PROP
static org.apache.log4j.Logger	logger
static java.lang.String	NODES_RESOURCES_FILE_PROP
static java.lang.String	PROJECT_GLOBALS_PROP
static Attribute	RUNDECK_APP_CONTEXT Environmental attribute for the rundeck app
static java.util.Set<Attribute>	RUNDECK_APP_ENV the rundeck app environment for authorization

Method Summary

Methods

Modifier and Type	Method and Description
NodeEntryImpl	createFrameworkNode()
static PropertyRetriever	createPropertyRetriever(java.io.File basedir)
INodeSet	filterAuthorizedNodes(java.lang.String project, java.util.Set<java.lang.String> actions, INodeSet unfiltered, AuthContext authContext)
ExecutionService	getExecutionService()
FileCopier	getFileCopierForNodeAndProject(INodeEntry node, java.lang.String project)
FileCopierService	getFileCopierService()
java.lang.String	getFrameworkNodeHostname() Gets the value of "framework.server.hostname" property
java.lang.String	getFrameworkNodeName() Gets the value of "framework.server.name" property
IFrameworkNodes	getFrameworkNodes()
ProjectManager	getFrameworkProjectMgr() Gets DepotMgr for this framework instance
IFrameworkServices	getFrameworkServices()
static Framework	getInstance(java.lang.String basedir, java.lang.String projectsdir)
INodeDesc	getNodeDesc() Gets the INodeDesc value describing the framework node
NodeDispatcher	getNodeDispatcherForContext(ExecutionContext context)
NodeExecutor	getNodeExecutorForNodeAndProject(INodeEntry node, java.lang.String project)
NodeExecutorService	getNodeExecutorService()
NodeStepExecutor	getNodeStepExecutorForItem(NodeStepExecutionItem item)
NodeStepExecutionService	getNodeStepExecutorService()
OrchestratorService	getOrchestratorService()
ServiceProviderLoader	getPluginManager()
java.util.Map<java.lang.String,java.lang.String>	getProjectGlobals(java.lang.String project) Retrieves the global properties defined for the specified project.
ProjectManager	getProjectManager()
java.lang.String	getProjectProperty(java.lang.String project, java.lang.String key)
java.lang.String	getProperty(java.lang.String name) Return the property value by name
IPropertyLookup	getPropertyLookup()
PropertyRetriever	getPropertyRetriever()
ResourceFormatGeneratorService	getResourceFormatGeneratorService()
ResourceFormatParserService	getResourceFormatParserService()
ResourceModelSourceService	getResourceModelSourceService()
FrameworkSupportService	getService(java.lang.String name)
StepExecutionService	getStepExecutionService()
WorkflowExecutionService	getWorkflowExecutionService()
WorkflowStrategyService	getWorkflowStrategyService()
boolean	hasProjectProperty(java.lang.String key, java.lang.String project)
boolean	hasProperty(java.lang.String key)
boolean	isLocalNode(INodeDesc node) Return true if the node is the local framework node.
void	setFrameworkNodes(IFrameworkNodes frameworkNodes)
void	setFrameworkServices(IFrameworkServices frameworkServices)
void	setProjectManager(ProjectManager projectManager)
void	setService(java.lang.String name, FrameworkSupportService service) Set a service by name
java.lang.String	toString() Returns a string with useful information for debugging.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

logger

public static final org.apache.log4j.Logger logger

NODES_RESOURCES_FILE_PROP

public static final java.lang.String NODES_RESOURCES_FILE_PROP

See Also:

Constant Field Values

FRAMEWORK_GLOBALS_PROP

public static final java.lang.String FRAMEWORK_GLOBALS_PROP

See Also:

Constant Field Values

PROJECT_GLOBALS_PROP

public static final java.lang.String PROJECT_GLOBALS_PROP

See Also:

Constant Field Values

RUNDECK_APP_CONTEXT

public static final Attribute RUNDECK_APP_CONTEXT

Environmental attribute for the rundeck app

RUNDECK_APP_ENV

public static final java.util.Set<Attribute> RUNDECK_APP_ENV

the rundeck app environment for authorization

Method Detail

getFrameworkProjectMgr

public ProjectManager getFrameworkProjectMgr()

Gets DepotMgr for this framework instance

Specified by:

getFrameworkProjectMgr in interface IFramework

Returns:

returns instance of IFrameworkProjectMgr

getService

public FrameworkSupportService getService(java.lang.String name)

Specified by:

getService in interface IFrameworkServices

Parameters:

name - service name

Returns:

a service by name

setService

public void setService(java.lang.String name,
              FrameworkSupportService service)

Description copied from interface: IFrameworkServices

Set a service by name

Specified by:

setService in interface IFrameworkServices

Parameters:

name - name

service - service

getExecutionService

public ExecutionService getExecutionService()

Specified by:

getExecutionService in interface IFrameworkServices

getOrchestratorService

public OrchestratorService getOrchestratorService()

Specified by:

getOrchestratorService in interface IFrameworkServices

getWorkflowExecutionService

public WorkflowExecutionService getWorkflowExecutionService()

Specified by:

getWorkflowExecutionService in interface IFrameworkServices

getWorkflowStrategyService

public WorkflowStrategyService getWorkflowStrategyService()

Specified by:

getWorkflowStrategyService in interface IFrameworkServices

getStepExecutionService

public StepExecutionService getStepExecutionService()

Specified by:

getStepExecutionService in interface IFrameworkServices

getFileCopierForNodeAndProject

public FileCopier getFileCopierForNodeAndProject(INodeEntry node,
                                        java.lang.String project)
                                          throws ExecutionServiceException

Specified by:

getFileCopierForNodeAndProject in interface IFrameworkServices

Throws:

ExecutionServiceException

getFileCopierService

public FileCopierService getFileCopierService()

Specified by:

getFileCopierService in interface IFrameworkServices

getNodeExecutorForNodeAndProject

public NodeExecutor getNodeExecutorForNodeAndProject(INodeEntry node,
                                            java.lang.String project)
                                              throws ExecutionServiceException

Specified by:

getNodeExecutorForNodeAndProject in interface IFrameworkServices

Throws:

ExecutionServiceException

getNodeExecutorService

public NodeExecutorService getNodeExecutorService()
                                           throws ExecutionServiceException

Specified by:

getNodeExecutorService in interface IFrameworkServices

Throws:

ExecutionServiceException

getNodeStepExecutorService

public NodeStepExecutionService getNodeStepExecutorService()
                                                    throws ExecutionServiceException

Specified by:

getNodeStepExecutorService in interface IFrameworkServices

Throws:

ExecutionServiceException

getNodeStepExecutorForItem

public NodeStepExecutor getNodeStepExecutorForItem(NodeStepExecutionItem item)
                                            throws ExecutionServiceException

Specified by:

getNodeStepExecutorForItem in interface IFrameworkServices

Throws:

ExecutionServiceException

getNodeDispatcherForContext

public NodeDispatcher getNodeDispatcherForContext(ExecutionContext context)
                                           throws ExecutionServiceException

Specified by:

getNodeDispatcherForContext in interface IFrameworkServices

Throws:

ExecutionServiceException

getResourceModelSourceService

public ResourceModelSourceService getResourceModelSourceService()

Specified by:

getResourceModelSourceService in interface IFrameworkServices

getResourceFormatParserService

public ResourceFormatParserService getResourceFormatParserService()

Specified by:

getResourceFormatParserService in interface IFrameworkServices

getResourceFormatGeneratorService

public ResourceFormatGeneratorService getResourceFormatGeneratorService()

Specified by:

getResourceFormatGeneratorService in interface IFrameworkServices

getPluginManager

public ServiceProviderLoader getPluginManager()

Specified by:

getPluginManager in interface IFrameworkServices

createPropertyRetriever

public static PropertyRetriever createPropertyRetriever(java.io.File basedir)

getInstance

public static Framework getInstance(java.lang.String basedir,
                    java.lang.String projectsdir)

getProperty

public java.lang.String getProperty(java.lang.String name)

Return the property value by name

Parameters:

name - Property key

Returns:

property value

getPropertyRetriever

public PropertyRetriever getPropertyRetriever()

Returns:

a PropertyRetriever interface for framework-scoped properties

hasProperty

public boolean hasProperty(java.lang.String key)

Parameters:

key - property key

Returns:

true if the property exists

hasProjectProperty

public boolean hasProjectProperty(java.lang.String key,
                         java.lang.String project)

Parameters:

project - project

key - property name

Returns:

true if the property is set for the project or the framework

getProjectProperty

public java.lang.String getProjectProperty(java.lang.String project,
                                  java.lang.String key)

Parameters:

project - project

key - property name

Returns:

the property value for the key from the project or framework properties if it exists, otherwise return null.

getProjectGlobals

public java.util.Map<java.lang.String,java.lang.String> getProjectGlobals(java.lang.String project)

Retrieves the global properties defined for the specified project. This variables are defined either in the framework (framework.globals.*) or in the project (project.globals.*). The prefix (xxx.globals.) will be stripped from the property name.

For variables defines both in framework and project contexts, the variable defined in the project will have priority.

Parameters:

project - The project identifier.

Returns:

Map with global variables.

getPropertyLookup

public IPropertyLookup getPropertyLookup()

Specified by:

getPropertyLookup in interface IFramework

Returns:

property lookup

toString

public java.lang.String toString()

Returns a string with useful information for debugging.

Overrides:

toString in class java.lang.Object

Returns:

Formatted string

getFrameworkNodeHostname

public java.lang.String getFrameworkNodeHostname()

Description copied from interface: IFramework

Gets the value of "framework.server.hostname" property

Specified by:

getFrameworkNodeHostname in interface IFramework

Specified by:

getFrameworkNodeHostname in interface IFrameworkNodes

Returns:

Returns value of framework.server.hostname property

getFrameworkNodeName

public java.lang.String getFrameworkNodeName()

Description copied from interface: IFramework

Gets the value of "framework.server.name" property

Specified by:

getFrameworkNodeName in interface IFramework

Specified by:

getFrameworkNodeName in interface IFrameworkNodes

Returns:

Returns value of framework.server.name property

createFrameworkNode

public NodeEntryImpl createFrameworkNode()

Specified by:

createFrameworkNode in interface IFramework

Specified by:

createFrameworkNode in interface IFrameworkNodes

Returns:

Generate a node entry for the framework with default values

filterAuthorizedNodes

public INodeSet filterAuthorizedNodes(java.lang.String project,
                             java.util.Set<java.lang.String> actions,
                             INodeSet unfiltered,
                             AuthContext authContext)

Specified by:

filterAuthorizedNodes in interface IFramework

Specified by:

filterAuthorizedNodes in interface IFrameworkNodes

Parameters:

project - project name

actions - action set

unfiltered - nodes

authContext - authoriziation

Returns:

the nodeset consisting only of the input nodes where the specified actions are all authorized

getNodeDesc

public INodeDesc getNodeDesc()

Description copied from interface: IFramework

Gets the INodeDesc value describing the framework node

Specified by:

getNodeDesc in interface IFramework

Specified by:

getNodeDesc in interface IFrameworkNodes

Returns:

the singleton INodeDesc object for this framework instance

isLocalNode

public boolean isLocalNode(INodeDesc node)

Description copied from interface: IFramework

Return true if the node is the local framework node. Compares the (logical) node names of the nodes after eliding any embedded 'user@' parts.

Specified by:

isLocalNode in interface IFramework

Specified by:

isLocalNode in interface IFrameworkNodes

Parameters:

node - the node

Returns:

true if the node's name is the same as the framework's node name

getFrameworkServices

public IFrameworkServices getFrameworkServices()

setFrameworkServices

public void setFrameworkServices(IFrameworkServices frameworkServices)

getFrameworkNodes

public IFrameworkNodes getFrameworkNodes()

setFrameworkNodes

public void setFrameworkNodes(IFrameworkNodes frameworkNodes)

getProjectManager

public ProjectManager getProjectManager()

setProjectManager

public void setProjectManager(ProjectManager projectManager)