Creating a simple Layar with ColdFusion: a step by step tutorial

I have been doing a lot of mobile development recently. The jqtouch plugin for jquery is awesome by the way! If you have not had the delight of developing with it yet I highly recommend the plugin for you next mobile project.

Anyhow back to Layar, I was asked to produce a simple Layar for one of our clients. Layar if you don't know is a cool augmented reality browser for the iPhone and Android. Other phone operating systems have been announced and its set to come pre-installed on most phones by 2012.

Augmented reality is exploding in Europe and I really think it's the next big thing. Creating a Layar is supper easy but no tutorial seemed to exist showing how to create POI in ColdFusion so I decided to write a quick post from an asp.NET Layar I did a few weeks back.

Before you start...

Requirements

  • Webserver with ColdFusion 8 or Above (JSON support needed)
  • Android or iPhone 3GS or above (needs GPS and compass)
  • Gmail Account

You should know that a Layers consist of two parts:

Layer definition: Created using a web form on the Layar Publishing site. I will show you how to do that.<.p>

Points of Interest within a layer: Fetched directly from the Layer Service Provider via the API. We will do this in CF. I will show you a quick example of this here also

[More]

ColdBox M5 and 2.6.4 Playing Together Continued

This morning I had sometime on my hands to revisit how I had setup ColdBox M5 using refactoring. Following a comment by Jason Dean, who suggested it would be much easier to use application specific mappings with CF8+. So I decided to give it another ago.

When I first tried this I got an error due to Application.cfc extending the framework. As another comment pointed out ColdBox apparently since version 2.6 comes with a no inheritance version that instead of extending the framework bootstraps it. This would allow me declare my mapping before the framework is initialised.

view plain print about
1<cfset this.mappings[ "/coldbox" ] = expandPath( "/coldbox" ) />

This is why I love the medium I choose to express myself in and the CF community, because they are so helpful.

ColdBox M5 and 2.6.4 Playing Together

To do this without refactoring see: http://www.cfcoffee.co.uk/index.cfm/2010/5/2/ColdBox-M5-and-264-Playing-Together-Continued

Have you downloaded the lasted update from Luis, ColdBox M5? No? Well you should download it right now! So many new goodies, however running CB release M5 alongside my stable version CB 2.6.4 took me a while to set-up in my environment. I have been playing with the new update for a week, but only locally. Now I wanted to actually do something I would need to run it in an environment with an older version.

I run IIS6 and have CB 2.6.4 mapped in my ColdFusion Administrator. Any reference to coldbox/system will use this release. I wanted to run both versions so that my old applications running 2.6.4 still work!

As I found out this can be done very easily following ColdBox Refactoring Guide found here and the Ant Script found in the download. I had a few issues with this tho, not many but here is what I did....

Your set-up many differ from this, this is just my experience!

I Downloaded M5 from the the ColdBox site and placed it on my desktop following the instructions in the refactoring guide. I used ColdFusion Builder to run the Ant script not Eclipse but it's the same.

My default path for my CFC's is coldbox.system, this is mapped in my ColdFusion Administrator to shared/frameworks/coldbox/system. Because my new version is going to run inside the same 'framework' folder I entered not the full path to the new location as the guide shows but the Logical Path. This is my case would be coldbox3.system.

[More]

BBC News Feedback on the ColdBox Application by Gencia Media

The feedback and press have started to come in for the She Says, She Says campaign created by Gencia Media which used ColdFuson and the framework ColdBox to power a mobile application to help awareness of teen sexual violence and rape. Read the full article on the BBC here

ColdBox Helps Government Rape Awareness Campaign

The start of several Government projects including a mobile application that helps teenagers become more aware of what constitutes as rape and how to get support was launched today. The applications both mobile and web needed a fast and reliable approach. After a short debate the development team including myself decided to use the ColdBox Framework by Luis Majano along with jQTouch (A jQuery plugin for mobile web development) we first heard about on a CF Podcast (CFHour).

The first campaign is using a version of Gencia's new survey based system written with the ColdBox framework. It's designed for Schools allowing them to create both mobile and web campaigns which then local authorities get live statistical data on how each area is doing including detailed analyse of changes in patterns of behaviour.

