feat(annotations): add allowEmpty parameter to #[RequestParam] attribute

README.md

@@ -71,7 +71,7 @@ With well-established PHP HTTP libraries available, you might wonder why this on
 - **HTTP Method Support**: Support for all standard HTTP methods (GET, POST, PUT, DELETE, etc.)
 - **Content Type Handling**: Support for `application/json`, `application/x-www-form-urlencoded`, and `multipart/form-data`
 - **Object Mapping**: Automatic mapping of request parameters to PHP objects
-- **Comprehensive Testing**: Built-in testing utilities with `APITestCase` class
+- **Comprehensive Testing**: Built-in testing utilities with `ServiceTestCase` class
 - **Error Handling**: Structured error responses with appropriate HTTP status codes
 - **Stream Support**: Custom input/output stream handling for advanced use cases
 
@@ -424,6 +424,21 @@ public function getData(int $id, ?string $name): array {
 }
 ```
 
+### Allowing Empty Strings
+
+By default, sending an empty string for a string parameter results in a validation error. Use `allowEmpty: true` in the `#[RequestParam]` attribute to accept empty strings:
+
+```php
+#[PostMapping]
+#[ResponseBody]
+#[RequestParam(name: 'notes', type: ParamType::STRING, optional: true, allowEmpty: true)]
+public function create(?string $notes): array {
+    return ['notes' => $notes ?? ''];
+}
+```
+
+This is the attribute equivalent of `ParamOption::EMPTY => true` in the array-based approach.
+
 ### Reusable Parameter Sets
 
 Implement the `ParameterSet` interface to group related parameters:
@@ -533,36 +548,30 @@ return new ResponseEntity($body, 418, 'text/plain');
 
 ## Testing
 
-### Using APITestCase
+### Using ServiceTestCase
 
 ```php
 <?php
-use WebFiori\Http\APITestCase;
+use WebFiori\Http\Test\ServiceTestCase;
 
-class MyServiceTest extends APITestCase {
+class MyServiceTest extends ServiceTestCase {
     public function testGetRequest() {
-        $manager = new WebServicesManager();
-        $manager->addService(new MyService());
-
-        $response = $this->getRequest($manager, 'my-service', [
+        $this->get(new MyService(), [
             'param1' => 'value1',
             'param2' => 'value2'
-        ]);
-
-        $this->assertJson($response);
-        $this->assertContains('success', $response);
+        ])
+            ->assertOk()
+            ->assertJson()
+            ->assertBodyContains('success');
     }
 
     public function testPostRequest() {
-        $manager = new WebServicesManager();
-        $manager->addService(new MyService());
-
-        $response = $this->postRequest($manager, 'my-service', [
+        $this->post(new MyService(), [
             'name' => 'John Doe',
             'email' => 'john@example.com'
-        ]);
-
-        $this->assertJson($response);
+        ])
+            ->assertOk()
+            ->assertJson();
     }
 }
 ```

WebFiori/Http/Annotations/RequestParam.php

@@ -24,7 +24,8 @@ public function __construct(
         public readonly mixed $filter = null,
         public readonly array $allowedValues = [],
         public readonly ?string $pattern = null,
-        public readonly ?string $message = null
+        public readonly ?string $message = null,
+        public readonly bool $allowEmpty = false
     ) {
     }
 }

WebFiori/Http/WebService.php

@@ -372,6 +372,11 @@ public function checkMethodAuthorization(): bool {
             return SecurityContext::isAuthenticated();
         }
 
+        // If class has #[AllowAnonymous], allow access
+        if (!$this->isAuthRequired()) {
+            return true;
+        }
+
         return $this->isAuthorized();
     }
 
@@ -1641,6 +1646,9 @@ private function configureParametersFromMethod(\ReflectionMethod $method): void
             if ($param->message !== null) {
                 $options[ParamOption::MESSAGE] = $param->message;
             }
