Auto-configure RSocketGraphQlClient

This commit contributes a `RSocketGraphQlClient.Builder` component to
the context, pre-configured with the `RSocketStrategies`, a customized
`RSocketConnector` and the expected data MIME type.

See gh-30453
This commit is contained in:
Brian Clozel
2022-04-19 10:53:15 +02:00
parent 9c3cce58ea
commit 2dc2e5ab11
5 changed files with 163 additions and 52 deletions

View File

@@ -117,13 +117,14 @@ Spring Boot supports many configuration properties under the `spring.graphql.cor
RSocket is also supported as a transport, on top of WebSocket or TCP.
Once the <<messaging#messaging.rsocket.server-auto-configuration,RSocket server is configured>>, we can configure our GraphQL handler on a particular route using configprop:spring.graphql.rsocket.mapping[].
For example, configuring that mapping as `"graphql"` means we can use the `RSocketGraphQlClient` as follows.
For example, configuring that mapping as `"graphql"` means we can use that as a route when sending requests with the `RSocketGraphQlClient`.
For RSocket over TCP:
include::code:RSocketGraphQlClientExample[tag=tcp]
Spring Boot auto-configures a `RSocketGraphQlClient.Builder<?>` bean that you can inject in your components:
For RSocket over WebSocket:
include::code:RSocketGraphQlClientExample[tag=websocket]
include::code:RSocketGraphQlClientExample[tag=builder]
And then send a request:
include::code:RSocketGraphQlClientExample[tag=request]
[[web.graphql.exception-handling]]

View File

@@ -16,32 +16,29 @@
package org.springframework.boot.docs.web.graphql.transports.rsocket;
import java.net.URI;
import java.time.Duration;
import reactor.core.publisher.Mono;
import org.springframework.graphql.client.RSocketGraphQlClient;
import org.springframework.stereotype.Component;
// tag::builder[]
@Component
public class RSocketGraphQlClientExample {
public void rsocketOverTcp() {
// tag::tcp[]
RSocketGraphQlClient client = RSocketGraphQlClient.builder().tcp("example.spring.io", 8181).route("graphql")
.build();
Mono<Book> book = client.document("{ bookById(id: \"book-1\"){ id name pageCount author } }")
.retrieve("bookById").toEntity(Book.class);
// end::tcp[]
book.block(Duration.ofSeconds(5));
}
private final RSocketGraphQlClient graphQlClient;
public void rsocketOverWebSocket() {
// tag::websocket[]
RSocketGraphQlClient client = RSocketGraphQlClient.builder()
.webSocket(URI.create("wss://example.spring.io/rsocket")).route("graphql").build();
Mono<Book> book = client.document("{ bookById(id: \"book-1\"){ id name pageCount author } }")
public RSocketGraphQlClientExample(RSocketGraphQlClient.Builder<?> builder) {
this.graphQlClient = builder.tcp("example.spring.io", 8181).route("graphql").build();
}
// end::builder[]
public void rsocketOverTcp() {
// tag::request[]
Mono<Book> book = this.graphQlClient.document("{ bookById(id: \"book-1\"){ id name pageCount author } }")
.retrieve("bookById").toEntity(Book.class);
// end::websocket[]
// end::request[]
book.block(Duration.ofSeconds(5));
}

View File

@@ -17,19 +17,21 @@
package org.springframework.boot.docs.web.graphql.transports.rsocket
import org.springframework.graphql.client.RSocketGraphQlClient
import java.net.URI
import org.springframework.stereotype.Component
import java.time.Duration
// tag::builder[]
@Component
class RSocketGraphQlClientExample(private val builder: RSocketGraphQlClient.Builder<*>) {
// end::builder[]
class RSocketGraphQlClientExample {
val graphQlClient = builder.tcp("example.spring.io", 8181)
.route("graphql")
.build()
fun rsocketOverTcp() {
// tag::tcp[]
val client = RSocketGraphQlClient.builder()
.tcp("example.spring.io", 8181)
.route("graphql")
.build()
val book = client.document(
// tag::request[]
val book = graphQlClient.document(
"""
{
bookById(id: "book-1"){
@@ -39,31 +41,10 @@ class RSocketGraphQlClientExample {
author
}
}
""")
.retrieve("bookById").toEntity(Book::class.java)
// end::tcp[]
book.block(Duration.ofSeconds(5))
}
fun rsocketOverWebSocket() {
// tag::websocket[]
val client = RSocketGraphQlClient.builder()
.webSocket(URI.create("wss://example.spring.io/rsocket"))
.route("graphql")
.build()
val book = client.document(
"""
{
bookById(id: "book-1"){
id
name
pageCount
author
}
}
""")
)
.retrieve("bookById").toEntity(Book::class.java)
// end::websocket[]
// end::request[]
book.block(Duration.ofSeconds(5))
}