WEB-INF.cftags.component coldbox.system.web.Controller
This is the ColdBox Front Controller that dispatches events and manages your ColdBox application.
Constructor Summary | |
---|---|
init(any appRootPath, any appKey)
Constructor. |
Method Summary | |
---|---|
any
|
getAppHash()
Get AppHash. |
any
|
getAppKey()
Get this application's key in memory space (application scope). |
any
|
getAppRootPath()
Get this application's physical path. |
any<boolean>
|
getAspectsInitiated()
Get AspectsInitiated. |
any
|
getCFMLEngine()
Get the CFMLEngine utility(coldbox. |
any<CacheFactory>
|
getCacheBox()
Get the application's CacheBox instance as coldbox. |
any
|
getColdboxInitiated()
Get ColdboxInitiated: Boolean. |
any<IColdboxApplicationCache>
|
getColdboxOCM([any cacheName='default'])
Get ColdboxOCM: coldbox. |
any<struct>
|
getColdboxSettings()
I retrieve the ColdBox Settings Structure by Reference. |
any<struct>
|
getConfigSettings()
I retrieve the Config Settings Structure by Reference. |
any
|
getDebuggerService()
Get DebuggerService: coldbox. |
any
|
getExceptionService()
Get ExceptionService: coldbox. |
any
|
getHandlerService()
Get HandlerService: coldbox. |
any
|
getInterceptorService()
Get interceptorService: coldbox. |
any
|
getLoaderService()
Get LoaderService: coldbox. |
any<LogBox>
|
getLogBox()
Get the application's LogBox instance. |
any
|
getMemento()
Get the controller's internal state. |
any
|
getModuleService()
Get ModuleService: coldbox. |
any
|
getPlugin(any plugin, [any customPlugin='false'], [any newInstance='false'], [any module=''], [any init='true'])
I am the Plugin cfc object factory. |
any
|
getPluginService()
Get PluginService: coldbox. |
any
|
getRequestService()
Get RequestService: coldbox. |
any<coldbox.system.web.coldbox>
|
getServices()
Get all the registered services structure. |
any
|
getSetting([any name], [any FWSetting='false'], [any defaultValue])
I get a setting from the FW Config structures. |
any<struct>
|
getSettingStructure([any FWSetting='false'], [any deepCopyFlag='false'])
Compatability & Utility Method. |
private any<Util>
|
getUtil()
Create and return a util object. |
any
|
getValidationManager()
Get the validation manager for the application. |
any<LogBox>
|
getWireBox()
Get the application's LogBox instance. |
private any
|
invoker(any target, any method, [any argCollection='[runtime expression]'], [any private='false'])
Method Invoker. |
any
|
persistVariables([any persist=''], [any<struct> persistStruct])
@deprecated DO NOT USE ANYMORE. |
private any
|
pushTimers()
Push timers into stack. |
any
|
runEvent([any event=''], [any<boolean> prepostExempt='false'], [any<boolean> private='false'], [any<boolean> default='false'], [any<struct> eventArguments='[runtime expression]'])
I am an event handler runnable factory. |
private any
|
sendRelocation(any url, [any<boolean> addtoken='false'], [any<numeric> statusCode='0'])
Send a CF relocation via ColdBox. |
any
|
setAppHash(any appHash)
Set AppHash. |
any
|
setAppRootPath(any appRootPath)
Set this application's physical path. |
any
|
setAspectsInitiated(any aspectsInitiated)
Set AspectsInitiated. |
any
|
setCacheBox(any<CacheFactory> cacheBox)
Set the application's CacheBox instance. |
any
|
setColdboxInitiated(any coldboxInitiated)
Set ColdboxInitiated. |
any
|
setColdboxOCM(any coldboxOCM)
Set ColdboxOCM. |
any
|
setColdboxSettings(any<struct> coldboxSettings)
Set ColdboxSettings. |
any
|
setConfigSettings(any<struct> configSettings)
Set ConfigSettings. |
any
|
setDebuggerService(any debuggerService)
Set DebuggerService. |
any
|
setHandlerService(any handlerService)
Set HandlerService. |
any
|
setInterceptorService(any interceptorService)
Set interceptorService. |
any
|
setLoaderService(any loaderService)
Set LoaderService. |
any
|
setLog(any logger)
Set the class logger object. |
any
|
setLogBox(any<LogBox> logBox)
Set the logBox instance. |
any
|
setModuleService(any moduleService)
Set ModuleService. |
any
|
setNextEvent([string event='[runtime expression]'], [string queryString=''], [boolean addToken='false'], [string persist=''], [struct persistStruct='[runtime expression]'], [boolean ssl], [string baseURL=''], [boolean postProcessExempt='false'], [string URL], [string URI], [numeric statusCode='0'])
I Set the next event to run and relocate the browser to that event. |
any
|
setPluginService(Any pluginService)
Set PluginService. |
any
|
setRequestService(any requestService)
Set RequestService. |
any
|
setSetting([any name], [any value])
I set a Global Coldbox setting variable in the configstruct, if it exists it will be overrided. |
any
|
setValidationManager(any validationManager)
Store the validation manager for the application. |
any
|
setWireBox(any<Injector> wireBox)
Set the WireBox instance. |
any<boolean>
|
settingExists(any name, [any FWSetting='false'])
I Check if a value exists in the configstruct or the fwsettingsStruct. |
private any
|
updateSSL(any inURL, any ssl)
Update SSL or not on a request string. |
private any
|
validateAction(any action='', [any inclusion=''], [any exclusion=''])
Checks if an action can be executed according to inclusion/exclusion lists. |
Methods inherited from class WEB-INF.cftags.component |
---|
None |
Constructor Detail |
---|
Constructor
appRootPath
- The application root pathappKey
- The application registered application keyMethod Detail |
---|
Get AppHash
Get this application's key in memory space (application scope)
Get this application's physical path
Get AspectsInitiated
Get the CFMLEngine utility(coldbox.system.core.util.CFMLEngine)
Get the application's CacheBox instance as coldbox.system.cache.CacheFactory
Get ColdboxInitiated: Boolean
Get ColdboxOCM: coldbox.system.cache.CacheManager or new CacheBox providers coldbox.system.cache.IColdboxApplicationCache
cacheName
- The cache name to retrieveI retrieve the ColdBox Settings Structure by Reference
I retrieve the Config Settings Structure by Reference
Get DebuggerService: coldbox.system.web.services.DebuggerService
Get ExceptionService: coldbox.system.web.services.ExceptionService
Get HandlerService: coldbox.system.web.services.HandlerService
Get interceptorService: coldbox.system.web.services.InterceptorService
Get LoaderService: coldbox.system.web.services.LoaderService
Get the application's LogBox instance
Get the controller's internal state
Get ModuleService: coldbox.system.web.services.ModuleService
I am the Plugin cfc object factory.
plugin
- The Plugin object's name to instantiatecustomPlugin
- Used internally to create custom plugins. BooleannewInstance
- If true, it will create and return a new plugin. No caching or persistance.module
- The module to retrieve the plugin frominit
- Auto init() the plugin upon construction, BooleanGet PluginService: coldbox.system.web.services.PluginService
Get RequestService: coldbox.system.web.services.RequestService
Get all the registered services structure
I get a setting from the FW Config structures. Use the FWSetting boolean argument to retrieve from the fwSettingsStruct.
name
- Name of the setting key to retrieveFWSetting
- Boolean Flag. If true, it will retrieve from the fwSettingsStruct else from the configStruct. Default is false.defaultValue
- Default value to return if not found.Compatability & Utility Method. By default I retrieve the Config Settings. You can change this by using the FWSetting flag.
FWSetting
- Boolean Flag. If true, it will retrieve from the fwSettingsStruct else the configStruct. Default is false.deepCopyFlag
- Default is false. True, creates a deep copy of the structure.Create and return a util object
Get the validation manager for the application
Get the application's LogBox instance
Method Invoker
target
- method
- argCollection
- The argument collection to passprivate
- Private method or not? Boolean@deprecated DO NOT USE ANYMORE. Persist variables for flash redirections, it can use a structure of name-value pairs or keys from the request collection. Use the flash object instead, this method will auto-save all persistence automatically.
persist
- What request collection keys to persist in the relocation. Keys must exist in the relocationpersistStruct
- A structure of key-value pairs to persist.Push timers into stack
I am an event handler runnable factory. If no event is passed in then it will run the default event from the config file.
event
- The event to run as a string. If no current event is set, use the default event from the config.xml. This is a stringprepostExempt
- If true, pre/post handlers will not be fired. Booleanprivate
- Execute a private event or not, default is false. Booleandefault
- The flag that let's this service now if it is the default set event running or not. USED BY THE FRAMEWORK ONLY. BooleaneventArguments
- A collection of arguments to passthrough to the calling event handler method. StructSend a CF relocation via ColdBox
url
- The URL to relocate toaddtoken
- Add the CF tokens or notstatusCode
- The status code to useSet AppHash
appHash
Set this application's physical path.
appRootPath
Set AspectsInitiated
aspectsInitiated
Set the application's CacheBox instance
cacheBox
- As coldbox.system.cache.CacheFactorySet ColdboxInitiated
coldboxInitiated
Set ColdboxOCM
coldboxOCM
- coldbox.system.cache.CacheManagerSet ColdboxSettings
coldboxSettings
Set ConfigSettings
configSettings
Set DebuggerService
debuggerService
Set HandlerService
handlerService
Set interceptorService
interceptorService
Set LoaderService
loaderService
Set the class logger object
logger
Set the logBox instance
logBox
- The logBox instanceSet ModuleService
moduleService
I Set the next event to run and relocate the browser to that event. If you are in SES mode, this method will use routing instead. You can also use this method to relocate to an absolute URL or a relative URI
event
- The name of the event to run, if not passed, then it will use the default event found in your configuration file.queryString
- The query string to append, if needed. If in SES mode it will be translated to convention name value pairsaddToken
- Wether to add the tokens or not. Default is falsepersist
- What request collection keys to persist in flash rampersistStruct
- A structure key-value pairs to persist in flash ram.ssl
- Whether to relocate in SSL or not. You need to explicitly say TRUE or FALSE if going out from SSL. If none passed, we look at the even's SES base URL (if in SES mode)baseURL
- Use this baseURL instead of the index.cfm that is used by default. You can use this for ssl or any full base url you would like to use. Ex: https://mysite.com/index.cfmpostProcessExempt
- Do not fire the postProcess interceptorsURL
- The full URL you would like to relocate to instead of an event: ex: URL='http://www.google.com'URI
- The relative URI you would like to relocate to instead of an event: ex: URI='/mypath/awesome/here'statusCode
- The status code to use in the relocationSet PluginService
pluginService
Set RequestService
requestService
I set a Global Coldbox setting variable in the configstruct, if it exists it will be overrided. This only sets in the ConfigStruct
name
- The name of the settingvalue
- The value of the setting (Can be simple or complex)Store the validation manager for the application
validationManager
Set the WireBox instance
wireBox
- The WireBox instanceI Check if a value exists in the configstruct or the fwsettingsStruct.
name
- Name of the setting to find.FWSetting
- Boolean Flag. If true, it will retrieve from the fwSettingsStruct else from the configStruct. Default is false.Update SSL or not on a request string
inURL
ssl
Checks if an action can be executed according to inclusion/exclusion lists. Boolean
action
- The action to checkinclusion
- inclusion listexclusion
- exclusion list