IBM®
Skip to main content
    Country/region [select]      Terms of use
 
 
    
     Home      Products      Services & solutions      Support & downloads      My account     
developerWorks  >  Blogs  >   developerWorks

author Jazz platform development

Bill Higgins works for Rational Software where I lead web development on the Jazz Platform. Bill graduated from Penn State University in 2000 with a B.S. in computer science. Outside of work, Bill enjoys spending time with his wife and two children, reading, and playing basketball.



Sunday June 29, 2008

from Windows to Ubuntu

Well, as we mentioned over on the Jazz Team Blog, my Jazz teammates and I just shipped Rational Team Concert 1.0, the first GA product built on the Jazz Platform. More on that later.

Since I've been working on what became Rational Team Concert for the last three years, I've gotten into quite a groove with regards to the technologies that I use and how I use them. But there were a couple of things I didn't like and I promised myself that I'd fix them once we shipped and I could spare a few days of being less than 100%.

Chief among these "things I'd like to change when I have the time" was my use of Windows XP as my operating system. For quite a while I was happy to use WinXP - mainly because I knew how to use it and IBM's internal set of applications are optimized for Windows XP users. And when I say "optimized" here I mean in the sense of lack of barriers - available, tested, and with support.

But after the past couple of years as I got more into web development, I started to experience some pain as a WinXP user because it seems like most of the interesting web technologies are optimized for Linux or Mac users, and for Windows users there's usually a short appendix in the doc that says "If you are unfortunate enough to use Windows, the following has been said to work..."

So the day after we declared bit freeze on Team Concert, I downloaded a Ubuntu ISO CD image, burned that, backed up my data, then formatted my hard drive and installed Linux.

The remainder of this entry I'll write in Steve O'Grady Q&A format so I don't have to think in full paragraphs :-)

Q: How did the installation go?
A: It was truly easy. Just insert the CD, restart my Thinkpad, and let the Ubuntu installer do its thing. The last time I tried to install Linux was probably about 5 years ago and I remember it asking me all kinds of questions for which I didn't know the answer. I don't even recall Ubuntu asking me any questions, and if they did they must have been trivial because I don't remember them.

Q: What was your first impression of the user experience?
A: I was really impressed. After installing just rebooted, logged in, and I was in a windowing system which was very easy to understand. The top panel has three simple, logical menus (Applications, Places, System), shortcuts to key programs, then the right side of the top menu has iconographic shortcuts to some important system applications (networking, sound, date time, system control). The bottom panel just lists the open programs and has some other miscellaneous controls related to desktop management (minimize all windows, switch between desktop, etc.)

My biggest takeaway on the window manager user experience is that it seems like they've taken care to strip out as much low-value cruft and redundancy as possible, so that you're left with a small set of orthogonal, useful controls.

Q: Any problems?
A: There were two sets of problems: 1) Finding and learning the Linux equivalent for simple Windows programs like Notepad and Paint. 2) Getting IBM stuff to work that was mainly developed and tested for Windows and/or Internet Explorer web browser. To get over these humps I bought a license for VMWare and spent much of my first week within a Windows XP virtual machine. Luckily VMWare's networking worked much better than I remember it working, so between VMWare and the Windows XP image with VPN and Lotus Notes, I could get basic things done like work email from home.

Luckily my Jazz colleague Matt Lavin has been using Ubuntu for over a year, so he was able to help me learn how to do some basic but important things like connect my system to the internal Debian package server.

I'm still having problems using Open Office vs. Microsoft Office. When I modified a Powerpoint file in Open Office, it ended up getting mangled back in Powerpoint. I'm not sure who's fault it was, but it sure was frustrating. I may look into running emulated MS Office on Linux.

Q: Why Linux instead of a Mac?
A: Because I already have an iMac that I use a lot at home and also I have a very nice laptop from work (Thinkpad T60p) so I didn't see the point of junking it and spending $3,000 for a new PowerBook.



Categories : [   linux  |  ubuntu  |  windows  ]

Jun 29 2008, 12:41:24 PM EDT Permalink



Monday February 18, 2008

RIA weekly podcast and errata

Last Friday I did an RIA weekly podcast (mp3) with Michael Coté of Redmonk and Ryan Stewart of Adobe. This was a fun and interesting experience. Fun because I like Coté and Ryan a great deal and enjoy talking to them and interesting because of the subject matter and also because it was the first podcast I've ever done.

There were a few things I said in the podcast for which I'd like to provide a bit of extra context, because it's difficult in the podcast format to provide a great deal of context.

Network Transparency and Latency

