Skip to end of metadata
Go to start of metadata

OGNL (Object Graph Navigation Library) Support

Support for OGNL-expressions with many language specific features is available since IDEA 11.
In 12.1+, Parser and PSI have been rewritten completely using GrammarKit.

Using OGNL in non-Struts 2 context

Icon

Using "IntelliLang" plugin OGNL-language support can enabled anywhere: method calls, XML attribute values, ... (see Settings->Project Settings->Language Injections)

Editing tip

Icon

Please use intention "Edit OGNL fragment" (Alt+Enter while cursor on OGNL expression) for better editing capatibilities. To enable it: Settings->Intentions->Language Injection "Edit Injected Fragment"

Icon

PLEASE NOTE: Support is under development, some expressions might not be parseable (yet) and will highlight bogus errors. See list of known issues.

Symbol

Status

(tick)

fully supported

(plus)

partly supported

(minus)

not done yet

(question)

future?

Integration with Struts 2

The goal is to support OGNL-expressions everywhere in Struts 2 applications in the same way as done for EL-expressions in JSPs.

OGNL language is available automatically at the following places:

(tick) JSP(X)

Struts UI, JQuery

  • all attributes containing "%{" (multiple occurences possible)
  • all attributes with list expression "{ el1, el2, ..}"
  • <s:iterator> "value" (without any prefix)
(tick) Freemarker

Struts UI, JQuery

  • all attributes containing "%{" (multiple occurences possible)
  • all attributes with list expression "{ el1, el2, ..}"
(minus) Velocity
(minus) validation.xml
  • Validator "fieldexpression" -> "expression"

Editor highlighting

(tick) Syntax highlighting

Basic syntax highlighting (identifiers, numbers, string literals, keywords, ..)

(tick) Escape sequences in strings

Highlight valid/invalid escape sequences

(plus) Semantic highlighting

Highlight missing closing brackets, parentheses, expressions, ...

(tick) Highlight matching parentheses, brackets and braces

(tick) Spellchecker

Strings and identifiers are checked for spelling errors using IDEA's integrated functionality.

(tick) Color settings page

Settings->Editor->Colors & Fonts->OGNL

Customize the appearance (color, style) to your needs:

Completion

(tick) Auto-complete closing quote/tick
(tick) Auto-complete closing '}'

Will be inserted automatically after typing "%{" and "{".

(plus) Keywords

Context-sensitive variants.

(minus) Identifiers

Editing

(tick) CTRL+W support

Expand/shrink selected part of expression semantically by repeatingly pressing CTRL-(Shift)-W:



(plus) Reformat

Basic whitespace-formatting (before/after operators, parentheses, brackets, ...) using Java-settings.
To reformat, use intention "Edit OGNL fragment..." and run "Code->Reformat Code" from there.

(plus) Live templates

Create your own OGNL-specific live templates (Context "OGNL") or use one of the predefined templates (see Settings->Live Templates).
NOTE Expanding live templates in injected context works with CTRL+J

(minus) Complete Current Statement

Complete expression syntactically, e.g. adding missing closing ")", "}"

(minus) Surround With

Provide specific "Surround with.." functionality.

Navigation

(minus) Go To Declaration

for identifiers

(minus) Go To Code references

Navigate to Class/Method references.

Documentation

(minus) QuickDoc

Provide quick documentation on hovering over elements (type, name).