Class RoleAttributeTag

java.lang.Object
jakarta.servlet.jsp.tagext.TagSupport
org.deltava.taglib.content.RoleAttributeTag
All Implemented Interfaces:
jakarta.servlet.jsp.tagext.IterationTag, jakarta.servlet.jsp.tagext.JspTag, jakarta.servlet.jsp.tagext.Tag, Serializable

public class RoleAttributeTag extends jakarta.servlet.jsp.tagext.TagSupport
A JSP Tag to set an attribute based on role membership.
Since:
2.6
Version:
7.0
Author:
Luke
See Also:
  • Field Summary

    Fields inherited from class jakarta.servlet.jsp.tagext.TagSupport

    id, pageContext

    Fields inherited from interface jakarta.servlet.jsp.tagext.IterationTag

    EVAL_BODY_AGAIN

    Fields inherited from interface jakarta.servlet.jsp.tagext.Tag

    EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE
  • Constructor Summary

    Constructors
    Constructor
    Description
     
  • Method Summary

    Modifier and Type
    Method
    Description
    int
    Closes the JSP and releases state.
    int
    Checks for the roles listed and adds the attribute to the request if found.
    void
    Clears state by reseting the role list.
    void
    setAttr(String attrName)
    Sets the request attribute name.
    void
    Sets the role(s) a user must belong to in order to view the body of this tag.
    void
    setValue(Object attrValue)
    Sets the request attribute value.

    Methods inherited from class jakarta.servlet.jsp.tagext.TagSupport

    doAfterBody, findAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setId, setPageContext, setParent, setValue

    Methods inherited from class Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Constructor Details

    • RoleAttributeTag

      public RoleAttributeTag()
  • Method Details

    • setAttr

      public void setAttr(String attrName)
      Sets the request attribute name.
      Parameters:
      attrName - the attribute name
    • setValue

      public void setValue(Object attrValue)
      Sets the request attribute value.
      Parameters:
      attrValue - the attribute value
    • setRoles

      public void setRoles(String roles)
      Sets the role(s) a user must belong to in order to view the body of this tag. Use * (asterisk) for all roles, and a role name prefaced by an ! (exclamation mark) for the lack of role memebrship.
      Parameters:
      roles - a comma-delimited list of authorized role names
    • release

      public void release()
      Clears state by reseting the role list.
      Specified by:
      release in interface jakarta.servlet.jsp.tagext.Tag
      Overrides:
      release in class jakarta.servlet.jsp.tagext.TagSupport
    • doStartTag

      public int doStartTag()
      Checks for the roles listed and adds the attribute to the request if found.
      Specified by:
      doStartTag in interface jakarta.servlet.jsp.tagext.Tag
      Overrides:
      doStartTag in class jakarta.servlet.jsp.tagext.TagSupport
      Returns:
      SKIP_BODY always
    • doEndTag

      public int doEndTag()
      Closes the JSP and releases state.
      Specified by:
      doEndTag in interface jakarta.servlet.jsp.tagext.Tag
      Overrides:
      doEndTag in class jakarta.servlet.jsp.tagext.TagSupport
      Returns:
      EVAL_PAGE always