package net.sourceforge.stripes.action;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * <p>
 * Annotation that marks an ActionBean as secure (i.e. an ActionBean that
 * requires SSL protection) URLs generated by the Stripes tag library will be
 * automatically rewritten
 * </p>
 * 
 * <ul>
 * <li>If the current request is not secure and the destination ActionBean is
 * marked as Secure, the URL will be rewritten to an absolute URL starting with
 * https://</li>
 * <li>If the current request is secure and the destination ActionBean is not
 * marked as Secure, the URL will be rewritten to an absolute URL starting with
 * http://</li>
 * <li>If the security state of the current request equals the secure state of
 * the destination ActionBean, the URL is left unchanged
 * </ul>
 * 
 * @author Christian Schwanke
 */
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Secure {

}