1    /*
2     * Copyright 2008 :torweg free software group
3     * 
4     * This program is free software: you can redistribute it and/or modify
5     * it under the terms of the GNU General Public License as published by
6     * the Free Software Foundation, either version 3 of the License, or
7     * (at your option) any later version.
8     * 
9     * This program is distributed in the hope that it will be useful,
10    * but WITHOUT ANY WARRANTY; without even the implied warranty of
11    * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12    * GNU General Public License for more details.
13    * 
14    * You should have received a copy of the GNU General Public License
15    * along with this program.  If not, see <http://www.gnu.org/licenses/>.
16    *
17    */
18   package org.torweg.pulse.annotations;
19   
20   import java.lang.annotation.Documented;
21   import java.lang.annotation.ElementType;
22   import java.lang.annotation.Retention;
23   import java.lang.annotation.RetentionPolicy;
24   import java.lang.annotation.Target;
25   
26   /**
27    * can be used to mark methods to require a valid {@code Token} in the
28    * {@code Command} triggering its execution.
29    * <p>
30    * This will provide a good protection against cross site request forgery (CSRF
31    * / XSRF). The token will be tied to the actual
32    * {@link org.torweg.pulse.service.request.Command} by including its hash code during the generation.
33    * </p>
34    * 
35    * @author Thomas Weber
36    * @version $Revision: 1381 $
37    */
38   @Documented
39   @Retention(RetentionPolicy.RUNTIME)
40   @Target( { ElementType.METHOD })
41   public @interface RequireToken {
42   
43   }
44