registry: Add support for java.lang.reflect.Type

registry: Allow to bind List/Set/Map

- fix #3659
- fix #3660

Author: jknack

docs/asciidoc/dependency-injection.adoc

@@ -1,4 +1,4 @@
-== Dependency Injection
+=== Dependency Injection
 
 include::modules/avaje-inject.adoc[]
 

docs/asciidoc/di-dagger.adoc

@@ -1,4 +1,4 @@
-=== Dagger
+==== Dagger
 
 1) Add Dagger to your project
 
@@ -95,7 +95,7 @@ fun main(args: Array<String>) {
 Check out the https://dagger.dev/tutorial[Dagger tutorial] to learn more.
 ====
 
-==== MVC routes
+===== MVC routes
 
 Integration of MVC routes with Dagger is as simple as:
 

docs/asciidoc/extension.adoc

@@ -21,7 +21,7 @@ public class MyExtension implements Extension {
       DataSource dataSource = createDataSource();           <1>
 
       ServiceRegistry registry = application.getServices(); <2>
-      registry.put(DataSource.class, dataSource);           <3>
+      registry.put(MyDataSource.class, dataSource);         <3>
 
       application.onStop(dataSource::close)                 <4>
    }
@@ -38,15 +38,15 @@ class MyExtension: Extension {
     val dataSource = createDataSource()                     <1>
 
     val registry = application.services                     <2>
-    registry.put(DataSource::class, dataSource)             <3>
+    registry.put(MyDataSource::class, dataSource)           <3>
     application.onStop(dataSource::close)                   <4>
   }
 }
 ----
 
-<1> Create the service
-<2> Access to service registry
-<3> Add it to the service registry
+<1> Create the service (DataSource)
+<2> Access to the service registry
+<3> Save into the service registry
 <4> Close/release service on application stop
 
 Let's install the extension and use the service!!
