Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 81 Next »

Introduction

Struts 2 Plugin for JetBrains IntelliJ IDEA provides tight and feature-rich integration to develop Struts 2 applications. Real productivity features (including refactoring support) and understanding the structure and framework will make you more productive instantly. No more countless wizards just generating some XML or code without much intelligence!

NEW Screencasts @jetbrains.tv

Icon

To get a quick overview watch these screencasts to see Struts 2 support "in action"

Navigation and Autocompletion: demonstrates basic navigation and autocompletion features
Spring integration: setting up Spring integration for your Struts 2 project
more to follow soon...

IDEA versions

Icon

Some features may not be available in all versions.
IDEA 8+ means "IDEA 8 or any higher version"

Please see Struts2PluginChangeNotes for detailed information.

Getting started

Icon

"Hello World" with Struts 2 and IntelliJ IDEA 8 - Detailed introductory blog post by Tabrez Iqbal

Symbol

Status

(minus)

planned

(plus)

in progress

(tick)

done

(question)

future planning

Struts 2 facet

All plugin configuration settings are bundled in a dedicated facet. Simply attach a new Struts 2-facet to an existing Web-facet, create a fileset and add your struts.xml-files from all auto-scanned configuration files in your project and the plugin is ready to work.

Fileset configuration

Icon

struts-default.xml from struts2-core.jar as well as any struts-plugin.xml from plugins (e.g. Spring integration) have to be added additionally to the fileset.
Also make sure to add all files used via <include>.
10.0.2+: projects created using project wizard will include all struts.xml-files from Struts-JARs automatically
(warning) Many features will NOT work if this setup has not been performed properly (warning)

(tick) Dedicated facet with configuration options
(tick) File Set manager

Group and manage your struts.xml-files with an easy to use editor, providing maximum flexibility w/r to your project setup.

(tick) Detect struts.xml files not mapped to file sets

Spot setup errors easily, additionally providing a quickfix to add the unmapped struts.xml-files to any existing fileset.

(tick) Library validator/setup

Creates IDEA project/module-library and - if required - downloads all necessary JAR files required for Struts 2.

(minus) Library validator/setup for standard plugins (Spring, Tiles, JSF, ..)
(tick) Autodetection of Struts 2 facets

Existing struts.xml-files are recognized upon opening your project and a new S2 facet will be created automatically.

(tick) Integration with "New Project"

Add a blank ready-to-start Struts 2 application template by selecting Struts 2 from the list of available technologies. A S2-facet with default fileset and an empty struts.xml-file already mapped in web.xml will be created automatically, all necessary libraries will be setup as well.

IDE integration

(tick) "Go To Action/Package" by name

Press Ctrl+Shift+Alt+N (Go To -> Symbol) to quickly navigate to any Action/Package by simply entering its name (including wildcards):

(tick) "Navigate -> Related File"

Tip: just start typing to narrow down the result list of related items and press ENTER to navigate.

IDEA 10.5+
Use this shortcut to quickly navigate from any web-resource used in <result> to its <action>-declaration and/or Action-method.
IDEA 11+
Also vice versa from Action-class to <action>-declaration and any referenced result(s) files.
Navigate from Action-class to all corresponding validation.xml files.

(tick) Dedicated dictionary

IDEA 11+
A bundled dictionary providing Struts-specific words integrates with IDEA's builtin spellchecker.

(tick) Dedicated icons for configuration/JAVA (Action) files

Recognize Struts related files/classes at a glance throughout the IDE (Project/Packages View, Editor tabs, Autocompletion, ..):

struts.xml/validation.xml

(plus) Autocompletion for all possible elements

Please see this screencast to see it "in action".

Auto-completion is available for virtually all tags and attributes, just give it a try:

(tick) Rename refactoring/Find Usages for all referencable elements

Need to refactor your S2 application? No more manual search and replace - just use Rename refactoring (Shift+F6) or perform Find Usages (Alt+F7 or Ctrl+Alt+F7):

(tick) Navigation to referenced elements

Simply Ctrl-click (or press Ctrl+B) on any element to navigate to its declaration - or take a peek without leaving the current editor using Quick Definition Lookup (Ctrl+Shift+I).

(plus) Highlighting of configuration/reference errors

Errors are highlighted immediately in the editor, additional validation is triggered for Make Project.
IDEA 7: see "Validation" tab in S2 facet for more options
IDEA 8+: see Settings->Compiler->Validation

