org.eclipse.jetty.ee8.nested.ServletConstraint Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of jetty-ee8-nested Show documentation
The jetty core handler adapted to legacy ee8 handler.
The newest version!
//
// ========================================================================
// Copyright (c) 1995 Mort Bay Consulting Pty Ltd and others.
//
// This program and the accompanying materials are made available under the
// terms of the Eclipse Public License v. 2.0 which is available at
// https://www.eclipse.org/legal/epl-2.0, or the Apache License, Version 2.0
// which is available at https://www.apache.org/licenses/LICENSE-2.0.
//
// SPDX-License-Identifier: EPL-2.0 OR Apache-2.0
// ========================================================================
//
package org.eclipse.jetty.ee8.nested;

import java.io.Serializable;
import java.util.Arrays;

/**
 * Constraint
 *
 * Describe an auth and/or data constraint.
 */
public class ServletConstraint implements Cloneable, Serializable {

    public static final int DC_NONE = 0;

    public static final int DC_INTEGRAL = 1;

    public static final int DC_CONFIDENTIAL = 2;

    public static final String NONE = "NONE";

    public static final String ANY_ROLE = "*";

    //Servlet Spec 3.1 pg 140
    public static final String ANY_AUTH = "**";

    private String _name;

    private String[] _roles;

    private int _dataConstraint = -1;

    private boolean _anyRole = false;

    private boolean _anyAuth = false;

    private boolean _authenticate = false;

    /**
     * Constructor.
     */
    public ServletConstraint() {
    }

    /**
     * Convenience Constructor.
     *
     * @param name the name
     * @param role the role
     */
    public ServletConstraint(String name, String role) {
        setName(name);
        setRoles(new String[] { role });
    }

    @Override
    public Object clone() throws CloneNotSupportedException {
        return super.clone();
    }

    /**
     * Set the name.
     * @param name the name
     */
    public void setName(String name) {
        _name = name;
    }

    public String getName() {
        return _name;
    }

    public void setRoles(String[] roles) {
        _roles = roles;
        _anyRole = false;
        _anyAuth = false;
        if (roles != null) {
            for (int i = roles.length; i-- > 0; ) {
                _anyRole |= ANY_ROLE.equals(roles[i]);
                _anyAuth |= ANY_AUTH.equals(roles[i]);
            }
        }
    }

    /**
     * @return True if any user role is permitted.
     */
    public boolean isAnyRole() {
        return _anyRole;
    }

    /**
     * Servlet Spec 3.1, pg 140
     *
     * @return True if any authenticated user is permitted (ie a role "**" was specified in the constraint).
     */
    public boolean isAnyAuth() {
        return _anyAuth;
    }

    /**
     * @return String array of roles for this constraint.
     */
    public String[] getRoles() {
        return _roles;
    }

    /**
     * @param authenticate True if users must be authenticated
     */
    public void setAuthenticate(boolean authenticate) {
        _authenticate = authenticate;
    }

    /**
     * @return True if the constraint requires request authentication
     */
    public boolean getAuthenticate() {
        return _authenticate;
    }

    /**
     * @return True if authentication required but no roles set
     */
    public boolean isForbidden() {
        return _authenticate && !_anyRole && (_roles == null || _roles.length == 0);
    }

    /**
     * @param c Data constrain indicator: 0=DC+NONE, 1=DC_INTEGRAL &
     * 2=DC_CONFIDENTIAL
     */
    public void setDataConstraint(int c) {
        if (c < 0 || c > DC_CONFIDENTIAL)
            throw new IllegalArgumentException("Constraint out of range");
        _dataConstraint = c;
    }

    /**
     * @return Data constrain indicator: 0=DC+NONE, 1=DC_INTEGRAL &
     * 2=DC_CONFIDENTIAL
     */
    public int getDataConstraint() {
        return _dataConstraint;
    }

    @Override
    public String toString() {
        return "SC{" + _name + "," + (_anyRole ? "*" : (_roles == null ? "-" : Arrays.asList(_roles).toString())) + "," + (_dataConstraint == -1 ? "UNSET}" : (_dataConstraint == DC_NONE ? "NONE}" : (_dataConstraint == DC_INTEGRAL ? "INTEGRAL}" : "CONFIDENTIAL}")));
    }
}