Nicolas Richeton

When developping Java web apps, you may sometime see random startup errors like this one :

java.lang.IllegalStateException: Unable to instantiate container.
at org.apache.tiles.web.startup.TilesListener.contextInitialized(TilesListener.java:60)
at org.mortbay.jetty.handler.ContextHandler.startContext(ContextHandler.java:549)
at org.mortbay.jetty.servlet.Context.startContext(Context.java:136)
at org.mortbay.jetty.webapp.WebAppContext.startContext(WebAppContext.java:1282)
at org.mortbay.jetty.handler.ContextHandler.doStart(ContextHandler.java:518)
at org.mortbay.jetty.webapp.WebAppContext.doStart(WebAppContext.java:499)
(...)


Most of the time your application works, but sometimes it just does not start.

This is because of the dtd resolution mecanism: if you use the reference of a dtd which is not in the webapp classpath, the container will try to get it from internet.

If the remote site is down (in this case http://tiles.apache.org), your app will no longer start.

Sadly, it’s easy to get in this situation.

• Upgrade a library without updating xml headers
• Copy/Paste a snippet from the elsewhere

… and the container will start to fetch dtds from the internet.

In my case, the previous error was caused by :

<?xml version="1.0" encoding="ISO-8859-1" ?>

<!DOCTYPE tiles-definitions PUBLIC
"-//Apache Software Foundation//DTD Tiles Configuration 2.1//EN"
"http://tiles.apache.org/dtds/tiles-config_2_1.dtd">

<tiles-definitions>
(...)
</tiles-definitions>

instead of :

<?xml version="1.0" encoding="ISO-8859-1" ?>

<!DOCTYPE tiles-definitions PUBLIC
"-//Apache Software Foundation//DTD Tiles Configuration 2.0//EN"
"http://tiles.apache.org/dtds/tiles-config_2_0.dtd">

<tiles-definitions>
(...)
</tiles-definitions>

With tiles 2.0.6 in the classpath.

Conclusion
Be sure to use the exact version of the dtd in your classpath. Don’t pickup examples from the internet without double-checking the dtd.
This will prevent longer startup times and potential random errors.

Note: this post dedicated to Olivier and Jimmy

Après une première partie technique, nous allons étudier une partie plus théorique sur les différents usages d’ESIGate dans des projets Web.

Attention: Article en cours de rédaction, les concepts étant relativement complexes à comprendre (mais simples à mettre en oeuvre), vous êtes invités à commenter ce post pour aider à l’améliorer.

Le coeur d’ESIGate est une implémentation Java d’un moteur d’ESI :

• a partir d’un document HTML, le framework va parser le flux à la recherche de directives référençant des contenus à intégrer depuis des URL externes.
• Ces contenus sont récupérés et mis en cache automatiquement, puis insérés dans le flux HTML original.
• Les directives peuvent soit suivre la norme ESI, soit utiliser le format ESIGate, plus riche en terme de fonctionnalités.

ESI, à quoi ça sert ?
Les usages sont multiples, mais à l’origine la norme ESI permet d’étendre les possibilités de mise en cache des pages produites par des applications web et donc d’améliorer grandement leurs performances.

(more…)

(Ce tutorial est aussi disponible en Français : ESIGate Tutorial – Partie 1)

In this series, I will present the various uses of ESIGate framework (former Assembly Web Tool – WAT).

In Part 1, we will integrate a very simple application in a remote template, only via http. The typical use is a corporate intranet: multiple different applications (content management, HR management, time reporting, etc …) can use the same theme, based on a master application.

This has the following benefits:

• almost no need to work on styling (html/css) in slave applications.
• When the theme changes in the master application, the changes are immediately reflected on all slave applications without restart
• the master application can be replaced with no impact if the new theme is compatible
• If the new master application is incompatible with the previous theme, the synchronization can be ‘broken’ by pointing slave applications on a static html file

(more…)

git config --global user.name "<your-name>"
git config --global user.email "<your-email>"

(This tutorial is also available in English : ESIGate (ex Web Assemble Tool – WAT).

Dans la partie 1, nous allons intégrer une application très simple à une template distante, uniquement via http. Le cas d’utilisation typique correspond à un intranet d’entreprise : de multiples applications différentes (gestion de contenus, gestion RH, saisie des temps, etc…) peuvent utiliser le même thème en se basant sur une application maître.

Grâce à ce fonctionnement, on obtient les avantages suivants :

• La charge de montage html est extrêmement réduite sur applications esclaves.
• Lorsque le thème change dans l’application maître, les modifications sont immédiatement répercutées sur toutes les applications esclaves, sans redémarrage
• On peut remplacer l’application maitre, sans impact si le thème est compatible
• En cas de modification incompatible de l’application maitre, on peut ‘casser’ la synchronisation en faisant pointer les applications esclaves sur un fichier html statique

(more…)