[#76] Parallel request routing for Blue Ocean

core/src/main/java/org/kohsuke/stapler/ForwardingFunction.java

@@ -40,6 +40,12 @@ public Class getReturnType() {
         return next.getReturnType();
     }
 
+    // can't really call next.contextualize()
+    @Override
+    public Function contextualize(Object usage) {
+        return this;
+    }
+
     @Override
     public Type[] getGenericParameterTypes() {
         return next.getGenericParameterTypes();

core/src/main/java/org/kohsuke/stapler/Function.java

@@ -86,6 +86,14 @@ public abstract class Function {
      */
     public abstract Class getReturnType();
 
+    /**
+     * Caller uses this method to tell {@link Function} about how it is being used.
+     * By default, this methods ignores the given context by returning {@code this}.
+     */
+    public Function contextualize(Object usage) {
+        return this;
+    }
+
     /**
      * Calls {@link #bindAndInvoke(Object, StaplerRequest, StaplerResponse, Object...)} and then
      * optionally serve the response object.
@@ -217,6 +225,9 @@ public Object invoke(StaplerRequest req, StaplerResponse rsp, Object o, Object..
         });
     }
 
+    /**
+     * @see StaticFunction#RETURN_NULL
+     */
     public static Object returnNull() { return null; }
 
     /**

core/src/main/java/org/kohsuke/stapler/FunctionList.java

@@ -31,7 +31,7 @@
  *
  * @author Kohsuke Kawaguchi
  */
-final class FunctionList extends AbstractList<Function> {
+public final class FunctionList extends AbstractList<Function> {
     private final Function[] functions;
 
     public FunctionList(Function... functions) {

core/src/main/java/org/kohsuke/stapler/JavaScriptMethodContext.java

@@ -0,0 +1,27 @@
+package org.kohsuke.stapler;
+
+import org.kohsuke.stapler.bind.JavaScriptMethod;
+
+/**
+ * {@link Function#contextualize(Object)} parameter that indicates
+ * the function is called to serve JavaScript method invocation from a proxy.
+ *
+ * @author Kohsuke Kawaguchi
+ * @see JavaScriptMethod
+ */
+public final class JavaScriptMethodContext {
+    private final String name;
+
+    // instantiation restricted to this class
+    /*package*/ JavaScriptMethodContext(String name) {
+        this.name = name;
+    }
+
+    /**
+     * Name of the web method. "" for index route.
+     */
+    public String getName() {
+        return name;
+    }
+}
+

core/src/main/java/org/kohsuke/stapler/KlassDescriptor.java

@@ -0,0 +1,29 @@
+package org.kohsuke.stapler;
+
+import org.kohsuke.stapler.lang.FieldRef;
+import org.kohsuke.stapler.lang.Klass;
+
+import java.util.List;
+
+/**
+ * Reflection information of a {@link Klass} that drives the request routing.
+ *
+ * <p>
+ * Born as a generalization of {@link ClassDescriptor} to {@link Klass}.
+ * @author Kohsuke Kawaguchi
+ */
+class KlassDescriptor<C> {
+    final Klass<C> clazz;
+    final FunctionList methods;
+    final List<FieldRef> fields;
+
+    /**
+     * @param klazz
+     *      The class to build a descriptor around.
+     */
+    public KlassDescriptor(Klass<C> klazz) {
+        this.clazz = klazz;
+        this.fields = klazz.getFields();
+        this.methods = new FunctionList(klazz.getFunctions());
+    }
+}