Welcome to Railo Ajax

The project has the mission to create and extend the ajax capabilities included into the railo cfml engine.

RailoAjax is made up of :

  • A set of tags build as cfc classes. This feature, introduced into Railo 3.1.1, is at the base of the project itself.
  • A custom javascript library that manage the low level js involved into the tags behaviours.
  • A set of javascript interfaces and conventions that will allow the switch between different
    UI js libraries keeping the integrity of the core cfml and js code.
  • A provider class that can be used to extend you Railo server remotely. That's all true ... you can install RailoAjax from your Railo admin panel.
 railo ajax

feed News

  • RailoAjax is going to close

    While this can looks like a bad new .... well it is not.

    Latest Railo BER ( 3.1.2.019 ) has included also the missing part of RailoAjax project into the Railo core distribution. From this point the development and maintenanace of the tags will be made directly from the Railo project itself.

    As per today Railo included the following tags:

    • cfajaxproxy
    • cfajaximport
    • cfdiv
    • cfmap
    • cfmapitem
    • cfwindow
    • cflayout and cflayoutarea ( just for tabs )
    • ajaxonload function
    • the js library that support the previous tags 

    I am quite happy about this step. RailoAjax just started like a fun coding of the ajaxproxy and ended into the Railo core..... I really have to thanks all the Railo Team for the support received.

    So please note the following:

    • If you have a RailoAjax extension installed into your server or we context please remove it before update to 3.1.2.019. Or if you have already updated just remove the extension and restart the Railo.
    • The RailoAjax website and the trac  will be shutted down when Railo 3.2 will be delivered.
    • The RailoAjax extension provider http://railoajax.org/extensionProvider.cfc  will be still available up to the 31 december 2010.

    If you have any issues please contact me or raise a JIRA tickect.

    If you want to help coding new functionalities the source code is available on github.

     

     

    (August 21, 2010)

  • Railo starts ajax support

    I am a bit late blogging about this but I had a quite 'intense' maech.

    Since version 3.1.2.009 Railo starts the ajax tags support . You can read more here.

    Ok so what's teh big news? What make me proud is that I developed those tags and after a long debugging they are finally part of the Railo core engine. The tags comes from the RailoAjax project that will go on focusing on the remaining ajax tags to fill the gap with ACF ( that's the plan .... but it's a long road to do ....).

    This is an example of how a community effort can really contribute to the main project. I am sure more efforts will come in the future ... so if you an idea .... some spare time ..... and you wish to contribute do not hesitate to contact me .... Railo needs you.

    (April 12, 2010)

  • RailoAjax 0.5.2 with cfmap is out

    Railo Ajax arrived to version 0.5.2.

    From this release cfmap has entered into the set of tags that RailoAjax ships. Cfmap support is still experimental and do not cover event the 50% of the ACF version but development is on the way.

    See more here.

    Remember that the demo app that you see online is installed ( if required ) when RailoAjax deploy on your Railo server. So you can have a look to the demo code that can help you on development stage.

    Another important announcment is that CFMENU is on the way to appear from a community contribution. Cfmenu has been added to 0.6 milestone ( at least in alpha version ).

    Next step will be focused on docs. For a month or so the main efforts ( over cfmap implementation ) will be on dodumenting what has been done up to know keeping an eye on bugs of course.

    Do not hesistate to contact me for any question and of course .... project is open ... so feel free to jump in ....

    (December 11, 2009)

  • Railo Ajax 0.5.1.5 released

    A new version has been released.

    The most interesting news is the complete refactor of the UI tags. RailoAjax library now provide bridges classes that need a speficic adapter to perform the action required. This allows to switch between one library support to another with no need to change the core code.

    An example can be found here.

    Once the concrete implementation is done ( the Ext cfwindow is already done ) you can choose the library using the cfajaximport tag.

    <cfajaximport library="ext"/>

    Having implemented a bridge pattern for any UI implementation has also allowed us to provide a set of new events provided directly by the Railo.Events engine that do not rely on the specific implementation making code even more portable. The following event has been added :

    • Window.beforeCreate
    • Window.afterCreate
    • Window.beforeShow
    • Window.afterShow
    • Window.beforeHide
    • Window.afterHide
    • Window.beforeClose
    • Window.afterClose
    • Layout.afterTabSelect
    • Layout.beforeTabInit
    • Layout.afterTabInit
    • Layout.beforeTabCreate
    • Layout.afterTabCreate
    • Layout.beforeTabRemove
    • Layout.afterTabRemove
    • Layout.beforeTabSelect
    • Layout.afterTabSelect
    • Layout.beforeTabDisable
    • Layout.afterTabDisable
    • Layout.beforeTabEnable
    • Layout.afterTabEnable

    What is usefull is that these events will always be usable in the same way not depending by the the tag concrete implementation. So If I need to listen to a window hide event and I have choosed the ext implementation I can use both the following syntax:

    Railo.Events.subscribe(callback,'Window.beforeHide')
