PluginSetup - gtosto/struts2-arianna-plugin GitHub Wiki

To begin to use the arianna plugin just download the plugin (available here) and put the jar into your application /WEB-INF/lib directory.

The plugin core functionalties are provided by an interceptor which needs to be added to your interceptor stack. Define the interceptor into your struts2 package

<interceptor name="breadCrumbs" class="xyz.timedrain.arianna.plugin.BreadCrumbInterceptor">
  <param name="defaultRewindMode">NEVER</param>
  <param name="defaultComparator">xyz.timedrain.arianna.plugin.NameComparator</param>
</interceptor>

and add it to your interceptor stack, i.e.

<interceptor-stack name="myStack">
  <interceptor-ref name="defaultStack"/>
  <interceptor-ref name="breadCrumbs"/>
</interceptor-stack>

Note

You could have very different (strange) behavior depending on where the BreadCrumbInterceptor is placed, however putting it after all standard interceptor is the best choice for almost all cases.

Once the interceptor is part of your interceptor's stack, you can just annotate with @BreadCrumb the actions and/or methods that you want to be tracked.

You can have several interceptor instance for different package each on with its own defaults, and they will be applied to all actions intercepted by that instance. However interceptor parameters are just defaults, so they can be overrided on an per-action basis using the @BreadCrumb annotation.

Note

Avoid to set more than one BreadCrumbInterceptor instance on a single stack as this could lead to unpredictable behaviour (see also Issue 1).

To set the maximum number of bread crumbs the plugin should store, you have to set a global constant in struts.xml file

<constant name="arianna:maxCrumbs" value="6"></constant>

that value is shared across all interceptors' instances.

⚠️ **GitHub.com Fallback** ⚠️