(plus) Quickfixes

Various quickfixes to create missing elements etc.

(tick) struts.xml: restrict resolving to <result> value depending on result-type (e.g. Tiles, Velocity)

IDEA 10+
Completion will only show resources relevant for the given (or inherited) result type.

(plus) Various inspections for common configuration errors

Highlight common configuration errors or possible problems on-the-fly - while you're editing.

(tick) Structure View

Visually groups all relevant info with Autoscroll from/to source. Searching for something in the tree? Just start typing its name to find it.

(tick) Pageflow graph (struts.xml)

IDEA 8+
Graph of all actions and results makes it easy to understand the structure of your application.

validation.xml

(tick) Navigation to/from corresponding Action-class

IDEA 11+
Autocompletion/Navigation to Action-class properties in <field> "name"
"Navigate -> Related File" from Action-class to validation.xml.

(minus) Show validation.xml node(s) under corresponding Action-class (like GUI-Designer forms)
(tick) Create corresponding validation.xml-template from Action

IDEA 11+
Intention to create new ActionClassName-validation.xml from file template.

(tick) Structure View
(tick) I18N-support

IDEA 11+
Support for .properties-based I18N for <message> "key" (can be disabled in S2 facet, tab "Features").

Actions (JAVA/Groovy)

(tick) Navigation to Action-declaration in struts.xml

Simply click on the action icon in the left editor bar to quickly open up the corresponding mapping(s) in struts.xml:
IDEA 8.1.1+: also for Groovy

(tick) Navigate to result

IDEA 10.5+
Use the gutter icon (or use Navigate->Related File) to directly navigate to any result(s) from your action method:

JSPs

(tick) Navigation to Action-declaration/class

Click on the Action-class icon to quickly open the corresponding JAVA/Groovy-class or Ctrl+click on the "action"-attribute to go to the struts.xml-definition:

(tick) Autocompletion/navigation for form properties

IDEA 11+
Form properties will be autocompleted/resolved in "surrounding" Action class. Ofcourse, rename refactoring and finding usages is supported here as well.

(plus) Autocompletion/navigation for other tags

Autocompletion is available for (almost) all attributes with static values.

(tick) JavaScript support

(plugin "JavaScript Support" must be enabled)
Enjoy the power of IDEA's powerful JavaScript-support within all S2 UI-tags.

(tick) CSS support

(IDEA 8+: plugin "CSS Support" must be enabled)
Define inline-styles (cssStyle) or reference existing CSS classes (cssClass).

(tick) I18N-support

IDEA 10+
Support for .properties-based I18N for <s:text> (can be disabled in S2 facet, tab "Features").

(plus) OGNL (Object Graph Navigation Library) Support

IDEA 11+
Provides editing, highlighting and autocompletion support for OGNL expressions - not just for Struts 2 applications.

Please see Struts 2 Plugin OGNL Support for details.

Plugins/3rd Party Extensions

Icon

Make sure to include struts-plugin.xml from corresponding plugin JAR to your Struts 2 fileset (configured in S2 facet in module settings).

(tick) Support struts2-spring-plugin

(plugin "Spring Support" must be enabled and Spring facet configured properly)

Please see this screencast to see Spring integration "in action".

Reference Spring beans where supported (e.g. in <action> "class", <constant> "value").

(plus) Convention plugin

IDEA 9+
Sophisticated configuration properties support

Autocompletion/navigation/usage search in annotations (WIP):

(tick) Integration with Tiles 2

Blog post

(plugin "Struts 1.x" must be enabled)
IDEA 8.1.1+
struts2-tiles-plugin.jar must be present as well as Tiles libraries. Configured tiles.xml-files will be set automatically as described in http://struts.apache.org/2.x/docs/tiles-plugin.html.

(tick) Freemarker

(plugin "FreeMarker support" must be enabled)
IDEA 8+
All supported S2 taglibs are automatically available:

Global variables as well as properties provided from corresponding Action-class will be resolved:

(plus) Velocity

(plugin "Velocity support" must be enabled)
IDEA 10.x+
Add all global macros (struts.vm in struts2-core.jar) automatically.
Autocomplete all global variables.
Blog post incl. screen-shots

(plus) Support struts2-jQuery plugin

IDEA 9+
Provides autocompletion, navigation for JSP tags.
Blog post showing off some features

struts-jQuery plugin

  • No labels