MSOC Part 7: onSession Event Handler

Wow! I just discovered that this post has been sitting since February, waiting to be finished and posted. Time flies! Well, now that I've upgraded to the latest version of BlogCFC, it's a good time to add a new post.

In our last post, in this series, we talked about the onApplication event handlers, which automatically fire when a ColdFusion application starts and ends. This go around we'll discuss the onSession event handlers. As you may have guessed, the onSession handlers (onSessionStart and onSessionEnd) wrap a user session. The onSessionStart method fires when a user first visits an application, allowing you to initialize any SESSION scope variables.

[More]

New Job, New Home, A Lot of Work

It's been a very busy year, up til now. Work ramped up in February, contracting me for additional hours for a month and a half straight, after which I've worked on a sting of side projects. This helped me finance a move to Jacksonville, Florida. My new (daytime) job is full-time telecommute, which allows me to put my desk anywhere. Teresa wanted to get back to sunshine and beaches, being tired of the cold and snow of Tennessee winters, and chose Jacksonville for it's location and proximity to family and friends. Jacksonville is a great area, and we nailed a terrific place in Fleming Island. I like it because there's lots of tech (user groups and such), and it's not far from other tech centers (Orlando, Tampa, Atlanta, etc). It doesn't hurt that I can maintain a year around tan or that the beach is a short drive away.

A lot of work has come my way, often tacking an additional 40 to 60 hours a week on top of my normal day job schedule. Often I'll take a project that takes a week or two, then take a few weeks off to spend with the family (and catch up on my reading). I have a list of posts I need to write, due to exposure to some projects I hadn't previously been exposed to. Part of that already started with some exposure to the DataTables JQuery plugin, but I'm also lining up posts for jqGrid, jsTree, and the cfUniForm project. Evernote is filling up with little tidbits. The most difficult piece is coming up with the time to write examples. I'm particular about writing well formed code and documentation, which is why my posts sometimes get spaced out a bit.

One of the things I have discovered, in my exposure to these other projects, is how much I miss working with Ext JS day-to-day. JQuery UI is a good project, but lacks the maturity of Ext JS, and is missing too many key components for writing web applications (Data Stores, Grid, Tree, Menus, Tooltips, etc). My exposure to those other projects was an attempt to fill needs for which Ext JS would have been better suited, while locked into using JQuery UI. The JQuery UI team is working on closing that gap, but there is a lot of catch up necessary to match the breadth and power of Ext JS.

Speaking of Ext JS, Packt Publishing asked me to write the next Ext JS book on my own. While very flattered, I had to carefully weigh what that commitment would mean. Ultimately, I could not justify committing seven and a half months to writing the book with all of the other responsibilities I have right now. I will write a few articles for Packt (as part of my contract on the last book), but feel like I can continue to create blog content that would be more timely (no six month editorial process) and have a greater reach, and do so as my schedule permits without being a burden on my family. Sencha has already announced What to Expect in Ext JS 4.1, and recently put Ext Designer 1.2 in Beta, so there's a lot to talk about here.

Last, but definitely not least, I'm following all the buzz about the upcoming ColdFusion "Zeus". A quick Google Search already brings up a ton of info that Adobe has put out regarding the next version of the ColdFusion server platform, and it looks to once again be a significant release. Some of the big things already mentioned have been the move from JRun to Tomcat, the retirement of Verity in favor of Solr, the upgrade to Axis 2, and the inclusion of closures in CFML. That's just some of what's coming, as Adobe appears to be giving more and more detail during the various conferences through the year (and you never know the whole story until it's released).

How Did I Get Started With ColdFusion

Today, developers across the web answer "How I Got Started In ColdFusion". Each tale is unique, and this one is mine. My discovery of ColdFusion was a blessing, leading to a great life and fulfilling career of fantastic experiences with outstanding friends, acquaintances, and mentors. Here's how it started for me....

In the early nineties I was stationed at Ft. Meade, MD, working for the National Security Agency. Professional Development is a key thing in the military. We were expected to constantly learn and foster new skills that might help us do our jobs better. Being interested in computers at an early age, I started taking classes on computer systems and, having a background in linguistics, once again became fascinated with computer programming, taking classes in C and C++.

