org.apache.tapestry5.services.linktransform
Interface ComponentEventLinkTransformer

All Known Subinterfaces:
LinkTransformer
All Known Implementing Classes:
LinkTransformerImpl

@UsesOrderedConfiguration(value=ComponentEventLinkTransformer.class)
public interface ComponentEventLinkTransformer

Allows for selective replacement of the default Link used to represent a component event request. This is a service, but also the contribution to the service, as a chain of command.

This transformer follows the same pattern as PageRenderLinkTransformer.

Since:
5.2.0

Method Summary
 ComponentEventRequestParameters decodeComponentEventRequest(Request request)
          Attempts to decode the page render request, to perform the opposite action for transformComponentEventLink(Link, ComponentEventRequestParameters).
 Link transformComponentEventLink(Link defaultLink, ComponentEventRequestParameters parameters)
          Allows the default Link created for the component event request to be replaced.
 

Method Detail

transformComponentEventLink

Link transformComponentEventLink(Link defaultLink,
                                 ComponentEventRequestParameters parameters)
Allows the default Link created for the component event request to be replaced.

Parameters:
defaultLink - the default Link generated for a component event request
parameters - used to create the default Link
Returns:
a replacement Link, or null

decodeComponentEventRequest

ComponentEventRequestParameters decodeComponentEventRequest(Request request)
Attempts to decode the page render request, to perform the opposite action for transformComponentEventLink(Link, ComponentEventRequestParameters). The transformer is also responsible for identifying the locale in the request (as part of the path, or as a query parameter or cookie) and setting the locale for the request.

This method will be invoked from the ComponentEventDispatcher and a non-null value returned from this method will prevent the default ComponentEventLinkEncoder.decodeComponentEventRequest(Request) method from being invoked.

Returns:
decoded parameters, or null to proceed normally
See Also:
LocalizationSetter.setLocaleFromLocaleName(String)


Copyright © 2003-2012 The Apache Software Foundation.