At one point in the podcast, I talk about Jazz's early RPC-style web services and say something along the lines of "This is great for the Java client developers because they essentially get network transparency, which is awesome except for the latency." This is sort of like saying "Not paying income tax is great, except for the eventual fines and imprisonment." RPC-style interfaces that strive to provide network transparency have the unusual problem that they make remote connectivity too easy for developers. The result, which is almost a cliché, is that developers design applications which are way too chatty and which work fine on local area networks (the environment in which they are developed) but fall apart in wide area networks (the environments in which they are deployed). Later, in the clichéd scenario, the developers learn about explicitly designing the "stuff" that travels over the wire to provide a good balance between the needs of the application and the realities of the network.

Sometimes you just shouldn't make things too easy. Like you shouldn't put the car's ejector seat button where the toddlers can reach it :-)

Why We Didn't Consider Flash as the Basis for the Jazz Web UI Infrastructure

At another point, Ryan asked me if we ever considered Flash and I said something along the lines of "Well we didn't select Flash because it wasn't as ubiquitous as the standalone browser" but after saying this I remember Pat Mueller telling me recently that Flash is the most widely deployed web client technology when you compare it against particular browsers (i.e. browsers in general are more widely deployed than Flash, but Flash is more widely deployed than any particular browser like Internet Explorer or Firefox). So though my memory is a little fuzzy, I believe the reason was that just as a general principle, we didn't want any core Web UI application functionality depedning on a particular plug-in; for instance, the user shouldn't require Flash to create a bug report. Another factor was that this was early 2006 so Flash was probably not as ubiquitous as it is today. Yet another factor was our later principle that "look like a normal web page" and some examples of Flash violate this (i.e. the big box of Flash in the middle of the page, or overly ambitious site welcome screens). But I have to say, my thoughts on Flash have really changed over the past two years, because I've seen some incredibly useful, subtle applications of it. I can't think of a particular example, but I know a couple of times some page on Amazon.com had a really cool little visual effect and sure enough when I right-clicked it turned out to be a little Flash app seamlessly embedded in the page. So using Flash in tactical ways where it can provide a powerful but non-jarring user experience is something I would like to explore in the future.

Meeting with the WebSphere Application Server Folks

At one point early in the interview Coté mentions that we hung out and got drinks in Austin one night and I mentioned that I was down for a meeting with some WebSphere Application Server folks and it was also a good opportunity to meet with Coté which is why I accepted the meeting. Listening to the podcast, I feel bad about how this came out because in reality the WebSphere App Server folks were doing us a favor by taking a day off to review the security architecture of Jazz.net and indeed they pointed out both important security and scalability issues. The missing context is that I hate work travel (I repeat hate) because I have two toddlers and they just grow too much and we miss each other too much when I travel without them. So the only time I travel for work is if I really need to be there in person (like if I'm speaking at a conference) or if I can accomplish more than one goal with a single trip. If not for the chance to both do the Jazz.net review and meet Coté, who in my opinion (don't blush Coté) is both a cool guy and important industry analyst, I would have probably called in.

Innovation vs. Standardization

At another point in the podcast, I mention a blog post by Alex Russell of Dojo where he talks about standards not saving us and encourages browser vendors to provide non-standard innovative features. I think in the podcast I may have come across as "standards don't matter". In fact I think standardization is important to build the applications of today but agree with Alex and that the future won't be invented by standards bodies.

Finally...

Otherwise I agree with everything I said :-)



Categories : [   ajax  ]

Feb 18 2008, 03:05:49 PM EST Permalink



Thursday January 17, 2008

Jazz Team Blog

On Monday there were two notable changes at the Jazz.net web site I manage:

  • We opened up registration to everyone (previously it had only been to Rational customers and business partners)
  • We made the Jazz Team Blog public

I wrote the first entry on the Jazz team blog, and it outlines the sorts of things we're going to write about over there.

Also, I created a video that provides a tour of Jazz.net in case you're ambivalent about registering but curious about what's behind the curtain.

Finally, I'm guessing that I'll probably write many, if not most, of my work-related blog entries (Jazz, Ajax, etc.) over on the Jazz Team Blog, so you may want to subscribe to that if you're into my writing on those topics. I'm currently working on an entry over there that explains how some of the early lessons learned developing the Jazz Web UI technology led to my UI design opinions that I captured in my "Uncanny Valley of UI design" post.



Categories : [   jazz  ]

Jan 17 2008, 11:03:39 PM EST Permalink



Wednesday January 02, 2008

measures of progress

I had an insight a few weeks ago that I thought was worth sharing. First some context.

