feature: support multiple application on single server #3645

- javadoc for Context.Selector

Author: jknack

jooby/src/main/java/io/jooby/Context.java

@@ -46,13 +46,27 @@
  */
 public interface Context extends Registry {
 
+  /** Select an application base on context path prefix matching a provided path. */
   interface Selector {
+    /**
+     * Select an application base on context path prefix matching a provided path.
+     *
+     * @param applications List of applications.
+     * @param path Path to match.
+     * @return Best match application.
+     */
     Jooby select(List<Jooby> applications, String path);
 
     static Selector create(List<Jooby> applications) {
       return applications.size() == 1 ? single() : multiple();
     }
 
+    /**
+     * Select an application the best match a given path. If none matches it returns the application
+     * that has no context path <code>/</code> or the first of the list.
+     *
+     * @return Best match application.
+     */
     static Selector multiple() {
       return (applications, path) -> {
         var defaultApp = applications.get(0);
@@ -68,13 +82,8 @@ static Selector multiple() {
       };
     }
 
-    static Selector single() {
-      return new Selector() {
-        @Override
-        public Jooby select(List<Jooby> applications, String path) {
-          return applications.get(0);
-        }
-      };
+    private static Selector single() {
+      return (applications, path) -> applications.get(0);
     }
   }