missing comments in civi dir
authorEileen McNaughton <eileen@fuzion.co.nz>
Sat, 24 May 2014 03:22:47 +0000 (15:22 +1200)
committerEileen McNaughton <eileen@fuzion.co.nz>
Sat, 24 May 2014 05:59:33 +0000 (17:59 +1200)
21 files changed:
Civi/API/Event/AuthorizeEvent.php
Civi/API/Event/Event.php
Civi/API/Event/ExceptionEvent.php
Civi/API/Event/PrepareEvent.php
Civi/API/Event/ResolveEvent.php
Civi/API/Event/RespondEvent.php
Civi/API/Exception/NotImplementedException.php
Civi/API/Exception/UnauthorizedException.php
Civi/API/Kernel.php
Civi/API/Provider/AdhocProvider.php
Civi/API/Provider/MagicFunctionProvider.php
Civi/API/Provider/ReflectionProvider.php
Civi/API/Request.php
Civi/API/Subscriber/APIv3SchemaAdapter.php
Civi/API/Subscriber/ChainSubscriber.php
Civi/API/Subscriber/I18nSubscriber.php
Civi/API/Subscriber/PermissionCheck.php
Civi/API/Subscriber/TransactionSubscriber.php
Civi/API/Subscriber/WrapperAdapter.php
Civi/API/Subscriber/XDebugSubscriber.php
Civi/Core/Container.php

index 42b814db9aa512ca24568be4af14c9e0707b4f45..dbe6cc17b9aacb9c531833b15e9a76e51d4f62a8 100644 (file)
 
 namespace Civi\API\Event;
 
