org.apache.catalina.deploy
Class SecurityConstraint

java.lang.Object
  org.apache.catalina.deploy.SecurityConstraint

All Implemented Interfaces:

java.io.Serializable

public class SecurityConstraint
extends java.lang.Object
implements java.io.Serializable

Representation of a security constraint element for a web application, as represented in a <security-constraint> element in the deployment descriptor.

WARNING: It is assumed that instances of this class will be created and modified only within the context of a single thread, before the instance is made visible to the remainder of the application. After that, only read access is expected. Therefore, none of the read and write access within this class is synchronized.

Author:

Craig R. McClanahan

See Also:

Serialized Form

SecurityConstraint

public SecurityConstraint()

Construct a new security constraint instance with default values.

getAllRoles

public boolean getAllRoles()

Was the "all roles" wildcard included in this authentication constraint?

getAuthConstraint

public boolean getAuthConstraint()

Return the authorization constraint present flag for this security constraint.

setAuthConstraint

public void setAuthConstraint(boolean authConstraint)

Set the authorization constraint present flag for this security constraint.

getDisplayName

public java.lang.String getDisplayName()

Return the display name of this security constraint.

setDisplayName

public void setDisplayName(java.lang.String displayName)

Set the display name of this security constraint.

getUserConstraint

public java.lang.String getUserConstraint()

Return the user data constraint for this security constraint.

setUserConstraint

public void setUserConstraint(java.lang.String userConstraint)

Set the user data constraint for this security constraint.

Parameters:

userConstraint - The new user data constraint

addAuthRole

public void addAuthRole(java.lang.String authRole)

Add an authorization role, which is a role name that will be permitted access to the resources protected by this security constraint.

Parameters:

authRole - Role name to be added

addCollection

public void addCollection(SecurityCollection collection)

Add a new web resource collection to those protected by this security constraint.

Parameters:

collection - The new web resource collection

findAuthRole

public boolean findAuthRole(java.lang.String role)

Return true if the specified role is permitted access to the resources protected by this security constraint.

Parameters:

role - Role name to be checked

findAuthRoles

public java.lang.String[] findAuthRoles()

Return the set of roles that are permitted access to the resources protected by this security constraint. If none have been defined, a zero-length array is returned (which implies that all authenticated users are permitted access).

findCollection

public SecurityCollection findCollection(java.lang.String name)

Return the web resource collection for the specified name, if any; otherwise, return null.

Parameters:

name - Web resource collection name to return

findCollections

public SecurityCollection[] findCollections()

Return all of the web resource collections protected by this security constraint. If there are none, a zero-length array is returned.

included

public boolean included(java.lang.String uri,
                        java.lang.String method)

Return true if the specified context-relative URI (and associated HTTP method) are protected by this security constraint.

Parameters:

uri - Context-relative URI to check

method - Request method being used

removeAuthRole

public void removeAuthRole(java.lang.String authRole)

Remove the specified role from the set of roles permitted to access the resources protected by this security constraint.

Parameters:

authRole - Role name to be removed

removeCollection

public void removeCollection(SecurityCollection collection)

Remove the specified web resource collection from those protected by this security constraint.

Parameters:

collection - Web resource collection to be removed

toString

public java.lang.String toString()

Return a String representation of this security constraint.

Overrides:

toString in class java.lang.Object