Shane O'Sullivan's technical blog… really ties the room together

Getting started with Ajax on Eclipse

Posted by Shane O'Sullivan on October 26, 2006

I recently tried to get up and running with the Eclipse Ajax Toolkit Framework, which contains many useful, though very early in development, features to make developing Ajax based applications easier. However, it turned out to be ridiculously difficult to get working. First I downloaded a v3.2 version of Eclipse, got the prerequisites (including the Web Standards Tools package) and tried to install the ATF package, but to no avail. I then tried downloading a bundled version of the WST package and installing the ATF on top of it, and once again it told me I was missing some plugins. Updating the entire platform through the Software Updates tool didn’t help either.

Finally, I found an amazingly simple tool that fixes all this for you. One of the Eclipse partners, Yoxos, has a web-based tool that allows you to configure your own copy of Eclipse, adding in whatever plugins and features you like. They have a list of the most popular configurations, but, unlike the bundled Eclipse distros, they allow you to mix and match different configurations before you download them. Yoxos also saves you the trouble of having to enter in many different update sites for the various different projects of Eclipse, something I always found extremely irritating. Why Eclipse can’t manage to have a single update site that encapsulates every project on, I’ll never know. Yoxos also include other open source Eclipse packages that are not part of the Eclipse project, such as Aptana, a very cool Ajax development environment for Eclipse.

All this very cool, but the ATF has a number of steps you must perform (see here) before it will work. The Yoxos distribution goes some way towards solving these.

  • It automatically downloads a distribution of Dojo and places it in the correct plugin resource folder (eclipse\plugins\org.eclipse.atf.personality.dojo.runtime_1.0.1\resources if you’re interested). Personally I prefer to make my own builds of Dojo, rather than taking one of the canned builds, but that’s a personal choice and the bundled one might do you just fine. Note that Dojo 0.4.0 was just release this week, and you may want to update to that instead.
  • The JsLint javascript file is downloaded to the correct folder (eclipse\plugins\org.eclipse.atf.javascript.jslint_1.0.1\resources), however it is not renamed from fulljslint.js to jslint.js as is required by ATF. So, go to that folder and rename it to jslint.js.
  • XulRunner is not downloaded and installed, so you’ll still have to follow the instructions here to get that part working.

However, these three little steps are miniscule compared to the headaches I had trying to set it up on my own, so give it a go. Some things to note

  1. Yoxos rebrand Eclipse so that their logo pops up in some places. I don’t mind, but some people might.
  2. They also offer an optional second update mechanism, which I prefer to the usual Eclipse tool. It integrates with their web tool to make sure you have all the plugins you need, without you having to enter in the various update sites and resolve the plugin dependancies yourself.


Some issues have come to light since I’ve downloaded from Yoxos and played around with it.

  1. Using the Yoxos update facility (after the initial download) requires you to register with their site, which unfortunately costs money.  So make sure that you have everything you need in the initial download if you don’t intend on paying for their service. The Yoxos update tool also caused Eclipse to crash when it found that I hadn’t bought a subscription, though this appears to be a bug rather than deliberate.
  2. There seems to be some problem with running the Mozilla browser.  When I choose to run a HTML file in the Mozilla browser (using the Ajax Toolkit Framework), the tab for the browser would appear, but the actual window never appeared.  This means that I cannot use the debugging features of the Ajax toolkit.

8 Responses to “Getting started with Ajax on Eclipse”

  1. ung said

    Yes I do agree with u. I could get it up an running the usual way (as suggested by the Dojo Project Cycle Demo Movie) How ever I came across the same problem running the Mozilla browser. The tab would appear but not the window. Anyone out there has a solution for this?

  2. Vineet Reynolds said

    I noticed that the Yoxos build of Eclipse has the same problem regarding the disabled Mozilla windows. This is however, something that is not a problem with the regular Eclipse distros. So either something is wrong is wrong with the ATF build that ships in the Yoxos release, or something wrong with XUL runner.

  3. Michal Zdzinski said

    I think to resolve problem with displayin only Mozilla Broser tab it is necessary to restart eclipse with -clean flag (see last paragraph on ATF download page). In my case it works now.

  4. Al said

    I am observing the same problem – the tab for the browser would appear, but the actual window never appeared. My config is from:

    as suggested in the IBM article.

    Any one out there with any ideas?


  5. alex said

    I read a note on the Yoxos website that says

    “Please note: This build now requires XULRunner 1.8.1 and will not work with XULRunner 1.8.0.x”

    I found it where you download the ATF.

    I downloaded 1.9a3pre.en-US.win32 and it works. (also runned eclipse.exe -clean – don’t know if that helped or not 🙂

  6. sudhir said

    I had the same problem. Before few months, I wanted to try Eclipse ATF. I struggled around one whole day, but I was not able to get it working.

    I think YOXOS may help me, I will give it a try.

  7. Hi,

    I know this post is from some time ago, but I was wondering if you still use ATF to develop AJAX-based applications with dojo? I have being toying with (the latest) ATF 0.2.3M4 build but it has many problems. Also, the atf-dev mailing list is not very active 😦


  8. Hi Martin,

    No, I generally use Aptana these days, it does so many things very well.


Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

%d bloggers like this: