Package io.ably.lib.types

Class Capability

java.lang.Object
io.ably.lib.types.Capability
public class Capability extends Object
A class representing an Ably Capability, providing convenience methods to simplify creation of token requests

  • Constructor Details

    • Capability

      public Capability()
      Construct a new empty Capability

  • Method Details

    • c14n

      public static String c14n(String capability) throws AblyException
      Convenience method to canonicalise a JSON capability expression.
      Parameters:
      capability - a capability string, which is the JSON text for the capability
      Returns:
      a capability string which has been canonicalised
      Throws:
      AblyException - if there is an error processing the given string (if for example it is not valid JSON)

    • addResource

      public void addResource(String resource, String... ops)
      Add a resource to an existing Capability instance with the given set of operations. If the resource already exists, it is wholly replaced by the given set of operations.
      Parameters:
      resource - the resource string
      ops - a String varargs of the operations permitted for this resource; the arguments do not need to be sorted

    • removeResource

      public void removeResource(String resource)
      Remove a resource from an existing Capability instance
      Parameters:
      resource - the (possibly existing) resource

    • addOperation

      public void addOperation(String resource, String op)
      Add an operation to an existing Capability instance for a given resource. If the resource does not already exist, it is created.
      Parameters:
      resource - the resource string
      op - a single operation String to be added for this resource;

    • removeOperation

      public void removeOperation(String resource, String op)
      Remove an operation for a given resource. If the resource becomes empty as a result, it is removed.
      Parameters:
      resource - the resource string
      op - a operation String to be removed for this resource;

    • toString

      public String toString()
      Get the canonicalised String text for a Capability instance. The json object and its members are sorted if the object has been modified since the last time it was canonicalised.
      Overrides:
      toString in class Object
      Returns:
      the canonicalised String text