Class QueueSasPermission

java.lang.Object
com.azure.storage.queue.sas.QueueSasPermission

public final class QueueSasPermission extends Object
Constructs a string representing the permissions granted by an Azure Service SAS to a queue. Setting a value to true means that any SAS which uses these permissions will grant permissions for that operation. Once all the values are set, this should be serialized with toString and set as the permissions field on QueueServiceSasSignatureValues.

It is possible to construct the permissions string without this class, but the order of the permissions is particular and this class guarantees correctness.

See Also:
  • Constructor Details

    • QueueSasPermission

      public QueueSasPermission()
      Initializes a QueueSasPermission object with all fields set to false.
  • Method Details

    • parse

      public static QueueSasPermission parse(String permissionString)
      Creates a QueueSasPermission from the specified permissions string. This method will throw an IllegalArgumentException if it encounters a character that does not correspond to a valid permission.
      Parameters:
      permissionString - A String which represents the QueueSasPermission.
      Returns:
      A QueueSasPermission generated from the given String.
      Throws:
      IllegalArgumentException - If permissionString contains a character other than r, a, u, or p.
    • hasReadPermission

      public boolean hasReadPermission()
      Gets the read permissions status.
      Returns:
      true if SAS has permission to read metadata, properties, message count, peek at messages. false, otherwise.
    • setReadPermission

      public QueueSasPermission setReadPermission(boolean hasReadPermission)
      Sets the read permission status.
      Parameters:
      hasReadPermission - true if SAS has permission to read metadata, properties, message count, peek at messages. false, otherwise.
      Returns:
      The updated QueueSasPermission object.
    • hasAddPermission

      public boolean hasAddPermission()
      Gets the add permission status.
      Returns:
      true if SAS has permission to add messages to the queue. false, otherwise.
    • setAddPermission

      public QueueSasPermission setAddPermission(boolean hasAddPermission)
      Sets the add permission status.
      Parameters:
      hasAddPermission - true if SAS has permission to add messages to the queue. false, otherwise.
      Returns:
      the updated QueueSasPermission object.
    • hasUpdatePermission

      public boolean hasUpdatePermission()
      Gets the update permission status.
      Returns:
      true if SAS has permission to update messages in the queue. false, otherwise.
    • setUpdatePermission

      public QueueSasPermission setUpdatePermission(boolean hasUpdatePermission)
      Sets the update permission status.

      Note: Use setProcessPermission(true) to get a particular message in the queue to update.

      Parameters:
      hasUpdatePermission - true if SAS has permission to update messages in the queue. false, otherwise.
      Returns:
      the updated QueueSasPermission object.
    • hasProcessPermission

      public boolean hasProcessPermission()
      Gets the process permission status.
      Returns:
      true if SAS has permission to get and delete messages from the queue. false, otherwise.
    • setProcessPermission

      public QueueSasPermission setProcessPermission(boolean hasProcessPermission)
      Sets the process permission status.
      Parameters:
      hasProcessPermission - true if SAS has permission to get and delete messages from the queue. false, otherwise.
      Returns:
      the updated QueueSasPermission object.
    • toString

      public String toString()
      Converts the given permissions to a String. Using this method will guarantee the permissions are in an order accepted by the service.
      Overrides:
      toString in class Object
      Returns:
      A String which represents the QueueSasPermission.