Support for registering handlers in RSocketRequester.Builder

[rstoyanchev]

Currently client-side handling involves registering an acceptor, for example like so, which is likely an RSocketMessageHandler bean with manually registered handlers.

Arguably in this case there isn't much reason for applications to be aware of the RSocketMessageHandler nor to have it as a bean, so we should offer an option to register such client-side handlers directly with RSocketRequester.Builder, which would internally create the RSocketMessageHandler and configure it as an acceptor in the RSocketFactory.

In the Javadoc we should make it clear that registering handlers is a shortcut for creating an RSocketMessageHandler and configuring it as an acceptor. That latter still remains an option for more advanced cases and that should be made clear.

[bclozel]

I'm working on this right now.
There's one downside to introducing a new method on the RSocketRequester.Builder like this:

RSocketRequester.Builder handlers(Object... handlers);

Annotated handlers cannot be typed (they're like MVC controllers). In #23135 we're discussing the possibility to introduce a functional variant for RSocket handlers. In this case they would have a proper type, and we would probably need to configure them on the builder as well.

Is there a way to design annotated handlers being configured on the requester, without clashing with potential future plans for the functional variant?

[rstoyanchev]

The method could be called annotatedHandlers leaving room for alternative handlers (and type of infrastructure) in the future.

[bclozel]

This commit introduced a package tangle by referencing RSocketMessageHandler (from the annotation package) in the main rsocket package.

We should reconsider the way to solve this issue, as this circular dependency when/if we try to introduce the function handlers variants here. Functional handlers will be typed so it will be even more obvious.

[rstoyanchev]

Object... for handlers is convenient but also inflexible. For any type of customization you would need to fall back on declaring an RSocketMessageHandler bean.

One idea would be to create a ClientResponderBuilder that RSocketMessageHandler provides an implementation for. Something like this:

ClientResponderBuilder responderBuilder =
        RSocketMessageHandler.clientResponderBuilder(new ClientHandler())
                .routeMatcher(routeMatcher)
                .build();

RSocketRequester.builder()
        .responder(responderBuilder)
        .rsocketStrategies(rsocketStrategies)
        .connectTcp("localhost", server.address().getPort())

This is slightly less convenient but more flexible and also breaks the package cycle if ClientResponderBuilder lives in the top-level rsocket package.

[bclozel]

@rstoyanchev I've got a slightly different proposal for this: bclozel@f6b879d

The Builder interface didn't feel right as we're building a client acceptor for the requester (and that's the only common interface). RSocket doesn't provide a dedicated interface for now. Happy to discuss further changes for this.

[rstoyanchev]

It's true RSocket doesn't provide an interface for a "client acceptor" which is actually a misnomer since on the client side it's merely a callback before the connection is even established. I'm going to rename the clientAcceptor and serverAcceptor in RSocketMessageHandler to clientResponder and serverResponder.

Next to that the proposed clientResponder(Object...) static method is reallyclientResponderFactory(Object...) returning ClientResponderFactory. However as a shortcut, this factory method is limited and doesn't allow customization of further RSocketMessageHandler properties. I see RSocketRequestBulider exposes a RouteMatcher but there is no viable path for exposing any further RSocketMessageHandler properties. That would be limiting then if you have to go back to creating RSocketMessageHandler for any other customization.

Back to the original idea, I think the main goal is to allow creating an RSocketRequester programmatically including some way to build an instance of RSocketMessageHandler without having to declare it as a Spring bean. RSocketMessageHandler is overwhelming for direct use with a number of options not applicable to programmatic, direct registration of handlers. Focusing on that, I would prefer to see something that effectively builds an RSocketMessageHandler instance and helps to configure a client responder.

So perhaps a ClientResponderFactory interface with a create(Object...) default method. That methods returns a ClientResponderFactory instance that is ready to pass to RSocketRequester.Builder as is, but also exposes further config methods for the subset of RSocketMessageHandler properties focusing on programmatic use (outside of Spring config) and relevant to direct registration of handlers.