ExceptionThrowerService added.

Author: fabiankessler

src/org/nameapi/client/services/ServiceFactory.php

@@ -6,6 +6,7 @@
 
 require_once(__DIR__.'/BaseService.php');
 require_once(__DIR__.'/Host.php');
+require_once(__DIR__.'/development/DevelopmentServiceFactory.php');
 require_once(__DIR__.'/system/SystemServiceFactory.php');
 require_once(__DIR__.'/parser/ParserServiceFactory.php');
 require_once(__DIR__.'/genderizer/GenderizerServiceFactory.php');
@@ -51,6 +52,7 @@ class ServiceFactory {
      */
     private $baseUrl;
 
+    private $developmentServiceFactory;
     private $systemServiceFactory;
     private $parserServiceFactory;
     private $genderizerServiceFactory;
@@ -83,6 +85,16 @@ public function __construct($apiKey, Context $context, Host $host=null, $apiVers
     }
 
 
+    /**
+     * @return development\DevelopmentServiceFactory
+     */
+    public function developmentServices() {
+        if ($this->developmentServiceFactory==null) {
+            $this->developmentServiceFactory = new development\DevelopmentServiceFactory($this->apiKey, $this->context, $this->baseUrl);
+        }
+        return $this->developmentServiceFactory;
+    }
+
     /**
      * @return system\SystemServiceFactory
      */

src/org/nameapi/client/services/development/DevelopmentServiceFactory.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace org\nameapi\client\services\development;
+
+use org\nameapi\client\services\development\exceptionthrower\ExceptionThrowerService;
+use org\nameapi\ontology\input\context\Context;
+
+require_once(__DIR__.'/exceptionthrower/ExceptionThrowerService.php');
+
+
+/**
+ * Provides access to the system-related services.
+ */
+class DevelopmentServiceFactory {
+
+    private $apiKey;
+    private $context;
+    private $baseUrl;
+    private $exceptionThrowerService;
+
+    /**
+     */
+    public function __construct($apiKey, Context $context, $baseUrl) {
+        $this->apiKey = $apiKey;
+        $this->context = $context;
+        $this->baseUrl = $baseUrl;
+    }
+
+    /**
+     * @return ExceptionThrowerService
+     * @since v5.0
+     */
+    public function exceptionThrower() {
+        if ($this->exceptionThrowerService==null) {
+            $this->exceptionThrowerService = new ExceptionThrowerService($this->apiKey, $this->context, $this->baseUrl);
+        }
+        return $this->exceptionThrowerService;
+    }
+
+}

src/org/nameapi/client/services/development/exceptionthrower/ExceptionThrowerService.php

@@ -0,0 +1,53 @@
+<?php
+
+namespace org\nameapi\client\services\development\exceptionthrower;
+
+use org\nameapi\client\fault\ServiceException;
+use org\nameapi\client\services\BaseService;
+use org\nameapi\ontology\input\context\Context;
+
+
+/**
+ * This is the service class for the web service offered at
+ * http://api.nameapi.org/rest/v5.0/development/exceptionthrower
+ *
+ * <p>The use is for development only; to see what happens when the server throws exceptions, and how they arrive
+ * at your end.</p>
+ *
+ * HOW TO USE:
+ * $exceptionThrower = $myServiceFactory->developmentServices()->exceptionThrowerService();
+ * $exceptionThrower = $ping->throwException();
+ */
+class ExceptionThrowerService extends BaseService {
+
+
+    private static $RESOURCE_PATH = "development/exceptionthrower";
+
+    public function __construct($apiKey, Context $context, $baseUrl) {
+        parent::__construct($apiKey, $context, $baseUrl);
+    }
+
+    /**
+     * @param string $exceptionType   One of 'AccessDeniedNoSuchAccount', 'InvalidInput', 'InternalServerError'
+     * @param int $exceptionChance    0-100 where 100 means always
+     * @return string                 'OK' in case the remote service does not throw.
+     * @throws ServiceException
+     */
+    public function throwException($exceptionType, $exceptionChance) {
+        $queryParams = array(
+            'exceptionType'   => $exceptionType,
+            'exceptionChance' => $exceptionChance,
+        );
+        $headerParams = array();
+
+        list($response, $httpResponseData) = $this->restHttpClient->callApiGet(
+            ExceptionThrowerService::$RESOURCE_PATH,
+            $queryParams, $headerParams
+        );
+        if ($response !== 'OK') {
+            throw $this->unmarshallingFailed($response, $httpResponseData);
+        }
+        return $response;
+    }
+
+}