or
Railo.Window.getWindowObject('mywin').addListener('beforeclose',callback,this);

    The RailoLayout.js package has already been rewritten with the default jquery implementation.

    Version 0.5.2 will allow ui tags to receive an options arguments called 'args'. This struct will be converted into json and pushed into the implementation init method. In this way any config defined by the jquery or ext apis will become available. I am also working on a start for cfmap implementation. 

     

    (November 8, 2009)

  • Railo Projects

    I have just finished to move RailoAjax project to the new, and final location, into the brand new space Railo is creating for supporting OS projects.

    Site is now visible at http://projects.getrailo.org/projects/railoajax/

    Svn has been migrated and can be found at http://svn.getrailo.org/svn/railoajax/  ( checkout as guest/guest)

    Trac install  http://getrailo.org/trac/railoajax/

    If you have a started project related to Railo or an idea you and you need support on your development please visit :

    http://projects.getrailo.org

    or drop me a line.

    (October 22, 2009)

  • Railo Ajax 0.5.1.4

    This version of RailoAjax starts the support of functions not strictly related to a tag or to a UI object like tabs or windows.

    Firsts functions to be supported are:

    Railo.Ajax.submitForm
    (formId,url,callbackhandler[,errorhandler,httpMethod,asynch,returnFormat,beforeSend])

    You can use this fucntions to ask a form to be ajax submitted at any time with no need to trigger the submit event.

    Railo.Ajax.ajaxForm
    (formId[,target,callbackhandler,errorhandler,returnFormat,beforeSend])

    This function is used to configure a form to be submitted in ajax mode. The main difference with the previous one is that in this case the form will be submitted in ajax mode in any case, and not only when invoked by the function itself.

    Railo.Ajax.navigate is on development stage.

    (October 8, 2009)

  • RailoAjax.org

    The RailoAjax project has finally arrived to his own location.

    RailoAjax.org is a the home site that will show news, guides to get started and will be updated with any usefull information about releases, road map, tutotials etc…

    The documentation part has been moved into a dedicated Trac Install that can be found at http://docs.railoajax.org.

    The Trac install will be used for:

    • Docs in wiki format
    • Tickets
    • Milestones and road map
    • Svn Browse

    A new extension provider has been created and is already available:

    http://railoajax.org/provider.cfc

    Use the Railo’s google group list for posting any related question or contact me at : andrea@railoajax.org.

    The spece on assembla site will be closed in teh next days.

    (October 3, 2009)

  • RailoAjax core is jquery free.

    To make library lighter, especially for core usage, I have removed the jQuery dependency from the core RailoAjax library. What does this mean ??

    Core tags like cfajacproxy or cfdiv do not use any UI lib and they rely on the lonely RailoAjax library. Up to version 0.5.1 some task like binding and xhr calls where made with the jQuery help and we were forced to load jQuery in any page.

    From version 0.5.1.1 ( already available ) RailoAjax is free from jquery dependency:

    XHR

    You can now use RailoAjax as a XHR utility:

    var x = new Railo.XHR() ;
x.request({
url : url,
success:....
});

    DOM Events

    Dom event binding can be added like this:

    ]Railo.Util.addEvent(dom element, event, callback );

    Btw I decide to keep one dependency in RailoAjax that is Sizzle.js.

    Sizzle is the most powerfull selector engine out there. Sizzle is fast, flexible and come from jQuery core.

    Check out docs if you like.

    You can use sizzle just as you were used to use jQuery selector:

    var element = Sizzle('#myId');

    Of course Sizzle return array of dom elements and not jQuery Objects.

    (September 18, 2009)

  • Railo Ajax 0.5.1

    RailoAjax 0.5.1 has been released.

    This update added the initial support for cflayout and in particular for the tab type. Over the cf8 compatibility I am trying to add more things like e deeper callback support and some extra functionalities from tje jquery UI library.

    You can update from Railo Admin ( if you already installed the extension ) or install from these 2 extensions providers:

    http://www.andreacfm.com/railoEx/andreacfm.cfc
    or
    http://preview.getrailo.org/ExtensionProvider.cfc ( this will be
    updated tomorrow - monday 14 during the day).

    Let me have your feedback and wishlist for the next project ehhancement.

     

    (September 13, 2009)

  • Railo Ajax 0.5.0.3

    I have just updated the RailoAjax extension provider with the new release. Many bugs have been fixed and a started cflayout ( just for tab up to now ) has been added to the demo page. Please let me have yur feedbacks, bugs, suggestions etc...

    You can grab a copy from svn repository or use the following extension provider:

    Svn

    AndreaCfm Extension Provider : http://www.andreacfm.com/railoEx/andreacfm.cfc

    From Railo preview server : http://preview.getrailo.org/ExtensionProvider.cfc

    Change log:

    0.5.0.3
    -------------------------------
    * Cflayout-tab binding.
    * Added support for tab add,hide,remove.
    * Support for tab custom styling.
    * Defined demo structure
    * Bug fixing.
    * Started docs in wiki.getrailo.org.

    0.5.0.2
    -------------------------------
    * Added cflayout tab initial support.

    0.5.0.1
    -------------------------------
    * New examples in demo pages.
    * Support for context root deployment.

    (September 7, 2009)

  • Railo Ajax Extension Provider

    I have created a Railo extension provider from my website. For the moment the only application you can install is the Railo Ajax Project that is also available from the http://preview.getrailo.org/ExtensionProvider.cfc provider.

    So now you have more choice... and I had the occasion to go deeper into railo extensions programming...

    Just add this url in the providers list of your Railo Admin ( server or web ) :

    http://www.andreacfm.com/railoEx/andreacfm.cfc

    Verify the provider and then you will find the Railo Ajax application available in the applications list. Run the install thread that will also install some demo into yoru webroot.

    IMPORTANT:

    If you have already installed the extension from the http://preview.getrailo.org/ExtensionProvider.cfc provider stay with that. I will update both the providers with new versions at the same time but as the providers are different and the extension have the same id some conflict is possible. Just choose one provider.

    (August 29, 2009)