OGNL使用手记

基本概念 

OGNL全称是Object-Graph Navigation Language，是一个用来获取和设置JAVA对象的属性的表达式语言。通过使用表达式语法导航对象图，而不是直接调用对象的获取和设置方法可以提供许 多应用。比如在XML文件或者脚本文件中嵌入OGNL表达式语法，在JSP页面展现层使用OGNL表达式语法。类似的应用有Velocity, Freemark,Webwork。

如何使用

最简单的使用是直接使用ognl.Ognl类来评估一个OGNL表达式。 Ognl类提供一些静态方法用来解析和解释OGNL表达式，最简单的示例是不使用上下文从一个对象中获取某个表达式的值，示例如下：

java 代码
 import ognl.Ognl; import ognl.OgnlException;
try {
       result = Ognl.getValue(expression, root);
}
catch (OgnlException ex)
{
        // Report error or recover
}

上述代码将基于root对象评估expression，返回结果，如果表达式有错，比如没有找到指定的属性，将抛出OgnlException。

更复杂一点的应用是使用预解析的表达式。这种方式允许评估表达式前捕获解析错误，也允许缓存解析出来的表达式进一个AST供重得使用从而提高性能。Ognl的parseExpression方法就是用来执行预解析操作的。

Ognl类的获取和设置方法大都可以接受一个context map参数，是一个Map类型的对象，允许你一些自己的变量进去，缺省的上下文里只包含#root和#context两个键。 Ognl内部会用这个Map替换OgnlContext类的缺省的map属性。Ognl的一些addDefaultContext方法就是完成这些功能 的。

OgnlContext提供一些设置，可以更改OGNL的缺省行为，比如TypeConverter接口实例用来改变类型转换行为，具体可以参见相关文档。

下面的示例展示如何从root对象中解析出documentName属性，然后将当前用户名称添加到返回的结果后面：

java 代码
private Map context = new HashMap();

public void setUserName(String value)
{
    context.put("userName", value);
}

ry {
   // get value using our own custom context map
   result = Ognl.getValue("userName"", context, root);
} catch (OgnlException ex) {
    // Report error or recover
}

基本语法

OGNL的语法正变得越来越丰富，但是基本语法是没有什么改变的。比如要获取一个对象的name属性，OGNL表达式就是name,要获取一个对象的headline属性的text属性，OGNL表达式就是headline.text。 

OGNL表达式的基本单位是导航链。最简单的链包含如下部分：

表达式组成部分 示例

属性名称	如上述示例中的name和headline.text
方法调用	hashCode()返回当前对象的哈希码。
数组元素	listeners[TEC:0]返回当前对象的监听器列表中的第一个元素。

所有的OGNL表达式都基于当前对象的上下文来评估，导航链的示例如下：

java 代码
name.toCharArray()[0].numericValue.toString()

评估步骤如下：

• 解析根对象的name属性。
• 调用上一步返回的结果字符串的toCharArray()方法。
• 获取返回的结果数组的第一个字符，是一个Character对象。
• 获取字符的数字值表示，Character有一个getNumericValue()方法。
• 调用结果Integer对象的toString()方法。

参考资料

API文档

语言规范

开发指南