add ApiException

src/ApiManager.php

@@ -23,6 +23,7 @@
 use Psr\Cache\CacheItemPoolInterface;
 use PSX\Api\Builder\SpecificationBuilder;
 use PSX\Api\Builder\SpecificationBuilderInterface;
+use PSX\Api\Exception\ApiException;
 use PSX\Api\Exception\InvalidApiException;
 use PSX\Api\Parser\Attribute\BuilderInterface;
 use PSX\Schema\Parser\ContextInterface;
@@ -41,6 +42,9 @@ class ApiManager implements ApiManagerInterface
     private CacheItemPoolInterface $cache;
     private bool $debug;
 
+    /**
+     * @var array<string, ParserInterface>
+     */
     private array $parsers = [];
 
     public function __construct(SchemaManagerInterface $schemaManager, BuilderInterface $builder, ?CacheItemPoolInterface $cache = null, bool $debug = false)
@@ -59,6 +63,9 @@ public function register(string $scheme, ParserInterface $parser): void
         $this->parsers[$scheme] = $parser;
     }
 
+    /**
+     * @throws ApiException
+     */
     public function getApi(string $source, ?ContextInterface $context = null): SpecificationInterface
     {
         $item = null;

src/Exception/ApiException.php

@@ -0,0 +1,32 @@
+<?php
+/*
+ * PSX is an open source PHP framework to develop RESTful APIs.
+ * For the current version and information visit <https://phpsx.org>
+ *
+ * Copyright (c) Christoph Kappestein <christoph.kappestein@gmail.com>
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+namespace PSX\Api\Exception;
+
+/**
+ * ApiException
+ *
+ * @author  Christoph Kappestein <christoph.kappestein@gmail.com>
+ * @license http://www.apache.org/licenses/LICENSE-2.0
+ * @link    https://phpsx.org
+ */
+class ApiException extends \Exception
+{
+}

src/Exception/ArgumentNotFoundException.php

@@ -27,6 +27,6 @@
  * @license http://www.apache.org/licenses/LICENSE-2.0
  * @link    https://phpsx.org
  */
-class ArgumentNotFoundException extends \Exception
+class ArgumentNotFoundException extends ApiException
 {
 }

src/Exception/GeneratorException.php

@@ -27,6 +27,6 @@
  * @license http://www.apache.org/licenses/LICENSE-2.0
  * @link    https://phpsx.org
  */
-class GeneratorException extends \Exception
+class GeneratorException extends ApiException
 {
 }

src/Exception/InvalidApiException.php

@@ -27,6 +27,6 @@
  * @license http://www.apache.org/licenses/LICENSE-2.0
  * @link    https://phpsx.org
  */
-class InvalidApiException extends \Exception
+class InvalidApiException extends ApiException
 {
 }

src/Exception/InvalidArgumentException.php

@@ -27,6 +27,6 @@
  * @license http://www.apache.org/licenses/LICENSE-2.0
  * @link    https://phpsx.org
  */
-class InvalidArgumentException extends \Exception
+class InvalidArgumentException extends ApiException
 {
 }

src/Exception/InvalidMethodException.php

@@ -27,6 +27,6 @@
  * @license http://www.apache.org/licenses/LICENSE-2.0
  * @link    https://phpsx.org
  */
-class InvalidMethodException extends \Exception
+class InvalidMethodException extends ApiException
 {
 }

src/Exception/InvalidOperationException.php

@@ -27,6 +27,6 @@
  * @license http://www.apache.org/licenses/LICENSE-2.0
  * @link    https://phpsx.org
  */
-class InvalidOperationException extends \Exception
+class InvalidOperationException extends ApiException
 {
 }

src/Exception/InvalidTypeException.php

@@ -27,6 +27,6 @@
  * @license http://www.apache.org/licenses/LICENSE-2.0
  * @link    https://phpsx.org
  */
-class InvalidTypeException extends \Exception
+class InvalidTypeException extends ApiException
 {
 }

src/Exception/OperationAlreadyExistsException.php

@@ -27,6 +27,6 @@
  * @license http://www.apache.org/licenses/LICENSE-2.0
  * @link    https://phpsx.org
  */
-class OperationAlreadyExistsException extends \Exception
+class OperationAlreadyExistsException extends ApiException
 {
 }

src/Exception/OperationNotFoundException.php

@@ -27,6 +27,6 @@
  * @license http://www.apache.org/licenses/LICENSE-2.0
  * @link    https://phpsx.org
  */
-class OperationNotFoundException extends \Exception
+class OperationNotFoundException extends ApiException
 {
 }

src/Exception/ParserException.php

@@ -27,6 +27,6 @@
  * @license http://www.apache.org/licenses/LICENSE-2.0
  * @link    https://phpsx.org
  */
-class ParserException extends \Exception
+class ParserException extends ApiException
 {
 }