Advanced topics


Generator: GetNavigation

Class name:org.weborganic.bastille.psml.GetNavigation
Version:0.7.0 - 6 October 2012


This generator returns the content of the navigation file in PSML located in /config/navigation.psml.

This generator is provided for convenience and behaves as if it were the GetConfigFile with the path parameter set to 'navigation'. It results in a less verbose code for websites that use a file for their global navigation.

This generator comes as a replacement for the GetNavigation (web package) generator.


No configuration is required.

The root of the PSML folder can be configured using the global property bastille.psml.root which can be either an absolute path or a relative path from the global repository.

By default, the PSML root is set to "psml" which usually corresponds to the /WEB-INF/psml folder of your Web application.


This generator does not require or accept any parameter.

Returned XML

This generator will wrap the content of the file with the <psml-file> element.

See below:

<psml-file name="navigation.xml" base="/config/" status="[status]">
  <!-- PSML navigation file content -->

Error handling

If the navigation file cannot be found or read, this generator will return the following:

<psml-file name="navigation.psml" base="/config/" status="not-found">
Unable to find file: [path]

The status of this generator will be set to 'NOT_FOUND'.


Below is the code to include in the services:

<generator class="com.weborganic.bastille.psml.GetNavigation" ... />

Note that it is equivalent to:

<generator class="com.weborganic.bastille.psml.GetConfigFile" ... >
  <parameter name="path" value="navigation"/>

Example: main navigation

The most common configuration is simply:

<generator class="com.weborganic.bastille.psml.GetNavigation" 
            name="navigation" target="navigation"/>

Created on , last edited on