+/**
+ * Class AuthorizeEvent
+ * @package Civi\API\Event
+ */
 class AuthorizeEvent extends Event {
   /**
    * @var bool
index 2c521673c2f3732ebc794a45808f838d8a194b98..0fab1eda3a7c2de58d868980bd5fafc337c8793a 100644 (file)
 
 namespace Civi\API\Event;
 
+/**
+ * Class Event
+ * @package Civi\API\Event
+ */
 class Event extends \Symfony\Component\EventDispatcher\Event {
   /**
    * @var \Civi\API\Provider\ProviderInterface
@@ -38,6 +42,10 @@ class Event extends \Symfony\Component\EventDispatcher\Event {
    */
   protected $apiRequest;
 
+  /**
+   * @param $apiProvider
+   * @param $apiRequest
+   */
   function __construct($apiProvider, $apiRequest) {
     $this->apiProvider = $apiProvider;
     $this->apiRequest = $apiRequest;
index c7771eefbfe8c643002ec8644314db40e385a0ad..d80425ef86cade3fe92b38ad2ca61ea94a8ff0c8 100644 (file)
 
 namespace Civi\API\Event;
 
+/**
+ * Class ExceptionEvent
+ * @package Civi\API\Event
+ */
 class ExceptionEvent extends Event {
 
   /**
@@ -34,6 +38,11 @@ class ExceptionEvent extends Event {
    */
   private $exception;
 
+  /**
+   * @param $exception
+   * @param $apiProvider
+   * @param $apiRequest
+   */
   function __construct($exception, $apiProvider, $apiRequest) {
     $this->exception = $exception;
     parent::__construct($apiProvider, $apiRequest);
index f7cf7dceaa63762bcd57076c417bfa2d525bf1f8..5ee84f1f96b98504205c5fffee7f4fe11381777b 100644 (file)
 
 namespace Civi\API\Event;
 
+/**
+ * Class PrepareEvent
+ * @package Civi\API\Event
+ */
 class PrepareEvent extends Event {
   /**
    * @param array $apiRequest
index 849ade21315db4537afc317050384de71e0b1451..c62d40751aaec73faf1c412428cda6078884764c 100644 (file)
 
 namespace Civi\API\Event;
 
+/**
+ * Class ResolveEvent
+ * @package Civi\API\Event
+ */
 class ResolveEvent extends Event {
+  /**
+   * @param $apiRequest
+   */
   function __construct($apiRequest) {
     parent::__construct(NULL, $apiRequest);
   }
index e8fb548aa510540f6d22cbe5a757f1a666aa3d08..58a7aa7c3587121edeb669c6518d235686aabe54 100644 (file)
 
 namespace Civi\API\Event;
 
+/**
+ * Class RespondEvent
+ * @package Civi\API\Event
+ */
 class RespondEvent extends Event {
   /**
    * @var mixed
    */
   private $response;
 
+  /**
+   * @param $apiProvider
+   * @param $apiRequest
+   * @param $response
+   */
   function __construct($apiProvider, $apiRequest, $response) {
     $this->response = $response;
     parent::__construct($apiProvider, $apiRequest);
index 69db92e02fb6b9232990296a3a030466f29a8e8b..68ca54478a42b3080026de73bb8d1cf3c215df2c 100644 (file)
@@ -2,8 +2,18 @@
 namespace Civi\API\Exception;
 
 require_once 'api/Exception.php';
+
+/**
+ * Class NotImplementedException
+ * @package Civi\API\Exception
+ */
 class NotImplementedException extends \API_Exception {
+  /**
+   * @param string $message
+   * @param array $extraParams
+   * @param Exception $previous
+   */
   public function __construct($message, $extraParams = array(), Exception $previous = NULL) {
     parent::__construct($message, \API_Exception::NOT_IMPLEMENTED, $extraParams, $previous);
   }
-}
\ No newline at end of file
+}
index 5595dcf7a18fce7a68dae9b108cf8ab51dafab01..7162a04f74343858deac44533d93ed346dfb93bb 100644 (file)
@@ -2,8 +2,18 @@
 namespace Civi\API\Exception;
 
 require_once 'api/Exception.php';
+
+/**
+ * Class UnauthorizedException
+ * @package Civi\API\Exception
+ */
 class UnauthorizedException extends \API_Exception {
+  /**
+   * @param string $message
+   * @param array $extraParams
+   * @param Exception $previous
+   */
   public function __construct($message, $extraParams = array(), Exception $previous = NULL) {
     parent::__construct($message, \API_Exception::UNAUTHORIZED, $extraParams, $previous);
   }
-}
\ No newline at end of file
+}
index c8dacea8fc4f68e48837cbe31cbb9fd521543f4b..59f5e6c5973a94af8aa27309ac3e43c46105a75a 100644 (file)
@@ -51,6 +51,10 @@ class Kernel {
    */
   protected $apiProviders;
 
+  /**
+   * @param $dispatcher
+   * @param array $apiProviders
+   */
   function __construct($dispatcher, $apiProviders = array()) {
     $this->apiProviders = $apiProviders;
     $this->dispatcher = $dispatcher;
@@ -359,4 +363,4 @@ class Kernel {
     $this->dispatcher = $dispatcher;
     return $this;
   }
-}
\ No newline at end of file
+}
index 47e0cde49489fee9b5f67b8b8f63faaa51352a56..e5a5d7a407722985f6a809880c6242d768598e2f 100644 (file)
@@ -34,6 +34,9 @@ use Symfony\Component\EventDispatcher\EventSubscriberInterface;
  */
 class AdhocProvider implements EventSubscriberInterface, ProviderInterface {
 
+  /**
+   * @return array
+   */
   public static function getSubscribedEvents() {
     return array(
       Events::RESOLVE => array(
@@ -83,6 +86,9 @@ class AdhocProvider implements EventSubscriberInterface, ProviderInterface {
     return $this;
   }
 
+  /**
+   * @param \Civi\API\Event\ResolveEvent $event
+   */
   public function onApiResolve(\Civi\API\Event\ResolveEvent $event) {
     $apiRequest = $event->getApiRequest();
     if ($this->matchesRequest($apiRequest)) {
@@ -92,6 +98,9 @@ class AdhocProvider implements EventSubscriberInterface, ProviderInterface {
     }
   }
 
+  /**
+   * @param \Civi\API\Event\AuthorizeEvent $event
+   */
   public function onApiAuthorize(\Civi\API\Event\AuthorizeEvent $event) {
     $apiRequest = $event->getApiRequest();
     if ($this->matchesRequest($apiRequest) && \CRM_Core_Permission::check($this->actions[strtolower($apiRequest['action'])]['perm'])) {
@@ -126,7 +135,12 @@ class AdhocProvider implements EventSubscriberInterface, ProviderInterface {
     }
   }
 
+  /**
+   * @param $apiRequest
+   *
+   * @return bool
+   */
   public function matchesRequest($apiRequest) {
     return $apiRequest['entity'] == $this->entity && $apiRequest['version'] == $this->version && isset($this->actions[strtolower($apiRequest['action'])]);
   }
-}
\ No newline at end of file
+}
index f3162041b5e67d449ff55c26bce03ca60ac31bb8..83d250659de2108dce757e20d8981224f153d51b 100644 (file)
@@ -34,6 +34,9 @@ use Symfony\Component\EventDispatcher\EventSubscriberInterface;
  * conventions.
  */
 class MagicFunctionProvider implements EventSubscriberInterface, ProviderInterface {
+  /**
+   * @return array
+   */
   public static function getSubscribedEvents() {
     return array(
       Events::RESOLVE => array(
@@ -47,10 +50,16 @@ class MagicFunctionProvider implements EventSubscriberInterface, ProviderInterfa
    */
   private $cache;
 
+  /**
+   *
+   */
   function __construct() {
     $this->cache = array();
   }
 
+  /**
+   * @param \Civi\API\Event\ResolveEvent $event
+   */
   public function onApiResolve(\Civi\API\Event\ResolveEvent $event) {
     $apiRequest = $event->getApiRequest();
     $resolved = $this->resolve($apiRequest);
index addaa3145dddb793301ee3846b3fed2d289be2ab..676458faea696201e9196db6ec19609ea24dd0c1 100644 (file)
@@ -33,6 +33,9 @@ use Symfony\Component\EventDispatcher\EventSubscriberInterface;
  * This class defines operations for inspecting the API's metadata.
  */
 class ReflectionProvider implements EventSubscriberInterface, ProviderInterface {
+  /**
+   * @return array
+   */
   public static function getSubscribedEvents() {
     return array(
       Events::RESOLVE => array(
@@ -65,6 +68,9 @@ class ReflectionProvider implements EventSubscriberInterface, ProviderInterface
     );
   }
 
+  /**
+   * @param \Civi\API\Event\ResolveEvent $event
+   */
   public function onApiResolve(\Civi\API\Event\ResolveEvent $event) {
     $apiRequest = $event->getApiRequest();
     $actions = isset($this->actions[$apiRequest['entity']]) ? $this->actions[$apiRequest['entity']] : $this->actions['*'];
@@ -76,6 +82,9 @@ class ReflectionProvider implements EventSubscriberInterface, ProviderInterface
     }
   }
 
+  /**
+   * @param \Civi\API\Event\AuthorizeEvent $event
+   */
   public function onApiAuthorize(\Civi\API\Event\AuthorizeEvent $event) {
     $apiRequest = $event->getApiRequest();
     if (isset($apiRequest['is_metadata'])) {
@@ -118,4 +127,4 @@ class ReflectionProvider implements EventSubscriberInterface, ProviderInterface
   function getActionNames($version, $entity) {
     return isset($this->actions[$entity]) ? $this->actions[$entity] : $this->actions['*'];
   }
-}
\ No newline at end of file
+}
index 3c6586c8b2f4f7a4e8d8bcfa0191c71d82fa91c4..feded2985571ebede9423828ebc1cc08a66da39e 100644 (file)
 */
 namespace Civi\API;
 
+/**
+ * Class Request
+ * @package Civi\API
+ */
 class Request {
   private static $nextId = 1;
 
index 54d5550737348ce3e14b16a91b91f6f3fc2df56e..904926e4367808a55d18fff8b7a0e6778760f502 100644 (file)
@@ -34,6 +34,9 @@ use Symfony\Component\EventDispatcher\EventSubscriberInterface;
  * and validates that the fields are provided correctly.
  */
 class APIv3SchemaAdapter implements EventSubscriberInterface {
+  /**
+   * @return array
+   */
   public static function getSubscribedEvents() {
     return array(
       Events::PREPARE => array(
@@ -43,6 +46,11 @@ class APIv3SchemaAdapter implements EventSubscriberInterface {
     );
   }
 
+  /**
+   * @param \Civi\API\Event\PrepareEvent $event
+   *
+   * @throws \API_Exception
+   */
   public function onApiPrepare(\Civi\API\Event\PrepareEvent $event) {
     $apiRequest = $event->getApiRequest();
     if ($apiRequest['version'] > 3) {
@@ -63,6 +71,11 @@ class APIv3SchemaAdapter implements EventSubscriberInterface {
     $event->setApiRequest($apiRequest);
   }
 
+  /**
+   * @param \Civi\API\Event\Event $event
+   *
+   * @throws \Exception
+   */
   public function onApiPrepare_validate(\Civi\API\Event\Event $event) {
      $apiRequest = $event->getApiRequest();
     // Not sure why this is omitted for generic actions. It would make sense to omit 'getfields', but that's only one generic action.
@@ -100,4 +113,4 @@ class APIv3SchemaAdapter implements EventSubscriberInterface {
     }
     return $required;
   }
-}
\ No newline at end of file
+}
index 5c4549feff4f80a25c8e8b9eac89aa6c1715c608..c21192ae85da7fc5c050d0acb416859e583713e8 100644 (file)
@@ -47,12 +47,20 @@ use Symfony\Component\EventDispatcher\EventSubscriberInterface;
  * API call (and passes some extra context -- eg Amy's contact_id).
  */
 class ChainSubscriber implements EventSubscriberInterface {
+  /**
+   * @return array
+   */
   public static function getSubscribedEvents() {
     return array(
       Events::RESPOND => array('onApiRespond', Events::W_EARLY),
     );
   }
 
+  /**
+   * @param \Civi\API\Event\RespondEvent $event
+   *
+   * @throws \Exception
+   */
   public function onApiRespond(\Civi\API\Event\RespondEvent $event) {
     $apiRequest = $event->getApiRequest();
     $result = $event->getResponse();
@@ -166,4 +174,4 @@ class ChainSubscriber implements EventSubscriberInterface {
     }
   }
 
-}
\ No newline at end of file
+}
index f920c442063b40661f5df13861b35583f9192b03..c5d36e6c24395b086340d0761de391dda3e33a05 100644 (file)
@@ -29,13 +29,25 @@ namespace Civi\API\Subscriber;
 use Civi\API\Events;
 use Symfony\Component\EventDispatcher\EventSubscriberInterface;
 
+/**
+ * Class I18nSubscriber
+ * @package Civi\API\Subscriber
+ */
 class I18nSubscriber implements EventSubscriberInterface {
+  /**
+   * @return array
+   */
   public static function getSubscribedEvents() {
     return array(
       Events::PREPARE => array('onApiPrepare', Events::W_MIDDLE)
     );
   }
 
+  /**
+   * @param \Civi\API\Event\Event $event
+   *
+   * @throws \API_Exception
+   */
   public function onApiPrepare(\Civi\API\Event\Event $event) {
     $apiRequest = $event->getApiRequest();
 
index 00bc3fef88c6c63ca96229a7302975c191d04359..4ead4938f3d3122ba8f268b1a006fef1ad17709d 100644 (file)
@@ -34,6 +34,9 @@ use Symfony\Component\EventDispatcher\EventSubscriberInterface;
  * permissions specified in Civi\API\Annotation\Permission.
  */
 class PermissionCheck implements EventSubscriberInterface {
+  /**
+   * @return array
+   */
   public static function getSubscribedEvents() {
     return array(
       Events::AUTHORIZE => array(
@@ -42,6 +45,11 @@ class PermissionCheck implements EventSubscriberInterface {
     );
   }
 
+  /**
+   * @param \Civi\API\Event\AuthorizeEvent $event
+   *
+   * @throws \Civi\API\Exception\UnauthorizedException
+   */
   public function onApiAuthorize(\Civi\API\Event\AuthorizeEvent $event) {
     $apiRequest = $event->getApiRequest();
     if ($apiRequest['version'] < 4) {
@@ -74,4 +82,4 @@ class PermissionCheck implements EventSubscriberInterface {
       $event->stopPropagation();
     }
   }
-}
\ No newline at end of file
+}
index 71c84397369b8ba6e1af5eee3f22f0f5b4522367..9393f1dbc2bf7993639cf6751214f87069255ed4 100644 (file)
@@ -29,7 +29,14 @@ namespace Civi\API\Subscriber;
 use Civi\API\Events;
 use Symfony\Component\EventDispatcher\EventSubscriberInterface;
 
+/**
+ * Class TransactionSubscriber
+ * @package Civi\API\Subscriber
+ */
 class TransactionSubscriber implements EventSubscriberInterface {
+  /**
+   * @return array
+   */
   public static function getSubscribedEvents() {
     return array(
       Events::PREPARE => array('onApiPrepare', Events::W_EARLY),
@@ -86,4 +93,4 @@ class TransactionSubscriber implements EventSubscriberInterface {
       unset($this->transactions[$apiRequest['id']]);
     }
   }
-}
\ No newline at end of file
+}
index 9ea309dee0e1a94980751459254d9c11ca7d725c..48ba665e727e33dedae029d99dce75300c0f624d 100644 (file)
@@ -36,6 +36,9 @@ use Symfony\Component\EventDispatcher\EventSubscriberInterface;
  */
 class WrapperAdapter implements EventSubscriberInterface {
 
+  /**
+   * @return array
+   */
   public static function getSubscribedEvents() {
     return array(
       Events::PREPARE => array('onApiPrepare', Events::W_MIDDLE),
@@ -48,10 +51,16 @@ class WrapperAdapter implements EventSubscriberInterface {
    */
   protected $defaults;
 
+  /**
+   * @param array $defaults
+   */
   function __construct($defaults = array()) {
     $this->defaults = $defaults;
   }
 
+  /**
+   * @param \Civi\API\Event\PrepareEvent $event
+   */
   public function onApiPrepare(\Civi\API\Event\PrepareEvent $event) {
     $apiRequest = $event->getApiRequest();
 
@@ -63,6 +72,9 @@ class WrapperAdapter implements EventSubscriberInterface {
     $event->setApiRequest($apiRequest);
   }
 
+  /**
+   * @param \Civi\API\Event\RespondEvent $event
+   */
   public function onApiRespond(\Civi\API\Event\RespondEvent $event) {
     $apiRequest = $event->getApiRequest();
     $result = $event->getResponse();
@@ -86,4 +98,4 @@ class WrapperAdapter implements EventSubscriberInterface {
     }
     return $apiRequest['wrappers'];
   }
-}
\ No newline at end of file
+}
index af23ecf41ddcde6d31a21673763829ca03b73ff0..46b03c9c5e6795c2552f063a5cfce8f1a15fa25f 100644 (file)
@@ -29,13 +29,23 @@ namespace Civi\API\Subscriber;
 use Civi\API\Events;
 use Symfony\Component\EventDispatcher\EventSubscriberInterface;
 
+/**
+ * Class XDebugSubscriber
+ * @package Civi\API\Subscriber
+ */
 class XDebugSubscriber implements EventSubscriberInterface {
+  /**
+   * @return array
+   */
   public static function getSubscribedEvents() {
     return array(
       Events::RESPOND => array('onApiRespond', Events::W_LATE),
     );
   }
 
+  /**
+   * @param \Civi\API\Event\RespondEvent $event
+   */
   function onApiRespond(\Civi\API\Event\RespondEvent $event) {
     $apiRequest = $event->getApiRequest();
     $result = $event->getResponse();
@@ -50,4 +60,4 @@ class XDebugSubscriber implements EventSubscriberInterface {
       $event->setResponse($result);
     }
   }
-}
\ No newline at end of file
+}
index eb0b13f11d5c8b01bc6761be50812a46f53a0ba5..504f206666ed38a2e0409d095b9b5eabf80ef752 100644 (file)
@@ -13,6 +13,10 @@ use Symfony\Component\DependencyInjection\Reference;
 
 // TODO use Symfony\Component\DependencyInjection\Loader\YamlFileLoader;
 
+/**
+ * Class Container
+ * @package Civi\Core
+ */
 class Container {
 
   const SELF = 'civi_container_factory';