@@ -86,12 +86,67 @@ class App: Kooby({
 <1> Install the extension
 <2> Use the service
 
-Services are accessible via javadoc:Registry[require, java.lang.Class].
+=== Collection of Services
+
+Adding a collection to the service registry is supported too.
+
+.List/Set
+[source,java]
+----
+import io.jooby.Extension;import io.jooby.Reified;
+
+public class Cats implements Extension {
+   
+   public void install(Jooby application) {
+      ServiceRegistry registry = application.getServices();
+      // as list
+      registry.listOf(Animal.class).add(new Cat());
+      // as set
+      registry.setOf(Animal.class).add(new Cat());
+      // as map
+      registry.mapOf(String.class, Animal.class).put("cat", new Cat());
+   }
+}
+
+public class Dogs implements Extension {
+   
+   public void install(Jooby application) {
+      ServiceRegistry registry = application.getServices();
+      // as list
+      registry.listOf(Animal.class).add(new Dog());
+      // as set
+      registry.setOf(Animal.class).add(new Dog());
+      // as map
+      registry.mapOf(String.class, Animal.class).put("dog", new Dog());
+   }
+}
+
+{
+  install(new Cats());
+  install(new Dogs());
+  // as list
+  get("/list", ctx -> {
+    return ctx.require(Reified.list(Animal.class));
+  });
+  // as set
+  get("/set", ctx -> {
+    return ctx.require(Reified.set(Animal.class));
+  });
+  // as map
+  get("/map", ctx -> {
+    return ctx.require(Reified.map(String.class, Animal.class));
+  });
+}
+----
+
+Services are accessible via javadoc:Registry[require, java.lang.Class] and integrated with
+dependency injection frameworks provided by Jooby like Guice and Avaje Inject. This mean they are
+accessible using the `jakarta.inject.Inject` annotation.
 
 In addition to services, an extension module may provides infrastructure routes, body decoder/encoder,
 template engines, etc.
 
 The extension mechanism is a simple way of reusing code and decoupling technical features from
-business logic. 
+business logic.
 
-More advanced techniques are describe in the <<Dependency Injection>> section.
+More advanced techniques are described in the next section.

docs/asciidoc/index.adoc

@@ -240,22 +240,22 @@ include::error-handler.adoc[]
 
 include::problem-details.adoc[]
 
-include::handlers.adoc[]
-
 include::configuration.adoc[]
 
+include::extension.adoc[]
+
+include::dependency-injection.adoc[]
+
 include::testing.adoc[]
 
 include::dev-tools.adoc[]
 
+include::handlers.adoc[]
+
 include::packaging/packaging.adoc[]
 
 include::servers.adoc[]
 
-include::extension.adoc[]
-
-include::dependency-injection.adoc[]
-
 include::modules.adoc[]
 
 == Appendix

docs/asciidoc/modules/avaje-inject.adoc

@@ -1,4 +1,4 @@
-=== Avaje Inject
+==== Avaje Inject
 
 1) Add Avaje Inject to your project
 
@@ -89,7 +89,7 @@ fun main(args: Array<String>) {
 <1> Install Avaje Inject module
 <2> The javadoc:Jooby[require, java.lang.Class] call is now resolved by Avaje Inject
 
-==== Property Injection
+===== Property Injection
 
 Configuration properties can be injected using the `@Named` annotation. As Avaje checks beans at compile time, `@External` is required to prevent false-positive compilation errors:
 
@@ -122,7 +122,7 @@ class BillingService @Inject constructor(@External @Named("currency") currency:
 }
 ----
 
-==== MVC routes
+===== MVC routes
 
 Avaje Inject will also provisioning MVC routes
 

docs/asciidoc/modules/guice.adoc

@@ -1,4 +1,4 @@
-=== Guice
+==== Guice
 
 1) Add Guice dependency to your project:
 
@@ -52,7 +52,7 @@ fun main(args: Array<String>) {
 <1> Install Guice module
 <2> The javadoc:Jooby[require, java.lang.Class] call is now resolved by Guice
 
-==== Property Injection
+===== Property Injection
 
 Configuration properties can be injected using the `@Named` annotation:
 
@@ -87,7 +87,7 @@ class BillingService @Inject constructor(@Named("currency") currency: String) {
 }
 ----
 
-==== MVC routes
+===== MVC routes
 
 Guice will also provisioning MVC routes
 

jooby/src/main/java/io/jooby/DefaultContext.java

@@ -57,6 +57,16 @@ default <T> T require(@NonNull Class<T> type) throws RegistryException {
     return getRouter().require(type);
   }
 
+  @NonNull @Override
+  default <T> T require(@NonNull Reified<T> type) throws RegistryException {
+    return getRouter().require(type);
+  }
+
+  @NonNull @Override
+  default <T> T require(@NonNull Reified<T> type, @NonNull String name) throws RegistryException {
+    return getRouter().require(type, name);
+  }
+
   @NonNull @Override
   default <T> T require(@NonNull ServiceKey<T> key) throws RegistryException {
     return getRouter().require(key);

jooby/src/main/java/io/jooby/ForwardingContext.java

@@ -1324,6 +1324,16 @@ public <T> T require(@NonNull Class<T> type, @NonNull String name) throws Regist
     return ctx.require(type, name);
   }
 
+  @NonNull @Override
+  public <T> T require(@NonNull Reified<T> type) throws RegistryException {
+    return ctx.require(type);
+  }
+
+  @NonNull @Override
+  public <T> T require(@NonNull Reified<T> type, @NonNull String name) throws RegistryException {
+    return ctx.require(type, name);
+  }
+
   @NonNull @Override
   public <T> T require(@NonNull ServiceKey<T> key) throws RegistryException {
     return ctx.require(key);

jooby/src/main/java/io/jooby/Jooby.java

@@ -827,6 +827,16 @@ public <T> T require(@NonNull Class<T> type) {
     return require(ServiceKey.key(type));
   }
 
+  @NonNull @Override
+  public <T> T require(@NonNull Reified<T> type) throws RegistryException {
+    return require(ServiceKey.key(type));
+  }
+
+  @NonNull @Override
+  public <T> T require(@NonNull Reified<T> type, @NonNull String name) throws RegistryException {
+    return require(ServiceKey.key(type, name));
+  }
+
   @Override
   public @NonNull <T> T require(@NonNull ServiceKey<T> key) {
     ServiceRegistry services = getServices();
@@ -835,10 +845,7 @@ public <T> T require(@NonNull Class<T> type) {
       if (!registry.isSet()) {
         throw new RegistryException("Service not found: " + key);
       }
-      String name = key.getName();
-      return name == null
-          ? registry.get().require(key.getType())
-          : registry.get().require(key.getType(), name);
+      return registry.get().require(key);
     }
     return service;
   }

jooby/src/main/java/io/jooby/Registry.java

@@ -37,6 +37,27 @@ public interface Registry {
    */
   @NonNull <T> T require(@NonNull Class<T> type, @NonNull String name) throws RegistryException;
 
+  /**
+   * Provides an instance of the given type.
+   *
+   * @param type Object type.
+   * @param <T> Object type.
+   * @return Instance of this type.
+   * @throws RegistryException If there was a runtime failure while providing an instance.
+   */
+  @NonNull <T> T require(@NonNull Reified<T> type) throws RegistryException;
+
+  /**
+   * Provides an instance of the given type where name matches it.
+   *
+   * @param type Object type.
+   * @param name Object name.
+   * @param <T> Object type.
+   * @return Instance of this type.
+   * @throws RegistryException If there was a runtime failure while providing an instance.
+   */
+  @NonNull <T> T require(@NonNull Reified<T> type, @NonNull String name) throws RegistryException;
+
   /**
    * Provides an instance of the given type.
    *