org.loom.mapping
Class Event

java.lang.Object
  org.loom.mapping.Event

All Implemented Interfaces:

ButtonDecorator, LinkDecorator

public class Event
extends java.lang.Object
implements LinkDecorator, ButtonDecorator

This class holds the internal data associated to an event. Events are public methods in Action classes that return Resolution and receive no arguments.

Author:

Ignacio Coloma

Constructor Summary

Event(ActionMapping mapping, java.lang.reflect.Method method)

Method Summary

void	addBoundValidator(PropertyValidator validator) Adds a new Validator.
void	addInterceptor(Interceptor interceptor)
void	addMethod(HttpMethod method) Add an allowed http method to this event.
void	assertNoOverlapping(Event other)
void	decorate(Button button) Modify button attributes based on the interceptors bound to this event.
void	decorate(Link link) Modify link attributes based on the interceptors bound to this event.
ActionMapping	getActionMapping()
java.util.Set<HttpMethod>	getHttpMethods()
InterceptorProxy	getInterceptors()
java.lang.reflect.Method	getJavaMethod()
java.lang.String	getName()
java.lang.String	getPrintName()
java.util.Set<java.lang.String>	getUriParameterNames()
UriParser	getUriParser()
java.util.Collection<PropertyValidator>	getValidators() Used only to inspect the list of validators while in development (actionDetails.jsp).
java.util.Set<PropertyValidator>	getValidatorsForProperty(java.lang.String propertyPath)
boolean	isDefault()
java.util.Map<java.lang.String,ParameterValue>	parse(java.lang.String uri, LoomServletRequest request) If this event is a match, return the list of parameter values extracted from the uri.
void	setInterceptorList(InterceptorProxy interceptorList)
void	setUriParser(UriParser uriParser)
boolean	supports(HttpMethod httpMethod)
java.lang.String	toString()
java.lang.StringBuilder	toUrl(com.google.common.collect.ListMultimap<java.lang.String,java.lang.String> params) Prepare the string representatuion of this method with the provided params.
void	validate(Action action, PropertyBinderMap propertyBinderMap, Messages messages) Applies all the configured validations to this object

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

Event

public Event(ActionMapping mapping,
             java.lang.reflect.Method method)

Method Detail

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

parse

public java.util.Map<java.lang.String,ParameterValue> parse(java.lang.String uri,
                                                            LoomServletRequest request)

If this event is a match, return the list of parameter values extracted from the uri. If the URI is not a match or the HTTP method is not included in the list of allowed methods, return null.

Parameters:

uri - the URI to be parsed, without the action handle.

request - the request object

Returns:

the Map of parameters extracted from the uri, null if it's not a match.

getName

public java.lang.String getName()

Returns:

the event name. This is the same as the method name.

getPrintName

public java.lang.String getPrintName()

Returns:

the print (full) event name for error messages. This is the action short name followed by the event name.

addBoundValidator

public void addBoundValidator(PropertyValidator validator)

Adds a new Validator. Allows validation overriding. If this property already has a validation of the same type, remove it and substitute with the new one. This allow to override the validation in fooAction.barField by placing annotations in fooAction.

Parameters:

validator -

validate

public void validate(Action action,
                     PropertyBinderMap propertyBinderMap,
                     Messages messages)
              throws MalformedPropertyPathException

Applies all the configured validations to this object

Parameters:

action - the action object

messages - All errors encountered are registered here

Throws:

MalformedPropertyPathException

assertNoOverlapping

public void assertNoOverlapping(Event other)

Throws:

ConfigException - if this Event is mapped to a URL that overlaps with another event for the same HTTP method

toUrl

public java.lang.StringBuilder toUrl(com.google.common.collect.ListMultimap<java.lang.String,java.lang.String> params)

Prepare the string representatuion of this method with the provided params.

Parameters:

params - the list of parameters to include in the URL.

Returns:

the String representation of this event object

getUriParameterNames

public java.util.Set<java.lang.String> getUriParameterNames()

Returns:

a list of the parameter names that are used to build the uri

addInterceptor

public void addInterceptor(Interceptor interceptor)

getJavaMethod

public java.lang.reflect.Method getJavaMethod()

getInterceptors

public InterceptorProxy getInterceptors()

setInterceptorList

public void setInterceptorList(InterceptorProxy interceptorList)

getValidators

public java.util.Collection<PropertyValidator> getValidators()

Used only to inspect the list of validators while in development (actionDetails.jsp). This method should not be used for any other purpose, as it exposes some class internals.

getValidatorsForProperty

public java.util.Set<PropertyValidator> getValidatorsForProperty(java.lang.String propertyPath)

Parameters:

propertyPath - the property path to retrieve validators

Returns:

Validators registered with the provided propertyName

getActionMapping

public ActionMapping getActionMapping()

isDefault

public boolean isDefault()

Returns:

true if this is the default event

decorate

public void decorate(Link link)

Modify link attributes based on the interceptors bound to this event.

Specified by:

decorate in interface LinkDecorator

decorate

public void decorate(Button button)

Modify button attributes based on the interceptors bound to this event.

Specified by:

decorate in interface ButtonDecorator

supports

public boolean supports(HttpMethod httpMethod)

Returns:

true if this method supports (can be invoked with) the provided HTTP method

addMethod

public void addMethod(HttpMethod method)

Add an allowed http method to this event. By default, GET and POST are allowed unless otherwise specified.

Parameters:

method - the method that should be allowed

getUriParser

public UriParser getUriParser()

setUriParser

public void setUriParser(UriParser uriParser)

getHttpMethods

public java.util.Set<HttpMethod> getHttpMethods()