Merge pull request #2 from ademarcy/master

Massive resource-centric permissions clearing

src/Drivers/ArrayDriver.php

@@ -145,6 +145,18 @@ public function hasRolePermission(Role $role, Permission $permission)
         return false;
     }
 
+    /**
+    * Removes all permissions for a resource, used
+    * for performance-critical massive removals.
+    *
+    * @param \BeatSwitch\Lock\Resources\Resource
+    * @return void
+    */
+    public function clearPermissionsForResource(Resource $resource)
+    {
+        throw new \Exception('Unimplemented method "ArrayDriver::clearPermissionsForResource"');
+    }
+
     /**
      * Creates a key to store the caller's permissions
      *

src/Drivers/Driver.php

@@ -4,6 +4,7 @@
 use BeatSwitch\Lock\Callers\Caller;
 use BeatSwitch\Lock\Permissions\Permission;
 use BeatSwitch\Lock\Roles\Role;
+use BeatSwitch\Lock\Resources\Resource;
 
 /**
  * A contract to identify an implementation to store permissions to
@@ -82,4 +83,13 @@ public function removeRolePermission(Role $role, Permission $permission);
      * @return bool
      */
     public function hasRolePermission(Role $role, Permission $permission);
+
+    /**
+    * Removes all permissions for a resource, used
+    * for performance-critical massive removals.
+    *
+    * @param \BeatSwitch\Lock\Resources\Resource
+    * @return void
+    */
+    public function clearPermissionsForResource(Resource $resource);
 }

src/Manager.php

@@ -138,6 +138,20 @@ protected function findRole($role)
         return new SimpleRole($role);
     }
 
+    /**
+    * Clear permissions for several resources (used
+    * for performance-critical massive removals).
+    *
+    * @param array $resources an array of Resource objects
+    * @return void
+    */
+    public function clearPermissionsForResources(array $resources)
+    {
+        foreach($resources as $resource) {
+            $this->driver->clearPermissionsForResource($resource);
+        }
+    }
+
     /**
      * @return \BeatSwitch\Lock\Drivers\Driver
      */