Apache Struts 2 Documentation > Home > Guides > Core Developers Guide > Interceptors > I18n Interceptor |

Apache Struts 2 Documentation
I18n Interceptor
Edit Page Browse Space Add Page Add News
Added by digi9ten, last edited by Don Brown on Jan 01, 2007 (view change)

An interceptor that handles setting the locale specified in a session as the locale for the current action request. In addition, this interceptor will look for a specific HTTP request parameter and set the locale to whatever value is provided. This means that this interceptor can be used to allow for your application to dynamically change the locale for the user's session. This is very useful for applications that require multi-lingual support and want the user to be able to set his or her language preference at any point. The locale parameter is removed during the execution of this interceptor, ensuring that properties aren't set on an action (such as request_locale) that have no typical corresponding setter in your action.

For example, using the default parameter name, a request to foo.action?request_locale=en_US, then the locale for US English is saved in the user's session and will be used for all future requests.

## Parameters

- parameterName (optional) - the name of the HTTP request parameter that dictates the locale to switch to and save in the session. By default this is request_locale

- attributeName (optional) - the name of the session key to store the selected locale. By default this is WW_TRANS_I18N_LOCALE

## Extending the Interceptor

There are no known extensions points for this interceptor.

## Examples

    <action name="someAction" class="com.examples.SomeAction">
        <interceptor-ref name="i18n"/>
        <interceptor-ref name="basicStack"/>
        <result name="success">good_result.ftl</result>
    </action>