ColdBox's Thrown Exception Types
- Framework.InvalidEventException
- Framework.onInValidEventSettingException
- Framework.InvalidEventHandlerException?
- Framework.ServiceNotDefinedException
- Framework.eventhandler.UDFLibraryNotFoundException
- Framework.EventHandlerInstantiationException
- Framework.InterceptorService?.InterceptorCantBeCached?
- Framework.plugins.settings.EventHandlerNotRegisteredException
- Framework.SettingNotFoundException
- Framework.coldboxFactory.DatasourceStructureEmptyException
- Framework.coldboxFactory.DatasourceNotFoundException
- Framework.actioncontroller.DatasourceStructureEmptyException
- Framework.actioncontroller.DatasourceNotFoundException
- Framework.actioncontroller.i18N.DefaultSettingsInvalidException
- Framework.loaderService.HandlersDirectoryNotFoundException
- Framework.loaderService.NoHandlersFoundException
- Framework.ValueNotInRequestCollectionException
- Framework.plugins.XMLParser.ColdBoxSettingsNotFoundException
- Framework.plugins.XMLParser.ColdboxSettingsParsingException
- Framework.plugins.XMLParser.ConfigXMLFileNotFoundException
- Framework.plugins.XMLParser.ConfigXMLParsingException
- Framework.plugins.XMLParser.InvalidCacheObjectDefaultTimeout
- Framework.plugins.XMLParser.InvalidObjectDefaultLastAccessTimeout
- Framework.plugins.XMLParser.InvalidReapFrequency
- Framework.plugins.XMLParser.InvalidMaxObjects
- Framework.plugins.XMLParser.InvalidFreeMemoryPercentageThreshold
- Framework.plugins.beanFactory.BeanCreationException
- Framework.plugins.beanFactory.PopulateBeanException
- Framework.plugins.cfcViewer.GettingMetaDataException
- Framework.plugins.FileWriter.InvalidEncodingException
- Framework.plugins.i18n.InvalidLocaleException
- Framework.plugins.ioc.InvalidIoCFramework
- Framework.plugins.ioc.InvalidDefitinionFile
- Framework.plugins.JavaLoader.PathNotFoundException
- Framework.plugins.JavaLoader.PathNotFoundException
- Framework.plugins.logger.InvalidSeverityException
- Framework.plugins.logger.WritingFirstEntryException
- Framework.plugins.logger.ColdboxLogsLocationNotFoundException
- Framework.plugins.messagebox.InvalidMessageTypeException
- Framework.plugin.queryHelper.InvalidSortOrderException
- Framework.plugins.renderer.ViewNotSetException
- Framework.plugins.renderer.RenderExternalViewNotFoundException
- Framework.plugins.resourceBundle.FileNotFoundException
- Framework.plugins.resourceBundle.BundleNotLoadedException
- Framework.plugins.resourceBundle.RBKeyNotFoundException
- Framework.plugins.resourceBundle
- Framework.plugins.webservices.WebServiceNotFoundException
- interceptors.environmentControl.configFilePropertyNotDefined
- interceptors.environmentControl.configFileNotFound
- interceptors.environmentControl.elementException
- interceptors.ses.configFilePropertyNotDefined
- interceptors.ses.executingConfigException
- interceptors.ses.invalidPropertyException
Below you can see a table of all the major exceptions the framework can throw during execution. You can actually use the exceptionHandler setting in the config.xml to declare an exception handler from where you can catch these exceptions and then determine what to do.
Framework.InvalidEventException
An invalid event has been detected and there are no custom traps for this error. Execution gets aborted.
Framework.onInValidEventSettingException
This exception occurs when an invalid event is detected in the system and the framework tries to fire the !onInvalidEvent setting, but that setting is also invalid. This exception will give you the details of both invalid events.
Framework.InvalidEventHandlerException?
When the invalid event handler is also invalid.
Framework.ServiceNotDefinedException
Internal service locator exception. An internal service could not be located.
Framework.eventhandler.UDFLibraryNotFoundException
The UDF library file declared in the config.xml cannot be located. So an exception is raised.
Framework.EventHandlerInstantiationException
The invalid event handler defined in the config.xml is also invalid.
Framework.InterceptorService?.InterceptorCantBeCached?
This means that the just created interceptors cannot be cached, and they need to be cached. Either the cache limit has been reached or there is no more memory in the JVM.
== Framework.InterceptorService?.InvalidInterceptionState?== The state sent in for execution is invalid.
Framework.plugins.settings.EventHandlerNotRegisteredException
An event to be executed could not be found in the internal handler registry. This registry is auto-populated by the framework by reading and parsing your public methods from your event handler components at the initialization of your application. If you are developing the application and added a new method and receive this error, you need to reload the index using the fwreinit=1 URL action or by placing the HandlersIndexAutoReload setting to TRUE (Only for Development). If not, an invalid event was detected. You can trap this error by using your exception handler and determining what to do with the flow.
Framework.SettingNotFoundException
The getSetting() method was called and the value it tried to retrieve did not exist in the structure.
Framework.coldboxFactory.DatasourceStructureEmptyException
You have tried to get a datasource bean, but the datasource configuration structure is empty. This means that you have not defined any datasources in your config file.
Framework.coldboxFactory.DatasourceNotFoundException
The datasource alias used to request a datasource bean is invalid or cannot be found. Please check your alias and your config file.
Framework.actioncontroller.DatasourceStructureEmptyException
You have tried to get a datasource bean, but the datasource configuration structure is empty. This means that you have not defined any datasources in your config file.
Framework.actioncontroller.DatasourceNotFoundException
The datasource alias used to request a datasource bean is invalid or cannot be found. Please check your alias and your config file.
Framework.actioncontroller.i18N.DefaultSettingsInvalidException
The default settings for the i18N could not be located. Most likely they have not been defined in the config file.
Framework.loaderService.HandlersDirectoryNotFoundException
Thrown at application initialization. Using the application mapping defined in the config.xml, the framework tries to locate the handler's directory in the application root. If it cannot be found, then no events can be fired. Therefore, execution is aborted and an exception is thrown.
Framework.loaderService.NoHandlersFoundException
Thrown at application initialization. The handler's directory was found in the correct place. However, there where no event handler cfc's in the directory. Therefore, execution is aborted and an exception is thrown.
Framework.ValueNotInRequestCollectionException
A call to the getValue() method request a value that did not exist in the request colleciton.
Framework.plugins.XMLParser.ColdBoxSettingsNotFoundException
The framework could not find the settings.xml file. THIS IS CRITICAL, something is defintely wrong with your framework installation.
Framework.plugins.XMLParser.ColdboxSettingsParsingException
The framework could not parse the settings.xml file. THIS IS CRITICAL, something is defintely wrong with your framework installation or parsing engine.
Framework.plugins.XMLParser.ConfigXMLFileNotFoundException
The framework could not locate the config.xml.cfm file for the current running application. Please verify that the config folder exists in your application, the application mapping is correct, the config.xml.cfm file exists and it has the correct read permissions.
Framework.plugins.XMLParser.ConfigXMLParsingException
The framework throws this error whenever a mandatory element has not been defined in the config.xml or the config.xml does not vaidate with the framework's config.xsd Schema.
Framework.plugins.XMLParser.InvalidCacheObjectDefaultTimeout
Invalid value for the default object timeout.
Framework.plugins.XMLParser.InvalidObjectDefaultLastAccessTimeout
Invalid value for the default last access timeout.
Framework.plugins.XMLParser.InvalidReapFrequency
Invalid value for the reaping frequency.
Framework.plugins.XMLParser.InvalidMaxObjects
Invalid value for the max objects setting.
Framework.plugins.XMLParser.InvalidFreeMemoryPercentageThreshold
Invalid free memory percentage threshold value
Framework.plugins.beanFactory.BeanCreationException
Thrown by the create() method in the bean factory plugin when trying to instantiate the named bean. Make sure the bean exists or is spelled correctly.
Framework.plugins.beanFactory.PopulateBeanException
Thrown by the populateBean() method when an error occurs populating a bean.
Framework.plugins.cfcViewer.GettingMetaDataException
Thrown by the getCFCMetaData() method in the cfc viewer plugin when an unhandled exception occurrs when trying to get the metadata from a cfc using the TemplateProxy.
Framework.plugins.FileWriter.InvalidEncodingException
The filewriter plugin throws this exception when the encoding defined or passed to it's methods is invalid or not supported.
Supported Encodings:
- US-ASCII Seven-bit ASCII, a.k.a. ISO646-US, a.k.a. the Basic Latin block of the Unicode character set
- ISO-8859-1 ISO Latin Alphabet No. 1, a.k.a. ISO-LATIN-1
- UTF-8 Eight-bit UCS Transformation Format
- UTF-16BE Sixteen-bit UCS Transformation Format, big-endian byte order
- UTF-16LE Sixteen-bit UCS Transformation Format, little-endian byte order
- UTF-16 Sixteen-bit UCS Transformation Format, byte order identified by an optional byte-order mark
Framework.plugins.i18n.InvalidLocaleException
The locale set in the config or passed in to the load locale method is an invalid locale string.
Framework.plugins.ioc.InvalidIoCFramework
The IoC framework chosen is invalid. The only valid values are coldspring and lightwire as of now.
Framework.plugins.ioc.InvalidDefitinionFile
The definition file set in the config file or in the plugin is invalid. Please check your path.
Framework.plugins.JavaLoader.PathNotFoundException
The java loader cannot load the specified file. It is either missing or misspelled.
Framework.plugins.JavaLoader.PathNotFoundException
The loadLocale() method threw an invalid exception on the locale it tried to load. Please look at your JVM's supported locales.
Framework.plugins.logger.InvalidSeverityException
The logEntry method has been called with an invalid severity. The available severities are: information, fatal, warning, error
== Framework.plugins.logger.LogFileNotWritableException== The log file is not writable.
Framework.plugins.logger.WritingFirstEntryException
If you receive this error, then for an unforseen error, the jvm cannot write to the log file. You can either check permissions on the file or the directory.
== Framework.plugins.logger.WritingEntryException== If you receive this error, then for an unforseen error, the jvm cannot write to the log file. You can either check permissions on the file or the directory.
Framework.plugins.logger.ColdboxLogsLocationNotFoundException
The log location directory declared in the config.xml cannot be located or it does not exist. Please verify the location.
Framework.plugins.messagebox.InvalidMessageTypeException
An invalid message type was set to the setMessage() method of the messagebox plugin. The available types are error, info, warning
Framework.plugin.queryHelper.InvalidSortOrderException
The sort order sent in to the sort query method is invalid. You can only send asc or desc.
Framework.plugins.renderer.ViewNotSetException
Thrown by the renderer plugin when the framework is trying to render a view and the executed event handler did not set a view to be rendered.
Framework.plugins.renderer.RenderExternalViewNotFoundException
Thrown by the renderer plugin when the framework is trying to render an external view. Please look at stack trace for more information.
== Framework.plugins.renderer.RenderExternalViewInvalidException== Thrown by the renderer plugin when the framework is trying to render an external view. Please look at stack trace for more information.
Framework.plugins.resourceBundle.FileNotFoundException
The resource bundle declared in the config.xml or the resource bundle that was beign loaded was not found. Either the specific locale information is wrong or the resource bundle has not been named correctly.
Framework.plugins.resourceBundle.BundleNotLoadedException
Exception thrown by the getResource() method because it cannot find in memory the specific bundle for the current set locale. Please make sure that the resource bundle for the choosen locale exists.
Framework.plugins.resourceBundle.RBKeyNotFoundException
The specified key cannot be found in the specified locale resource bundle. Thrown by the getRBString() method.
Framework.plugins.resourceBundle
Thrown by the messageFormat() method when an unexpected error occurs in this method.
Framework.plugins.webservices.WebServiceNotFoundException
You have called the getWS() or getWSobj() method with an invalid alias that has not been declared in the config.xml
interceptors.environmentControl.configFilePropertyNotDefined
The configFile property was not defined
interceptors.environmentControl.configFileNotFound
The config file was not found.
interceptors.environmentControl.elementException
The xml is not properly defined, look at samples.
interceptors.ses.configFilePropertyNotDefined
The configFile property was not defined
interceptors.ses.executingConfigException
Error executing the config file
interceptors.ses.invalidPropertyException
Some of the properties have not been correctly defined in the config file.
