Populate coldfusion bean from query

I thought of a nice way to populate coldfusion beans from a query. It might be obvious, but we have code all over in our mach-ii application that explicitly calls setters on a bean after query. So following method got added to BaseComponent.cfc (thanks Hal Helms). It's not checking anything so the burden is on query to have the right data.

<br /><cffunction name="setInstanceFromQuery" access="public" returntype="VOID" output="false"><br /> <cfargument name="data" required="true" type="query" /><br /> <cfscript><br /> var i = 0; <br /> var q = arguments.data;<br /> var l = listToArray(q.columnList);<br /> if(q.recordCount gt 0) {<br /> for (i=1; i LTE arrayLen(l); i=i+1) {<br /> evaluate('set#l[i]#(q[l[i]][1])');<br /> }<br /> }<br /> </cfscript><br /></cffunction><br />
If you use generic setter the line:
<br />evaluate('set#l[i]#(q[l[i]][1])');<br />
can be replaced with:
<br />set(l[i],(q[l[i]][1]));<br />

So this allows me to do something like this:
<br /><!--- this method could be in SomeBeanService ---><br /><cffunction name="getSomeBeanByID" access="public" returntype="SomeBean" output="false"><br /> <cfargument name="id" type="string" required="true" /><br /> <cfscript><br /> var SomeBean = createObject("component","SomeBean").init();<br /> var beanData = getSomeBeanGateway().getSomeBeanByID(arguments.id);<br /> SomeBean.setInstanceFromQuery(beanData);<br /> return SomeBean;<br /> </cfscript><br /></cffunction><br />

Object collection class with iterator

So I added an iterator to my collection cfc. Several people blogged about using java iterator for coldfusion arrays and looks like Transfer uses those.

Here is an iterator method:
<br /><cffunction name="iterator" access="public" output="false" returntype="any"><br /> <cfscript><br /> var iterator = variables.container.Iterator();<br /> return iterator;<br /> </cfscript><br /></cffunction><br />
I also changed getBy() and removeBy() to use iterator:
<br /><cffunction name="getBy" access="public" output="false" returntype="Any"><br /> <cfargument name="property" type="String" required="true" /><br /> <cfargument name="value" type="Any" required="true" /><br /> <cfscript><br /> var i = 0; <br /> var o = '';<br /> var iterator = this.iterator();<br /> while(iterator.hasNext()) { <br /> o = iterator.next();<br /> if(isObject(o) and o.hasProperty(arguments.property) and o.get(arguments.property) is arguments.value) {<br /> return o;<br /> }<br /> }<br /> return null; <br /> </cfscript><br /></cffunction><br /><br /><cffunction name="removeBy" access="public" output="false" returntype="boolean"><br /> <cfargument name="property" type="String" required="true" /><br /> <cfargument name="value" type="Any" required="true" /><br /> <cfscript><br /> var i = 0; <br /> var o = '';<br /> var iterator = this.iterator();<br /> while(iterator.hasNext()) { <br /> o = iterator.next();<br /> if(isObject(o) and o.hasProperty(arguments.property) and o.get(arguments.property) is arguments.value) {<br /> iterator.remove();;<br /> return true;<br /> }<br /> }<br /> return false;<br /> </cfscript><br /></cffunction><br />
Also have to plug MXUnit. Using it made refactoring like that above, much more enjoyable.

Object collection class

This is collection cfc that's largely based on one I found here.

I added couple of methods, getBy and removeBy that I think will be helpful for working with collection of objects. Each takes a property and a value of that property as arguments, then we try to match those to one of the objects in the collection.

Now I need an Iterator for this.

Replacing notepad with notepad++

I discovered notepad++ and wanted to replace windows notepad with it. The instructions are here in the middle of the page under heading "Notepad Replacement". Well it turned out it's not that easy to delete notepad.exe. It kept on reappearing. So I found instructions here and it helped, I am reproducing instructions in case they disappear.