This new thing called "the internet" was becoming a big deal around the office. On my first PC, in the barracks, I was becoming a junky of Prodigy (then AOL, then my first ISP...) and learning to master 'search' through Alta Vista. At work someone asked me to create a 'web page' for our department on our local intranet. NCSA Mosaic was rapidly being replaced with Netscape Navigator, and updates to HTML had introduced new tags, like TABLE and IMG. Things were changing rapidly.

I started teaching myself HTML. Compared to 'programming languages', HTML was a walk in the park, though a bit frustrating in it's layout limitations. The internet was really becoming a big thing, and I thought I was ahead of the curve. I could make a living doing this? Wow, that would be cool! I had been in the Army for almost a decade. Still young, and single, with no kids, I had been thinking it was time to move on in the world. The Army had been good to me, but I thought I could do more, be more, back in the civilian world. (Mental Note: kick self later for being young and dumb)

I became friends with a guy who owned a screenprinting and advertising specialties company in southern Delaware. I created a quick web site for them, which helped them get some state funding for growth and expansion. They offered me a job, leading me to believe that my new skills could help them augment their corporate branding offerings to another level. After a brief assignment overseas, I put in paperwork to get out of the Army, packed up my stuff, and moved to the Eastern Shore to start a new life and career.

Things didn't quite work out as planned. The company really wanted someone to sell product to the military, develop paperwork automation processes in the office, and help out with 'production' (printing T-Shirts and stuff). Transitioning from military life to civilian life isn't always easy, and I had trapped myself in a strange place, with no real friends, in a job that wasn't going anywhere. I did this for three years, working 18+ hour days for next-to-nothing, becoming more and more disillusioned and watching myself slide behind the curve again. I had taught myself Visual Basic for Applications, tying together workflow between different MS Office applications, but my web development advancement had grown stale, being relegated to maintaining the company website with MS FrontPage (shiver). Then the best thing happened, I was layed off. The company decided they really needed a salesman more than a computer guru.

Unemployment has the fortunate by-product of forcing one to do the things they need to do. I knew that I loved computers, and had a talent for languages. I needed to get back to those things. For two months I called Manpower everyday, hauling stuff around warehouses or working in a buddies garage changing oil and tires, while scanning the want ads. Finally, I saw an ad for a Corporate Support Specialist with a regional Internet Service Provider. I went in for the interview, they gave me a test (on ColdFusion), and I failed. I didn't know the language, didn't have much for reference, and bombed it.

Luckily, the interviewer saw some potential. They referred me up to the manager of the Tech Support team. He was a retired Army guy himself, and had an open position in his department. The thought was, bring me in, learn the ropes and the business, and work on increasing my skills until I could transition to development. Now we're talking! I didn't make much, but it was more than the screenprinting company, better than being unemployed doing odd jobs, and it was getting back on track. I jumped on it.

I was a good Tech Support rep. We talked 70 year old ladies through manually creating a Windows Dialer to dial into our service. We talked 80 year old men through setting up and using email. Yes, that TV looking thing in front of you is called a 'monitor' and, no, that is not a cupholder (seriously). Things were pretty smooth, and I wasn't on the phone all the time, so I started brushing back up on web dev skills. I got on a mailing list to learn JavaScript (which had passed me by til then). I started playing with DHTML, and this new thing called CSS (Layout! Hot Damn!) To make it worthwhile, I created the first real FAQ for the ISP; a set of interactive, online tutorials for the basic tasks we always talked about on the phone (setting up email programs, configuring browser settings, etc.)

This was all good, but wasn't getting me moved to Corporate Support. I took on a real challenge on my own. I got a copy of Visual Studio from the college, and began to create a dialer application for the company. I had already gotten up to speed on the changes in HTML, picked up better than passable skills in JavaScript, and was fairly good with CSS. Now I needed to dig in deeper into programming, so I started learning Visual Basic (not a big jump from VBA), then InstallShield scripting, which in turn led to diving back in to C++. Four months later the ISP was pressing it's own CD's of the dialer app for distribution to new clients. And, they were hiring again in the Corporate Support department.

