Page History

Overview

The Struts 2 OSGi plugin

Features

• Application packages can be divided into bundles
• Supports Velocity and FreeMarker templates
• Supports Struts Spring integration

Missing Features

• No GUI for bundle administration
• Probably can't access application classes from bundles, including Spring classes
• No support for any results other than Velocity

Simple Usage

If your actions do not extend ActionSupport, and you are not using Spring then convert your jar that contains Actions, Velocity files, and a struts.xml file into a bundle, add a few lines in the jar's manifest.mf:

Bundle-Activator: org.apache.struts2.osgi.StrutsActivator
Export-Package: com.mycompany.myapp.actions
Bundle-Version: 1.0.0
Bundle-SymbolicName: foo.actions

Now the jar is ready to be deployed. Drop the jar into the /WEB-INF/classes/bundles directory and it will automatically be installed when the application starts up.

Advanced Usage

If your actions extend ActionSupport, or use other classes distributed with Struts, you will have to list their package names in the jar's manifest.mf:

Import-Package: com.opensymphony.xwork2

If you want to use the Spring as the object factory for your actions, then follow these steps:

...

<constant name="struts.objectFactory" value="osgi" />
<constant name="struts.objectFactory.delegate" value="spring" />
<constant name="struts.freemarker.manager.classname" value="org.apache.struts2.osgi.BundleFreemarkerManager" />

...

{rate:title=Rating|theme=dynamic}

Overview

This plugin

If you are going to use Velocity results, then add Velocity and Common Digester jars to your application. Using maven:

...

<dependency>
    <groupId>velocity</groupId>
    <artifactId>velocity</artifactId>
    <version>1.5</version>
</dependency>

<dependency>
    <groupId>velocity-tools</groupId>
    <artifactId>velocity-tools</artifactId>
    <version>1.3</version>
</dependency>
        
<dependency>
    <groupId>commons-digester</groupId>
    <artifactId>commons-digester</artifactId>
    <version>1.8</version>
</dependency>

Example

Here is how an example architecture would look:

Settings

The following settings can be customized. See the developer guide.

Installation

Follow these steps to use this plugin:

• Copying the plugin jar into your application's /WEB-INF/lib directory.
• Modify your web.xml to add the osgi configuration provider to your Struts 2 filter:

  Code Block
  lang xml
  <filter> <filter-name>struts</filter-name> <filter-class>org.apache.struts2.dispatcher.FilterDispatcher</filter-class> <init-param> <param-name>configProviders</param-name> <param-value>org.apache.struts2.osgi.OsgiConfigurationProvider</param-value> </init-param> </filter>

Resources

• OSGi
• Apache Felix

Version History

...

Version

...

Date

...

Author

...