HttpConstraintElement (Servlet 3.1 API Documentation - Apache Tomcat 8.5.94)

Package javax.servlet

## Class HttpConstraintElement

- java.lang.Object
- - javax.servlet.HttpConstraintElement

- Direct Known Subclasses:
    `HttpMethodConstraintElement`, `ServletSecurityElement`

      public class HttpConstraintElement
      extends java.lang.Object

  Equivalent of `HttpConstraint` for programmatic configuration of security constraints.
  Since:
    Servlet 3.0

- - ### Constructor Summary

    Constructors
    Constructor | Description
    --- | ---
    `HttpConstraintElement()` | Default constraint is permit with no transport guarantee.
    `HttpConstraintElement​(ServletSecurity.EmptyRoleSemantic emptyRoleSemantic)` | Construct a constraint with an empty role semantic.
    `HttpConstraintElement​(ServletSecurity.EmptyRoleSemantic emptyRoleSemantic, ServletSecurity.TransportGuarantee transportGuarantee, java.lang.String... rolesAllowed)` | Construct a constraint with an empty role semantic, a transport guarantee and roles.
    `HttpConstraintElement​(ServletSecurity.TransportGuarantee transportGuarantee, java.lang.String... rolesAllowed)` | Construct a constraint with a transport guarantee and roles.

  - ### Method Summary

    All Methods Instance Methods Concrete Methods
    Modifier and Type | Method | Description
    --- | --- | ---
    `ServletSecurity.EmptyRoleSemantic` | `getEmptyRoleSemantic()` | TODO
    `java.lang.String[]` | `getRolesAllowed()` | TODO
    `ServletSecurity.TransportGuarantee` | `getTransportGuarantee()` | TODO

    - ### Methods inherited from class java.lang.Object

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

- - ### Constructor Detail

    - #### HttpConstraintElement

          public HttpConstraintElement()

      Default constraint is permit with no transport guarantee.

    - #### HttpConstraintElement

          public HttpConstraintElement​(ServletSecurity.EmptyRoleSemantic emptyRoleSemantic)

      Construct a constraint with an empty role semantic. Typically used with `ServletSecurity.EmptyRoleSemantic.DENY`.
      Parameters:
        `emptyRoleSemantic` - The empty role semantic to apply to the newly created constraint

    - #### HttpConstraintElement

          public HttpConstraintElement​(ServletSecurity.TransportGuarantee transportGuarantee,
                                       java.lang.String... rolesAllowed)

      Construct a constraint with a transport guarantee and roles.
      Parameters:
        `transportGuarantee` - The transport guarantee to apply to the newly created constraint
        `rolesAllowed` - The roles to associate with the newly created constraint

    - #### HttpConstraintElement

          public HttpConstraintElement​(ServletSecurity.EmptyRoleSemantic emptyRoleSemantic,
                                       ServletSecurity.TransportGuarantee transportGuarantee,
                                       java.lang.String... rolesAllowed)

      Construct a constraint with an empty role semantic, a transport guarantee and roles.
      Parameters:
        `emptyRoleSemantic` - The empty role semantic to apply to the newly created constraint
        `transportGuarantee` - The transport guarantee to apply to the newly created constraint
        `rolesAllowed` - The roles to associate with the newly created constraint
      Throws:
        `java.lang.IllegalArgumentException` - if roles are specified when DENY is used

  - ### Method Detail

    - #### getEmptyRoleSemantic

          public ServletSecurity.EmptyRoleSemantic getEmptyRoleSemantic()

      TODO
      Returns:
        TODO

    - #### getTransportGuarantee

          public ServletSecurity.TransportGuarantee getTransportGuarantee()

      TODO
      Returns:
        TODO

    - #### getRolesAllowed

          public java.lang.String[] getRolesAllowed()

      TODO
      Returns:
        TODO