+            if ($param->allowEmpty) {
+                $options[ParamOption::EMPTY] = true;
+            }
 
             $this->addParameters([
                 $param->name => $options

examples/00-basic/01-hello-world/index.php

@@ -1,16 +1,9 @@
 <?php
 
-use WebFiori\Http\WebServicesManager;
+use WebFiori\Http\RequestProcessor;
 
 require_once '../../../vendor/autoload.php';
+require_once 'HelloService.php';
 
-// Create and configure the services manager
-$manager = new WebServicesManager();
-$manager->setVersion('1.0.0');
-$manager->setDescription('Hello World API Example');
-
-// Auto-discover and register services
-$manager->autoDiscoverServices();
-
-// Process the incoming request
-$manager->process();
+$processor = new RequestProcessor();
+$processor->process(new HelloService());

examples/00-basic/02-with-parameters/index.php

@@ -1,16 +1,9 @@
 <?php
 
-use WebFiori\Http\WebServicesManager;
+use WebFiori\Http\RequestProcessor;
 
 require_once '../../../vendor/autoload.php';
+require_once 'GreetingService.php';
 
-// Create and configure the services manager
-$manager = new WebServicesManager();
-$manager->setVersion('1.0.0');
-$manager->setDescription('Greeting API with Parameters');
-
-// Auto-discover and register services
-$manager->autoDiscoverServices();
-
-// Process the incoming request
-$manager->process();
+$processor = new RequestProcessor();
+$processor->process(new GreetingService());

examples/00-basic/03-multiple-methods/index.php

@@ -1,16 +1,9 @@
 <?php
 
-use WebFiori\Http\WebServicesManager;
+use WebFiori\Http\RequestProcessor;
 
 require_once '../../../vendor/autoload.php';
+require_once 'TaskService.php';
 
-// Create and configure the services manager
-$manager = new WebServicesManager();
-$manager->setVersion('1.0.0');
-$manager->setDescription('Task Management API');
-
-// Auto-discover and register services
-$manager->autoDiscoverServices();
-
-// Process the incoming request
-$manager->process();
+$processor = new RequestProcessor();
+$processor->process(new TaskService());

examples/01-core/01-parameter-validation/index.php

@@ -1,16 +1,9 @@
 <?php
 
-use WebFiori\Http\WebServicesManager;
+use WebFiori\Http\RequestProcessor;
 
 require_once '../../../vendor/autoload.php';
+require_once 'ValidationService.php';
 
-// Create and configure the services manager
-$manager = new WebServicesManager();
-$manager->setVersion('1.0.0');
-$manager->setDescription('Parameter Validation API');
-
-// Auto-discover and register services
-$manager->autoDiscoverServices();
-
-// Process the incoming request
-$manager->process();
+$processor = new RequestProcessor();
+$processor->process(new ValidationService());

examples/01-core/02-error-handling/index.php

@@ -1,16 +1,9 @@
 <?php
 
-use WebFiori\Http\WebServicesManager;
+use WebFiori\Http\RequestProcessor;
 
 require_once '../../../vendor/autoload.php';
+require_once 'ErrorService.php';
 
-// Create and configure the services manager
-$manager = new WebServicesManager();
-$manager->setVersion('1.0.0');
-$manager->setDescription('Error Handling API');
-
-// Auto-discover and register services
-$manager->autoDiscoverServices();
-
-// Process the incoming request
-$manager->process();
+$processor = new RequestProcessor();
+$processor->process(new ErrorService());

examples/01-core/03-json-requests/index.php

@@ -1,16 +1,9 @@
 <?php
 
-use WebFiori\Http\WebServicesManager;
+use WebFiori\Http\RequestProcessor;
 
 require_once '../../../vendor/autoload.php';
+require_once 'JsonService.php';
 
-// Create and configure the services manager
-$manager = new WebServicesManager();
-$manager->setVersion('1.0.0');
-$manager->setDescription('JSON Request Handling API');
-
-// Auto-discover and register services
-$manager->autoDiscoverServices();
-
-// Process the incoming request
-$manager->process();
+$processor = new RequestProcessor();
+$processor->process(new JsonService());

examples/01-core/04-file-uploads/index.php

@@ -1,16 +1,9 @@
 <?php
 
-use WebFiori\Http\WebServicesManager;
+use WebFiori\Http\RequestProcessor;
 
 require_once '../../../vendor/autoload.php';
+require_once 'UploadService.php';
 
-// Create and configure the services manager
-$manager = new WebServicesManager();
-$manager->setVersion('1.0.0');
-$manager->setDescription('File Upload API');
-
-// Auto-discover and register services
-$manager->autoDiscoverServices();
-
-// Process the incoming request
-$manager->process();
+$processor = new RequestProcessor();
+$processor->process(new UploadService());

examples/01-core/06-allowed-values-and-pattern/index.php

@@ -3,8 +3,7 @@
 require_once '../../../vendor/autoload.php';
 require_once 'OrderService.php';
 
-use WebFiori\Http\WebServicesManager;
+use WebFiori\Http\RequestProcessor;
 
-$manager = new WebServicesManager();
-$manager->addService(new OrderService());
-$manager->process();
+$processor = new RequestProcessor();
+$processor->process(new OrderService());

examples/02-security/01-basic-auth/index.php

@@ -1,16 +1,9 @@
 <?php
 
-use WebFiori\Http\WebServicesManager;
+use WebFiori\Http\RequestProcessor;
 
 require_once '../../../vendor/autoload.php';
+require_once 'BasicAuthService.php';
 
-// Create and configure the services manager
-$manager = new WebServicesManager();
-$manager->setVersion('1.0.0');
-$manager->setDescription('Basic Authentication API');
-
-// Auto-discover and register services
-$manager->autoDiscoverServices();
-
-// Process the incoming request
-$manager->process();
+$processor = new RequestProcessor();
+$processor->process(new BasicAuthService());

examples/03-annotations/01-rest-controller/TaskService.php

@@ -20,6 +20,7 @@
  * - Dynamic HTTP status codes via ResponseEntity
  */
 #[RestController('tasks', 'Task management service')]
+#[AllowAnonymous]
 class TaskService extends WebService {
 
     private array $tasks = [
@@ -30,11 +31,9 @@ class TaskService extends WebService {
 
     #[GetMapping]
     #[ResponseBody]
-    #[AllowAnonymous]
     #[RequestParam('task-id', ParamType::INT, true)]
     public function getTask(?int $id): ResponseEntity {
         if ($id === null) {
-            // Return all tasks
             return ResponseEntity::ok(new Json(['tasks' => array_values($this->tasks)]));
         }
 
@@ -47,7 +46,6 @@ public function getTask(?int $id): ResponseEntity {
 
     #[PostMapping]
     #[ResponseBody]
-    #[AllowAnonymous]
     #[RequestParam('task-name', ParamType::STRING)]
     #[RequestParam('task-priority', ParamType::STRING, true)]
     public function createTask(string $name, ?string $priority): ResponseEntity {
@@ -63,7 +61,6 @@ public function createTask(string $name, ?string $priority): ResponseEntity {
 
     #[DeleteMapping]
     #[ResponseBody]
-    #[AllowAnonymous]
     #[RequestParam('task-id', ParamType::INT)]
     public function deleteTask(int $id): ResponseEntity {
         if (!isset($this->tasks[$id])) {
@@ -72,11 +69,4 @@ public function deleteTask(int $id): ResponseEntity {
 
         return ResponseEntity::noContent();
     }
-
-    public function isAuthorized(): bool {
-        return true;
-    }
-
-    public function processRequest() {
-    }
 }

examples/03-annotations/01-rest-controller/index.php

@@ -3,8 +3,7 @@
 require_once '../../../vendor/autoload.php';
 require_once 'TaskService.php';
 
-use WebFiori\Http\WebServicesManager;
+use WebFiori\Http\RequestProcessor;
 
-$manager = new WebServicesManager();
-$manager->addService(new TaskService());
-$manager->process();
+$processor = new RequestProcessor();
+$processor->process(new TaskService());

examples/03-annotations/02-allow-empty/NotesService.php

@@ -0,0 +1,34 @@
+<?php
+
+require_once '../../../vendor/autoload.php';
+
+use WebFiori\Http\Annotations\AllowAnonymous;
+use WebFiori\Http\Annotations\PostMapping;
+use WebFiori\Http\Annotations\RequestParam;
+use WebFiori\Http\Annotations\ResponseBody;
+use WebFiori\Http\Annotations\RestController;
+use WebFiori\Http\ParamType;
+use WebFiori\Http\WebService;
+
+/**
+ * Demonstrates using allowEmpty in #[RequestParam] to accept empty strings.
+ *
+ * Without allowEmpty: sending notes="" results in a 422 validation error.
+ * With allowEmpty: true, empty strings are accepted as valid input.
+ */
+#[RestController('notes', 'Notes service demonstrating allowEmpty')]
+#[AllowAnonymous]
+class NotesService extends WebService {
+
+    #[PostMapping]
+    #[ResponseBody]
+    #[RequestParam(name: 'title', type: ParamType::STRING)]
+    #[RequestParam(name: 'notes', type: ParamType::STRING, optional: true, allowEmpty: true)]
+    public function createNote(string $title, ?string $notes): array {
+        return [
+            'title' => $title,
+            'notes' => $notes ?? '',
+            'created_at' => date('Y-m-d H:i:s'),
+        ];
+    }
+}