On the Jazz project, one of my jobs is leading the software development for our platform-level web UI stuff [1]. Erich Gamma is the overall Jazz technology lead. Twice a month we have a sync up meeting where we discuss platform-level web UI progress.

In our last chat in mid-December, one of the things we chatted about was the status of the Jazz Server's Admin Web UI. We began bootstrapping the Admin Web UI in September and I thought we'd made good progress in such a short amount of time. Erich didn't seem so impressed with what he saw. I was a bit frustrated by this because I thought Erich was being unreasonable - we'd made good progress for the short amount of time we'd been working on it. But after a few more minutes of chatting, I realized that there was simply a mismatch in what we were evaluating. I was evaluating the state of the Admin Web UI vs. the resources (time and people) we'd had to work on it; Erich was evaluating the state of the Admin Web UI vs. his vision of what an awesome Admin Web UI should look like. Put more tersely, I was measuring "current vs. previous" while Erich was measuring "current vs. ideal".

I found this difference in approach fascinating and insightful. I'm a very methodical person; when someone gives me a job I very methodically list its goals and measures of success, then I work backwards given the time and people I have to reach the goals and then over the course of weeks or month work towards the goals. But during my conversation with Erich I realized that a risk of my methodical approach is that I can become too bogged-down on the blocking and tackling of day-to-day software development and become overly focused on incremental progress and lose sight of the big vision of what you're trying to build. I found that when I adopted Erich's point of view and thought about the current state of the Admin Web UI vs. what it could become in the very long-term, I became very dissatisfied with its current state and highly motivated to be more ambitious with the next iteration plan.

It's ironic because most of the iterative software development literature talks about the converse problem - you're too focused on the big picture that you don't make day-to-day progress. Indeed it's become a cliché over the past several years to make fun of architects who are too far removed from day-to-day coding, testing, and building.

So the insight I gained was that I need to think in terms of both "current vs. previous" and "current vs. ideal". Fortunately our iterative development process supports finding this balance. At the beginning of iterations it's fine to dream big dreams about what you're trying to achieve but then to become very pragmatic about how to make incremental progress towards realizing those dreams in the course of a four week iteration. Then over the four weeks you can be extremely methodical about making progress. Then at the end of the iteration you can reflect on what you've accomplished and feel some short satisfaction that the software is significantly better now than it was four weeks ago. Then you can reflect that the software's not nearly as good as you ideally want it to be which provides the motivation to start the cycle again.

[1] By "platform-level" I simply mean more of the infrastructure. That is, frameworks and APIs rather than tangible applications.



Categories : [   culture  |  design  ]

Jan 02 2008, 02:03:44 AM EST Permalink



Sunday October 28, 2007

job news

As I mentioned on Twitter, as of this week I've got a new job of managing the Jazz.net community site. I'll continue to lead the development on the framework-y pieces of the Jazz Platform web UI stack.

This is going to be a fun job since we're trying something relatively new with the Jazz Project that we're calling "Open Commercial Development". On traditional commercial software projects, there's a pretty high wall between the development team and everyone else. With the Jazz Platform and the products we're building on top of it, we want to create a much higher bandwidth channel between the development team and people who use Jazz-based tools and people who build their own tools on top of the Jazz Platform.

So my job is to make it easier for the development team, users, and extenders to collaborate. This of course means good docs and good tools for collaboration, but more than anything, it means getting to know more folks who are interested in learning more about Jazz technology and influencing its direction.

So if you have questions or concerns about Jazz.net, feel free to drop me a line. My work email address is bhiggins@us.ibm.com and my cell phone number is 919-672-7993. Please don't be shy :-)



Categories : [   jazz  ]

Oct 28 2007, 08:51:31 PM EDT Permalink



Sunday September 09, 2007

if you're using Jazz, what other development tools do you need?

Aaron Cohen of Rational asked an interesting question in the Jazz.net forum the other day. I've reprinted his question and my answer here verbatim, with permission from Aaron and the Jazz Project.

Question (Cohen):

Right now Jazz.net uses Wikis and newsgroups to supplement Jazz. If a team is deploying Jazz. What type of Wiki or other collaborative software should we use with Jazz?

Answer (Higgins):

Aaron, it really depends on the needs of your team. With Jazz, our goal is not to reinvent every known software and/or collaboration tool as a Jazz component. Basically we look for opportunities where deep integration with other Jazz components could produce a much more productive experience.

Just implementing a Wiki on top of the Jazz repository is not interesting; the world doesn't need another Wiki implementation. But it is interesting to observe how we tend to use our own Wiki and then explore how we could provide new functionality in Jazz to replace Wikis for these needs. For example, every Jazz component lead used to create an iteration plan page in the Wiki. Observing this, the Agile Planning team provided an "Overview" page for each iteration plan, where a team can write semi-structured markup as well as linking forward to important work items. Now most component leads don't feel the need to create a separate plan overview in the Wiki.

