Commits

Anonymous committed ed9aae7

Initial import.

Comments (0)

Files changed (256)

+<?xml version="1.0" encoding="UTF-8"?>
+<classpath>
+	<classpathentry kind="src" path="src/java"/>
+	<classpathentry kind="src" path="src/test/java"/>
+	<classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER"/>
+	<classpathentry kind="lib" path="lib/build/javacc.jar"/>
+	<classpathentry kind="lib" path="lib/build/javassist.jar"/>
+	<classpathentry kind="lib" path="lib/build/junit.jar"/>
+	<classpathentry kind="output" path="build/java"/>
+</classpath>
+OGNL.iws
+build
+dist
+extlib
+target
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+	<name>ognl</name>
+	<comment></comment>
+	<projects>
+	</projects>
+	<buildSpec>
+		<buildCommand>
+			<name>org.eclipse.jdt.core.javabuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+	</buildSpec>
+	<natures>
+		<nature>org.eclipse.jdt.core.javanature</nature>
+	</natures>
+</projectDescription>

.settings/org.eclipse.jdt.core.prefs

+#Tue Dec 19 23:49:08 EST 2006
+eclipse.preferences.version=1
+org.eclipse.jdt.core.compiler.codegen.targetPlatform=1.1
+org.eclipse.jdt.core.compiler.compliance=1.3
+org.eclipse.jdt.core.compiler.problem.annotationSuperInterface=warning
+org.eclipse.jdt.core.compiler.problem.assertIdentifier=ignore
+org.eclipse.jdt.core.compiler.problem.autoboxing=ignore
+org.eclipse.jdt.core.compiler.problem.deprecation=warning
+org.eclipse.jdt.core.compiler.problem.deprecationInDeprecatedCode=disabled
+org.eclipse.jdt.core.compiler.problem.deprecationWhenOverridingDeprecatedMethod=disabled
+org.eclipse.jdt.core.compiler.problem.discouragedReference=warning
+org.eclipse.jdt.core.compiler.problem.emptyStatement=ignore
+org.eclipse.jdt.core.compiler.problem.enumIdentifier=ignore
+org.eclipse.jdt.core.compiler.problem.fallthroughCase=ignore
+org.eclipse.jdt.core.compiler.problem.fieldHiding=ignore
+org.eclipse.jdt.core.compiler.problem.finalParameterBound=warning
+org.eclipse.jdt.core.compiler.problem.finallyBlockNotCompletingNormally=warning
+org.eclipse.jdt.core.compiler.problem.forbiddenReference=error
+org.eclipse.jdt.core.compiler.problem.hiddenCatchBlock=warning
+org.eclipse.jdt.core.compiler.problem.incompatibleNonInheritedInterfaceMethod=warning
+org.eclipse.jdt.core.compiler.problem.incompleteEnumSwitch=ignore
+org.eclipse.jdt.core.compiler.problem.indirectStaticAccess=ignore
+org.eclipse.jdt.core.compiler.problem.localVariableHiding=ignore
+org.eclipse.jdt.core.compiler.problem.methodWithConstructorName=warning
+org.eclipse.jdt.core.compiler.problem.missingDeprecatedAnnotation=ignore
+org.eclipse.jdt.core.compiler.problem.missingOverrideAnnotation=ignore
+org.eclipse.jdt.core.compiler.problem.missingSerialVersion=ignore
+org.eclipse.jdt.core.compiler.problem.noEffectAssignment=warning
+org.eclipse.jdt.core.compiler.problem.noImplicitStringConversion=warning
+org.eclipse.jdt.core.compiler.problem.nonExternalizedStringLiteral=ignore
+org.eclipse.jdt.core.compiler.problem.nullReference=ignore
+org.eclipse.jdt.core.compiler.problem.overridingPackageDefaultMethod=warning
+org.eclipse.jdt.core.compiler.problem.parameterAssignment=ignore
+org.eclipse.jdt.core.compiler.problem.possibleAccidentalBooleanAssignment=ignore
+org.eclipse.jdt.core.compiler.problem.rawTypeReference=warning
+org.eclipse.jdt.core.compiler.problem.specialParameterHidingField=disabled
+org.eclipse.jdt.core.compiler.problem.staticAccessReceiver=warning
+org.eclipse.jdt.core.compiler.problem.suppressWarnings=enabled
+org.eclipse.jdt.core.compiler.problem.syntheticAccessEmulation=ignore
+org.eclipse.jdt.core.compiler.problem.typeParameterHiding=warning
+org.eclipse.jdt.core.compiler.problem.uncheckedTypeOperation=warning
+org.eclipse.jdt.core.compiler.problem.undocumentedEmptyBlock=ignore
+org.eclipse.jdt.core.compiler.problem.unhandledWarningToken=warning
+org.eclipse.jdt.core.compiler.problem.unnecessaryElse=ignore
+org.eclipse.jdt.core.compiler.problem.unnecessaryTypeCheck=ignore
+org.eclipse.jdt.core.compiler.problem.unqualifiedFieldAccess=ignore
+org.eclipse.jdt.core.compiler.problem.unusedDeclaredThrownException=ignore
+org.eclipse.jdt.core.compiler.problem.unusedDeclaredThrownExceptionWhenOverriding=disabled
+org.eclipse.jdt.core.compiler.problem.unusedImport=warning
+org.eclipse.jdt.core.compiler.problem.unusedLabel=warning
+org.eclipse.jdt.core.compiler.problem.unusedLocal=warning
+org.eclipse.jdt.core.compiler.problem.unusedParameter=ignore
+org.eclipse.jdt.core.compiler.problem.unusedParameterWhenImplementingAbstract=disabled
+org.eclipse.jdt.core.compiler.problem.unusedParameterWhenOverridingConcrete=disabled
+org.eclipse.jdt.core.compiler.problem.unusedPrivateMember=warning
+org.eclipse.jdt.core.compiler.problem.varargsArgumentNeedCast=warning
+org.eclipse.jdt.core.compiler.source=1.3
+/* ====================================================================
+ * The OpenSymphony Software License, Version 1.1
+ *
+ * (this license is derived and fully compatible with the Apache Software
+ * License - see http://www.apache.org/LICENSE.txt)
+ *
+ * Copyright (c) 2001-2004 The OpenSymphony Group. All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in
+ *    the documentation and/or other materials provided with the
+ *    distribution.
+ *
+ * 3. The end-user documentation included with the redistribution,
+ *    if any, must include the following acknowledgment:
+ *       "This product includes software developed by the
+ *        OpenSymphony Group (http://www.opensymphony.com/)."
+ *    Alternately, this acknowledgment may appear in the software itself,
+ *    if and wherever such third-party acknowledgments normally appear.
+ *
+ * 4. The names "OpenSymphony" and "The OpenSymphony Group"
+ *    must not be used to endorse or promote products derived from this
+ *    software without prior written permission. For written
+ *    permission, please contact license@opensymphony.com .
+ *
+ * 5. Products derived from this software may not be called "OpenSymphony"
+ *    or "OGNL", nor may "OpenSymphony" or "OGNL" appear in their
+ *    name, without prior written permission of the OpenSymphony Group.
+ *
+ * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
+ * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ * SUCH DAMAGE.
+ * ====================================================================
+ */
+<?xml version="1.0" encoding="UTF-8"?>
+<module version="4" relativePaths="true" type="JAVA_MODULE">
+  <component name="ModuleRootManager" />
+  <component name="NewModuleRootManager">
+    <output url="file://$MODULE_DIR$/build/classes" />
+    <exclude-output />
+    <exclude-exploded />
+    <content url="file://$MODULE_DIR$">
+      <sourceFolder url="file://$MODULE_DIR$/src/java" isTestSource="false" />
+      <sourceFolder url="file://$MODULE_DIR$/src/test/java" isTestSource="true" />
+      <excludeFolder url="file://$MODULE_DIR$/build" />
+      <excludeFolder url="file://$MODULE_DIR$/dist" />
+      <excludeFolder url="file://$MODULE_DIR$/extlib" />
+    </content>
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+    <orderEntry type="module-library">
+      <library>
+        <CLASSES>
+          <root url="jar://$MODULE_DIR$/lib/build/javacc.jar!/" />
+        </CLASSES>
+        <JAVADOC />
+        <SOURCES />
+      </library>
+    </orderEntry>
+    <orderEntry type="module-library">
+      <library>
+        <CLASSES>
+          <root url="jar://$MODULE_DIR$/lib/build/ant-contrib-0.3.jar!/" />
+        </CLASSES>
+        <JAVADOC />
+        <SOURCES />
+      </library>
+    </orderEntry>
+    <orderEntry type="module-library">
+      <library>
+        <CLASSES>
+          <root url="jar://$MODULE_DIR$/lib/build/javassist.jar!/" />
+        </CLASSES>
+        <JAVADOC />
+        <SOURCES />
+      </library>
+    </orderEntry>
+    <orderEntry type="module-library">
+      <library>
+        <CLASSES>
+          <root url="jar://$MODULE_DIR$/lib/build/junit.jar!/" />
+        </CLASSES>
+        <JAVADOC />
+        <SOURCES />
+      </library>
+    </orderEntry>
+    <orderEntryProperties />
+  </component>
+</module>
+
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4" relativePaths="false">
+  <component name="AntConfiguration">
+    <defaultAnt name="Apache Ant version 1.6.5" />
+    <buildFile url="file://$PROJECT_DIR$/build.xml">
+      <additionalClassPath>
+        <entry path="file://$PROJECT_DIR$/lib/build/junit.jar" />
+        <entry path="file://$PROJECT_DIR$/lib/build/clover.jar" />
+      </additionalClassPath>
+      <antReference projectDefault="true" />
+      <customJdkName value="" />
+      <maximumHeapSize value="128" />
+      <properties />
+    </buildFile>
+    <buildFile url="file://$PROJECT_DIR$/docbook.xml">
+      <additionalClassPath />
+      <antReference projectDefault="true" />
+      <customJdkName value="" />
+      <maximumHeapSize value="128" />
+      <properties />
+    </buildFile>
+  </component>
+  <component name="CodeStyleSettingsManager">
+    <option name="PER_PROJECT_SETTINGS" />
+    <option name="USE_PER_PROJECT_SETTINGS" value="false" />
+  </component>
+  <component name="CompilerConfiguration">
+    <option name="DEFAULT_COMPILER" value="Javac" />
+    <option name="CLEAR_OUTPUT_DIRECTORY" value="false" />
+    <option name="DEPLOY_AFTER_MAKE" value="0" />
+    <resourceExtensions>
+      <entry name=".+\.(properties|xml|html|dtd|tld)" />
+      <entry name=".+\.(gif|png|jpeg|jpg)" />
+    </resourceExtensions>
+    <wildcardResourcePatterns>
+      <entry name="?*.properties" />
+      <entry name="?*.xml" />
+      <entry name="?*.html" />
+      <entry name="?*.dtd" />
+      <entry name="?*.tld" />
+      <entry name="?*.gif" />
+      <entry name="?*.png" />
+      <entry name="?*.jpeg" />
+      <entry name="?*.jpg" />
+    </wildcardResourcePatterns>
+  </component>
+  <component name="DataSourceManagerImpl" />
+  <component name="DependencyValidationManager" />
+  <component name="EntryPointsManager">
+    <entry_points />
+  </component>
+  <component name="ExportToHTMLSettings">
+    <option name="PRINT_LINE_NUMBERS" value="false" />
+    <option name="OPEN_IN_BROWSER" value="false" />
+    <option name="OUTPUT_DIRECTORY" />
+  </component>
+  <component name="GUI Designer component loader factory" />
+  <component name="JavacSettings">
+    <option name="DEBUGGING_INFO" value="true" />
+    <option name="GENERATE_NO_WARNINGS" value="false" />
+    <option name="DEPRECATION" value="true" />
+    <option name="ADDITIONAL_OPTIONS_STRING" value="" />
+    <option name="MAXIMUM_HEAP_SIZE" value="128" />
+    <option name="USE_GENERICS_COMPILER" value="false" />
+  </component>
+  <component name="JavadocGenerationManager">
+    <option name="OUTPUT_DIRECTORY" />
+    <option name="OPTION_SCOPE" value="protected" />
+    <option name="OPTION_HIERARCHY" value="true" />
+    <option name="OPTION_NAVIGATOR" value="true" />
+    <option name="OPTION_INDEX" value="true" />
+    <option name="OPTION_SEPARATE_INDEX" value="true" />
+    <option name="OPTION_DOCUMENT_TAG_USE" value="false" />
+    <option name="OPTION_DOCUMENT_TAG_AUTHOR" value="false" />
+    <option name="OPTION_DOCUMENT_TAG_VERSION" value="false" />
+    <option name="OPTION_DOCUMENT_TAG_DEPRECATED" value="true" />
+    <option name="OPTION_DEPRECATED_LIST" value="true" />
+    <option name="OTHER_OPTIONS" value="" />
+    <option name="HEAP_SIZE" />
+    <option name="OPEN_IN_BROWSER" value="true" />
+  </component>
+  <component name="JikesSettings">
+    <option name="JIKES_PATH" value="" />
+    <option name="DEBUGGING_INFO" value="true" />
+    <option name="DEPRECATION" value="true" />
+    <option name="GENERATE_NO_WARNINGS" value="false" />
+    <option name="IS_EMACS_ERRORS_MODE" value="true" />
+    <option name="ADDITIONAL_OPTIONS_STRING" value="" />
+  </component>
+  <component name="PEExternalization">
+    <option name="IGNORE_METHOD_NAMES" value="" />
+    <option name="IGNORE_METHOD_NAMES_ENABLED" value="false" />
+    <option name="IGNORE_CLASS_CONSTRUCTORS">
+      <value>
+        <option class="Exception" includeInheritors="true" />
+      </value>
+    </option>
+    <option name="IGNORE_CLASS_CONSTRUCTOR_NAMES_ENABLED" value="true" />
+    <option name="IGNORE_CLASS_METHODS_ENABLED" value="true" />
+    <option name="IGNORE_STRINGS_CONTAINS_ONLY_ENABLED" value="true" />
+    <option name="IGNORE_STRINGS_CONTAINS_ONLY_WHITESPACES" value="true" />
+    <option name="IGNORE_STRINGS_CONTAINS_ONLY_PUNCTUATIONS" value="true" />
+    <option name="IGNORE_STRINGS_CONTAINS_ONLY_SPECIFIED_ENABLED" value="true" />
+    <option name="IGNORE_STRINGS_CONTAINS_ONLY_SPECIFIED" value="" />
+    <option name="IGNORE_CLASS_METHODS">
+      <value>
+        <option class="Exception" includeInheritors="false" />
+        <option class="java.util.ResourceBundle" includeInheritors="true" />
+      </value>
+    </option>
+    <option name="IGNORE_CONSTANTS_DECLARATIONS" value="true" />
+  </component>
+  <component name="Palette2">
+    <group name="Swing">
+      <item class="com.intellij.uiDesigner.HSpacer" tooltip-text="Horizontal Spacer" icon="/com/intellij/uiDesigner/icons/hspacer.png" removable="false">
+        <default-constraints vsize-policy="1" hsize-policy="6" anchor="0" fill="1" />
+      </item>
+      <item class="com.intellij.uiDesigner.VSpacer" tooltip-text="Vertical Spacer" icon="/com/intellij/uiDesigner/icons/vspacer.png" removable="false">
+        <default-constraints vsize-policy="6" hsize-policy="1" anchor="0" fill="2" />
+      </item>
+      <item class="javax.swing.JPanel" icon="/com/intellij/uiDesigner/icons/panel.png" removable="false">
+        <default-constraints vsize-policy="3" hsize-policy="3" anchor="0" fill="3" />
+      </item>
+      <item class="javax.swing.JScrollPane" icon="/com/intellij/uiDesigner/icons/scrollPane.png" removable="false">
+        <default-constraints vsize-policy="7" hsize-policy="7" anchor="0" fill="3" />
+      </item>
+      <item class="javax.swing.JButton" icon="/com/intellij/uiDesigner/icons/button.png" removable="false">
+        <default-constraints vsize-policy="0" hsize-policy="3" anchor="0" fill="1" />
+        <initial-values>
+          <property name="text" value="Button" />
+        </initial-values>
+      </item>
+      <item class="javax.swing.JRadioButton" icon="/com/intellij/uiDesigner/icons/radioButton.png" removable="false">
+        <default-constraints vsize-policy="0" hsize-policy="3" anchor="8" fill="0" />
+        <initial-values>
+          <property name="text" value="RadioButton" />
+        </initial-values>
+      </item>
+      <item class="javax.swing.JCheckBox" icon="/com/intellij/uiDesigner/icons/checkBox.png" removable="false">
+        <default-constraints vsize-policy="0" hsize-policy="3" anchor="8" fill="0" />
+        <initial-values>
+          <property name="text" value="CheckBox" />
+        </initial-values>
+      </item>
+      <item class="javax.swing.JLabel" icon="/com/intellij/uiDesigner/icons/label.png" removable="false">
+        <default-constraints vsize-policy="0" hsize-policy="0" anchor="8" fill="0" />
+        <initial-values>
+          <property name="text" value="Label" />
+        </initial-values>
+      </item>
+      <item class="javax.swing.JTextField" icon="/com/intellij/uiDesigner/icons/textField.png" removable="false">
+        <default-constraints vsize-policy="0" hsize-policy="6" anchor="8" fill="1">
+          <preferred-size width="150" height="-1" />
+        </default-constraints>
+      </item>
+      <item class="javax.swing.JPasswordField" icon="/com/intellij/uiDesigner/icons/passwordField.png" removable="false">
+        <default-constraints vsize-policy="0" hsize-policy="6" anchor="8" fill="1">
+          <preferred-size width="150" height="-1" />
+        </default-constraints>
+      </item>
+      <item class="javax.swing.JFormattedTextField" icon="/com/intellij/uiDesigner/icons/formattedTextField.png" removable="false">
+        <default-constraints vsize-policy="0" hsize-policy="6" anchor="8" fill="1">
+          <preferred-size width="150" height="-1" />
+        </default-constraints>
+      </item>
+      <item class="javax.swing.JTextArea" icon="/com/intellij/uiDesigner/icons/textArea.png" removable="false">
+        <default-constraints vsize-policy="6" hsize-policy="6" anchor="0" fill="3">
+          <preferred-size width="150" height="50" />
+        </default-constraints>
+      </item>
+      <item class="javax.swing.JTextPane" icon="/com/intellij/uiDesigner/icons/textPane.png" removable="false">
+        <default-constraints vsize-policy="6" hsize-policy="6" anchor="0" fill="3">
+          <preferred-size width="150" height="50" />
+        </default-constraints>
+      </item>
+      <item class="javax.swing.JEditorPane" icon="/com/intellij/uiDesigner/icons/editorPane.png" removable="false">
+        <default-constraints vsize-policy="6" hsize-policy="6" anchor="0" fill="3">
+          <preferred-size width="150" height="50" />
+        </default-constraints>
+      </item>
+      <item class="javax.swing.JComboBox" icon="/com/intellij/uiDesigner/icons/comboBox.png" removable="false">
+        <default-constraints vsize-policy="0" hsize-policy="2" anchor="8" fill="1" />
+      </item>
+      <item class="javax.swing.JTable" icon="/com/intellij/uiDesigner/icons/table.png" removable="false">
+        <default-constraints vsize-policy="6" hsize-policy="6" anchor="0" fill="3">
+          <preferred-size width="150" height="50" />
+        </default-constraints>
+      </item>
+      <item class="javax.swing.JList" icon="/com/intellij/uiDesigner/icons/list.png" removable="false">
+        <default-constraints vsize-policy="6" hsize-policy="2" anchor="0" fill="3">
+          <preferred-size width="150" height="50" />
+        </default-constraints>
+      </item>
+      <item class="javax.swing.JTree" icon="/com/intellij/uiDesigner/icons/tree.png" removable="false">
+        <default-constraints vsize-policy="6" hsize-policy="6" anchor="0" fill="3">
+          <preferred-size width="150" height="50" />
+        </default-constraints>
+      </item>
+      <item class="javax.swing.JTabbedPane" icon="/com/intellij/uiDesigner/icons/tabbedPane.png" removable="false">
+        <default-constraints vsize-policy="3" hsize-policy="3" anchor="0" fill="3">
+          <preferred-size width="200" height="200" />
+        </default-constraints>
+      </item>
+      <item class="javax.swing.JSplitPane" icon="/com/intellij/uiDesigner/icons/splitPane.png" removable="false">
+        <default-constraints vsize-policy="3" hsize-policy="3" anchor="0" fill="3">
+          <preferred-size width="200" height="200" />
+        </default-constraints>
+      </item>
+      <item class="javax.swing.JSpinner" icon="/com/intellij/uiDesigner/icons/spinner.png" removable="false">
+        <default-constraints vsize-policy="0" hsize-policy="6" anchor="8" fill="1" />
+      </item>
+      <item class="javax.swing.JSlider" icon="/com/intellij/uiDesigner/icons/slider.png" removable="false">
+        <default-constraints vsize-policy="0" hsize-policy="6" anchor="8" fill="1" />
+      </item>
+    </group>
+  </component>
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/OGNL.iml" filepath="$PROJECT_DIR$/OGNL.iml" />
+    </modules>
+  </component>
+  <component name="ProjectRootManager" version="2" assert-keyword="false" jdk-15="false" project-jdk-name="JDK 1.4.2" />
+  <component name="RmicSettings">
+    <option name="IS_EANABLED" value="false" />
+    <option name="DEBUGGING_INFO" value="true" />
+    <option name="GENERATE_NO_WARNINGS" value="false" />
+    <option name="GENERATE_IIOP_STUBS" value="false" />
+    <option name="ADDITIONAL_OPTIONS_STRING" value="" />
+  </component>
+  <component name="libraryTable" />
+  <component name="uidesigner-configuration">
+    <option name="INSTRUMENT_CLASSES" value="true" />
+    <option name="COPY_FORMS_RUNTIME_TO_OUTPUT" value="true" />
+  </component>
+</project>
+
+name = ognl
+fullname = OGNL
+version = 2.6.9
+cvs.tag = ognl_2_6_9
+package = ognl
+<project name="ognl" default="jar" basedir=".">
+
+    <import file="osbuild.xml"/>
+
+    <path id="junit.cp">
+        <pathelement location="${build.test}"/>
+        <pathelement location="${build.java-test}"/>
+        <pathelement location="${test}/classLoadingTestFiles"/>
+        <pathelement location="${test}/etc"/>
+        <path refid="cp"/>
+    </path>
+
+    <target name="jar" depends="compile">
+        <mkdir dir="${build}"/>
+
+        <mkdir dir="${build.java}/META-INF"/>
+
+        <jar basedir="${build.java}" jarfile="${build}/${name}-${version}.jar">
+            <manifest>
+                <attribute name="Implementation-Title" value="${fullname}"/>
+                <attribute name="Implementation-Version" value="${version}"/>
+            </manifest>
+        </jar>
+    </target>
+
+    <target name="dist" depends="jar, docs">
+        <copy file="${build}/${name}-${version}.jar" todir="${dist}"/>
+        <copy todir="${dist}/src">
+            <fileset dir="${src}"/>
+        </copy>
+
+        <mkdir dir="${dist}/lib"/>
+        <copy todir="${dist}/lib">
+            <fileset dir="${lib}"/>
+        </copy>
+
+        <copy todir="${dist}">
+            <fileset dir="${basedir}">
+                <include name="build.*"/>
+            </fileset>
+        </copy>
+
+        <!-- copy README -->
+        <tstamp/>
+        <copy filtering="on" todir="${dist}">
+            <fileset dir=".">
+                <include name="*.html"/>
+            </fileset>
+            <filterset>
+                <filter token="version" value="${version}"/>
+                <filter token="builddate" value="${TODAY}"/>
+            </filterset>
+        </copy>
+
+        <zip zipfile="${build}/${name}-${version}.zip" basedir="${dist}">
+            <exclude name="docs/clover/**/*"/>
+            <exclude name="docs/junit/**/*"/>
+        </zip>
+    </target>
+
+    <target name="javacc-generate">
+        <java classname="org.javacc.jjtree.Main" classpathref="cp" fork="true">
+            <arg value="-OUTPUT_DIRECTORY=${src.java}/ognl"/>
+            <arg value="${src.java}/ognl/ognl.jjt"/>
+        </java>
+
+        <java classname="org.javacc.parser.Main" classpathref="cp" fork="true">
+            <arg value="-OUTPUT_DIRECTORY=${src.java}/ognl"/>
+            <arg value="${src.java}/ognl/ognl.jj"/>
+        </java>
+    </target>
+
+    <target name="docs.impl">
+        <ant antfile="docbook.xml" target="doc-docbook"/>
+
+        <copy todir="${dist}/docs">
+            <fileset dir="${docs}"/>
+        </copy>
+
+        <copy todir="${dist}/docs">
+            <fileset dir="${build}/docbook">
+                <include name="html/**/*"/>
+                <include name="pdf/**/*"/>
+            </fileset>
+        </copy>
+    </target>
+</project>

