Add possibility to explicitely pass target delegate and parameters

Author: thekid

ChangeLog.md

@@ -3,6 +3,9 @@ Web frontends change log
 
 ## ?.?.? / ????-??-??
 
+* Added possibility to explicitely pass target delegate and parameters
+  to frontend handling, bypassing the request URI based routing logic.
+  (@thekid)
 * Added accessors for delegates and templates to `Frontend` - @thekid
 * Merged PR #36: Migrate to new testing library - @thekid
 

src/main/php/web/frontend/Frontend.class.php

@@ -1,7 +1,7 @@
 <?php namespace web\frontend;
 
 use lang\reflect\TargetInvocationException;
-use web\{Error, Handler};
+use web\{Error, Handler, Request};
 
 /**
  * Annotation-based frontend
@@ -53,6 +53,23 @@ public function errors(): Errors { return $this->errors ?? $this->errors= new Ra
   /** Returns security */
   public function security(): Security { return $this->security ?? $this->security= new Security(); }
 
+  /**
+   * Selects a target for a given method and path
+   *
+   * @param  util.URI|web.Request|string $arg
+   * @return ?var[]
+   */
+  public function target($method, $arg= '/') {
+    if ($arg instanceof URI) {
+      $path= $arg->path();
+    } else if ($arg instanceof Request) {
+      $path= $arg->uri()->path();
+    } else {
+      $path= (string)$arg;
+    }
+    return $this->delegates->target($method, $path);
+  }
+
   /**
    * Determines view to be displayed, handling errors while going along.
    *

src/test/php/web/frontend/unittest/FrontendTest.class.php

@@ -3,7 +3,7 @@
 use lang\IllegalArgumentException;
 use test\{Assert, Before, Expect, Test, Values};
 use web\frontend\unittest\actions\Users;
-use web\frontend\{Exceptions, Frontend, RaiseErrors, Security, Templates, MethodsIn};
+use web\frontend\{Delegate, Exceptions, Frontend, RaiseErrors, Security, Templates, MethodsIn};
 
 class FrontendTest {
   private $templates;
@@ -74,4 +74,22 @@ public function security() {
     $s= new Security();
     Assert::equals($s, (new Frontend(new Users(), $this->templates))->enacting($s)->security());
   }
+
+  #[Test]
+  public function all_target() {
+    $users= new Users();
+    Assert::equals(
+      [new Delegate($users, 'all'), ['get/users']],
+      (new Frontend($users, $this->templates))->target('get', '/users')
+    );
+  }
+
+  #[Test]
+  public function find_target() {
+    $users= new Users();
+    Assert::equals(
+      [new Delegate($users, 'find'), [0 => 'get/users/me', 1 => 'me', 'id' => 'me']],
+      (new Frontend($users, $this->templates))->target('get', '/users/me')
+    );
+  }
 }