interface/modules/zend_modules/library/Zend/Permissions/Rbac/RoleInterface.php

   1 <?php
   2 /**
   3  * Zend Framework (http://framework.zend.com/)
   4  *
   5  * @link      http://github.com/zendframework/zf2 for the canonical source repository
   6  * @copyright Copyright (c) 2005-2013 Zend Technologies USA Inc. (http://www.zend.com)
   7  * @license   http://framework.zend.com/license/new-bsd New BSD License
   8  */
   9
  10 namespace Zend\Permissions\Rbac;
  11
  12 use RecursiveIterator;
  13
  14 interface RoleInterface extends RecursiveIterator
  15 {
  16     /**
  17      * Get the name of the role.
  18      *
  19      * @return string
  20      */
  21     public function getName();
  22
  23     /**
  24      * Add permission to the role.
  25      *
  26      * @param $name
  27      * @return RoleInterface
  28      */
  29     public function addPermission($name);
  30
  31     /**
  32      * Checks if a permission exists for this role or any child roles.
  33      *
  34      * @param  string $name
  35      * @return bool
  36      */
  37     public function hasPermission($name);
  38
  39     /**
  40      * Add a child.
  41      *
  42      * @param  RoleInterface|string $child
  43      * @return Role
  44      */
  45     public function addChild($child);
  46
  47     /**
  48      * @param  RoleInterface $parent
  49      * @return RoleInterface
  50      */
  51     public function setParent($parent);
  52
  53     /**
  54      * @return null|RoleInterface
  55      */
  56     public function getParent();
  57 }