org.springframework.security.access.prepost
Annotation Type PreFilter


@Target(value={METHOD,TYPE})
@Retention(value=RUNTIME)
@Inherited
@Documented
public @interface PreFilter

Annotation for specifying a method filtering expression which will be evaluated before a method has been invoked. The name of the argument to be filtered is specified using the filterTarget attribute. This must be a Java Collection implementation which supports the remove method. Pre-filtering isn't supported on array types and will fail if the value of named filter target argument is null at runtime.

For methods which have a single argument which is a collection type, this argument will be used as the filter target.

The annotation value contains the expression which will be evaluated for each element in the collection. If the expression evaluates to false, the element will be removed. The reserved name "filterObject" can be used within the expression to refer to the current object which is being evaluated.

Since:
3.0
Version:
$Id: PreFilter.java 3650 2009-05-11 05:18:20Z ltaylor $
Author:
Luke Taylor

Required Element Summary
 String value
           
 
Optional Element Summary
 String filterTarget
           
 

Element Detail

value

public abstract String value
Returns:
the Spring-EL expression to be evaluated before invoking the protected method

filterTarget

public abstract String filterTarget
Returns:
the name of the parameter which should be filtered (must be a non-null collection instance) If the method contains a single collection argument, then this attribute can be omitted.
Default:
""


Copyright © 2004-2009 SpringSource, Inc. All Rights Reserved.