Release Notes:

• Updated build and project to OpenSymphony. License has changed, as well as project organization
• Added Eclipse project files
• OgnlContext.java: Added try...catch around System.getProperty() access for limited security environments.
• OgnlRuntime.java: Added security manager API enhancements to OgnlRuntime (requested by Ciber).
• OgnlOps.java: Fixed bug in compareWithConversion() where non-numeric non-Comparable objects throw invalid comparison exception.
• Various cleanups of code formatting

SimpleNode.java
Fixed bug where current object is not set during navigation if that object is null.

Download 3.0.0 Preview 2 binary

Download 3.0.0 Preview 2 source

This is a developer preview release and comes in source and binary form.

The intent is to gather feedback on the new direction of the OGNL API. The language is not changed, but the internals of OGNL have changed dramatically.

Please take a look at this and provide feedback via the OGNL lists.

Bugs fixed for this release parallel the 2.6.6 release.

ArrayPropertyAccessor.java
Fixed bug with not calling conversion on setting value in array

NoSuchPropertyException.java
Made message clearer about which object is being accessed

OgnlOps.java
Added compareWithConversion() method used by relational operators for comparisons.

Tests

• Added new ArithmeticAndLogicalOperatorsTest test case
• Added new ArrayElementsTest test cases to test conversion when setting array values

This is a developer preview release and only comes in source form.

The intent is to gather feedback on the new direction of the OGNL API. The language is not changed, but the internals of OGNL have changed dramatically.

Please take a look at this and provide feedback via the OGNL lists.

• Fixed several NullPointerException points
• Fixed greater than operator for Comparable objects
• Fixed static method calls on instance
• Added isEqual() method to OgnlOps for more robust equality check than object's equals() method
• Added 3 new test cases (operators, nested properties within method calls, NoSuchPropertyException handling)
• Added 4 new tests to existing test cases for static method calls

• Fixed root & this keywords not working
• Added constant value folding for expression evaluation
• Improved String -> Number handling
• bigIntValue(), bigDecValue(), longValue() and doubleValue() now declare to throw NumberFormatException.
• Removed deadlock from SimpleNode on evaluation pool.
• Added default primitive values for setting and getting null results on methods that return primitives.
• TypeConverter result value of NoConversionPossible now returnable for TypeConverter implementations where (suprisingly enough) no conversion is possible
• Tests include an experimental Javassist-based compiler for faster property expression handling (compiles a property accessor to bytecode).
• Converted all tests to JUnit
• Split documentation into Language Guide and Developer Guide
• Build file now self-contained
• Distributions of source and documentation are now zip files instead of jar files

Build file that will work for OGNL 2.6.3 external builds.

1. Download build-ext.xml and build-ext.properties into the OGNL source directory
2. Download copies of ant-contrib-x.x.jar and javacc.jar.
3. Edit build-ext.properties to point to the downloaded jars from (2)
4. Build OGNL using the build-ext.xml file:
   
         ant -f build-ext.xml
   
   This will build the ognl-2.6.3.jar into the current working directory
5. Enjoy your newly built OGNL jar!

Bug fix release:

• Fixed bug with Object Indexed properties wherein you could not override the get or set methods.
• Corrected OgnlOps operations with regard to String catenation and null handling. If two strings are being catenated with the "+" operator and one of them is null this will now use "null" (literal string) as a replacement. This is consistent with Java's handling of null catenation to a String. Any other object catenated to a null object will throw a NullPointerException as usual.

Wow, a release 2 hours after a previous release.

• Fixed bug with finding Object Indexed properties that were of the form get(Object) and set(Object, Object). This was triggered by an expression on java.lang.reflect.Field, the only JDK class to implement this pattern.

This release adds some interesting features that will make OGNL more compatible with embedding in XML, as well as some bug fixes.

• Aliased all logical and relational operators with plain text equivalents (see OGNL Reference for a complete guide to the new operators). This should make embedding OGNL in XML attributes and text much easier (no more CDATA sections!).
• Fixed bug with Object Indexing which caused the indexing code to always check the type of the root of the expression rather than the currently set #this object.
• Changed NullHandler and MethodHandler to take an Object[] (like ExtendedMethodHandler and ExtendedNullHandler used to). Updated ObjectNullHandler and ObjectMethodAccessor appropriately.
• Added new create() methods to ObjectArrayPool for creating object arrays initialized with a variety of different sizes.
• Removed ExtendedNullHandler and ExtendedMethodAccessor, which were not very useful anyway.
• As always, added many new tests to test new and improved functionality.
• Updated the documentation to include mentioning the use of single quotes in strings, removed reference to Strings and null handling (Strings are handled exactly like other Object) and also a new section on the wide variety of indexing options that OGNL supports.

Fixed NullPointerException in ArrayPropertyAccessor when expression starts with array reference (i.e. "[0]").

Added indexed property support. As a result of this I also added Evaluation tracing.

See ognl.OgnlContext API and ognl.Evaluation API for usage of Evaluation class.

Removed specific dependency on LinkedHashMap that prevented OGNL versions 2.2.2 and later from being used on JDK 1.3.1 VMs.

Fixed bug dealing with calling methods on Class (like object.getClass().getName()).

Added 4 new tests to support this bug fix.

Changed the way PDF documentation is generated and don't distribute the temporary FOP code with the doc bundle (build file changes).

• MethodAccessor interface for choosing methods class-by-class and executing them. Blame and congratulate Patrick Lightbody and his constant pestering for this one.
• NullHandler interface for handling how nulls are navigated (allows for substitution of null value with non-null for recovery). Amazingly enough this suggestion also came from Patrick Lightbody.

• Single quotes (') with a length of one will be turned into a Character (for compatibility with current expressions)
• Single quotes of length greater than one will be turned into String (so that OGNL expressions can be safely embedded in XML attributes, for example).
• Double quotes (") are exclusively for String
• new back quotes (`) are exclusively for Character and must be one character long.

• PropertyNode tracking fixed (used internally by MapPropertyAccessor)
• Fixed private/protected/package protected access for properties and methods
• Used PMD to clean up code (unused imports & local variables). Recommended.
• Added 9 tests for private access stuff.

Security added for method invocation. To use you need to add entries for ognl.OgnlInvokePermission with a pattern that matches the methods you want to be able to call like "invoke.class-name.method-name". Example in Tomcat, permitting access to the org.ognl and the javax.mail packages:

grant codeBase "file:${catalina.home}/webapps/OGNL/-"

{

    permission ognl.OgnlInvokePermission "invoke.org.ognl.*";

    permission ognl.OgnlInvokePermission "invoke.javax.mail.*";

    ...more entries follow...

}

Added Map creation syntax:
#{ "foo":"bar" } will yield a java.util.HashMap with one key/value pair, "foo"->"bar". You can specify the type of map to create by inserting a class reference between the # and {, thusly:
#@java.util.LinkedHashMap@{"foo":"bar", "bar":"baz"}