tests and docs, organize inputs

Author: zootalures

README.md

@@ -299,6 +299,10 @@ invoked, and to use external configuration variables that you can set up with
 the Fn tool, have a look at the [Function
 Configuration](docs/FunctionConfiguration.md) tutorial.
 
+### Handling HTTP requests 
+
+If your function serves an HTTP trigger you may want to access HTTP details such as request or response headers or the HTTP status , checko ut [Accessing HTTP Information From Functions](docs/HTTPGatewayFunctions.md).
+
 ### Input and output bindings
 
 You have the option of taking more control of how serialization and

api/src/main/java/com/fnproject/fn/api/InputEvent.java

@@ -3,7 +3,6 @@
 import java.io.Closeable;
 import java.io.InputStream;
 import java.time.Instant;
-import java.util.Date;
 import java.util.function.Function;
 
 public interface InputEvent extends Closeable {

api/src/test/java/com/fnproject/fn/api/HeadersTest.java

@@ -1,6 +1,7 @@
 package com.fnproject.fn.api;
 
 import org.junit.Test;
+
 import static org.assertj.core.api.Assertions.assertThat;
 
 /**

docs/HTTPGatewayFunctions.md

@@ -0,0 +1,36 @@
+# Accessing HTTP Information From Functions 
+
+Functions can be used to handle events, RPC calls or HTTP requests.  When you are writing a function that handles an HTTP request you frequently need access to the HTTP headers of the incoming request or need to set HTTP headers or the status code on the outbound respsonse. 
+
+
+In Fn for Java, when your function is being served by an HTTP trigger (or another compatible HTTP gatway) you can get access to both the incoming request headers for your function by adding a 'com.fnproject.fn.api.httpgateway.HTTPGatewayContext' parameter to your function's parameters.
+
+ 
+ Using this  allows you to : 
+ 
+ * Read incoming headers
+ * Access the method and request URL for the trigger
+ * Write outbound headers to the response 
+ * Set the status code  of the response
+ 
+ 
+ For example this function reads a request header the method and request URL, sets an response header and sets the response status code to perform an HTTP redirect.
+ 
+```java
+package com.fnproject.fn.examples;
+import com.fnproject.fn.api.httpgateway.HTTPGatewayContext;
+
+
+public class RedirectFunction {
+    
+    public redirect(HTTPGatewayContext hctx) {
+        System.err.println("Request URL is:" + hctx.getRequestURL());
+        System.err.println("Trace ID" + hctx.getHeaders().get("My-Trace-ID").orElse("N/A"));
+        
+        hctx.setResponseHeader("Location","http://example.com");
+        hctx.setStatusCode(302);
+         
+    }
+}
+
+```

runtime/src/test/java/com/fnproject/fn/runtime/HeaderBuilder.java

@@ -2,7 +2,10 @@
 
 import com.fnproject.fn.api.Headers;
 
-import java.util.*;
+import java.util.AbstractMap;
+import java.util.Arrays;
+import java.util.List;
+import java.util.Map;
 
 class HeaderBuilder {
     static Map.Entry<String, List<String>> headerEntry(String key, String... values) {

runtime/src/test/java/com/fnproject/fn/runtime/JacksonCoercionTest.java

@@ -5,7 +5,6 @@
 import com.fnproject.fn.api.MethodWrapper;
 import com.fnproject.fn.runtime.coercion.jackson.JacksonCoercion;
 import com.fnproject.fn.runtime.testfns.Animal;
-import jdk.internal.util.xml.impl.Input;
 import org.junit.Assert;
 import org.junit.Test;