Create backup copy of c:\WINDOWS\notepad.exe
Change Explorer view options to show system files
In temporary folder: Have your new notepad.exe file ready
Copy the exe file into the clipboard ( select the file and hit Ctrl-C )
Open folder C:\WINDOWS\ServicePackFiles\i386 in Explorer
Ctrl-V
Open folder C:\WINDOWS\system32\dllcache in Explorer
Ctrl-V, Backspace
Ctrl-V, Backspace
Ctrl-V, Backspace

*Just for your information Ctrl-V pastes the new notepad and Backspace moves you up a directory. By doing this as outlined above you replace all of the default Windows notepad.exe files. Make sure you copy the notepad.exe that you want to use first by selecting that file and hitting Ctrl-C

Also one other note, for the first step where I said to replace notepad here:
C:\WINDOWS\ServicePackFiles\i386

on some computers it might actually be: C:\WINDOWS\i386 and notepad will have the name like: notepad.ex_ -- Simply copy the notepad.exe over the notepad.ex_ and make sure you keep that same file name with the underscore (or whatever symbol its using)

Mach-ii sub-application - part 2

To demonstrate sub-application setup I am going to use example application from mach-ii site called ContactManager. If you are going to follow along then download it and unzip into ContactManager folder under your webroot. After that you should be able to browse to it using http://[your-web-root]/contactmanager/

Next I made a folder under contactmanager called "subapp". Under that "config" folder. Also I made a subapphome.cfm file in the "views" folder to show something different in subapp. Just put any random text in that file. Look at an image of the ContactManager tree to see added elements.

Now we separate common elements into an include called mach-ii-common.xml
<br /><mach-ii version="1.5"><br /> <!-- PLUGINS --><br /> <plugins><br /> <plugin name="tracePlugin" type="MachII.plugins.TracePlugin" /><br /> </plugins><br /> <br /> <!-- EVENT-HANDLERS --><br /> <event-handlers><br /> <event-handler event="exceptionEvent" access="private"><br /> <view-page name="exception" /><br /> </event-handler><br /> </event-handlers><br /> <br /> <!-- PAGE-VIEWS --><br /> <page-views><br /> <page-view name="mainMenu" page="/views/mainMenu.cfm" /><br /> <page-view name="mainTemplate" page="/views/mainTemplate.cfm" /><br /> <page-view name="exception" page="/views/exception.cfm" /><br /> </page-views><br /></mach-ii><br />
Those elements are removed from main applications mach-ii.xml, but we add an include before properties section
<br /><includes><br /> <include file="../config/mach-ii-common.xml" override="true" /><br /></includes><br />
Here is sub-application mach-ii.xml
<br /><mach-ii version="1.5"><br /> <includes><br /> <include file="/contactmanager/config/mach-ii-common.xml" override="true" /><br /> </includes><br /> <br /> <!-- PROPERTIES --><br /> <properties><br /> <property name="applicationRoot" value="/ContactManager" /><br /> <property name="defaultEvent" value="showsubappHome" /><br /> <property name="eventParameter" value="event" /><br /> <property name="parameterPrecedence" value="form" /><br /> <property name="maxEvents" value="10" /><br /> <property name="exceptionEvent" value="exceptionEvent" /><br /> <br /> <property name="urlDelimiters" value="/|/|/" /><br /> <property name="urlBase" value="/index.cfm" /> <br /> </properties><br /><br /> <!-- EVENT-HANDLERS --><br /> <event-handlers><br /> <event-handler event="showsubappHome" access="public"><br /> <view-page name="subapphome" contentArg="content" /><br /> <view-page name="mainTemplate" /><br /> </event-handler><br /> </event-handlers><br /> <br /> <!-- PAGE-VIEWS --><br /> <page-views><br /> <page-view name="subapphome" page="/views/subapphome.cfm" /><br /> </page-views><br /></mach-ii><br />
Notice the properties for SES URLs.