In the case of newsgroups, we needed a lightweight way to make announcements to a subset of the project, and newsgroups have been doing this for years so we used newsgroups. This continues to work really well, so... I don't know why we'd ever change it.

But getting back to your question, I'd rephrase it as "What non-Jazz tools do I find my team using to support our software development?" And if you notice yourself using some non-Jazz tools for large chunks of your development, it's worth asking "Could a Jazz-based component provide a richer, more productive, more integrated experience?" If the answer to the second question is "Yes", then we encourage you to consider either building your own Jazz component to fulfill the need or to raise enhancement requests against us.

Thanks for your question and I hope this helps.



Categories : [   jazz  ]

Sep 09 2007, 02:46:01 AM EDT Permalink



Thursday August 23, 2007

Upcoming Beijing Talks

I'll be in Beijing, China next week giving a couple of talks on the Jazz Platform and Rational Team Concert: Rational Team Concert: Agile Team Development with Jazz Inside the Jazz Technology Platform
  • When? Friday, 31 Aug 2007 (10AM - Noon, local time)
  • Where? IBM China Research Lab, Beijing
  • What? A technology-focused presentation on the Jazz Platform architecture and how to extend the Jazz Platform with custom components (charts courtesy of Scott Rich and Kai Maetzel)
[...]
Read more


Aug 23 2007, 04:08:08 PM EDT Permalink



Wednesday June 06, 2007

links for 2007-06-06




Jun 06 2007, 05:24:59 AM EDT Permalink



Thursday May 17, 2007

the Uncanny Valley of user interface design

There's a theory called 'The Uncanny Valley' regarding humans' emotional response to human-like robots. From The Wikipedia entry:

The Uncanny Valley is a hypothesis about robotics concerning the emotional response of humans to robots and other non-human entities. It was introduced by Japanese roboticist Masahiro Mori in 1970 [...]

Mori's hypothesis states that as a robot is made more humanlike in its appearance and motion, the emotional response from a human being to the robot will become increasingly positive and empathic, until a point is reached beyond which the response quickly becomes strongly repulsive. However, as the appearance and motion continue to become less distinguishable from a human being's, the emotional response becomes positive once more and approaches human-human empathy levels.

This area of repulsive response aroused by a robot with appearance and motion between a "barely-human" and "fully human" entity is called the Uncanny Valley. The name captures the idea that a robot which is "almost human" will seem overly "strange" to a human being and thus will fail to evoke the requisite empathetic response required for productive human-robot interaction.

While most of us don't interact with human-like robots frequently enough to accept or reject this theory, many of us have seen a movie like The Polar Express or Final Fantasy: The Spirit Within, which use realistic - as opposed to cartoonish - computer-generated human characters. Although the filmmakers take great care to make the characters' expressions and movements replicate those of real human actors, many viewers find these almost-but-not-quite-human characters to be unsettling or even creepy.

The problem is that our minds have a model of how humans should behave and the pseudo-humans, whether robotic or computer-generated images, don't quite fit this model, producing a sense of unease - in other words, we know that something's not right - even if we can't precisely articulate what's wrong.

Why don't we feel a similar sense of unease when we watch a cartoon like The Simpsons, where the characters are even further away from our concept of humanness? Because in the cartoon environment, we accept that the characters are not really human at all - they're cartoon characters and are self-consistent within their animated environment. Conversely, it would be jarring if a real human entered the frame and interacted with the Simpsons, because eighteen years of Simspons cartoons and eighty years of cartoons in general have conditioned us not to expect this [Footnote 1].

There's a lesson here for software designers, and one that I've talked about recently - we must ensure that we design our applications to remain consistent with the environment in which our software runs. In more concrete terms: a Windows application should look and feel like a Windows application, a Mac application should look and feel like a Mac application, and a web application should look and feel like a web application.

Obvious, you say? I'd agree that software designers and developers generally observe this rule except in the midst of a technological paradigm shift. During periods of rapid innovation and exploration, it's tempting and more acceptable to violate the expectations of a particular environment. I know this is a sweeping and abstract claim, so let me back it up with a few examples.