Delmarva Online was a small regional Internet Service Provider, with about 14,000 dialup clients, that also ran a small hosting business. They hosted roughly 600 corporate sites for everything from churches to school districts to car dealerships and small manufacturing companies. In it's earliest days they had used a server-side technology called IHTML, and by the time I moved into Corporate Support they still had one or two clients on that platform. But the majority of their clients were on something called ColdFusion, a server-side technology built on C++ by a company called Allaire. Coming in to Corporate Support, my job was similar to that of Tech Support; walking clients through email configuration and stuff. But, I also got the responsibility of taking on minor coding tasks to hosted sites, slowly learning ColdFusion.

Having started on-line classes for Computer Science, with the University of Maryland University College, I was really getting in to Object Oriented Programming. .NET was in beta at this point, and I was thinking that it was going to be 'the thing', but I was getting better and better everyday with ColdFusion. Our lead programmer, Joel Firestone, had taken his hobby site for guitar (Guitarists.net) to a new level, getting it mentioned in Guitar Player magazine. Pretty cool for a site that had taken a few months of "spare time" to develop in ColdFusion (Joel moved to PHP later in life, and has since moved his site to that as well, but that's another story). We had one or two sites on ASP that had taken me forever to implement easy stuff, like mail, that took me seconds in ColdFusion. I really started to pick it up, combining ColdFusion with JavaScript, CSS and XHTML. They started giving me small apps to write, then full site rewrites. ColdFusion 5 was released, and UDF's were the new rage, then Blackstone started talking about CFC's, and I quickly started seeing full Object Oriented web development on the horizon. ColdFusion was moving to a Java EE server, and the changes were awesome!

Jump ahead a decade. Wow, how times have changed! ColdFusion has changed hands twice (from Allaire to Macromedia to Adobe), and has gotten better and better with each iteration. I've watched ColdFusion grow with the web, and continually been amazed by the things that have been done. I've had the opportunity to play with close to a dozen server-side technologies in that time, and always come back to ColdFusion for the core of my work. It does far more than just pay the bills, and I'm never short of work, and thank God every day for the opportunities that have come my way this past decade. ColdFusion development (and developers) change and grow every day. Millions of sites with outdated code are being upgraded, or rewritten, to more modern development standards. ColdFusion is an incredibly easy language to learn and use, which also makes it easy to write bad code as well. Today we see developers apply new skills and standards towards writing scalable and efficient code, which highlights the ROI of ColdFusion development in that those upgrades and rewrites are accomplished in a fraction of the time (and cost, and resources) than it would take in many competing technologies. The web's first web application server platform and language has proven itself as an enterprise ready rapid application development platform, and modern developers are proving it, time and again, as a real world solution toward answering real business needs rapidly and effectively.

I've seen great frameworks come about, outstanding public (and private) sites, Web Services enter the fray and change and grow, ColdFusion developers (historically server-side people) embrace JavaScript and Ajax, mobile become the new hotness, Open Source projects multiply and grow and grow and grow... It's an exciting time to work on the web, and just as exciting to work with such a dynamic technology as ColdFusion. I can't wait to see what comes next!

The Next Wave: Ext JS 4 Beta 1

I only have a few minutes, as I am totally buried right now, but I wanted to reach out to everybody to spread the word about Ext JS 4 Beta 1 being released yesterday. Some of you may have been following the Developer Previews on the Sencha Blog, and if you have you already know some of the amazing work coming out of Sencha for this release. If you haven't, well let me give you a really quick recap of some of what you could expect:

There's also an entirely new rendering engine under the hood, new components, and more. You can even run Ext JS 3 & 4 on the same page, if needed. Go to the Sencha site to see some great examples of what you can do. It is still a beta, so the forums are pretty busy with people learning the ropes and filing bugs as they're found, but the foundation has been laid for a truly ground-breaking update to this library.

Java RegEx replaceAll In ColdFusion

In an odd turn, I was given text like below to display on a page.

view plain print about
1Some Title<br />
2&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;A.&amp;nbsp;&amp;nbsp;Some&amp;nbsp;subheader&amp;nbsp;here<br />
3&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;B.&amp;nbsp;&amp;nbsp;Some&amp;nbsp;other&amp;nbsp;subheader&amp;nbsp;here<br />

Two issues here (aside from the fact that it should have been an HTML list): 1) it needed to retain the spacing format, and 2)it needed to wrap within a sized element. A non-breaking space, when viewed, appears as a space ( ), but isn't an actual space, so the browser doesn't know where to break the text when wrapping it in an element. Hmmmm....