[More]

Learning Coldbox: Validating

I have tried many ways to validate data in ColdBox, and there are many ways! I have used 3rd party plug-ins and followed many blogs posts on the subject. I want to share one of my preferred ways to validate data in ColdBox. Its not the most polished method and it has its flaws (persisting values) but it has worked well for me!

First I will create an example handler (show below). This handler is used to display School data based on the ID and School URL passed to it. I won't go into the Application or the model here.

[More]

IE and XML issue over SSL

I spent most of Friday morning with a strange ColdFusion and XML issue. A number of customers reported that a flash application we run was hanging on the loading screen. The flash accepts a XML file created by ColdFusion. The flash application appeared to be working in FireFox and Chrome but not in good old IE! The plot thickens, when the request was made on port 80 and not SSL the flash worked in IE and the load was successful.

The problem got even more strange, some IE users were successfully loading the flash. The only difference between the two IE users where some had installed a set of IE updates (xml did not load) and the other had not (xml worked, flash loaded).

[More]

Learning ColdBox: Coldbox Proxy How Cool is This!

I had some CFGRID code I needed to implement into an existing ColdBox application. The grid run out of the box without any intervention from the ColdBox Framework. However it would be necessary for the CFGRID to access my service layer and properties injected from ColdSpring if I wanted it to take full advantage of the CB Framework. I assumed this would be a nightmare, I mean how to I get my AJAX grid to use the same reusable ColdBox and model code?

With ColdBox Proxy of course! The ColdBox proxy enables remote calls like AJAX to communicate with ColdBox and take advantage of all the goodies it has to offer, thanks ColdBox!

So how easy was it to get working? Very, it only took a few extra lines of code to work, really!

First I told my CFGRID to access the proxy directly and not the CFC.

view plain print about
1bind="cfc:admin.coldboxproxy.getAllproducts({cfgridpage},
2 {cfgridpagesize},
3 {cfgridsortcolumn},
4 {cfgridsortdirection})"

Next using the ColdBox proxy template already provided (which extends coldbox.system.extras.ColdboxProxy) I created a new function that works the same was as handlers in ColdBox.

