Officially Deprecated Elements - Mach-II/Mach-II-Framework GitHub Wiki

Elements To Be Removed in Mach-II 2.0.0

We wanted to remind everyone about the elements that are officially deprecated. Please take this list seriously as we plan to remove all of the elements in this list in Mach-II 2.0. Unlike in Java, where elements remain in the virtual machine despite being deprecated many years ago, the items in this list will go away in Mach-II 2.0. Read more to check out what is going to removed from the framework core in Mach-II 2.0 which is slated for release in the first half of 2009.

Elements To Be Removed in Mach-II 2.0.0

These elements are officially deprecated and will be removed from Mach-II in version 2.0!

Most deprecated features will log a message at the warn level. Use the Mach-II 1.6 logging package.

Old Invokers

CFCInvoker_Event.cfc and CFCInvoker_EventArgs.cfc were officially deprecated in Mach-II 1.1.0. Please use the new invokers. If you do not know what a listener invoker is, then you are not using them and have nothing to worry about. Using these will result in a log message at the warn level.

ContentKey and ResultKey

In conjunction with the old invokers, ContentKey and ResultKey were deprecated in Mach-II 1.1.0 although we did not preach this deprecation in the documentation fully. Some of our planned features such as caching and some of the other unannounced features in 2.0 rely on using ContentArg and ResultArg. Please develop all new applications with using ContentArg and ResultArg. Using these will result in a log message at the warn level.

EventBean Filter

This filter is bundled in the core framework, but it will be deprecated in Mach-II 1.5 as it was replaced by the event-bean command in Mach-II 1.0.6. Using these will result in a log message at the warn level.

`hasParameter()` in BaseComponent

hasParameter() is a function available in the BaseComponent, which is in turn inheirited by all listeners, filters, properties and plugins. In an effort to clean up the API and keep consistent method names, please use isParameterDefined() instead. hasParameter() was officially deprecated in Mach-II 1.1.0. Using these will result in a log message at the warn level.

`hasProperty()` in PropertyManager

hasProperty() is a function available in the PropertyManager. In an effort to clean up the API and keep consistent method names, please use isPropertyDefined() instead. hasProperty() was officially deprecated in Mach-II 1.1.0. Using these will result in a log message at the warn level.

Trace Plugin

The MachII.plugins.TracePlugin was officially deprecated in Mach-II 1.6. Use the new Logging functionality that was added in Mach-II 1.6. Using these will result in a log message at the warn level.

Application.cfm bootstrapper (mach-ii.cfm)

The mach-ii.cfm bootstrapper for Application.cfm was officially deprecated in Mach-II 1.6. Use the Application.cfc boostrapper added in Mach-II 1.1.1. Using these will result in a log message at the warn level.

`request.MACHII_CONFIG_MODE` in Application.cfc bootstrapper (mach-ii.cfc)

The legacy code that supports the request.MACHII_CONFIG_MODE was officially deprecated in Mach-II 1.6. Do not use the request scope to temporarily override the config mode, use an unqualified MACHII_CONFIG_MODE variable in your Application.cfc since the mach-ii CFC in inherited by your Application.cfc. Using this will not log a message at the warn level.

`setArgType()`, `getArgType()` and the `argType` argument of `setArg` in Event.cfc

The argType feature of the Event object was never implemented and was officially depreated in Mach-II 1.8. Do not this theses functions or argument as it will be removed in Mach-II 2.0.