docbook.properties

+#=======================================================================
+# DocBook XML processor setup
+#=======================================================================
+docbook.xml.version=4.2
+docbook.xml.base=docbook-xml-4.2
+docbook.xml.path=extlib/docbook-xml-4.2
+
+#=======================================================================
+# DocBook XSL processor setup
+#=======================================================================
+docbook.xsl.version=1.69.1
+docbook.xsl.base=docbook-xsl-1.69.1
+docbook.xsl.path=extlib/docbook-xsl-1.69.1
+
+#=======================================================================
+# FOP setup
+#=======================================================================
+fop.version=0.20.5
+fop.base=fop-0.20.5
+fop.path=extlib/fop-0.20.5
+<?xml version="1.0"?>
+
+<project name="ognl-docs" default="doc-docbook" basedir=".">
+
+    <path id="cp">
+        <fileset dir="lib">
+            <include name="**/*.jar"/>
+        </fileset>
+    </path>
+
+    <property file="./docbook.properties"/>
+
+    <!-- **************************************************************** -->
+    <!-- *************************** TaskDefs *************************** -->
+    <!-- **************************************************************** -->
+    <taskdef resource="net/sf/antcontrib/antcontrib.properties" classpathref="cp"/>
+
+    <!-- **************************************************************** -->
+    <!-- *************************** Docbook **************************** -->
+    <!-- **************************************************************** -->
+
+    <!-- ==================== Initialization properties ===================== -->
+    <!-- Project information -->
+    <property name="project.docbook" location="docbook"/>
+    <property name="project.docbook.filelist" value="LanguageGuide,DeveloperGuide"/>
+
+    <!-- Build results setup -->
+    <property name="output.docbook.style" location="build/docbook/style"/>
+    <property name="output.docbook.fop" location="build/docbook/fop"/>
+    <property name="output.docbook.html" location="build/docbook/html"/>
+    <property name="output.docbook.pdf" location="build/docbook/pdf"/>
+
+    <!-- DocBook -->
+
+    <property name="docbook.xml.dir" location="${docbook.xml.path}"/>
+    <property name="docbook.xsl.dir" location="${docbook.xsl.path}"/>
+    <property name="docbook.html.chunked.xsl" location="${output.docbook.style}/${docbook.xsl.base}-html-chunked.xsl"/>
+    <property name="docbook.fop.xsl" location="${output.docbook.style}/${docbook.xsl.base}-fop.xsl"/>
+    <property name="fop.dir" location="${fop.path}"/>
+
+    <xmlcatalog id="docbook.catalog">
+        <dtd publicId="-//OASIS//DTD DocBook XML V${docbook.xml.version}//EN" location="${docbook.xml.dir}/docbookx.dtd"/>
+        <dtd publicId="-//OASIS//DTD DocBook CALS Table Model V${docbook.xml.version}//EN" location="${docbook.xml.dir}/calstblx.dtd"/>
+        <dtd publicId="-//OASIS//DTD XML Exchange Table Model 19990315//EN" location="${docbook.xml.dir}/soextblx.dtd"/>
+        <dtd publicId="-//OASIS//ELEMENTS DocBook Information Pool V${docbook.xml.version}//EN" location="${docbook.xml.dir}/dbpoolx.mod"/>
+        <dtd publicId="-//OASIS//ELEMENTS DocBook Document Hierarchy V${docbook.xml.version}//EN" location="${docbook.xml.dir}/dbhierx.mod"/>
+        <dtd publicId="-//OASIS//ENTITIES DocBook Additional General Entities V${docbook.xml.version}//EN" location="${docbook.xml.dir}/dbgenent.mod"/>
+        <dtd publicId="-//OASIS//ENTITIES DocBook Notations V${docbook.xml.version}//EN" location="${docbook.xml.dir}/dbnotnx.mod"/>
+        <dtd publicId="-//OASIS//ENTITIES DocBook Character Entities V${docbook.xml.version}//EN" location="${docbook.xml.dir}/dbcentx.mod"/>
+        <dtd publicId="ISO 8879:1986//ENTITIES Diacritical Marks//EN//XML" location="${docbook.xml.dir}/ent/iso-dia.ent"/>
+        <dtd publicId="ISO 8879:1986//ENTITIES Numeric and Special Graphic//EN//XML" location="${docbook.xml.dir}/ent/iso-num.ent"/>
+        <dtd publicId="ISO 8879:1986//ENTITIES Publishing//EN//XML" location="${docbook.xml.dir}/ent/iso-pub.ent"/>
+        <dtd publicId="ISO 8879:1986//ENTITIES General Technical//EN//XML" location="${docbook.xml.dir}/ent/iso-tech.ent"/>
+        <dtd publicId="ISO 8879:1986//ENTITIES Added Latin 1//EN//XML" location="${docbook.xml.dir}/ent/iso-lat1.ent"/>
+        <dtd publicId="ISO 8879:1986//ENTITIES Added Latin 2//EN//XML" location="${docbook.xml.dir}/ent/iso-lat2.ent"/>
+        <dtd publicId="ISO 8879:1986//ENTITIES Greek Letters//EN//XML" location="${docbook.xml.dir}/ent/iso-grk1.ent"/>
+        <dtd publicId="ISO 8879:1986//ENTITIES Monotoniko Greek//EN//XML" location="${docbook.xml.dir}/ent/iso-grk2.ent"/>
+        <dtd publicId="ISO 8879:1986//ENTITIES Greek Symbols//EN//XML" location="${docbook.xml.dir}/ent/iso-grk3.ent"/>
+        <dtd publicId="ISO 8879:1986//ENTITIES Alternative Greek Symbols//EN//XML" location="${docbook.xml.dir}/ent/iso-grk4.ent"/>
+        <dtd publicId="ISO 8879:1986//ENTITIES Added Math Symbols: Arrow Relations//EN//XML" location="${docbook.xml.dir}/ent/iso-amsa.ent"/>
+        <dtd publicId="ISO 8879:1986//ENTITIES Added Math Symbols: Binary Operators//EN//XML" location="${docbook.xml.dir}/ent/iso-amsb.ent"/>
+        <dtd publicId="ISO 8879:1986//ENTITIES Added Math Symbols: Delimiters//EN//XML" location="${docbook.xml.dir}/ent/iso-amsc.ent"/>
+        <dtd publicId="ISO 8879:1986//ENTITIES Added Math Symbols: Negated Relations//EN//XML" location="${docbook.xml.dir}/ent/iso-amsn.ent"/>
+        <dtd publicId="ISO 8879:1986//ENTITIES Added Math Symbols: Ordinary//EN//XML" location="${docbook.xml.dir}/ent/iso-amso.ent"/>
+        <dtd publicId="ISO 8879:1986//ENTITIES Added Math Symbols: Relations//EN//XML" location="${docbook.xml.dir}/ent/iso-amsr.ent"/>
+        <dtd publicId="ISO 8879:1986//ENTITIES Box and Line Drawing//EN//XML" location="${docbook.xml.dir}/ent/iso-box.ent"/>
+        <dtd publicId="ISO 8879:1986//ENTITIES Russian Cyrillic//EN//XML" location="${docbook.xml.dir}/ent/iso-cyr1.ent"/>
+        <dtd publicId="ISO 8879:1986//ENTITIES Non-Russian Cyrillic//EN//XML" location="${docbook.xml.dir}/ent/iso-cyr2.ent"/>
+        <entity publicId="html/chunk.xsl" location="${docbook.xsl.dir}/html/chunk.xsl"/>
+        <entity publicId="fo/docbook.xsl" location="${docbook.xsl.dir}/fo/docbook.xsl"/>
+    </xmlcatalog>
+
+    <!-- ============================= Targets ============================== -->
+    <target name="doc-docbook-html" depends="docbook-html-doc" description="Build OGNL DocBook HTML documentation"/>
+
+    <target name="doc-docbook-pdf" depends="docbook-pdf-doc" description="Build OGNL DocBook PDF documentation"/>
+
+    <target name="doc-docbook" depends="doc-docbook-html, doc-docbook-pdf" description="Build all OGNL DocBook documentation"/>
+
+    <target name="docbook-init">
+        <available property="docbook.xml.available" file="${docbook.xml.dir}" type="dir"/>
+        <available property="docbook.xsl.available" file="${docbook.xsl.dir}" type="dir"/>
+        <available property="fop.available" file="${fop.dir}" type="dir"/>
+        <mkdir dir="${output.docbook.style}"/>
+
+        <antcall target="docbook.xml-check"/>
+        <antcall target="docbook.xsl-check"/>
+        <antcall target="fop-check"/>
+    </target>
+
+    <target name="docbook.xml-check" unless="docbook.xml.available">
+        <echo>
+            Cannot run docbook: DocBook XML is required at extlib/docbook-xml-4.2
+
+            Please download at:
+            http://www.docbook.org/xml/4.2/docbook-xml-4.2.zip
+        </echo>
+        <fail/>
+    </target>
+
+    <target name="docbook.xsl-check" unless="docbook.xsl.available">
+        <echo>
+            Cannot run docbook: DocBook XSL is required at extlib/docbook-xsl-1.65.1
+
+            Please download at:
+            http://sourceforge.net/project/showfiles.php?group_id=21935&amp;package_id=16608
+        </echo>
+        <fail/>
+    </target>
+
+    <target name="fop-check" unless="fop.available">
+        <echo>
+            Cannot run docbook: FOP is required at extlib/fop-0.20.5
+
+            Please download at:
+            http://www.apache.org/dyn/closer.cgi/xml/fop
+        </echo>
+        <fail/>
+    </target>
+
+    <target name="docbook-info">
+        <echo message="*          project.docbook: ${project.docbook}"/>
+        <echo message="*"/>
+        <echo message="*         docbook.xml.base: ${docbook.xml.base}"/>
+        <echo message="*          docbook.xml.dir: ${docbook.xml.dir}"/>
+        <echo message="*         docbook.xsl.base: ${docbook.xsl.base}"/>
+        <echo message="*          docbook.xsl.dir: ${docbook.xsl.dir}"/>
+        <echo message="* docbook.html.chunked.xsl: ${docbook.html.chunked.xsl}"/>
+        <echo message="*          docbook.fop.xsl: ${docbook.fop.xsl}"/>
+        <echo message="*"/>
+        <echo message="*                 fop.base: ${fop.base}"/>
+        <echo message="*                  fop.dir: ${fop.dir}"/>
+        <echo message="*"/>
+        <echo message="*     output.docbook.style: ${output.docbook.style}"/>
+        <echo message="*       output.docbook.fop: ${output.docbook.fop}"/>
+        <echo message="*      output.docbook.html: ${output.docbook.html}"/>
+        <echo message="*       output.docbook.pdf: ${output.docbook.pdf}"/>
+    </target>
+
+    <target name="docbook-clean">
+        <delete file="${output.docbook.style}"/>
+        <delete file="${output.docbook.html}"/>
+        <delete file="${output.docbook.fop}"/>
+        <delete file="${output.docbook.pdf}"/>
+    </target>
+
+    <!--
+        Takes "docbook.file" as a parameter to the file to generate
+     -->
+    <target name="docbook-html-doc-single">
+        <copy file="${project.docbook}/style/html-xsl.template" tofile="${docbook.html.chunked.xsl}">
+            <filterset>
+                <filter token="docbook.xsl.base" value="${docbook.xsl.base}"/>
+                <filter token="docbook.xsl.dir" value="${docbook.xsl.dir}"/>
+                <filter token="format" value="chunk"/>
+            </filterset>
+        </copy>
+        <replace token="\" value="/" file="${docbook.html.chunked.xsl}"/>
+
+        <copy todir="${output.docbook.html}">
+            <fileset dir="${project.docbook}">
+                <include name="**/*.gif"/>
+                <include name="**/*.jpg"/>
+                <include name="**/*.jpeg"/>
+            </fileset>
+        </copy>
+
+        <copy todir="${output.docbook.html}" file="${project.docbook}/style/docbook.css"/>
+        <uptodate property="uptodate.html" targetfile="${output.docbook.html}/${docbook.file}/index.html">
+            <srcfiles dir="${project.docbook}">
+                <include name="${docbook.file}.xml"/>
+            </srcfiles>
+        </uptodate>
+        <antcall target="docbook-generate-html-chunked">
+            <param name="docbook.file" value="${docbook.file}"/>
+        </antcall>
+    </target>
+
+    <target name="docbook-generate-html-chunked" unless="uptodate.html">
+        <style basedir="${project.docbook}"
+            style="${docbook.html.chunked.xsl}"
+            processor="trax"
+            force="true"
+            in="${project.docbook}/${docbook.file}.xml"
+            out="${output.docbook.html}/${docbook.file}/index.html">
+            <param name="base.dir" expression="${output.docbook.html}/${docbook.file}/"/>
+            <param name="chunk.quietly" expression="1"/>
+            <param name="root.filename" expression="index"/>
+            <param name="use.id.as.filename" expression="1"/>
+            <xmlcatalog refid="docbook.catalog"/>
+        </style>
+    </target>
+
+    <target name="docbook-html-doc" depends="docbook-init">
+        <foreach target="docbook-html-doc-single" list="${project.docbook.filelist}" param="docbook.file"/>
+    </target>
+
+    <target name="docbook-pdf-doc-single" depends="docbook-init">
+        <mkdir dir="${output.docbook.fop}"/>
+        <copy file="${project.docbook}/style/fop-xsl.template" tofile="${docbook.fop.xsl}">
+            <filterset>
+                <filter token="docbook.xsl.base" value="${docbook.xsl.base}"/>
+                <filter token="docbook.xsl.dir" value="${docbook.xsl.dir}"/>
+                <filter token="format" value="docbook"/>
+            </filterset>
+        </copy>
+        <replace token="\" value="/" file="${docbook.fop.xsl}"/>
+
+        <copy todir="${output.docbook.fop}/standard-images">
+            <fileset dir="${project.docbook}/images">
+                <include name="callouts/**/*.gif"/>
+            </fileset>
+        </copy>
+        <copy todir="${output.docbook.fop}/common-images">
+            <fileset dir="${project.docbook}/images">
+                <include name="navigation/**/*.gif"/>
+                <include name="admon/**/*.gif"/>
+            </fileset>
+            <mapper type="flatten"/>
+        </copy>
+
+        <mkdir dir="${output.docbook.pdf}"/>
+
+        <!-- copy project-local images (if they exist) -->
+        <copy todir="${output.docbook.fop}">
+            <fileset dir="${project.docbook}">
+                <include name="images/**/*.gif"/>
+                <include name="images/**/*.jpg"/>
+                <include name="images/**/*.jpeg"/>
+            </fileset>
+        </copy>
+
+        <uptodate property="uptodate.fop" targetfile="${output.docbook.fop}/${docbook.file}.fop">
+            <srcfiles dir="${project.docbook}">
+                <include name="*.xml"/>
+            </srcfiles>
+        </uptodate>
+        <antcall target="docbook-generate-fop"/>
+
+        <uptodate property="uptodate.pdf" targetfile="${output.docbook.pdf}/${docbook.file}.pdf">
+            <srcfiles dir="${project.docbook}">
+                <include name="*.xml"/>
+            </srcfiles>
+        </uptodate>
+        <antcall target="docbook-convert-fo-to-pdf"/>
+    </target>
+
+    <target name="docbook-generate-fop" unless="uptodate.fop">
+        <style destdir="${output.docbook.fop}"
+            style="${docbook.fop.xsl}"
+            processor="trax"
+            force="true"
+            in="${project.docbook}/${docbook.file}.xml"
+            out="${output.docbook.fop}/${docbook.file}.fop">
+            <param name="base.dir" expression="${output.docbook.html}/${docbook.file}/"/>
+            <param name="project.docbook.file" expression="${docbook.file}"/>
+            <param name="use.id.as.filename" expression="1"/>
+            <xmlcatalog refid="docbook.catalog"/>
+        </style>
+    </target>
+
+    <target name="docbook-convert-fo-to-pdf" unless="uptodate.pdf">
+        <echo>Converting FO to PDF ...</echo>
+        <java classname="org.apache.fop.apps.Fop" fork="true">
+            <classpath>
+                <fileset dir="${fop.dir}">
+                    <include name="**/*.jar"/>
+                </fileset>
+            </classpath>
+            <arg line="-q"/>
+            <arg line="-fo ${output.docbook.fop}/${docbook.file}.fop"/>
+            <arg line="-pdf ${output.docbook.pdf}/${docbook.file}.pdf"/>
+        </java>
+    </target>
+
+    <target name="docbook-pdf-doc" depends="docbook-init">
+        <foreach target="docbook-pdf-doc-single" list="${project.docbook.filelist}" param="docbook.file"/>
+    </target>
+
+</project>