Does anyone remember Active Desktop? When Bill Gates realized that the web was a big deal, he directed all of Microsoft to web-enable all Microsoft software products. Active Desktop was a feature that made the Windows desktop look like a web page and allowed users to initiate the default action on a file or folder via a hyperlink-like single-click rather than the traditional double-click. One of the problems with Active Desktop was that it broke all of users expectations about interacting with files and folders. Changing from the double-click to single-click model subtley changed other interactions, like drag and drop, select, and rename. The only reason I remember this feature is because so many non-technical friends at Penn State asked me to help them turn it off.

Another game-changing technology of the 1990s was the Java platform. Java's attraction was that the language's syntax looked and felt a lot like C and C++ (which many programmers knew) but it was (in theory) 'write once, run anywhere' - in other words, multiplatform. Although Java took hold on the server-side, it never took off on the desktop as many predicted it would. Why didn't it take off on the desktop? My own experience with using Java GUI apps of the late 1990s was that they were slow and they looked and behaved weirdly vs. standard Windows (or Mac or Linux) applications. That's because they weren't true Windows/Mac/Linux apps. They were Java Swing apps which emulated Windows/Mac/Linux apps. Despite the herculean efforts of the Swing designers and implementers, they couldn't escape the Uncanny Valley of emulated user interfaces.

Eclipse and SWT took a different approach to Java-based desktop apps [Footnote 2]. Rather than emulating native desktop widgets, SWT favor direct delegation to native desktop widgets [Footnote 3], resulting in applications that look like Windows/Mac/Linux applications rather than Java Swing applications. The downside of this design decision is that SWT widget developers must manually port a new widget to each supported desktop environment. This development-time and maintenance pain point only serves to emphasize how important the Eclipse/SWT designers judged native look and feel to be.

Just like Windows/Mac/Linux apps have a native look and feel, so too do browser-based applications. The native widgets of the web are the standard HTML elements - hyperlinks, tables, buttons, text inputs, select boxes, and colored spans and divs. We've had the tools to create richer web applications ever since pre-standards DOMs and Javascript 1.0, but it's only been the combination of DOM (semi-)standardization, XHR de-facto standardization, emerging libraries, and exemplary next-gen apps like Google Suggest and Gmail that have led to a non-trivial segment of the software community to attempt richer web UIs which I believe we're now lumping under the banner of 'Ajax' (or is it 'RIA'?). Like the web and Java before it, the availability of Ajax technology is causing some developers to diverge from the native look and feel of the web in favor of a user interface style I call "desktop app in a web browser". For an example of this style of Ajax app, take a few minutes and view this Flash demo of the Zimbra collaboration suite.

To me, Zimbra doesn't in any way resemble my mental model of a web application; it resembles Microsoft Outlook [Footnote 4]. On the other hand Gmail, which is also an Ajax-based email application, almost exactly matches my mental model of how a web application should look and feel (screenshots). Do I prefer the Gmail look and feel over the Zimbra look and feel? Yes. Why? Because over the past twelve years, my mind has developed a very specific model of how a web application should look and feel, and because Gmail aligns to this model, I can immediately use it and it feels natural to me. Gmail uses Ajax to accelerate common operations (e.g. email address auto-complete) and to enable data transfer sans jarring page refresh (e.g. refresh Inbox contents) but its core look and feel remains very similar to that of a traditional web page. In my view, this is not a shortcoming; it's a smart design decision.

So I'd recommend that if you're considering or actively building Ajax/RIA applications, you should consider the Uncanny Valley of user interface design and recognize that when you build a "desktop in the web browser"-style application, you're violating users' unwritten expectations of how a web application should look and behave. This choice may have significant negative impact on learnability, pleasantness of use, and adoption. The fact that you can create web applications that resemble desktop applications does not imply that you should; it only means that you have one more option and subsequent set of trade-offs to consider when making design decisions.

[Footnote 1] Who Framed Roger Rabbit is a notable exception.

[Footnote 2] I work for the IBM group (Eclipse/Jazz) that created SWT, so I may be biased.

[Footnote 3] Though SWT favors delegation to native platform widgets, it sometimes uses emulated widgets if the particular platform doesn't provide an acceptable native widget. This helps it get around the 'least-common denominator' problem of AWT.

[Footnote 4] I'm being a bit unfair to Zimbra here because there's a scenario where its Outlook-like L&F really shines. If I were a CIO looking to migrate off of Exchange/Outlook to a cheaper multiplatform alternative, Zimbra would be very attractive because since Zimbra is functionally consistent with Outlook, I'd expect that Outlook users could transition to Zimbra fairly quickly.




May 17 2007, 03:14:54 AM EDT Permalink



Friday May 11, 2007

HTTP caching options