[More]

MSOC Part 6: onApplication Event Handlers

In our last MSOC post we gave a brief introduction to the ColdFusion application framework's event handlers. With this post, we'll give a brief explanation of the onApplication handlers.

onApplicationStart

The CFC constructor is the first thing that processes on a request, but the first request to an application will then run the onApplicationStart() method. This method will run prior to any other code in the request, and is your opportunity to setup variables in the shared APPLICATION scope. Within the onApplication handlers, you are able to manipulate the APPLICATION scope without being required to lock access to the scope, as no other process can access the variables until the method is completed, and preventing race conditions.

The APPLICATION scope is a where you place those variables you will use throughout the entire application. For instance, you may wish to keep a simple variable that holds the phone number for your Customer Support team, so that if the number changes it can instantly update throughout the site. The APPLICATION scope is also where you would store objects that you would use throughout your application, like a user or page manager.

onApplicationEnd

As you might have guessed, this is the last method to fire during the lifetime of your application. In your constructor you would have set THIS.applicationTimeout. This is the length of time that the application will continue to live after it's last request. After this timeout limit is reached is when the onApplicationEnd will fire. This allows you to do some cleanup, or some application level logging. It is important to note that this only occurrs if the application does timeout. It will not fire if the server instance is shutdown/restarted.

Consider This

When you want to write to the APPLICATION scope from one of the other event handlers, you must lock access to prevent race conditions. You may, in your onServerStart method, have created a struct to log each active application (start up, last hit, timeout, number of sessions). When accessing the SERVER scope, you must also lock access.

You also have to heavily consider how much work you're putting into each of these event handlers, especially within the onApplicationStart. The more process you have there, the longer the startup time is for your application. It will be up to you just how much of a trade off that startup time is to the overall performance of your application.

The last thing you must consider (and I'll say this a lot during this series) is what variables and objects belong in what scopes. Remember that everything you place in the APPLICATION scope adds to the overall RAM utilization of that app. Everything you place in the SESSION scope will add to the overall RAM utilization of that session. This is especially important to consider in an MSOC environment. Try to think of it in these terms: the size of the SERVER scope + THE size of every APPLICATION + the size of every SESSION in every application must be less than the amount of RAM allocated to your ColdFusion instance. Careful planning is critical.

In our next piece we'll discuss the onSession event handlers. Hopefully you're finding this series beneficial. As always, any feedback/comments/questions are welcome.

Using The DataTables JQuery Plugin

For adminstrative applications, most of my readers know I'm a huge proponent of the Ext JS library. But for front-end, consumer facing sites, I'm often pushed to use JQuery. JQuery is very light weight, and wonderful for DOM manipulation, but it isn't a component library. When you want widgets for advanced data display, you have to use something like JQueryUI. Unfortunately, JQueryUI doesn't yet have a grid component (though they are working on it). So when I recently needed a dynamic, paging data grid, I started looking for something that used server-side data requests and could be skinned using the ThemeRoller. That's when I came upon the DataTables plugin.

It took me some time to figure out the works of how the plugin makes server-side requests. What I found was that, by default the plugin passes an extreme amount of data on a request, and not typically in a format very conducive for our needs. I also had to find a way to pass the method name and data returnFormat needed. That's when I discovered that I could override it's default request. Once I figured that out, I wrote a method to parse the data to create a request object more conducive to a ColdFusion Component request. It passes the following arguments along in a request:

  • iDisplayStart - The number of the first record in the requested set.
  • iDisplayLength - The number of records to return in the requested set.
  • sEcho - A DataTables request identifier, to be echoed back with the return.
  • aoSort - If present, this will be a JSON string representation of sort columns and orders. It's an array of objects:
    • colName - the column name
    • sortDir - the sort direction (asc|desc)

After getting data to my CFC, I had to build my paging query. For my example here I wanted to use the MySQL database I use for my blog, so this was a learning experience for me. The biggest trick for me was getting the TotalCount of records, as this is extremely different from MS SQL, requiring two separate SQL statements for the query and the count. Since DataTables can also sort off of different columns, I needed a way to dynamically set the ORDER BY clause of the query. You can't bind parameters to the ORDER BY clause, but you want to protect your server from SQL injection attack, so you have to validate that part of the request (especially as it's an ajax request, which would be easier to manipulate). Pete Frietag came up with a little regex expression that could be used in this case.

