Document x-www-form-urlencoded for Java API

[relgames]

Akka HTTP Java documentation does not have much examples on form requests.
One of examples which is missing is x-www-form-urlencoded used in POST requests.

Sample code which can be used as an example for both server and client form handling:

public class Test1 extends JUnitRouteTest {
    private static final Logger log = LoggerFactory.getLogger(Test1.class);

    private static class Test1Route extends AllDirectives {
        public Route createRoute() {
            return post(() ->
                formFieldMap(form -> {
                    log.info("Got form {}", form);
                    return complete("OK");
                })
            );
        }
    }

    private final TestRoute appRoute = testRoute(new Test1Route().createRoute());

    @Test
    public void testAccessControl() {
        RequestEntity requestEntity = FormData.create(
            Pair.apply("key1", "value2"),
            Pair.apply("key2", "value2")
        ).toEntity();

        appRoute.run(HttpRequest.POST("/").withEntity(requestEntity))
            .assertEntity("OK");

    }

}

From https://gitter.im/akka/akka?at=57dfd8f1c3e7045a305fac0e

[jrudolph]

Thanks, @relgames, that's a good suggestion, thanks for extracting it from the chat. Once we've finished the documentation migration, this may be a nice thing for a community contribution.

[jlprat]

Isn't this already covered now? I can see a similar example here: http://doc.akka.io/docs/akka-http/current/java/http/routing-dsl/directives/form-field-directives/formFieldMap.html

Or is this issue referring to add it somewhere else?

[relgames]

Indeed it is in DSL section, I did not look here as I was looking for examples of POST request using Http client. I was looking for x-www-form-urlencoded and it was not mentioned anywhere in the doc.

I think adding x-www-form-urlencoded to http://doc.akka.io/docs/akka-http/current/java/http/routing-dsl/directives/form-field-directives/formFieldMap.html should be enough.

[ktoso]

Sounds good 👍 Awaiting PR 😀

[jlprat]

I could do it later today. I think it's good if it's added in http://doc.akka.io/docs/akka-http/current/java/http/routing-dsl/directives/by-trait.html (when the FormFieldDirectives are explained) and in each FormFieldDirective.
I'll do it for both Java and Scala (for Scala only where it makes sense, as I think it already has quite more info about x-www-form-urlencoded