Class Rights

  • All Implemented Interfaces:
    Cloneable

    public class Rights
    extends Object
    implements Cloneable
    The Rights class represents the set of rights for an authentication identifier (for instance, a user or a group).

    A right is represented by the Rights.Right inner class.

    A set of standard rights are predefined (see RFC 2086). Most folder implementations are expected to support these rights. Some implementations may also support site-defined rights.

    The following code sample illustrates how to examine your rights for a folder.

    
     Rights rights = folder.myRights();
    
     // Check if I can write this folder
     if (rights.contains(Rights.Right.WRITE))
            System.out.println("Can write folder");
    
     // Now give Joe all my rights, except the ability to write the folder
     rights.remove(Rights.Right.WRITE);
     ACL acl = new ACL("joe", rights);
     folder.setACL(acl);
     

    • Nested Class Summary

      Nested Classes 
      Modifier and Type Class Description
      static class  Rights.Right
      This inner class represents an individual right.
    • Constructor Summary

      Constructors 
      Constructor Description
      Rights()
      Construct an empty Rights object.
      Rights​(Rights rights)
      Construct a Rights object initialized with the given rights.
      Rights​(Rights.Right right)
      Construct a Rights object initialized with the given right.
      Rights​(String rights)
      Construct a Rights object initialized with the given rights.
    • Constructor Detail

      • Rights

        public Rights()
        Construct an empty Rights object.
      • Rights

        public Rights​(Rights rights)
        Construct a Rights object initialized with the given rights.
        Parameters:
        rights - the rights for initialization
      • Rights

        public Rights​(String rights)
        Construct a Rights object initialized with the given rights.
        Parameters:
        rights - the rights for initialization
      • Rights

        public Rights​(Rights.Right right)
        Construct a Rights object initialized with the given right.
        Parameters:
        right - the right for initialization
    • Method Detail

      • add

        public void add​(Rights.Right right)
        Add the specified right to this Rights object.
        Parameters:
        right - the right to add
      • add

        public void add​(Rights rights)
        Add all the rights in the given Rights object to this Rights object.
        Parameters:
        rights - Rights object
      • remove

        public void remove​(Rights.Right right)
        Remove the specified right from this Rights object.
        Parameters:
        right - the right to be removed
      • remove

        public void remove​(Rights rights)
        Remove all rights in the given Rights object from this Rights object.
        Parameters:
        rights - the rights to be removed
      • contains

        public boolean contains​(Rights.Right right)
        Check whether the specified right is present in this Rights object.
        Parameters:
        right - the Right to check
        Returns:
        true of the given right is present, otherwise false.
      • contains

        public boolean contains​(Rights rights)
        Check whether all the rights in the specified Rights object are present in this Rights object.
        Parameters:
        rights - the Rights to check
        Returns:
        true if all rights in the given Rights object are present, otherwise false.
      • equals

        public boolean equals​(Object obj)
        Check whether the two Rights objects are equal.
        Overrides:
        equals in class Object
        Returns:
        true if they're equal
      • hashCode

        public int hashCode()
        Compute a hash code for this Rights object.
        Overrides:
        hashCode in class Object
        Returns:
        the hash code
      • getRights

        public Rights.Right[] getRights()
        Return all the rights in this Rights object. Returns an array of size zero if no rights are set.
        Returns:
        array of Rights.Right objects representing rights
      • clone

        public Object clone()
        Returns a clone of this Rights object.