docbook/DeveloperGuide.xml

+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
+<book>
+    <bookinfo>
+        <title>OGNL Developer Guide</title>
+
+        <author>
+            <firstname>Drew</firstname>
+
+            <surname>Davidson</surname>
+        </author>
+
+        <affiliation>
+            <address><email>drew@ognl.org</email></address>
+        </affiliation>
+
+        <copyright>
+            <year>2004</year>
+
+            <holder>OGNL Technology, Inc.</holder>
+        </copyright>
+    </bookinfo>
+
+    <chapter id="introduction">
+        <title>Introduction</title>
+
+        <para><acronym>OGNL</acronym> as a language allows for the navigation of Java objects through a concise syntax that allows for specifying, where possible, symmetrically settable and gettable values. The language specifies a syntax that
+        attempts to provide as high a level of abstraction as possible for navigating object graphs; this usually means specifying paths through and to JavaBeans properties, collection indices, etc. rather than directly accessing property getters and
+        setters (collectively know as <emphasis>accessors</emphasis>).</para>
+
+        <para>The normal usage of OGNL is to embed the language inside of other constructs to provide a place for flexible binding of values from one place to another. An example of this is a web application where values need to be bound from a model
+        of some sort to data transfer objects that are operated on by a view. Another example is an XML configuration file wherein values are generated via expressions which are then bound to configured objects.</para>
+
+        <section id="embeddingOGNL">
+            <title id="embeddingOGNL">Embedding OGNL</title>
+
+            <para>The <classname>ognl.Ognl</classname> class contains convenience methods for evaluating <acronym>OGNL</acronym> expressions. You can do this in two stages, parsing an expression into an internal form and then using that internal form
+            to either set or get the value of a property; or you can do it in a single stage, and get or set a property using the String form of the expression directly. It is more efficient to pre-compile the expression to it&#39;s parsed form,
+            however, and this is the recommended usage.</para>
+
+            <para>OGNL expressions can be evaluated without any external context, or they can be provided with an execution environment that sets up custom extensions to modify the way that expressions are evaluated.</para>
+
+            <para>The following example illustrates how to encapsulate the parsing of an OGNL expression within an object so that execution will be more efficient. The class then takes an <classname>OgnlContext</classname> and a root object to
+            evaluate against.</para>
+
+            <example>
+                <title>Expression Class</title>
+
+                <programlisting>import ognl.Ognl;
+import ognl.OgnlContext;
+
+public class OgnlExpression
+{
+    private Object       expression;
+
+    public OgnlExpression(String expressionString) throws OgnlException
+    {
+        super();
+        expression = Ognl.parseExpression(expressionString);
+    }
+
+    public Object getExpression()
+    {
+        return expression;
+    }
+
+    public Object getValue(OgnlContext context, Object rootObject) throws OgnlException
+    {
+        return Ognl.getValue(getExpression(), context, rootObject);
+    }
+
+    public void setValue(OgnlContext context, Object rootObject, Object value) throws OgnlException
+    {
+        Ognl.setValue(getExpression(), context, rootObject, value);
+    }
+}</programlisting>
+            </example>
+        </section>
+
+        <section id="extendingOGNL">
+            <title id="extendingOGNL">Extending OGNL</title>
+
+            <para>OGNL expressions are not evaluated in a static environment, as Java programs are. Expressions are not compiled to bytecode at the expression level based on static class reachability. The same expression can have multiple paths
+            through an object graph depending upon the root object specified and the dynamic results of the navigation. Objects that are delegated to handle all of the access to properties of objects, elements of collections, methods of objects,
+            resolution of class names to classes and converting between types are collectively known as <emphasis>OGNL extensions</emphasis>. The following chapters delve more deeply into these extensions and provide a roadmap as to how they are used
+            within OGNL to customize the dynamic runtime environment to suit the needs of the embedding program.</para>
+        </section>
+    </chapter>
+
+    <chapter id="propertyAccessors">
+        <title>Property Accessors</title>
+
+        <para>When navigating an <acronym>OGNL</acronym> expression many of the elements that are found are properties. Properties can be many things depending on the object being accessed. Most of the time these property names resolve to JavaBeans
+        properties that conform to the set/get pattern. Other objects (such as <classname>Map</classname>) access properties as keyed values. Regardless of access methodology the OGNL syntax remains the same. Under the hood, however, there are
+        <classname>PropertyAccessor</classname> objects that handle the conversion of property name to an actual access to an objects&#39; properties.</para>
+
+        <programlisting xml:space="preserve">public interface PropertyAccessor
+{
+    Object getProperty( Map context, Object target, Object name ) throws OgnlException;
+    void setProperty( Map context, Object target, Object name, Object value ) throws OgnlException;
+}</programlisting>
+
+        <para>You can set a property accessor on a class-by-class basis using <methodname>OgnlRuntime.setPropertyAccessor()</methodname>. There are default property accessors for <classname>Object</classname> (which uses JavaBeans patterns to extract
+        properties) and <classname>Map</classname> (which uses the property name as a key).</para>
+    </chapter>
+
+    <chapter id="methodAccessors">
+        <title>Method Accessors</title>
+
+        <para>Method calls are another area where OGNL needs to do lookups for methods based on dynamic information. The MethodAccessor interface provides a hook into how OGNL calls a method. When a static or instance method is requested the
+        implementor of this interface is called to actually execute the method.</para>
+
+        <programlisting xml:space="preserve">public interface MethodAccessor
+{
+    Object callStaticMethod( Map context, Class targetClass, String methodName, List args ) throws MethodFailedException;
+    Object callMethod( Map context, Object target, String methodName, List args ) throws MethodFailedException;
+}</programlisting>
+
+        <para>You can set a method accessor on a class-by-class basis using <methodname>OgnlRuntime.setMethodAccessor()</methodname>. The is a default method accessor for <classname>Object</classname> (which simply finds an appropriate method based
+        on method name and argument types and uses reflection to call the method).</para>
+    </chapter>
+
+    <chapter id="elementsAccessors">
+        <title>Elements Accessors</title>
+
+        <para>Since iteration is a built-in function of OGNL and many objects support the idea of iterating over the contents of an object (i.e. the <methodname>object.{ ... }</methodname> syntax) OGNL provides a hook into how iteration is done. The
+        <classname>ElementsAccessor</classname> interface defines how iteration is done based on a source object. Simple examples could be a <classname>Collection</classname> elements accessor, which would simply</para>
+
+        <programlisting xml:space="preserve">public interface ElementsAccessor
+{
+    public Enumeration getElements( Object target ) throws OgnlException;
+}</programlisting>
+
+        <para>You can set a method accessor on a class-by-class basis using <methodname>OgnlRuntime.setElementsAccessor()</methodname>. There are default elements accessors for <classname>Object</classname> (which returns an <classname>Enumeration</classname>
+        of itself as the only object), <classname>Map</classname> (which iterates over the values in the <classname>Map</classname>), and Collection (which uses the collection&#39;s <methodname>iterator()</methodname>). One clever use of
+        <classname>ElementsAccessor</classname>s is the <classname>NumberElementsAccessor</classname> class which allows for generating numeric sequences from 0 to the target value. For example the expression <literal>(100).{ #this }</literal> will
+        generate a list of 100 integers ranged 0..99.</para>
+    </chapter>
+
+    <chapter id="classReferences">
+        <title>Class References</title>
+
+        <para>In the sections on accessing static field and static methods it stated that classes must be full-specified in between the class reference specifier (<constant>@</constant><classname>&#60;classname&#62;</classname><constant>@</constant><property>&#60;field|method&#62;</property><constant>@</constant>).
+        This is not entirely true; the default <classname>ClassResolver</classname> simply looks up the name of the class and assumes that it is fully specified. The <classname>ClassResolver</classname> interface is included in the
+        <acronym>OGNL</acronym> context to perform lookup of classes when an expression is evaluated. This makes it possible to specify, for example, a list of imports that are specific to a particular <function>setValue()</function> or
+        <function>getValue()</function> context in order to look up classes. It also makes class references agreeably short because you don&#39;t have to full specify a class name.</para>
+
+        <programlisting xml:space="preserve">public interface ClassResolver
+{
+    public Class classForName(Map context, String className) throws ClassNotFoundException;
+}</programlisting>
+
+        <para>You can set a class resolver on a context basis using the <classname>Ognl</classname> methods <methodname>addDefaultContext()</methodname> and <methodname>createDefaultContext()</methodname>.</para>
+    </chapter>
+
+    <chapter id="typeConversion">
+        <title>Type Conversion</title>
+
+        <para>When performing set operations on properties or calling methods it is often the case that the values you want to set have a different type from the expected type of the class. <acronym>OGNL</acronym> supports a context variable (set by
+        <function>OgnlRuntime.setTypeConverter(Map context, TypeConverter typeConverter)</function>) that will allow types to be converted from one to another. The default type converter that is uses is the <classname>ognl.DefaultTypeConverter</classname>,
+        which will convert among numeric types <classname>(Integer</classname>, <classname>Long</classname>, <classname>Short</classname>, <classname>Double</classname>, <classname>Float</classname>, <classname>BigInteger</classname>,
+        <classname>BigDecimal</classname>, and their primitive equivalents), string types (<classname>String</classname>, <classname>Character</classname>) and <classname>Boolean</classname>. Should you need specialized type conversion (one popular
+        example is in Servlets where you have a <classname>String[]</classname> from an <function>HttpServletRequest.getParameters()</function> and you want to set values with it in other objects; a custom type converter can be written (most likely
+        subclassing <classname>ognl.DefaultTypeConverter</classname>) to convert <classname>String[]</classname> to whatever is necessary.</para>
+
+        <programlisting xml:space="preserve">public interface TypeConverter
+{
+    public Object convertValue(Map context,
+                                Object target,
+                                Member member,
+                                String propertyName,
+                                Object value,
+                                Class toType);
+}</programlisting>
+
+        <para>Note that <classname>ognl.DefaultTypeConverter</classname> is much easier to subclass; it implements <classname>TypeConverter</classname> and calls it&#39;s own <function>convertValue(Map context, Object value, Class toType)</function>
+        method and already provides the numeric conversions. For example, the above converter (i.e. converting <classname>String[]</classname> to <classname>int[]</classname> for a list of identifier parameters in a request) implemented as a subclass
+        of <classname>ognl.DefaultTypeConverter</classname>: <programlisting xml:space="preserve">HttpServletRequest request;
+Map context = Ognl.createDefaultContext(this);
+
+/* Create an anonymous inner class to handle special conversion */
+Ognl.setTypeConverter(context, new ognl.DefaultTypeConverter() {
+    public Object convertValue(Map context, Object value, Class toType)
+    {
+        Object  result = null;
+
+        if ((toType == int[].class) &#38;&#38; (value instanceof String[].class)) {
+            String  sa = (String[])value;
+            int[]   ia = new int[sa.length];
+
+            for (int i = 0; i &#60; sa.length; i++) {
+                Integer     cv;
+
+                cv = (Integer)super.convertValue(context,
+                                                    sa[i],
+                                                    Integer.class);
+                ia[i] = cv.intValue();
+            }
+            result = ia;
+        } else {
+            result = super.convertValue(context, value, toType);
+        }
+        return result;
+    }
+});
+/* Setting values within this OGNL context will use the above-defined TypeConverter */
+Ognl.setValue(&#34;identifiers&#34;,
+                context,
+                this,
+                request.getParameterValues(&#34;identifier&#34;));</programlisting></para>
+    </chapter>
+
+    <chapter id="memberAccessManager">
+        <title>Member Access</title>
+
+        <para>Normally in Java the only members of a class (fields, methods) that can be accessed are the ones defined with public access. <acronym>OGNL</acronym> includes an interface that you can set globally (using <function>OgnlContext.setMemberAccessManager()</function>)
+        that allows you to modify the runtime in Java 2 to allow access to private, protected and package protected fields and methods. Included in the <acronym>OGNL</acronym> package is the <classname>DefaultMemberAccess</classname> class. It
+        contains a constructor that allows you to selectively lower the protection on any private, protected or package protected members<classname> using the AccessibleObject</classname> interface in Java2. The default class can be subclasses to
+        select different objects for which accessibility is allowed.</para>
+
+        <programlisting xml:space="preserve">public interface MemberAccess
+{
+    public Object setup( Member member );
+    public void restore( Member member, Object state );
+    public boolean isAccessible( Member member );
+}</programlisting>
+    </chapter>
+
+    <chapter id="nullHandler">
+        <title>Null Handler</title>
+
+        <para>When navigating a chain sometimes properties or methods will evaluate to null, causing subsequent properties or method calls to fail with <classname>NullPointerException</classname>s. Most of the time this behaviour is correct (as it is
+        with Java), but sometimes you want to be able to dynamically substitute another object in place of <constant>null</constant>. The <classname>NullHandler</classname> interface allows you to specify on a class-by-class basis how nulls are
+        handled within OGNL expressions. Implementing this interface allows you to intercept when methods return <constant>null</constant> and properties evaluate to <constant>null</constant> and allow you to substitute a new value. Since you are
+        given the source of the method or property a really clever implementor might write the property back to the object so that subsequent invocations do not return or evaluate to <constant>null</constant>.</para>
+
+        <programlisting xml:space="preserve">public interface NullHandler
+{
+    public Object nullMethodResult(Map context, Object target, String methodName, List args);
+    public Object nullPropertyValue(Map context, Object target, Object property);
+}</programlisting>
+
+        <para><classname>NullHandler</classname> implementors are registered with <acronym>OGNL</acronym> using the <function>OgnlRuntime.setNullHandler()</function> method.</para>
+    </chapter>
+
+    <chapter id="evaluation">
+        <title>Other API features</title>
+
+        <section>
+            <title>Tracing Evaluations</title>
+
+            <para>As of OGNL 2.5.0 the <classname>OgnlContext</classname> object can automatically tracks evaluations of expressions. This tracking is kept in the <classname>OgnlContext</classname> as <property>currentEvaluation</property> during the
+            evaluation. After execution you can access the last evaluation through the <property>lastEvaluation</property> property of <classname>OgnlContext</classname>.</para>
+
+            <note>
+                <para>The tracing feature is turned off by default. If you wish to turn it on there is a <function>setTraceEvaluations()</function> method on <classname>OgnlContext</classname> that you can call.</para>
+            </note>
+
+            <para>Any <link linkend="methodAccessors">method accessor</link>, <link linkend="elementsAccessors">elements accessor</link>, <link linkend="typeConversion">type converter</link>, <link linkend="propertyAccessors">property accessor</link>
+            or <link linkend="nullHandler">null handler</link> may find this useful to give context to the operation being performed. The <classname>Evaluation</classname> object is itself a tree and can be traversed up, down and left and right
+            through siblings to determine the exact circumstances of an evaluation. In addition the <classname>Evaluation</classname> object tracks the node that was performing the operation, the source object on which that operation was being
+            performed and the result of the operation. If an exception is thrown during execution the user can get the last evaluation&#39;s last descendent to find out exactly which subexpression caused the error. The execption is also tracked in
+            the <classname>Evaluation</classname>.</para>
+        </section>
+    </chapter>
+</book>

docbook/LanguageGuide.xml

+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
+<book>
+    <bookinfo>
+        <title>OGNL Language Guide</title>
+
+        <author>
+            <firstname>Drew</firstname>
+
+            <surname>Davidson</surname>
+        </author>
+
+        <affiliation>
+            <address><email>drew@ognl.org</email></address>
+        </affiliation>
+
+        <copyright>
+            <year>2004</year>
+
+            <holder>OGNL Technology, Inc.</holder>
+        </copyright>
+    </bookinfo>
+
+    <chapter id="introduction">
+        <title>Introduction</title>
+
+        <para><acronym>OGNL</acronym> stands for <emphasis role="bold">O</emphasis>bject <emphasis role="bold">G</emphasis>raph <emphasis role="bold">N</emphasis>avigation <emphasis role="bold">L</emphasis>anguage. It is an expression and binding
+        language for getting and setting properties of Java objects. Normally the same expression is used for both getting and setting the value of a property.</para>
+
+        <para>We pronounce <acronym>OGNL</acronym> as a word, like the last syllables of a drunken pronunciation of &#34;orthogonal.&#34;</para>
+
+        <para>Many people have asked exactly what <acronym>OGNL</acronym> is good for. Several of the uses to which <acronym>OGNL</acronym> has been applied are:</para>
+
+        <itemizedlist>
+            <listitem>
+                <para>A binding language between GUI elements (textfield, combobox, etc.) to model objects. Transformations are made easier by <acronym>OGNL</acronym>&#39;s TypeConverter mechanism to convert values from one type to another (String to
+                numeric types, for example).</para>
+            </listitem>
+
+            <listitem>
+                <para>A data source language to map between table columns and a Swing TableModel.</para>
+            </listitem>
+
+            <listitem>
+                <para>A binding language between web components and the underlying model objects (<ulink url="http://www.ognl.org">WebOGNL</ulink>, <ulink url="http://jakarta.apache.org/tapestry/index.html">Tapestry</ulink>, <ulink
+                url="http://sourceforge.net/projects/opensymphony">WebWork</ulink>, <ulink url="http://wonder.sourceforge.net/index.html">WebObjects</ulink>).</para>
+            </listitem>
+
+            <listitem>
+                <para>A more expressive replacement for the property-getting language used by the Jakarata Commons BeanUtils package or JSTL&#39;s EL (which only allow simple property navigation and rudimentary indexed properties).</para>
+            </listitem>
+        </itemizedlist>
+
+        <para>Most of what you can do in Java is possible in <acronym>OGNL</acronym>, plus other extras such as list <glossterm><link linkend="projection">projection</link></glossterm> and <glossterm><link linkend="selection">selection</link></glossterm>
+        and <glossterm><link linkend="lambdaExpressions">lambda expressions</link></glossterm>.</para>
+    </chapter>
+
+    <chapter id="history">
+        <title>History</title>
+
+        <para><acronym>OGNL</acronym> started out as a way to set up associations between UI components and controllers using property names. As the desire for more complicated associations grew, Drew Davidson created what he called
+        <acronym>KVCL</acronym>, for Key-Value Coding Language, egged on by Luke Blanshard. Luke then reimplemented the language using ANTLR, came up with the new name, and, egged on by Drew, filled it out to its current state. Later on Luke again
+        reimplemented the language using <ulink url="http://www.webgain.com/products/java_cc/">JavaCC</ulink>. Further maintenance on all the code is done by Drew (with spiritual guidance from Luke).</para>
+    </chapter>
+
+    <chapter id="basicSyntax">
+        <title>Syntax</title>
+
+        <para>Simple <acronym>OGNL</acronym> expressions are very simple. The language has become quite rich with features, but you don&#39;t generally need to worry about the more complicated parts of the language: the simple cases have remained
+        that way. For example, to get at the name property of an object, the <acronym>OGNL</acronym> expression is simply <property>name</property>. To get at the <property>text</property> property of the object returned by the headline property, the
+        <acronym>OGNL</acronym> expression is <property>headline.text</property>.</para>
+
+        <para>What is a property? Roughly, an <acronym>OGNL</acronym> property is the same as a bean property, which means that a pair of get/set methods, or alternatively a field, defines a property (the full story is a bit more complicated, since
+        properties differ for different kinds of objects; see below for a full explanation).</para>
+
+        <para>The fundamental unit of an <acronym>OGNL</acronym> expression is the navigation chain, usually just called &#34;chain.&#34; The simplest chains consist of the following parts:</para>
+
+        <table frame="all">
+            <title><acronym>OGNL</acronym> Expression Parts</title>
+
+            <tgroup cols="2">
+                <colspec colname="elementPart" />
+
+                <colspec colname="example" />
+
+                <thead>
+                    <row>
+                        <entry valign="top">Expression Element Part</entry>
+
+                        <entry valign="top">Example</entry>
+                    </row>
+                </thead>
+
+                <tbody>
+                    <row>
+                        <entry valign="top">Property names</entry>
+
+                        <entry valign="top">like the <property>name</property> and <property>headline.text</property> examples above</entry>
+                    </row>
+
+                    <row>
+                        <entry valign="top">Method Calls</entry>
+
+                        <entry valign="top"><property>hashCode()</property> to return the current object&#39;s hash code</entry>
+                    </row>
+
+                    <row>
+                        <entry valign="top">Array Indices</entry>
+
+                        <entry valign="top"><property>listeners[0]</property> to return the first of the current object&#39;s list of listeners</entry>
+                    </row>
+                </tbody>
+            </tgroup>
+        </table>
+
+        <para>All <acronym>OGNL</acronym> expressions are evaluated in the context of a current object, and a chain simply uses the result of the previous link in the chain as the current object for the next one. You can extend a chain as long as you
+        like. For example, this chain:</para>
+
+        <programlisting>name.toCharArray()[0].numericValue.toString()</programlisting>
+
+        <para>This expression follows these steps to evaluate:</para>
+
+        <itemizedlist>
+            <listitem>
+                <para>extracts the <property>name</property> property of the initial, or root, object (which the user provides to <acronym>OGNL</acronym> through the <glossterm><acronym>OGNL</acronym> context</glossterm>)</para>
+            </listitem>
+
+            <listitem>
+                <para>calls the <property>toCharArray()</property> method on the resulting <classname>String</classname></para>
+            </listitem>
+
+            <listitem>
+                <para>extracts the first character (the one at index 0) from the resulting array</para>
+            </listitem>
+
+            <listitem>
+                <para>gets the <property>numericValue</property> property from that character (the character is represented as a <classname>Character</classname> object, and the <classname>Character</classname> class has a method called
+                <property>getNumericValue()</property>).</para>
+            </listitem>
+
+            <listitem>
+                <para>calls <property>toString()</property> on the resulting <classname>Integer</classname> object. The final result of this expression is the <classname>String</classname> returned by the last <property>toString()</property> call.</para>
+            </listitem>
+        </itemizedlist>
+
+        <para>Note that this example can only be used to get a value from an object, not to set a value. Passing the above expression to the <property>Ognl.setValue()</property> method would cause an <classname>InappropriateExpressionException</classname>
+        to be thrown, because the last link in the chain is neither a property name nor an array index.</para>
+
+        <para>This is enough syntax to do the vast majority of what you ever need to do.</para>
+    </chapter>
+
+    <chapter id="basicExpressions">
+        <title>Expressions</title>
+
+        <para>This section outlines the details the elements of <acronym>OGNL</acronym>&#39;s expressions.</para>
+
+        <section id="constants">
+            <title>Constants</title>
+
+            <para><acronym>OGNL</acronym> has the following kinds of constants:</para>
+
+            <itemizedlist>
+                <listitem>
+                    <para>String literals, as in Java (with the addition of single quotes): delimited by single- or double-quotes, with the full set of character escapes.</para>
+                </listitem>
+
+                <listitem>
+                    <para>Character literals, also as in Java: delimited by single-quotes, also with the full set of escapes.</para>
+                </listitem>
+
+                <listitem>
+                    <para>Numeric literals, with a few more kinds than Java. In addition to Java&#39;s ints, longs, floats and doubles, <acronym>OGNL</acronym> lets you specify BigDecimals with a &#34;b&#34; or &#34;B&#34; suffix, and BigIntegers
+                    with an &#34;h&#34; or &#34;H&#34; suffix (think &#34;huge&#34;---we chose &#34;h&#34; for BigIntegers because it does not interfere with hexadecimal digits).</para>
+                </listitem>
+
+                <listitem>
+                    <para>Boolean <constant>(true</constant> and <constant>false</constant>) literals.</para>
+                </listitem>
+
+                <listitem>
+                    <para>The <constant>null</constant> literal.</para>
+                </listitem>
+            </itemizedlist>
+        </section>
+
+        <section id="properties">
+            <title>Referring to Properties</title>
+
+            <para><acronym>OGNL</acronym> treats different kinds of objects differently in its handling of property references. Maps treat all property references as element lookups or storage, with the property name as the key. Lists and arrays
+            treat numeric properties similarly, with the property name as the index, but string properties the same way ordinary objects do. Ordinary objects (that is, all other kinds) only can handle string properties and do so by using
+            &#34;get&#34; and &#34;set&#34; methods (or &#34;is&#34; and &#34;set&#34;), if the object has them, or a field with the given name otherwise.</para>
+
+            <para>Note the new terminology here. Property &#34;names&#34; can be of any type, not just Strings. But to refer to non-String properties, you must use what we have been calling the &#34;index&#34; notation. For example, to get the length
+            of an array, you can use this expression:</para>
+
+            <programlisting>array.length</programlisting>
+
+            <para>But to get at element 0 of the array, you must use an expression like this:</para>
+
+            <programlisting>array[0]</programlisting>
+
+            <para>Note that Java collections have some special properties associated with them. See <xref linkend="specialCollectionsProperties" />for these properties.</para>
+        </section>
+
+        <section id="indexing">
+            <title>Indexing</title>
+
+            <para>As discussed above, the &#34;indexing&#34; notation is actually just property reference, though a computed form of property reference rather than a constant one.</para>
+
+            <para>For example, <acronym>OGNL</acronym> internally treats the &#34;array.length&#34; expression exactly the same as this expression:</para>
+
+            <programlisting>array[&#34;length&#34;]</programlisting>
+
+            <para>And this expression would have the same result (though not the same internal form):</para>
+
+            <programlisting>array[&#34;len&#34; + &#34;gth&#34;]</programlisting>
+
+            <section>
+                <title>Array and List Indexing</title>
+
+                <para>For Java arrays and Lists indexing is fairly simple, just like in Java. An integer index is given and that element is the referrent. If the index is out of bounds of the array or List and IndexOutOfBoundsException is thrown,
+                just as in Java.</para>
+            </section>
+
+            <section>
+                <title>JavaBeans Indexed Properties</title>
+
+                <para>JavaBeans supports the concept of Indexed properties. Specifically this means that an object has a set of methods that follow the following pattern:</para>
+
+                <itemizedlist>
+                    <listitem>
+                        <para>public <replaceable>PropertyType</replaceable>[] get<replaceable>PropertyName</replaceable>()</para>
+                    </listitem>
+
+                    <listitem>
+                        <para>public void set<replaceable>PropertyName</replaceable>(<replaceable>PropertyType</replaceable>[] anArray)</para>
+                    </listitem>
+
+                    <listitem>
+                        <para>public <replaceable>PropertyType</replaceable> get<replaceable>PropertyName</replaceable>(int index)</para>
+                    </listitem>
+
+                    <listitem>
+                        <para>public void set<replaceable>PropertyName</replaceable>(int index, <replaceable>PropertyType</replaceable> value)</para>
+                    </listitem>
+                </itemizedlist>
+
+                <para>OGNL can interpret this and provide seamless access to the property through the indexing notation. References such as</para>
+
+                <programlisting>someProperty[2]</programlisting>
+
+                <para>are automatically routed through the correct indexed property accessor (in the above case through <function>getSomeProperty(2)</function> or <function>setSomeProperty(2, value)</function>). If there is no indexed property
+                accessor a property is found with the name <varname>someProperty</varname> and the index is applied to that.</para>
+            </section>
+
+            <section>
+                <title>OGNL Object Indexed Properties</title>
+
+                <para>OGNL extends the concept of indexed properties to include indexing with arbitrary objects, not just integers as with JavaBeans Indexed Properties. When finding properties as candidates for object indexing, OGNL looks for
+                patterns of methods with the following signature:</para>
+
+                <itemizedlist>
+                    <listitem>
+                        <para>public <replaceable>PropertyType</replaceable> get<replaceable>PropertyName</replaceable>(<replaceable>IndexType</replaceable> index)</para>
+                    </listitem>
+
+                    <listitem>
+                        <para>public void set<replaceable>PropertyName</replaceable>(<replaceable>IndexType</replaceable> index, <replaceable>PropertyType</replaceable> value)</para>
+                    </listitem>
+                </itemizedlist>
+
+                <para>The <replaceable>PropertyType</replaceable> and <replaceable>IndexType</replaceable> must match each other in the corresponding set and get methods. An actual example of using Object Indexed Properties is with the Servlet API:
+                the Session object has two methods for getting and setting arbitrary attributes:</para>
+
+                <programlisting>public Object getAttribute(String name) public void setAttribute(String name, Object value)</programlisting>
+
+                <para>An OGNL expression that can both get and set one of these attributes is</para>
+
+                <programlisting>session.attribute[&#34;foo&#34;]</programlisting>
+            </section>
+        </section>
+
+        <section id="methods">
+            <title>Calling Methods</title>
+
+            <para><acronym>OGNL</acronym> calls methods a little differently from the way Java does, because <acronym>OGNL</acronym> is interpreted and must choose the right method at run time, with no extra type information aside from the actual
+            arguments supplied. <acronym>OGNL</acronym> always chooses the most specific method it can find whose types match the supplied arguments; if there are two or more methods that are equally specific and match the given arguments, one of
+            them will be chosen arbitrarily.</para>
+
+            <para>In particular, a null argument matches all non-primitive types, and so is most likely to result in an unexpected method being called.</para>
+
+            <para>Note that the arguments to a method are separated by commas, and so the comma operator cannot be used unless it is enclosed in parentheses. For example,</para>
+
+            <programlisting>method( ensureLoaded(), name )</programlisting>
+
+            <para>is a call to a 2-argument method, while</para>
+
+            <programlisting>method( (ensureLoaded(), name) )</programlisting>
+
+            <para>is a call to a 1-argument method.</para>
+        </section>
+
+        <section id="varref">
+            <title>Variable References</title>
+
+            <para><acronym>OGNL</acronym> has a simple variable scheme, which lets you store intermediate results and use them again, or just name things to make an expression easier to understand. All variables in <acronym>OGNL</acronym> are global
+            to the entire expression. You refer to a variable using a number sign in front of its name, like this:</para>
+
+            <programlisting>#var</programlisting>
+
+            <para><acronym>OGNL</acronym> also stores the current object at every point in the evaluation of an expression in the this variable, where it can be referred to like any other variable. For example, the following expression operates on
+            the number of listeners, returning twice the number if it is more than 100, or 20 more than the number otherwise:</para>
+
+            <programlisting>listeners.size().(#this &#62; 100? 2*#this : 20+#this)</programlisting>
+
+            <para><acronym>OGNL</acronym> can be invoked with a map that defines initial values for variables. The standard way of invoking <acronym>OGNL</acronym> defines the variables <varname>root</varname> (which holds the initial, or root,
+            object), and <varname>context</varname> (which holds the <classname>Map</classname> of variables itself).</para>
+
+            <para>To assign a value to a variable explicitly, simply write an assignment statement with a variable reference on the left-hand side:</para>
+
+            <programlisting>#var = 99</programlisting>
+        </section>
+
+        <section id="paren">
+            <title>Parenthetical Expressions</title>
+
+            <para>As you would expect, an expression enclosed in parentheses is evaluated as a unit, separately from any surrounding operators. This can be used to force an evaluation order different from the one that would be implied by
+            <acronym>OGNL</acronym> operator precedences. It is also the only way to use the comma operator in a method argument.</para>
+        </section>
+
+        <section id="chainedSubexpressions">
+            <title>Chained Subexpressions</title>
+
+            <para>If you use a parenthetical expression after a dot, the object that is current at the dot is used as the current object throughout the parenthetical expression. For example,</para>
+
+            <programlisting>headline.parent.(ensureLoaded(), name)</programlisting>
+
+            <para>traverses through the <property>headline</property> and <property>parent</property> properties, ensures that the <property>parent</property> is loaded and then returns (or sets) the parent&#39;s <property>name</property>.</para>
+
+            <para>Top-level expressions can also be chained in this way. The result of the expression is the right-most expression element.</para>
+
+            <programlisting>ensureLoaded(), name</programlisting>
+
+            <para>This will call <function>ensureLoaded()</function> on the root object, then get the <property>name</property> property of the root object as the result of the expression.</para>
+        </section>
+
+        <section id="collectionConstruction">
+            <title>Collection Construction</title>
+
+            <section id="listConstruction">
+                <title>Lists</title>
+
+                <para>To create a list of objects, enclose a list of expressions in curly braces. As with method arguments, these expressions cannot use the comma operator unless it is enclosed in parentheses. Here is an example:</para>
+
+                <programlisting>name in { null,&#34;Untitled&#34; }</programlisting>
+
+                <para>This tests whether the <varname>name</varname> property is <constant>null</constant> or equal to <constant>&#34;Untitled&#34;</constant>.</para>
+
+                <para>The syntax described above will create a instanceof the <classname>List</classname> interface. The exact subclass is not defined.</para>
+            </section>
+
+            <section id="nativeArrayConstruction">
+                <title>Native Arrays</title>
+
+                <para>Sometimes you want to create Java native arrays, such as <type>int[]</type> or <type>Integer[]</type>. <acronym>OGNL</acronym> supports the creation of these similarly to the way that constructors are normally called, but allows
+                initialization of the native array from either an existing list or a given size of the array.</para>
+
+                <programlisting>new int[] { 1, 2, 3 }</programlisting>
+
+                <para>This creates a new <type>int</type> array consisting of three integers 1, 2 and 3.</para>
+
+                <para>To create an array with all <constant>null</constant> or <constant>0</constant> elements, use the alternative size constructor</para>
+
+                <programlisting>new int[5]</programlisting>
+
+                <para>This creates an <type>int</type> array with 5 slots, all initialized to zero.</para>
+            </section>
+
+            <section id="mapConstruction">
+                <title>Maps</title>
+
+                <para>Maps can also be created using a special syntax.</para>
+
+                <programlisting>#{ &#34;foo&#34; : &#34;foo value&#34;, &#34;bar&#34; : &#34;bar value&#34; }</programlisting>
+
+                <para>This creates a Map initialized with mappings for <literal>&#34;foo&#34;</literal> and <literal>&#34;bar&#34;</literal>.</para>
+
+                <para>Advanced users who wish to select the specific Map class can specify that class before the opening curly brace</para>
+
+                <programlisting>#@java.util.LinkedHashMap@{ &#34;foo&#34; : &#34;foo value&#34;, &#34;bar&#34; : &#34;bar value&#34; }</programlisting>
+
+                <para>The above example will create an instance of the JDK 1.4 class <classname>LinkedHashMap</classname>, ensuring the the insertion order of the elements is preserved.</para>
+            </section>
+        </section>
+
+        <section id="projection">
+            <title>Projecting Across Collections</title>
+
+            <para><acronym>OGNL</acronym> provides a simple way to call the same method or extract the same property from each element in a collection and store the results in a new collection. We call this &#34;projection,&#34; from the database
+            term for choosing a subset of columns from a table. For example, this expression:</para>
+
+            <programlisting>listeners.{delegate}</programlisting>
+
+            <para>returns a list of all the listeners&#39; delegates. See the coercion section for how <acronym>OGNL</acronym> treats various kinds of objects as collections.</para>
+
+            <para>During a projection the <varname>#this</varname> variable refers to the current element of the iteration.</para>
+
+            <programlisting>objects.{ #this instanceof String ? #this : #this.toString()}</programlisting>
+
+            <para>The above would produce a new list of elements from the objects list as string values.</para>
+        </section>
+
+        <section id="selection">
+            <title>Selecting From Collections</title>
+
+            <para><acronym>OGNL</acronym> provides a simple way to use an expression to choose some elements from a collection and save the results in a new collection. We call this &#34;selection,&#34; from the database term for choosing a subset of
+            rows from a table. For example, this expression:</para>
+
+            <programlisting>listeners.{? #this instanceof ActionListener}</programlisting>
+
+            <para>returns a list of all those listeners that are instances of the <classname>ActionListener</classname> class. See the <ulink url="???"><link linkend="coercion">coercion section</link></ulink> for how <acronym>OGNL</acronym> treats
+            various kinds of objects as collections.</para>
+
+            <section>
+                <title>Selecting First Match</title>
+
+                <para>In order to get the first match from a list of matches, you could use indexing such as <literal>listeners.{? true }[0]</literal>. However, this is cumbersome because if the match does not return any results (or if the result
+                list is empty) you will get an <classname>ArrayIndexOutOfBoundsException</classname>.</para>
+
+                <para>The selection syntax is also available to select only the first match and return it as a list. If the match does not succeed for any elements an empty list is the result.</para>
+
+                <programlisting>objects.{^ #this instanceof String }</programlisting>
+
+                <para>Will return the first element contained in objects that is an instance of the <classname>String</classname> class.</para>
+            </section>
+
+            <section>
+                <title>Selecting Last Match</title>
+
+                <para>Similar to getting the first match, sometimes you want to get the last element that matched.</para>
+
+                <programlisting>objects.{$ #this instanceof String }</programlisting>
+
+                <para>This will return the last element contained in objects that is an instanceof the <classname>String</classname> class</para>
+            </section>
+        </section>
+
+        <section id="constructors">
+            <title>Calling Constructors</title>
+
+            <para>You can create new objects as in Java, with the <function>new</function> operator. One difference is that you must specify the fully qualified class name for classes other than those in the java.lang package.<footnoteref
+            linkend="classresolver" /><footnote><para>This is only true with the default ClassResolver in place. With a custom class resolver packages can be mapped in such a way that more Java-like references to classes can be made. Refer to the
+            OGNL Developer&#39;s Guide for details on using <classname>ClassResolver</classname> class.</para></footnote> (for example, <function>new java.util.ArrayList()</function>, rather than simply <function>new ArrayList()</function>).</para>
+
+            <para><acronym>OGNL</acronym> chooses the right constructor to call using the same procedure it uses for overloaded method calls.</para>
+        </section>
+
+        <section id="staticMethods">
+            <title>Calling Static Methods</title>
+
+            <para>You can call a static method using the syntax <constant>@</constant><varname>class</varname><constant>@</constant><function>method(args)</function>. If you leave out class, it defaults to <classname>java.lang.Math</classname>, to
+            make it easier to call <function>min</function> and <function>max</function> methods. If you specify the class, you must give the fully qualified name.</para>
+
+            <para>If you have an instance of a class whose static method you wish to call, you can call the method through the object as if it was an instance method.</para>
+
+            <para>If the method name is overloaded, <acronym>OGNL</acronym> chooses the right static method to call using the same procedure it uses for overloaded instance methods.</para>
+        </section>
+
+        <section id="staticFields">
+            <title>Getting Static Fields</title>
+
+            <para>You can refer to a static field using the syntax <constant>@</constant><classname>class</classname><constant>@</constant><varname>field</varname>. The class must be fully qualified.</para>
+        </section>
+
+        <section id="expressionEvaluation">
+            <title>Expression Evaluation</title>
+
+            <para>If you follow an <acronym>OGNL</acronym> expression with a parenthesized expression, without a dot in front of the parentheses, <acronym>OGNL</acronym> will try to treat the result of the first expression as another expression to
+            evaluate, and will use the result of the parenthesized expression as the root object for that evaluation. The result of the first expression may be any object; if it is an AST, <acronym>OGNL</acronym> assumes it is the parsed form of an
+            expression and simply interprets it; otherwise, <acronym>OGNL</acronym> takes the string value of the object and parses that string to get the AST to interpret.</para>
+
+            <para>For example, this expression</para>
+
+            <programlisting>#fact(30H)</programlisting>
+
+            <para>looks up the <property>fact</property> variable, and interprets the value of that variable as an <acronym>OGNL</acronym> expression using the <classname>BigInteger</classname> representation of <constant>30</constant> as the
+            <property>root</property> object. See below for an example of setting the <varname>fact</varname> variable with an expression that returns the factorial of its argument. Note that there is an ambiguity in <acronym>OGNL</acronym>&#39;s
+            syntax between this double evaluation operator and a method call. <acronym>OGNL</acronym> resolves this ambiguity by calling anything that looks like a method call, a method call. For example, if the current object had a fact property
+            that held an <acronym>OGNL</acronym> factorial expression, you could not use this approach to call it</para>
+
+            <programlisting>fact(30H)</programlisting>
+
+            <para>because <acronym>OGNL</acronym> would interpret this as a call to the <property>fact</property> method. You could force the interpretation you want by surrounding the property reference by parentheses:</para>
+
+            <programlisting>(fact)(30H)</programlisting>
+        </section>
+
+        <section id="lambdaExpressions">
+            <title>Pseudo-Lambda Expressions</title>
+
+            <para><acronym>OGNL</acronym> has a simplified lambda-expression syntax, which lets you write simple functions. It is not a full-blown lambda calculus, because there are no closures---all variables in <acronym>OGNL</acronym> have global
+            scope and extent.</para>
+
+            <para>For example, here is an <acronym>OGNL</acronym> expression that declares a recursive factorial function, and then calls it:</para>
+
+            <programlisting>#fact = :[#this&#60;=1? 1 : #this*#fact(#this-1)], #fact(30H)</programlisting>
+
+            <para>The lambda expression is everything inside the brackets. The <property>#this</property> variable holds the argument to the expression, which is initially <constant>30H</constant>, and is then one less for each successive call to the
+            expression.</para>
+
+            <para><acronym>OGNL</acronym> treats lambda expressions as constants. The value of a lambda expression is the <glossterm>AST</glossterm> that <acronym>OGNL</acronym> uses as the parsed form of the contained expression.</para>
+        </section>
+
+        <section id="specialCollectionsProperties">
+            <title>Pseudo-Properties for Collections</title>
+
+            <para>There are some special properties of collections that <acronym>OGNL</acronym> makes available. The reason for this is that the collections do not follow JavaBeans patterns for method naming; therefore the <function>size()</function>,
+            <function>length()</function>, etc. methods must be called instead of more intuitively referring to these as properties. <acronym>OGNL</acronym> corrects this by exposing certain pseudo-properties as if they were built-in.</para>
+
+            <table frame="all">
+                <title>Special Collections Pseudo-Properties</title>
+
+                <tgroup cols="2">
+                    <colspec colwidth="100" />
+
+                    <colspec />
+
+                    <thead role="italic">
+                        <row>
+                            <entry valign="top">Collection</entry>
+
+                            <entry valign="top">Special Properties</entry>
+                        </row>
+                    </thead>
+
+                    <tbody>
+                        <row>
+                            <entry valign="top"><classname>Collection</classname> (inherited by <classname>Map</classname>, <classname>List</classname> &#38; <classname>Set</classname>)</entry>
+
+                            <entry valign="top"><variablelist><varlistentry><term><literal>size</literal></term><listitem><para>The size of the collection</para></listitem></varlistentry><varlistentry><term><literal>isEmpty</literal></term><listitem><para>Evaluates
+                            to <constant>true</constant> if the collection is empty</para></listitem></varlistentry></variablelist></entry>
+                        </row>
+
+                        <row>
+                            <entry valign="top">List</entry>
+
+                            <entry valign="top"><variablelist><varlistentry><term><literal>iterator</literal></term><listitem><para>Evalutes to an <classname>Iterator</classname> over the <classname>List</classname>.</para></listitem></varlistentry></variablelist></entry>
+                        </row>
+
+                        <row>
+                            <entry valign="top"><classname>Map</classname></entry>
+
+                            <entry valign="top"><variablelist><varlistentry><term><literal>keys</literal></term><listitem><para>Evalutes to a <classname>Set</classname> of all keys in the <classname>Map</classname>.</para></listitem></varlistentry><varlistentry><term><literal>values</literal></term><listitem><para>Evaluates
+                            to a <classname>Collection</classname> of all values in the <classname>Map</classname>.</para></listitem></varlistentry></variablelist><note><para>These properties, plus <literal>size</literal> and <literal>isEmpty</literal>,
+                            are different than the indexed form of access for <classname>Map</classname>s (i.e. <literal>someMap[&#34;size&#34;]</literal> gets the <literal>&#34;size&#34;</literal> key from the map, whereas <literal>someMap.size</literal>
+                            gets the size of the <classname>Map</classname>.</para></note></entry>
+                        </row>
+
+                        <row>
+                            <entry valign="top"><classname>Set</classname></entry>
+
+                            <entry valign="top"><variablelist><varlistentry><term><literal>iterator</literal></term><listitem><para>Evalutes to an <classname>Iterator</classname> over the <classname>Set</classname>.</para></listitem></varlistentry></variablelist></entry>
+                        </row>
+
+                        <row>
+                            <entry valign="top"><classname>Iterator</classname></entry>
+
+                            <entry valign="top"><variablelist><varlistentry><term><literal>next</literal></term><listitem><para>Evalutes to the next object from the <classname>Iterator</classname>.</para></listitem></varlistentry><varlistentry><term><literal>hasNext</literal></term><listitem><para>Evaluates
+                            to <constant>true</constant> if there is a next object available from the <classname>Iterator</classname>.</para></listitem></varlistentry></variablelist></entry>
+                        </row>
+
+                        <row>
+                            <entry valign="top"><classname>Enumeration</classname></entry>
+
+                            <entry valign="top"><variablelist><varlistentry><term id="Enumeration.next"><literal>next</literal></term><listitem><para>Evalutes to the next object from the <classname>Enumeration</classname>.</para></listitem></varlistentry><varlistentry><term
+                            id="Enumeration.hasNext"><literal>hasNext</literal></term><listitem><para>Evaluates to <constant>true</constant> if there is a next object available from the <classname>Enumeration</classname>.</para></listitem></varlistentry><varlistentry><term><literal>nextElement</literal></term><listitem><para>Synonym
+                            for <literal><link linkend="Enumeration.next">next</link></literal>.</para></listitem></varlistentry><varlistentry><term><literal>hasMoreElements</literal></term><listitem><para>Synonym for <literal><link
+                            linkend="Enumeration.hasNext">hasNext</link></literal>.</para></listitem></varlistentry></variablelist></entry>
+                        </row>
+                    </tbody>
+                </tgroup>
+            </table>
+        </section>
+
+        <section id="differences">
+            <title>Operators that differ from Java&#39;s operators</title>
+
+            <para>For the most part, <acronym>OGNL</acronym>&#39;s operators are borrowed from Java and work similarly to Java&#39;s operators. See the <acronym>OGNL</acronym> Reference for a complete discussion. Here we describe <acronym>OGNL</acronym>
+            operators that are not in Java, or that are different from Java.</para>
+
+            <itemizedlist>
+                <listitem>
+                    <para>The comma (,) or sequence operator. This operator is borrowed from C. The comma is used to separate two independent expressions. The value of the second of these expressions is the value of the comma expression. Here is an
+                    example:</para>
+
+                    <programlisting>ensureLoaded(), name</programlisting>
+
+                    <para>When this expression is evaluated, the ensureLoaded method is called (presumably to make sure that all parts of the object are in memory), then the name property is retrieved (if getting the value) or replaced (if setting).</para>
+                </listitem>
+
+                <listitem>
+                    <para>List construction with curly braces ({}). You can create a list in-line by enclosing the values in curly braces, as in this example:</para>