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

Compare with Current View Page History

« Previous Version 12 Next »

Name

Breadcrumb Plugin

Publisher

Scott Stanlick

License

Open Source (ASL2)

Version

1.3

Compatibility

Struts 2.0.9+

Homepage

http://strutsschool.com

Download

http://www.strutsschool.com/downloads/downloads.action

Error formatting macro: rate: java.lang.NoSuchMethodError: 'java.lang.String com.atlassian.confluence.setup.BootstrapManager.getDomainName()'

The Struts 2 plug-in is designed to capture bread crumbs. It can be configured many ways.

This Struts 2 plug-in is designed to capture bread crumbs when the "breadCrumbs" interceptor is included. This plug-in
can be activated by incorporating it with your registered interceptors.

  • Can be configured to suit many different requirements
  • Utilizes native framework functionality

The plug-in extends struts-default so you can extend the "breadcrumb" package to get these additional features.

======================
A sample configuration
======================

<struts>

 <package name="strutsSchool" extends="tiles-default,com.strutsschool.interceptors.breadcrumbs">

	<interceptors>
		<interceptor-stack name="strutsschoolStack">
			<interceptor-ref name="defaultStack"></interceptor-ref>
			<interceptor-ref name="breadCrumbs">
				<param name="wildCardSeparator">_</param>
	    		        <param name="uniqueCrumbsOnly">true</param>
	    		        <param name="getRequestsOnly">true</param>
	    		        <param name="crumbMax">24</param>
				<param name="excludeMethods">save,update,remove</param>
			</interceptor-ref>
		</interceptor-stack>
	</interceptors>

	<default-interceptor-ref name="strutsschoolStack"/>
</package>
	...
</struts>

The collection of captured requests are stored in session as Crumb objects which expose behavior sensitive to the respective web request.

====================
A sample page region
====================
<div class="breadcrumbs" style="float: left; width: 100%;">
<span>
	<s:iterator	value="%{#session['com.strutsschool.interceptors.breadcrumbs']}" status="status">
		<s:if test="#status.index > 0">
			&#187;
		</s:if>
		<s:url id="uri" action="%{action}" namespace="%{nameSpace}"/>
		<nobr><s:a href="%{uri}"><s:property value="wildPortionOfName"/></s:a></nobr>
	</s:iterator>
</span>
</div>

You could also include screenshots by attaching the images to this page:

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

Setting

Description

Default

Possible Values

crumbMax

Maximum crumbs to manage before a new request will pop the oldest from stack.  It's a running list of crumbs.

4

int

uniqueCrumbsOnly

Determines if the same Crumb object is unique in crumb collection

true

boolean

getRequestsOnly

This will include only HTTP method=GET requests

true

boolean

wildCardSeparator

Wildcard separator used in action mappings. 

_

String

includeMethods

Plug-in utilizes MethodFilterInterceptor, so you can configure methods to be included

none

comma delimited list

excludeMethods

Plug-in utilizes MethodFilterInterceptor, so you can configure methods to be excluded

none

comma delimited list

This plug-in can be installed by copying the plug-in jar into your application's /WEB-INF/lib directory. No other files need to be copied or created.

  • Links to any other documentation or related products

Version

Date

Author

Notes

1.3

Oct 27, 2007

stanlick

Initial release

  • No labels