FW/1 - The Invisible Framework

Framework One and friends...

FW/1 Roadmap

Whilst you can read the FW/1 issues list to see what’s on the cards for future releases, several people have asked that I document things at a higher level so they can get a better sense of what’s coming.

3.0 Integrations

FW/1 3.0 represents the direction that most users have already been going:

  • Using DI/1 to manage services and beans
  • Explicitly calling services in the item() controller methods

FW/1 3.0 bundles DI/1 and automatically creates bean factories following the convention of a model folder containing services and beans subfolders. Subsystems also follow this convention and use the main application’s bean factory as a parent to enable sharing of common services across subsystems.

FW/1 3.0 also slims down the framework by removing all of the service queue machinery and the start/end variants of controller methods, as well as coalescing all the framework components in a single folder framework (with org.corfield.framework replaced by framework.one).

2.5 Deprecations

FW/1 2.5 represented a large shift from 2.2.1 and deprecated a number of long-standing features that were removed in 3.0:

  • Service queue - implicit service calls were disabled in 2.x but still supported for backward compatibility with 1.x, but in 2.5 the whole service queue machinery is deprecated, including the service() call, and will be removed in 3.0.
  • startItem() / endItem() controller methods - these were originally introduced to encourage a clean separation of controller logic from (queued) service logic. With the service queue going away, they make no sense, so they are deprecated in 2.5 and will be removed in 3.0.
  • Global access to the rc variable - this was never really intended to be supported but some users found it convenient and started to rely on it. Due to edge case bugs, and the fact that there are better ways to manage the rc in the lifecycle, global access is deprecated in 2.5 and will be removed in 3.0. This will mostly affect users who update the rc in setupRequest() - logic which should generally be moved to Application.cfc in the global before() controller method.

2.x Release Stream

This is the previous stable stream. FW/1 2.5 is the latest stable version. The 2.x versions support Adobe ColdFusion 9.0.1 and later, Lucee 4.5.0 and later, and Railo 3.2.2 and later.

Changes between 1.x and 2.x include:

  • No more implicit service calls
  • Custom route support
  • Property-based injection in controllers
  • Better lifecycle control: layout and view control, abort controllers
  • Better REST support: render data instead of views, resource packs and regular expressions in routes
  • Environment control
  • Application tracing
  • Automated test suite

1.x Release Stream

This is the legacy stream. FW/1 1.3 is the most recent legacy version, provided to support older CFML engines (Adobe ColdFusion 9.0.0 and earlier, Railo 3.1.x, Open BlueDragon). FW/1 2.x and 3.x will not run on these older CFML engines. Only critical fixes will be made to the 1.x release stream. Currently no new 1.x releases are planned.