view plain print about
1<cffunction name="getAllproducts" output="false" access="remote" returntype="any" hint="Process a remote call and return data/objects back.">
2 <cfargument name="page" type="numeric" required="yes">
3 <cfargument name="pageSize" type="numeric" required="yes">
4 <cfargument name="gridsortcolumn" type="string" required="no" default="">
5 <cfargument name="gridsortdir" type="string" required="no" default="">
6
7 <cfset var results = "">
8 <cfset results = getBean("storeService").getAJAXProducts(page=#arguments.page#,                     pageSize=#arguments.pageSize#,
9            gridsortcolumn=#arguments.gridsortcolumn#,
10            gridsortdir=#arguments.gridsortdir#) /
>

11
12 <!--- Convert Query for Paging --->
13 <cfreturn QueryConvertForGrid(results,page,pageSize)>
14</cffunction>

getBean("storeService") interact directly with the service layer. Once this was done I could then take advantage of my dependency injection framework and ColdBox features. How cool is that!

Learning ColdBox: Multiple Updates uisng a Object

My venture in ColdBox has been so far very enjoyable. It has really changed the way I plan my applications. My stumble in to using objects (correctly) has also brought with it some challenges and changed my approach to building maintainable and reusable applications.

So far my blog entries on ColdBox have mainly been on objects, validation and persistent, all straight forward when doing simple updating/creating/deleting actions.

Anyway, going back to challenges and objects, my first real stumbling block came a few weeks ago. How do I insert multiple records from data that comes from a form using a object?

I asked this question on both the ColdBox forums and CFTALK list. They all make it sound so simple, not sure they had this in mind.

My problem was as follows: when creating/updating a product I need to insert/update or delete multiple records for the product options based on what the user ticked or not ticked. So my first attempt worked that's a start right? here goes....

[More]

Persisting Values in ColdBox

I have never found a way to validate data I feel is 100% right for me, but I think I am getting close, let me explain.

I have a simple ColdBox 'view' containing my user form. This form is used to both create and update user's credentials.

view plain print about
1user view
2
3<cfoutput>
4 <fieldset>
5 <div class="fm-req">
6 <label for="firstname">First Name</label>
7 <input id="firstname" name="firstname" type="text" class="text" value="#rc.bean.getfirstname()#" maxlength="15">
8 </div>
9 <div class="fm-req">
10 <label for="surname">Last Name</label>
11 <input id="surname" name="surname" type="text" class="text" maxlength="15" value="#rc.bean.getsurname()#">
12 </div>
13 <div class="fm-req">
14 <label for="email">Email Address</label>
15 <input id="email" name="email" type="text" class="text" maxlength="100" value="#rc.bean.getemail()#">
16 </div>
17 <div class="fm-req">
18 <label for="username">Username</label>
19 <input id="username" name="username" type="text" class="text" maxlength="12" value="#rc.bean.getusername()#">
20 </div>
21 <div class="fm-req">
22 <label for="password">Password</label>
23 <input id="password" name="password" type="password" class="text" maxlength="20" value="#variables.PasswordEncrypt#">
24 </div>
25 </fieldset>
26</cfoutput>
view plain print about
1example handler
2
3<!--- Edit User --->
4<cffunction name="editUser" access="public" returntype="void" output="false">
5<cfargument name="Event" type="coldbox.system.beans.requestContext">
6 <cfscript>
7     var rc = event.getCollection();// RC Reference
8
var userBean = variables.adminUsersService.createAdminUserBean(); //Create adminUserBean
9
     getPlugin('beanFactory').populateBean(userBean);//the magic bean machine
10
     variables.adminUsersService.getUserByID(userBean);
11     rc.bean = userBean;
12     event.setValue("pageTitle","Edit System User");//Form H1 Title
13
     event.setValue("formURL","/users/updateUser?adminId=#rc.adminId#");
14     event.setValue("buttonValue1","Update User");//H1 Title
15
     runEvent(event='users.createUserTabs',private=true); // Create User Tabs
16
     Event.setView("user/edit"); // Set the View To Display, after Logic
17
</cfscript>
18</cffunction>

I use one handler to create a new user and another to update, the only difference is the update handler pre populates the object from the database. So far simple stuff. Next I needed to validate my input. Again simple, I would submit to an intermediate handler that would validate my data against the object. However my dilemma is what to do if validation fails!

view plain print about
1<!--- Validation --->
2<cffunction name="validation" access="public" returntype="void" output="false">
3<cfargument name="Event" type="coldbox.system.beans.requestContext">
4 <cfscript>
5     var rc = event.getCollection();// RC Reference
6
var userBean = variables.adminUsersService.createAdminUserBean(); //Create adminUserBean
7
getPlugin('beanFactory').populateBean(userBean);//the magic bean machine
8
    
9     errors = userBean.validateUserALL();//Check For Validation Errors
10
    
11     if NOTT ArrayLen(errors)){//No Validation Errors
12
    
13         if ( variables.adminUsersService.updateUser(userBean)) {//Update Was OK
14
             getPlugin("messagebox").setMessage("info", "User was successfully updated.");
15         }
16         else {//Could Not Update User Show Error Message
17
             getPlugin("messagebox").setMessage("error", "Sorry, for some reason this user was not updated!");
18         }
19        
20     setNextEvent('users.overView'); // Set the Event To Run, After Logic
21
     }//End Of No Validation Errors
22
    
23     else {//We Have Validation Errors Show The User A Message
24
getPlugin("messagebox").setMessage("error", "<b>The Following Validation Errors Occurred:</b><br />",errors);
25        
26 ///what to do here?
27
        
28 }
29
</cfscript>
30</cffunction>

[More]

More Entries

 

About Me

Glyn Jackson, 28 years old, MD and senior developer of a development firm based in Staffordshire called Newebia Ltd. Academic background in BSc Information System & Internet Commerce. Online marketing expert (EE Ranked) and .NET developer. Has been developing with ColdFusion for 5 years and loves it. "I am not a veteran in ColdFusion but I do work on challenging projects which help me learn more about ColdFusion and if I can contribute to the community in anyway then, it's all good!"

Recommends

  • ColdFusion