Note to readers: For a while now, I've been looking for guidance on designing useful messages and message-based systems, but without much luck. To help others and also because I learn by writing, I'm going to use my blog to document some of the messaging lessons I've learned over the past couple of years. I hope this blog entry and future ones like it don't seem overly-pedantic; my only goal is to help clarify my own thoughts and perhaps help others looking for similar information on a topic with which I've personally struggled.

In this blog entry, I talk about the fundamentals of caching resource representations in HTTP-based distributed systems using the language of basic concepts while avoiding HTTP terminology which might sidetrack novice readers. This entry does assume some knowledge of HTTP (e.g. requests, responses, URIs), so if you find these concepts sidetracking you, I'd suggest you read the first couple of chapters of a book like HTTP: The Definitive Guide to familiarize yourself.

If you're already familiar with HTTP caching (e.g. most likely anyone reading this via Planet Intertwingly), you may wish to skip this entry altogether, unless you're curious about my take on the topic or are interested in looking for mistakes or misrepresentations. If you do find a problem, please add a comment and I'll attempt to correct and/or clarify.

Intro

One of the benefits of developing distributed applications using the REST architectural style with the HTTP protocol is their first-class support for caching documents (or 'entities-bodies' in HTTP terminology). If you're simply serving files using a world-class web server like Apache HTTP Server, you get some degree of caching for free. But in dynamic web applications, you're often generating dynamic documents (e.g. an XML document containing data from a row in a relational database) rather than simply serving files, where the resource and the representation are equivalent.

Unless you're using an application framework that automatically generates caching information for HTTP responses based on the framework's meta-data model, you'll likely have to roll your own caching logic. This presents both a challenge and an opportunity. The challenge is that you must learn about the various HTTP caching options so that you can intelligently apply them to your particular data model; the opportunity is that you can often take advantage of your data model's semantics to perform smarter caching logic than out-of-the-box file system caching.

In this entry I describe the basic rationale for caching and then discuss the basic caching options possible with the HTTP protocol. Note that I describe these caching options at a very high level, without getting into many implementation details, and at this level the 'HTTP caching options' are more like general caching patterns, but nevertheless I describe them in the context and using the language of HTTP, since it's both a ubiquitously deployed protocol and also the protocol with which I'm most familiar.

Why Cache?

Caching may be one of the most boring topics in software, but if you're working with distributed systems (like the web), smart cache design is absolutely vital to both system scalability and responsiveness, among other things. In brief, a cache is simply a local copy of data that resides elsewhere. A computing component (whether hardware or software) uses a data cache to avoid performing an expensive operation like fetching data over a network or executing a computationally-expensive algorithm. The trade-off is that your copy of the data may become out of sync with the original data source, or stale, in caching terminology. Whether or not staleness matters depends on the nature of the data and the needs of your application.

For example if your web site displays the average daily temperature for Philadelphia over the past hundred years, you probably display a simple stored data element (e.g. "59 degrees F") rather than performing this very expensive computation in realtime. Because it would take a long period of unusual weather to noticably affect the result, it doesn't really matter if your cached copy doesn't consider very recent temperatures. At the other extreme, an automated teller machine (ATM) definitely should not use a cached copy of your checking account balance when determining whether you have enough money to make a withdrawl since this might allow a malicious customer to make simultaneous withdrawls of his entire balance from multiple ATMs.

Generally speaking, the cacheability of a particular piece of data varies along two axes:

  • the volatility of the data
  • the potential negative impact of using stale data

HTTP Caching Options