There is at least one issue with this setup is that links need to be relative to the web root so that they work from main app and from sub app. So in mainTemplate.cfm file I added "/contactmanager/" to all the links resource references at the top.
Here is an example, following lines
<br /><a href="index.cfm?event=showHome">Home</a> | <br /><a href="index.cfm?event=listContacts">List Contacts</a> | <br /><a href="index.cfm?event=newContactEventArgs">Add Contact Using Event Arguments</a> | <br /><a href="index.cfm?event=newContactEventBean">Add Contact Using an Event Bean</a> | <br /><a href="subapp/">Sub-Application</a><br />
became...
<br /><a href="/contactmanager/index.cfm?event=showHome">Home</a> | <br /><a href="/contactmanager/index.cfm?event=listContacts">List Contacts</a> | <br /><a href="/contactmanager/index.cfm?event=newContactEventArgs">Add Contact Using Event Arguments</a> | <br /><a href="/contactmanager/index.cfm?event=newContactEventBean">Add Contact Using an Event Bean</a> | <br /><a href="/contactmanager/subapp/">Sub-Application</a><br />
As you can see I also added a link to my sub-application.

After all this you should be able to get to your subapp by going to http://[your-web-root]/contactmanager/subapp/index.cfm/event/subapphome/

Mach-ii sub-application - part 1

Sometimes it's handy to make a sub-application in mach-ii. Config file gets rather large rather quickly at times. One thing to understand is that sub-application is not a completely stand alone app. It relies on the main application. Mach-ii 1.5 introduced modules and includes so some of the issues of breaking out large chunks of configuration and code that are solved with those.

However one use case just came up where I wanted to have only part of the application to have SES URLs. So by breaking out this new part of the application into sub-application I could reuse layout and user tracking from the main one but use new SES properties (also introduced in mach-ii 1.5) in subapp. I think I could also put common properties, event-handlers, listeners, e.t.c into an include that way duplication of code will be minimal.

I am going to demonstrate this in the next post.

ColdFusion Code Highlighting for a blog

One thing that's keeps me amazed is that every time I need to solve something, someone somewhere already encountered that issue and most likely solved it. This is especially true for all things computer. I pretty much expect this behavior. So this proved true as I ventured to find a way to have code highlighting for my blog.

Thanks to Aaquagua!: Web Page Syntax Highlighting for ColdFusion - Brush for SyntaxHighlighter post I was able to add code highlighting. Not only he had instructions for adding SyntaxHighlighter but also added ColdFusion brush. How cool is that?

One thing I want to add though using <textarea> insted of <pre> tag worked better. When using <pre> it adds closing tags for some reason for ColdFusion tags that are not closed. Here is an example of this behavior:

<pre name="code" class="cf">

 
 
 
 
 
  // comments
  var bar = 1;
  return foo+bar;
 

</pre>

<textarea name="code" class="cf" >
<br /><cffunction name="someFunc" access="public" output="false" returntype="any"><br /> <cfargument name="someArg" required="true" type="numeric" /><br /> <!--- comments ---><br /> <cfset var foo = 0><br /> <br /> <cfscript><br /> // comments<br /> var bar = 1;<br /> return foo+bar;<br /> </cfscript><br /></cffunction><br />
</textarea>

Turns out the above mentioned problem is dependent on a browser. IE7 seems to be fine FF2 and FF3 have an issue mentioned, and Opera blew up completely.

So use <textarea> since that seems to be working in all browsers

Custom domain for my blog

I registered a domain for my blog, actually two: ifedotov.com and iheartcf.com (second one is way too fruitty). The domains were registered and parked at goDaddy.com. GoDaddy.com makes it very easy to have your parked domain pointed to blogger.

Also it's a free feature on blogger. WordPress for example charges $10 a year to have your personal custom domain to point to your blog.

I wonder why Blogger doesn't have categories for posts? They have labels so it's probably almost the same and keeps with the google theme.

I think Blogger might be temporary solution. I would like to use some ColdFusion based blogs, maybe machblog or Mango blog.

Preamble

After avoiding blogging scene for years I finally decided to give it a try.

The most important reason is to remember my own findings. Right now I am working as ColdFusion Developer / Architect and there is slew of new things that are being researched, reviewed and implemented. So this is a way to keep track of my findings and thoughts.

Also I do find other peoples blogs helpful occasionally so perhaps this will be a way to give back to the community.