feat(metadata): throwOnNotFound option (#6027)

Author: soyuka

src/Metadata/ApiResource.php

@@ -978,6 +978,7 @@ public function __construct(
         protected ?bool $strictQueryParameterValidation = null,
         protected ?bool $hideHydraOperation = null,
         protected ?bool $jsonStream = null,
+        protected ?bool $throwOnNotFound = null,
         protected array $extraProperties = [],
         ?bool $map = null,
         protected ?array $mcp = null,
@@ -1026,6 +1027,7 @@ class: $class,
             strictQueryParameterValidation: $strictQueryParameterValidation,
             hideHydraOperation: $hideHydraOperation,
             jsonStream: $jsonStream,
+            throwOnNotFound: $throwOnNotFound,
             extraProperties: $extraProperties,
             map: $map,
         );

src/Metadata/Delete.php

@@ -102,6 +102,7 @@ public function __construct(
         ?bool $strictQueryParameterValidation = null,
         protected ?bool $hideHydraOperation = null,
         ?bool $jsonStream = null,
+        ?bool $throwOnNotFound = null,
         array $extraProperties = [],
         ?bool $map = null,
     ) {
@@ -187,6 +188,7 @@ class: $class,
             parameters: $parameters,
             strictQueryParameterValidation: $strictQueryParameterValidation,
             hideHydraOperation: $hideHydraOperation,
+            throwOnNotFound: $throwOnNotFound,
             stateOptions: $stateOptions,
             map: $map
         );

src/Metadata/Extractor/XmlResourceExtractor.php

@@ -149,6 +149,7 @@ private function buildBase(\SimpleXMLElement $resource): array
             'write' => $this->phpize($resource, 'write', 'bool'),
             'jsonStream' => $this->phpize($resource, 'jsonStream', 'bool'),
             'map' => $this->phpize($resource, 'map', 'bool'),
+            'throwOnNotFound' => $this->phpize($resource, 'throwOnNotFound', 'bool'),
         ];
     }
 

src/Metadata/Extractor/YamlResourceExtractor.php

@@ -176,6 +176,7 @@ private function buildBase(array $resource): array
             'write' => $this->phpize($resource, 'write', 'bool'),
             'jsonStream' => $this->phpize($resource, 'jsonStream', 'bool'),
             'map' => $this->phpize($resource, 'map', 'bool'),
+            'throwOnNotFound' => $this->phpize($resource, 'throwOnNotFound', 'bool'),
         ];
     }
 

src/Metadata/Extractor/schema/resources.xsd

@@ -526,6 +526,7 @@
         <xsd:attribute type="xsd:boolean" name="collectDenormalizationErrors"/>
         <xsd:attribute type="xsd:boolean" name="jsonStream"/>
         <xsd:attribute type="xsd:boolean" name="map"/>
+        <xsd:attribute type="xsd:boolean" name="throwOnNotFound"/>
     </xsd:attributeGroup>
 
     <xsd:attributeGroup name="extendedBase">

src/Metadata/Get.php

@@ -102,6 +102,7 @@ public function __construct(
         ?bool $strictQueryParameterValidation = null,
         protected ?bool $hideHydraOperation = null,
         ?bool $jsonStream = null,
+        ?bool $throwOnNotFound = null,
         array $extraProperties = [],
         ?bool $map = null,
     ) {
@@ -186,6 +187,7 @@ class: $class,
             strictQueryParameterValidation: $strictQueryParameterValidation,
             hideHydraOperation: $hideHydraOperation,
             jsonStream: $jsonStream,
+            throwOnNotFound: $throwOnNotFound,
             extraProperties: $extraProperties,
             map: $map
         );

src/Metadata/GetCollection.php

@@ -103,6 +103,7 @@ public function __construct(
         protected ?bool $hideHydraOperation = null,
         ?bool $jsonStream = null,
         array $extraProperties = [],
+        ?bool $throwOnNotFound = null,
         private ?string $itemUriTemplate = null,
         ?bool $map = null,
     ) {
@@ -181,6 +182,7 @@ class: $class,
             processor: $processor,
             parameters: $parameters,
             jsonStream: $jsonStream,
+            throwOnNotFound: $throwOnNotFound,
             extraProperties: $extraProperties,
             rules: $rules,
             policy: $policy,

src/Metadata/HttpOperation.php

@@ -222,6 +222,7 @@ public function __construct(
         array|string|null $middleware = null,
         ?bool $queryParameterValidationEnabled = null,
         ?bool $jsonStream = null,
+        ?bool $throwOnNotFound = null,
         array $extraProperties = [],
         ?bool $map = null,
     ) {
@@ -283,6 +284,7 @@ class: $class,
             strictQueryParameterValidation: $strictQueryParameterValidation,
             hideHydraOperation: $hideHydraOperation,
             jsonStream: $jsonStream,
+            throwOnNotFound: $throwOnNotFound,
             extraProperties: $extraProperties,
             map: $map
         );

src/Metadata/Metadata.php

@@ -82,6 +82,7 @@ public function __construct(
         protected ?bool $hideHydraOperation = null,
         protected ?bool $jsonStream = null,
         protected ?bool $map = null,
+        protected ?bool $throwOnNotFound = null,
         protected array $extraProperties = [],
     ) {
         if (\is_array($parameters) && $parameters) {
@@ -655,6 +656,19 @@ public function withMiddleware(string|array $middleware): static
         return $self;
     }
 
+    public function getThrowOnNotFound(): ?bool
+    {
+        return $this->throwOnNotFound;
+    }
+
+    public function withThrowOnNotFound(bool $throwOnNotFound): static
+    {
+        $self = clone $this;
+        $self->throwOnNotFound = $throwOnNotFound;
+
+        return $self;
+    }
+
     public function getExtraProperties(): ?array
     {
         return $this->extraProperties;

src/Metadata/Operation.php

@@ -814,6 +814,7 @@ public function __construct(
         protected ?bool $strictQueryParameterValidation = null,
         protected ?bool $hideHydraOperation = null,
         protected ?bool $jsonStream = null,
+        protected ?bool $throwOnNotFound = null,
         protected array $extraProperties = [],
         ?bool $map = null,
     ) {
@@ -862,6 +863,7 @@ class: $class,
             strictQueryParameterValidation: $strictQueryParameterValidation,
             hideHydraOperation: $hideHydraOperation,
             jsonStream: $jsonStream,
+            throwOnNotFound: $throwOnNotFound,
             extraProperties: $extraProperties,
             map: $map
         );