Caching is a first-class concern of the REST architectural style and the HTTP protocol. Indeed, one of the main goals of HTTP/1.1 was to enhance the basic caching capabilities provided by HTTP/1.0 (see chapter 7 of Krishnamurthy and Rexford's Web Protocols and Practice for an excellent discussion on the design goals of HTTP 1.1). At the risk of oversimplifying, for a given RESTful HTTP URI, you have three basic caching options:

  1. don't use caching
  2. use validation-based caching
  3. use expiration-based caching

These options demonstrate the trade-offs between the need to avoid stale data and the performance benefits of using cached data. The no caching option means that a client will always fetch the most recent data available from an origin server. This is useful in cases where the data is extremely volatile and using stale data may have dire consequences. For example, anytime you view a list of current auctions on eBay (e.g. for 19th Century Unused US Stamps), you'll notice many anti-caching directives in the HTTP response included to ensure that you always see the most recent state of the various auctions. The downside of no caching is that every request is guaranteed to incur some cost in terms of client-perceived latency, server resources (e.g. CPU, memory), and network bandwidth.

Validation-based caching allows an HTTP response to include a logical 'state identifier' (such as an HTTP ETag or Last-Modified timestamp) which a client can then resend on subsequent requests for the same URI, potentially resulting in a short 'not modified' message from the server. Validation-based caching provides a useful trade-off between the need for fresh data and the goal to reduce consumption of network bandwidth and, to a lesser extent, server resources and client-perceived latency.

For example, imagine a web page that changes frequently but not on a regular schedule. This web page could use validation-based caching so that each time a client attempts to view the page, the request goes all the way back to the origin server but may result in either a full response (if the client either has an old version of the page or no cached version of the page) or a terse 'not modified' response (if the client has the most recent version of the page). All other things being equal, in the 'not modified' case the response will be smaller (since the server sent no document), the server will do less work (since it doesn't have to stream the page bytes from disk or memory), and the client may observe a faster load time since the message is smaller and the user agent (e.g. the browser) may even have a cached rendering of the page. These are certainly superior non-functional characteristics to the 'no caching' case and we don't have to worry about seeing stale data (assuming the client does the right thing). However, the server still did some work to determine that the client had the most recent resource, the client still experienced some latency waiting for the 'not modified' message, and we still used some network bandwidth to send the request and received the (albeit short) response.

Expiration-based caching allows an origin server associate an expiration timestamp on a particular document so that clients can simply assume that their cached copy is safe to use if it not passed its expiration date. In other words, an origin server asserts that the document is 'good' or 'good enough' for a certain period of tme. This sort of caching has fantastic performance characteristics but requires the designer to ensure either that:

  • the data won't become stale before the expiration period ends, or
  • the impact of a client using stale data is negligible

An example of a resource that is well-suited for expiration-based caching is an image of a book cover on Amazon.com (e.g. the image of the cover of Steve Krug's Don't Make Me Think). While it's possible that the book cover could change, it's extremely unlikely and since image files are relatively large, it would be wise for Amazon to set an expiration date so that clients load the image from their cache without even asking Amazon whether or not they have the most recent version. If somehow the cover of the book does change between when you cache your copy and when your cache copy expires, it's not a big deal unless you base your purchasing decisions on book cover aesthetics.

Another performance benefit of expiration-based caching is that even in the case where a client doesn't have a valid cached copy of a document, it's possible that a network intermediary (e.g. a proxy server) does. In this case a client requests a particular URI and before the request reaches the origin server, an intermediary determines that it has a still-valid cached copy of the document and returns its copy immediately rather than forwarding the request to the next intermediary or the origin server. It should be clear from these examples that expiration-based caching results in significantly less user-perceived latency and consumes significantly less network bandwith and server resources. The trick is that you have to guarantee either no staleness or feel confident that the risks involved in a client processing stale data are justified by the performance benefits. Note that its generally not possible to take advantage of intermediary caching over an HTTPS connection.

Summary

In this entry I've explained the basic rationale for why we cache things in distributed systems and given an overview of the three basic caching options in REST/HTTP-based systems. This information represents a bare-bone set of fundamental caching concepts, but you must understand these concepts thoroughly before being able to make informed caching design choices vis-à-vis your data model.

In future entries, I'll build upon these foundational concepts to discuss caching design strategies for various scenarios.




May 11 2007, 01:36:58 PM EDT Permalink



Saturday April 21, 2007

the value of UI consistency

Andrew Shebanow of Adobe recently wrote an interesting blog entry with the unfortunate title of "The Death of UI Consistency". A few excerpts:

What I’m really talking about here is how the goal of complete UI consistency is a quest for the grail, a quest for a goal that can never be reached.

...

The reason I think [that RIAs bringing web conventions to the desktop is a good thing] is that it lets us move the conversation away from the discussion of conformance with a mythical ideal and towards a discussion of what a usable UI should be.

I've been thinking about UI consistency quite a bit recently. Although Andrew's on the right track, I think he clouds the issue by arguing that the "the goal of complete UI consistency is a quest for the grail". I personally don't know anyone who has argued for complete UI consistency; indeed my recent experience, especially with Ajax-style web applications, has been that many designers don't consider UI consistency enough. But before going further, I think it's important to consider what it means to provide UI consistency.

First it's important to remember that consistency is relative. While we can measure certain UI characteristics, like background color or width, in absolute terms (e.g. 'white' or '1400 pixels'), we can only measure consistency relative to established visual and behavioral conventions. These conventions vary by platform - for example in a Windows application you expect to see a closing 'x' in the upper right hand corner of each application; on a web site you expect clicking on a hyperlink to take you to a new page. So because there are no universal UI conventions, there's no such thing as absolute consistency; there is only consistency vis-à-vis platform conventions.

I believe Andrew is observing that as rich client and web technologies converge, so too do their UI conventions, and sometimes these conventions conflict with one another. John Gruber complained that the Adobe CS3 close box didn't follow the Mac convention; Andrew posits that this is because CS3 does not try to follow Mac conventions nor Windows conventions - it follows the conventions of the Adobe platform.

It's all well and good to say that you're creating a new platform and that your new platform introduces new UI conventions, but the fact is that users do have certain expectations about how UIs should look and behave, and when you violate these expectations by not following conventions, you'd better be confident that the benefits outweigh the potential pain you'll cause users.

So how should we decide whether to follow established UI conventions or to attempt something new and different? To answer this question, it's important to first understand the value of following conventions as well as the costs and benefits of violating conventions.

Observing established UI conventions has two main benefits:

  • You reduce your application's learning curve because the user can (subconsciously) leverage previous experience within your application. For example, when you see blue underlined text on a web page, no one needs to explain that you can click it.
  • Your app is more pleasant to use or, more accurately, your app is less unpleasant to use; observe Gruber's comment "God, that just looks so wrong" - have you ever felt that way when you used a Swing application that was trying to emulate a native Windows or Macintosh look and feel but not quite succeeding?

To quote my former colleague Don Ferguson, "different is hard". Different can also feel awkward. As you interact with a class of apps over time, your mind builds up subconscious expectations about how apps of that class should look and behave. When an app violates its platform conventions, it often becomes harder to use and sometimes just plain annoying. For instance, have you ever used a web site that decided its hyperlinks shouldn't be underlined and shouldn't be blue? Not pleasant. All this being said, it seems like we should always observe UI conventions, but this is not the case either.

UI conventions are not the laws of physics. They represent previous human design decisions that became the norm either because they were very useful (the hyperlink) or just because they became entrenched (the 'File' menu). Either way it is possible that a smart or lucky designer can invent a new mechanism that violates existing conventions yet overcomes the barriers to entry because of its usefulness. But it's a high bar. A new UI mechanism must not simply be better than a UI convention; it must be significantly better such that its value negates the added learning curve and strangeness. A good example of a UI innovation that succeeded is the 'web text box auto-complete dropdown' pattern that we see in web applications like Google Suggest, del.icio.us, and Google Maps. Many smart people considered this behavior strange and novel when they first discovered it; these days we don't really notice it though we certainly appreciate its usefulness. In other words it's on its way to becoming a new convention.

So I believe that designers should observe established UI conventions except when they decide that violating said conventions provides enough value to obviate the costs. In practice, many designers don't really think about observing or breaking conventions; they just do what feels right. And you know what? Sometimes they succeed and their arbitrary design choices become new conventions. But a design that violates conventions without understanding the trade-offs runs the risk of feeling just plain arbitrary.




Apr 21 2007, 12:35:52 AM EDT Permalink



Wednesday April 18, 2007

links for 2007-04-13




Apr 18 2007, 11:19:10 PM EDT Permalink



Saturday March 24, 2007

quote of the day

Joe Gregorio:
While REST is best thought of as a guide and not a law, you have to remember that so is, "Don't run with scissors."



Mar 24 2007, 11:15:31 AM EDT Permalink


Saturday March 24, 2007

links for 2007-03-24




Mar 24 2007, 10:43:40 AM EDT Permalink



Thursday March 22, 2007

links for 2007-03-22




Mar 22 2007, 11:03:45 AM EDT Permalink

Previous month
  July 2009
S M T W T F S
   1234
5
67891011
12131415161718
19202122232425
262728293031 
       
Today

RSS for

Favorites
(full links)
Get Firefox!
IBM Systems Journal
Rational @ developerWorks
Wikipedia

Categories
agile (2)
ajax (6)
blogging (34)
books and articles (28)
culture (1)
design (1)
it industry (54)
jazz (10)
linux (1)
off topic (25)
rest (4)
software dev (63)
tips and toys (1)
tutorials (3)
ubuntu (1)
was (1)
windows (1)
worklife (14)
writing (4)

Recent Entries
from Windows to Ubuntu
RIA weekly podcast and errata
Jazz Team Blog
measures of progress
job news
if you're using Jazz, what other...
Upcoming Beijing Talks
links for 2007-06-06
the Uncanny Valley of user inter...
HTTP caching options
the value of UI consistency
links for 2007-04-13
quote of the day
links for 2007-03-24
links for 2007-03-22

Blogs I read
(full blogroll)
Bobby Woolf [IBM]
James Governor [RedMonk]

Special offers
Save on Rational testing software
Download trial versions of popular IBM software
Register for the DB2 Information Management Technical Conference

More offers


 
    About IBM Privacy Contact