Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin

Name

OSGi Plugin

Publisher

Donald Brown Apache Software Foundation

License

Open Source (ASL2)

Version

0.1-SNAPSHOT

Compatibility

Struts Bundled with Struts from 2.01.9+

Homepage

OSGi Plugin

Download

SVN

Overview

Note

This plugin is only experimental and hasn't been released yet. It is not ready to be used in production applications.

The Struts 2 OSGi plugin

Excerpt

leverages OSGi to allow Struts 2 applications to be divided into multiple jars (bundles) and managed at runtime

. It allows you to separate your application into jars (called bundles), each containing a struts.xml file, Action classes, and Velocity (for now) files.

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:

No Format

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 listen their package names in the jar's manifest.mf:

No Format

Import-Package: com.opensymphony.xwork2

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

  1. Copy all these jar files into /WEB-INF/classes/bundles
  2. Make sure that the following properties are set(with the listed values) or not set at all in struts.xml or struts.properties in your webapp:

...


<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" />

Wiki Markup
{rate:title=Rating|theme=dynamic}

Overview

This plugin

Excerpt

provides support for starting an instance of Apache Felix inside a web application, and scanning installed bundles for Struts configuration

. An admin bundle is also provided.

Example

Here is how an example architecture would look:

Gallery

Settings

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

Setting

Description

Default

Possible Values

struts.objectFactory.delegate

The alias of the ObjectFactory to wrap

struts

Any configured alias

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
    langxml
    
    <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

Version History

...

Version

...

Date

...

Author

...