Add documentation for routing to functions #3767
Conversation
This one specifically refers to using Spring Cloud Function framework Signed-off-by: Oleg Zhurakousky <ozhurakousky@vmware.com>
olegz
force-pushed
the
s-c-function-docs
branch
from
ea51cb1 to
81f2444
Compare
| WARNING: As of version 4.1.7, `HandlerFunctions.http(String)` and `HandlerFunctions.http(URI)` are now deprecated. Please use `HandlerFunctions.http()` in combination with the `BeforeFilterFunctions.uri()` filter instead. This fixes inconsistencies in dealing with the route url request attribute. | ||
|
|
||
| === Spring Cloud Function Handler Function | ||
| This feature provides support for transparently routing to Java functions when using https://spring.io/projects/spring-cloud-function[Spring Cloud Function] framework. |
|
|
||
| === Spring Cloud Function Handler Function | ||
| This feature provides support for transparently routing to Java functions when using https://spring.io/projects/spring-cloud-function[Spring Cloud Function] framework. | ||
| Gateway routing configuration will be provided as soon as you provide Spring Cloud Function dependency. |
There was a problem hiding this comment.
By placing Spring Cloud Function is on the classpath, Spring Cloud Gateway will automatically configure routes to invoke functions you define as beans. The bean names of the functions will be used as the path of the routes.
For example, given the following configuration:
| } | ||
| } | ||
| ---- | ||
| You can now invoke `concat` or `uppercase` as GET or POST request |
There was a problem hiding this comment.
You can invoke the concat or uppercase functions by issuing a GET or POST request to /concat or /uppercase.
Making a GET request to ``http://localhost:8080/uppercase/hello` will invoke the uppercase function with the String `hello` and return `HELLO` in the `GET` response body.
Instead of passing the function parameter as a path parameter you can use a POST request. For example the following cURL command can issued to invoke the concat function:
[source,bash]
$ curl -d ‘"hello"' -H "Content-Type: application/json" -X POST http://localhost:8080/concat
The response body will contain hellohello.
Spring Cloud Gateway also supports function composition by issuing a request to a path composed of function names separated by a comma. For example:
[source,bash]
$ curl -d ‘"hello"' -H "Content-Type: application/json" -X POST http://localhost:8080/concat,uppercase
The response body will contain HELLOHELLO.
Signed-off-by: Spencer Gibb <sgibb@pivotal.io>
5 participants
This one specifically refers to using Spring Cloud Function framework