[JEXL-99] Documentation of Thread Safety / Invalid code examples on homepage

• Type: Task
• Status: Closed
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: 2.0
• Fix Version/s: 2.0.1
• Assignee: Henri Biestro
• Reporter: Marcel Schoen
• Created: 24/Mar/10 10:26
• Updated: 07/Apr/10 14:40
• Resolved: 24/Mar/10 17:54

Description

I had trouble with a custom method invoked in a JEXL script. This method throws a RuntimeException, which got swallowed with JEXL 2. Using the debugger, I found the "strict" flag of the Interpreter to be false, even though I had invoked "JexlEngine.setLenient(false)" in my initialization code.

Now I suspect my initialization logic to be faulty, but while I looked into this, I realized that the javadoc of JexlEngine doesn't really tell me if I can use it as a singleton or not (or if I should, for that matter). If so, are its various methods thread-safe or not? It only says so for a few methods like "setDebug()".

In addition, some code examples on the homepage are heavily outdated. For example, the first code fragment on this page

http://commons.apache.org/jexl/reference/examples.html

shows the usage of a class "ExpressionFactory" which doesn't even exist in the JEXL 2 source tree. Of course it would be nice if these examples would show how to correctly use "JexlEngine", for instance.