OOPhoto - Annotating The User Interface Before Designing The Domain Model

Posted July 8, 2008 at 4:07 PM by Ben Nadel

Tags: ColdFusion

The latest OOPhoto application can be experienced here.

The latest OOPhoto code can be seen here.

Now that I have my OOPhoto interface prototype complete, I am moving onto the next step of Interface Driven Architecture - annotating the prototype. A prototype is awesome, crucial in fact for successful outcome of any piece of software; but, because it is really just HTML with some ColdFusion includes, it lacks the ability to demonstrate some of the finer business logic that cannot be demonstrated by an interface alone. As such, it is important that we take time to really define what the interface does and what possible actions may be precipitated from its use.

Right now, I have just done a crude graphical annotation using Fireworks (so that I could post this), but this sort of thing can be done in a much more professional, dynamic way using our in-house prototyping tools:


 
 
 

 
OOPhoto - Annotating The Interface In My Object Oriented Programming Demo In ColdFusion  
 
 
 

Luckily, the interface for this application is very small, so the annotation did not take long. But you can really see, especially in the gallery Add / Edit page, where details about the functionality would not have been illustrated well enough via the interface alone. All of this gives us better insight into the requirements of the Domain Model, whose design will be determined in the next step of our object oriented development process.


You Might Also Be Interested In:



Reader Comments

Jul 8, 2008 at 9:23 PM // reply »
5 Comments

Hey Ben, I'm digging your OOP series so far. I'm excited to see how the series of articles progresses, since I've caught the OOP bug as well. For me, the biggest help so far has been learning some of the GoF design patterns.

Also, I find your Interface Design method really cool. A project I'm working on now is using that approach, but we just didn't have a name for it. I'll have to look more into IDA and the specifics of it.


Jul 9, 2008 at 8:09 AM // reply »
10,640 Comments

@Jon,

Glad you are liking it so far. Right now, I have done the easy stuff.... or rather, the stuff that I am accustomed to. Now, getting into the domain model, I am starting to deal with areas in which I feel I have no clue.

I read through the GoF book a while back; it was a bit too heavy for me. Then I tried Head First Design Patterns, which was much easier to swallow. But even after that, and reading a bunch of blogs, there is a lot that remains a mystery to me as to how it all fits together.


Jul 9, 2008 at 9:57 AM // reply »
5 Comments

@Ben
I agree, Head First was a great help to understanding the patterns. Ironically, I didn't even know about the GoF until I read the Head First book. I still haven't read the entire GoF Book, although I do plan on grabbing a used copy from Amazon.

When you say you're not sure how it all fits together, do you mean how say a decorator pattern would be used, or how it all fits in the grand CRUD-type scheme of web development?


Jul 9, 2008 at 10:00 AM // reply »
10,640 Comments

@Jon,

Like, I feel that I understand things in a one-off basis - like a Gateway, a model object, a view, etc.... but when it comes to tying them all together into an application, I am lost. That is what I am trying to figure out in this project.


Post A Comment

Comment Etiquette: Please do not post spam. Please keep the comments on-topic. Please do not post unrelated questions or large chunks of code. And, above all, please be nice to each other - we're trying to have a good conversation here.

Please review the following issues:

Author Name:


Author Email:

Author Website:

Comment:

Supported HTML tags for formatting: <strong>bold</strong>   <em>italic</em>   <code>code</code>







  • Help Wanted - Find Your Next ColdFusion Job
InVision App - Prototyping Made Beautiful With Prototyping Tools Ben Nadel's Company - Epicenter Consulting Recent Blog Comments
Feb 10, 2012 at 7:21 PM
jQuery AJAX Strips Script Tags And Inserts Them After Parent-Most Elements
Update! Instead of $(eval(options.insertAfter)).after(data['insertData']); I now use: var ajaxNode = document.createElement('span'); var parent = $(eval(options.insertAfter))[0].parentNode; ... read »
Feb 10, 2012 at 6:18 PM
jQuery AJAX Strips Script Tags And Inserts Them After Parent-Most Elements
encountered this same, what I consider, jQuery bug last week. I'm building a site in which I load some content via AJAX. This content contains Linkedin share button placeholders which Linkedin API ne ... read »
Feb 10, 2012 at 11:30 AM
Cross-Origin Resource Sharing (CORS) AJAX Requests Between jQuery And Node.js
After you understand the concepts here, this is an awesome cheatsheet for enabling CORS in just about anything http://enable-cors.org/ ... read »
JM
Feb 10, 2012 at 9:10 AM
My Safari Browser SQLite Database Hello World Example
@Amy, Here is a very good tutorial on how to use JOIN: http://www.sqltutorial.org/sqljoin-innerjoin.aspx ... read »
Feb 10, 2012 at 4:42 AM
Building A Twitter-Inspired RESTful API Architecture In ColdFusion
This is great, very useful Ben. I spotted a small typo in the api.cgm listing: <cfthrow type="Unauthroized" /> Cheers Stefan ... read »
Feb 9, 2012 at 10:35 PM
CFDirectory Filtering Uses Pipe Character For Multiple Filters (Thanks Steve Withington)
I was wondering if there would be a filter you could apply so that you got everything but what you included in the filter. As in show me all docs that are not a .pdf. ... read »
Feb 9, 2012 at 10:29 PM
Learning ColdFusion 9: Application-Specific Data Sources
@Ben, No offence, but if people were really wanting advanced features they would be using a platform like ASP.NET MVC. CFML is so structurally compromised as a tag-based scripting language that ... read »
Feb 9, 2012 at 10:03 PM
Subversion - Cleanup Failed To Process The Following Paths
@Leviaguirre, do you still have problems with this? ... read »