We set up our component to return a structure in the following format:

  • success - A boolean to denote success or failure of the request.
  • message - Only returned if the request fails, a message to state why the failure occurred.
  • totalCount - The total number of records available for the filters applied.
  • result - The paging query.

The last piece of the puzzle was back on the client-side again, where the ColdFusion return had to be put back into a format that can be consumed by the DataTables plugin. This was actually very easy because of the way that ColdFusion returns query data.

Once I had these methods, I wanted to find out how to write a feature plugin for DataTables. One where I could identify additional config arguments in DataTables, and have it automatically work. I contacted Allan Jardine, who wrote DataTables (and has some great web dev tools on his site). He never wrote in that capability, saying that the method override was the only way to make this happen. What I did discover was that I could add options to the standard DataTables config. I created a new option for DataTables, oCFReaderDT, which takes an object of options. Only one argument is required, "method", to define the method to call in the CFC request. I also setup the processor to accept an option, "sForm", as a string selector of a form whose values you may need in the request (i.e.: 'form#myForm'). Then I wrote a custom function that encapsulated the previously written methods into one method, that could then be used as the value of the "fnServerData" option in the DataTables configuration object.

In the download link below is a zip file with all of the files for the example, which has been heavily commented so you know what's going on. Though written for ColdFusion 9, I have included both scripted and non-scripted CFC's. I hope you find this useful, and please leave any comments/questions/suggestions through the Comment Form or Contact links below.

MSOC Part 5: Application Event Handlers, An Intro

Handling the "big picture" application flow in ColdFusion is extremely easy, as a large part of it occurs directly in your application's Application.cfc file. Getting a handle on what's going on, in an MSOC app or any other app, is a matter of managing that application flow effectively. If you have a solid understanding of the event handlers available to you, then you can really begin to see the power behind ColdFusion's application framework.

[More]

MSOC Part 4: Application Constructor

OK, we're still working through setting up our Application for a Multi Site One Codebase scenario, and we haven't really gotten into the application yet (aside from dynamically setting the application name). Now is where we really have to take some serious consideration to variable scoping and application workflow. Thing is, there are dozens of ways to skin this cat (no, the view layer stuff comes later). The things we'll talk about in these next several posts aren't MSOC specific either, as they can apply to most any application. The first step is getting a hard handle on what you can do within the Application.cfc, and start to use it as intended.

[More]

I'm an ACP again for 2011

Once again I slid under the radar to become an Adobe Community Professional in 2011. I am, again, extremely humbled and honored to be included in such excellent company. Last year was my first year as an ACP, and events of last year prohibited me from being as involved as I would like (I've already posted more this month than all of last year put together), so I was very happy that I made the list again this year to get it on target. For those unfamiliar with the program:

The Adobe Community Professionals Program is a community based program made up of Adobe customers who share their product expertise with the world-wide Adobe community. The Adobe Community Professionals' mission is to provide high caliber peer-to-peer communication educating and improving the product skills of Adobe customers worldwide.

Adobe has also introduced a new community program, Adobe Community Champions. This is a new program for those who maybe don't have the time to write as much, or possibly the fiscal resources to speak at conferences, but are no less vocal in their support of Adobe products or in helping to educate newer members of the community. Congratulations to this new group. In brief:

Adobe Community Champions are the "megaphone" of the Adobe community, whose objective is to evangelize Adobe products beyond the existing circle of our Adobe ecosystem and helping connect people to the Adobe community.

2011 is going to be a great year, and I can't wait to see what Adobe has in the works. Congratulations to all the new and returning ACP's, and the new ACC's.

Previous Entries / More Entries