Brett Porter - Developing with Jetty: Where Have You Been All My Life?

Developing with Jetty: Where Have You Been All My Life?

[ Brett ] 22:01, Tuesday, 10 January 2006

Do yourself a favour - check out Jetty6.

It's been a while since I've done any form of webapp development, so I'm a bit rusty. The last place I worked at ran Tomcat servers (quite successfully), so development was naturally done against the same, with the occasional foray into Resin. But both suffered from the problem that fairly regularly, someone would get their dev environment misconfigured and spend some time troubleshooting where it had all gone wrong. It was inevitably something simple and completely unrelated to the NullPointerException or some other runtime exception that had popped up in the logs or in the browser.

With IDEA having Tomcat support built in, when I was starting to test the new webapp I naturally fell back to the old habit of firing that up. And then, no end of of problems:

The Windows install of Tomcat omits all the startup scripts because you get a service, and you'd never want anything else, right? The IDEA support requires the scripts, so I grab the tarball instead.
Errors on startup. SEVERE: Error filterStart. I know that means an exception in the filters I have configured. I'd like to know what it is. But the only way I'm extracting it is with a breakpoint and startup in debug mode (yes, this was my fault, but a little more helpful error message would be nice).
Ok, everything working. Webapp redeploys most of the time, in about 15-20 seconds after making changes. Sometimes it needs a stop/start cycle to pick it up though.
Somehow I manage to get a NullPointerException on startup when it was working before. Googling seems to indicate this is an invalid ROOT.xml, as I see a user getting reprimanded for not bothering to do validation on the XML. Sorry, but a NullPointerException is a bug, user error or not. I can't find the cause, the XML is valid and I've deleted IDEA's cache of the tomcat base to no avail.

The IDEA support for Tomcat is actually quite good, but I just didn't have time for this. This was with a default configuration!

Luckily, Jetty6 to the rescue. I've heard much about it recently and I know they just did a Maven 2 plugin that sounded cool. I wasn't really aiming to learn another new technology, but thought it was worth a shot since it was on my todo list and I wasn't getting anywhere. Less than 5 minutes later, the environment is running flawlessly with features I've had to fumble around to set up for other containers in the past:

web resources read directly from the source tree, so you can edit, save, refresh without any deploying, etc.
detects changes on a scheduled interval (I'm using 10 seconds), reloads the webapp if classes/descriptors/libs change. It reloads fast and I haven't seen it fall over on it yet.
Very little setup required.

What setup was required?

First, the normal Maven2 stuff: run the archetype command to generate a skeleton webapp project, start adding web content, and run mvn package to build the WAR. I'd done all this before using Tomcat today. Because of the way I was using Tomcat, I wasn't using mvn package, but had used mvn idea:idea to generate the appropriate webapp IDEA module and was letting it do all the exploded webapp creation in the Maven layout, so I could continue to use that as is.

To set up Jetty6, I added this to the POM:

<plugin>

  <groupId>org.mortbay.jetty</groupId>

  <artifactId>maven-jetty6-plugin</artifactId>

  <configuration>

    <scanIntervalSeconds>10</scanIntervalSeconds>

    <contextPath>/</contextPath>

  </configuration>

</plugin>

The rest of the defaults were fine. Then:

mvn jetty6:run

Jetty is now sitting on localhost:8080 with the webapp running, listening for changes.

This is my ideal set up for development, and I don't see myself going back any time soon. A huge thanks to the Greg and Jan for their work on this. I'm really looking forward to using it some more.

It looks great, and much easier than Tomcat for development purpose...

I tried it quickly (took really 5mins), the only problem I got now is that my project expect some libraries to be provided by the container (such as the jdbc driver, javamail, activation, and others...) which then have the scope "provided" in the POM...

It doesn't seem that the maven jetty plugin add them to the classpath, and I think it should...

Maybe I'm wrong or I missed something... Cannot ask to get everything working in only 5mins !

I'll definitively give it a go, anyway and spend some more time figuring things out...

Thanks for the tip !

--Samuel Le Berrigaud, January 11, 2006 12:57 AM

Note to the unwary: jetty6 has been renamed to jetty. Change your poms accordingly or be prepared to spend much more than 5 minutes to get this running.

The current version of jetty6 (the one from july 2006) is still available, but not working with the circulating examples.

Hope this helps.

related error:
190 [main] INFO org.mortbay.log - jetty-6.0-SNAPSHOT
250 [main] WARN org.mortbay.log - failed ContextHandler@1bf7b23{/testApp,file:/C
:/eclipse/workspaces/3.1/testApp/src/main/webapp/}
250 [main] WARN org.mortbay.log - failed ContextHandlerCollection@2d7440
250 [main] WARN org.mortbay.log - failed HandlerCollection@2b349d
290 [main] INFO org.mortbay.log - Started SelectChannelConnector @ 0.0.0.0:8080
290 [main] WARN org.mortbay.log - failed Server@1f7708
[INFO] Jetty server exiting.
[INFO] ------------------------------------------------------------------------
[ERROR] FATAL ERROR
[INFO] ------------------------------------------------------------------------
[INFO] org.mortbay.jetty.webapp.WebAppClassLoader.getUrlClassPath()Ljava/lang/St
ring;
[INFO] ------------------------------------------------------------------------
[INFO] Trace
java.lang.NoSuchMethodError : org.mortbay.jetty.webapp.WebAppClassLoader.getUrlCl
assPath()Ljava/lang/String;
at org.mortbay.jetty.plugin.Jetty6MavenConfiguration.configureClassLoade
r(Jetty6MavenConfiguration.java:62)
at org.mortbay.jetty.webapp.WebAppContext.doStart(WebAppContext.java:453
)

--iwein, October 1, 2006 12:44 AM