Package jakarta.servlet

## Class HttpConstraintElement

- java.lang.Object
- - jakarta.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
`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
`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