Support for Mutiny Reactive #15537

MoritzArena · 2025-07-11T00:54:03Z

What is the purpose of the change?

Ref: #15528 15528

As of Dubbo 3.3, Reactor remains the primary Reactive Streams implementation officially supported. This integration is highly convenient for applications built with Spring WebFlux or any other frameworks based on Reactor, as it can be used out of the box.

However, beyond Reactor, the Mutiny reactive framework has been steadily gaining traction. From our perspective, we see strong potential for Mutiny as an emerging direction in reactive programming. Similarly, as more modern enterprise applications adopt Quarkus for web development, the demand for Mutiny-compatible support in Dubbo is likely to grow.

In response to this, our team has already integrated Mutiny support into Dubbo based on version 3.3. We are currently in the process of completing full business-level testing and protoc compilation validation, which we expect to finalize within the coming week. We would like to contribute this feature to the Dubbo community and sincerely hope it can be officially considered for inclusion in an upcoming release.

Missions

The work on Dubbo's support for Mutiny Reactive has been completed, and the code has been created on the 3.3 branch. It is located in the dubbo-plugin/dubbo-mutiny module. This module requires at least JDK 17, as starting from Mutiny 3, it switched to the JDK 9 Flow reactive specification, and the module uses Mutiny 3.

Regarding the proto compiler plugin, we have completed the build of version 3.4.0.beta1 and introduced it into the project. We have also validated the transport of Uni -> Uni, Uni -> Multi, Multi -> Uni, and Multi -> Multi in a wide range of business scenarios on Quarkus platform and Mutiny based web applications. After ensuring that all reactive methods run correctly, I am submitting this PR.

The Multi -> Multi run example:

Dubbo samples will be added soon later.

Checklist

Make sure there is a GitHub_issue field for the change.
Write a pull request description that is detailed enough to understand what the pull request does, how, and why.
Write necessary unit-test to verify your logic correction. If the new feature or significant change is committed, please remember to add sample in dubbo samples project.
Make sure gitHub actions can pass. Why the workflow is failing and how to fix it?

codecov-commenter · 2025-07-11T01:28:54Z

Codecov Report

❌ Patch coverage is 74.52471% with 67 lines in your changes missing coverage. Please review.
✅ Project coverage is 61.06%. Comparing base (34c3468) to head (82a9865).

Files with missing lines	Patch %	Lines
...g/apache/dubbo/mutiny/calls/MutinyClientCalls.java	52.63%	18 Missing ⚠️
...he/dubbo/mutiny/AbstractTripleMutinyPublisher.java	73.77%	4 Missing and 12 partials ⚠️
...bo/gen/tri/mutiny/MutinyDubbo3TripleGenerator.java	0.00%	9 Missing ⚠️
...e/dubbo/mutiny/AbstractTripleMutinySubscriber.java	74.19%	1 Missing and 7 partials ⚠️
...che/dubbo/mutiny/ServerTripleMutinySubscriber.java	72.00%	6 Missing and 1 partial ⚠️
...che/dubbo/mutiny/ClientTripleMutinySubscriber.java	20.00%	4 Missing ⚠️
...g/apache/dubbo/mutiny/calls/MutinyServerCalls.java	95.00%	1 Missing and 2 partials ⚠️
...ache/dubbo/mutiny/ClientTripleMutinyPublisher.java	60.00%	2 Missing ⚠️

Additional details and impacted files

@@             Coverage Diff              @@
##                3.3   #15537      +/-   ##
============================================
+ Coverage     60.05%   61.06%   +1.00%     
- Complexity    10167    11500    +1333     
============================================
  Files          1909     1922      +13     
  Lines         86782    87045     +263     
  Branches      13094    13106      +12     
============================================
+ Hits          52119    53153    +1034     
+ Misses        29200    28456     -744     
+ Partials       5463     5436      -27

Flag	Coverage Δ
integration-tests-java21	`32.84% <0.00%> (-0.11%)`	⬇️
integration-tests-java8	`32.96% <0.00%> (-0.10%)`	⬇️
samples-tests-java21	`31.51% <0.00%> (?)`
samples-tests-java8	`29.21% <0.00%> (?)`
unit-tests-java11	`59.08% <0.00%> (?)`
unit-tests-java17	`58.83% <74.52%> (+0.03%)`	⬆️
unit-tests-java21	`58.85% <74.52%> (+0.05%)`	⬆️
unit-tests-java8	`59.08% <0.00%> (+<0.01%)`	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

# Conflicts: # dubbo-dependencies-bom/pom.xml

zrlw · 2025-07-16T07:26:53Z

if the plugin just works on jdk17+, the module should be added to jdk17+ profile, like dubbo-spring6-security at dubbo-parent pom (Not only this pom needs to be modified):

<profile>
      <id>jdk-version-ge-17</id>
      <activation>
        <jdk>[17,)</jdk>
      </activation>
      <modules>
        ...
        <module>dubbo-plugin/dubbo-spring6-security</module>
        ...
      </modules>
    </profile>

supplement test cases to [dubbo-integration-cases]https://github.com/apache/dubbo-integration-cases / dubbo-samples for the new plugin.

MoritzArena · 2025-07-16T08:25:29Z

if the plugin just works on jdk17+, the module should be added to jdk17+ profile, like dubbo-spring6-security at dubbo-parent pom (Not only this pom needs to be modified):
<profile>
      <id>jdk-version-ge-17</id>
      <activation>
        <jdk>[17,)</jdk>
      </activation>
      <modules>
        ...
        <module>dubbo-plugin/dubbo-spring6-security</module>
        ...
      </modules>
    </profile>
supplement test cases to dubbo-integration-cases / dubbo-samples for the new plugin.

got it!

zrlw · 2025-07-16T08:47:52Z

The main function of dubbo-samples is demonstrating usage example, so push the new plugin case with README.md might be more important.

MoritzArena · 2025-07-19T16:27:20Z

What caused these github action errors? Are they related with dubbo-plugin/dubbo-mutiny module?

zrlw · 2025-07-20T01:17:46Z

What caused these github action errors? Are they related with dubbo-plugin/dubbo-mutiny module?

download log archive of the failed test job, you'll find the root cause, e.g.

2025-07-19T16:09:01.8175695Z [INFO] --- compiler:3.14.0:compile (default-compile) @ dubbo-mutiny ---
2025-07-19T16:09:01.8248711Z [INFO] Recompiling the module because of changed dependency.
2025-07-19T16:09:01.8254429Z [INFO] Compiling 12 source files with javac [forked debug release 9] to target/classes
2025-07-19T16:09:01.9315266Z [INFO] -------------------------------------------------------------
2025-07-19T16:09:01.9315894Z [ERROR] COMPILATION ERROR : 
2025-07-19T16:09:01.9316406Z [INFO] -------------------------------------------------------------
2025-07-19T16:09:01.9316832Z [ERROR] javac: invalid target release: 9
2025-07-19T16:09:01.9317114Z Usage: javac <options> <source files>
2025-07-19T16:09:01.9317391Z use -help for a list of possible options

MoritzArena · 2025-07-20T02:32:02Z

What caused these github action errors? Are they related with dubbo-plugin/dubbo-mutiny module?

download log archive of the failed test job, you'll find the root cause, e.g.

2025-07-19T16:09:01.8175695Z [INFO] --- compiler:3.14.0:compile (default-compile) @ dubbo-mutiny ---
2025-07-19T16:09:01.8248711Z [INFO] Recompiling the module because of changed dependency.
2025-07-19T16:09:01.8254429Z [INFO] Compiling 12 source files with javac [forked debug release 9] to target/classes
2025-07-19T16:09:01.9315266Z [INFO] -------------------------------------------------------------
2025-07-19T16:09:01.9315894Z [ERROR] COMPILATION ERROR : 
2025-07-19T16:09:01.9316406Z [INFO] -------------------------------------------------------------
2025-07-19T16:09:01.9316832Z [ERROR] javac: invalid target release: 9
2025-07-19T16:09:01.9317114Z Usage: javac <options> <source files>
2025-07-19T16:09:01.9317391Z use -help for a list of possible options

maybe I need some help, I have already update jdk-version-17-ge with dubbo-plugin/dubbo-mutiny in dubbo-parent pom.xml and aligned with the configuration of dubbo-plugin/dubbo-spring6-security, and successfully installed whole project at jdk 17 on platform macos. but still got the errors below:

2025-07-20T02:23:20.3825185Z Caused by: org.apache.maven.plugin.compiler.CompilationFailureException: Compilation failure
2025-07-20T02:23:20.3825779Z javac: invalid target release: 17
2025-07-20T02:23:20.3826042Z Usage: javac <options> <source files>
2025-07-20T02:23:20.3826311Z use -help for a list of possible options

zrlw · 2025-07-20T03:14:59Z

modify all pom.xml files that contains dubbo-spring6-security, just do what dubbo-spring6-security did.

MoritzArena · 2025-07-20T03:15:54Z

modify all pom.xml files that contains dubbo-spring6-security, just do what dubbo-spring6-security did.

really thx a lot

zrlw · 2025-07-20T09:57:27Z

you'd better to search maven articles to know how to use profiles to specify which dependencies should be included and which ones should be excluded based on the currently active profile.

MoritzArena · 2025-07-20T14:12:55Z

you'd better to search maven articles to know how to use profiles to specify which dependencies should be included and which ones should be excluded based on the currently active profile.

What confuses me is that I did lock the new dubbo-mutiny module to the jdk-version-ge-17 profile, and it compiles successfully with maven under jdk 1.8, jdk 11, jdk 17, jdk 21, and jdk 24 (with the correct profile). I don't know why I can't find the corresponding jdk version in the Github Action.

zrlw · 2025-07-20T14:47:19Z

What confuses me is that I did lock the new dubbo-mutiny module to the jdk-version-ge-17 profile, and it compiles successfully with maven under jdk 1.8, jdk 11, jdk 17, jdk 21, and jdk 24 (with the correct profile). I don't know why I can't find the corresponding jdk version in the Github Action.

no, you didn't lock it. you also add it to the dependencies for building dubbo with
every jdk version which will make your lock trying no sense.
see details at new reviews.

MoritzArena · 2025-07-20T14:52:22Z

dependencies for building

Sorry about that, I forgot to remove this module from top.

zrlw · 2025-07-20T14:55:37Z

do what it did includes don't do what it didn't

zrlw · 2025-07-21T11:32:43Z

the version of io.smallrye.reactive/mutiny has been set at dubbo-dependencies-bom, dubbo-plugin/dubbo-mutiny should not set it again.

MoritzArena · 2025-07-21T12:02:13Z

the version of io.smallrye.reactive/mutiny has been set at dubbo-dependencies-bom, dubbo-plugin/dubbo-mutiny should not set it again.

got it

dubbo-plugin/dubbo-mutiny/pom.xml

RainYuY · 2025-07-27T04:03:08Z

@oxsean PTAL

oxsean

It would be good to have a example to showcase these capabilities.

MoritzArena · 2025-07-28T08:04:43Z

It would be good to have a example to showcase these capabilities.

these will done in this week

MoritzArena and others added 6 commits July 11, 2025 08:12

fix code format and add server/client unit tests

4c2e840

add module info

7959133

fix review issue

70703d1

fallback to use jdk9 language

598dea1

support for mutiny reactive

f0863b2

fix 3.4 commits cherry-pick to 3.3

73faaaa

This comment was marked as resolved.

Sign in to view

MoritzArena added 3 commits July 15, 2025 20:23

fix typo

3cb7384

Merge remote-tracking branch 'origin/3.3' into 3.3-mutiny

f8a26e3

# Conflicts: # dubbo-dependencies-bom/pom.xml

resolve conflicts

084e4ce

fixed min java version for mutiny to 9

f208ab0

fixed min java version for mutiny to 17

1e2c758

align with spring6-security config

ed13df7

Merge remote-tracking branch 'origin/3.3' into 3.3-mutiny

1a5ad4b

remove top dependency building mutiny module

81e8703

remove all declared useless mutiny module

8c21899

modify FileTest

8354e32

zrlw requested review from AlbumenJ, gnl00 and oxsean and removed request for gnl00 July 21, 2025 01:08

Merge branch '3.3' into 3.3

7284adb

remove redundant mutiny version

a976521

zrlw self-requested a review July 21, 2025 22:59

zrlw approved these changes Jul 21, 2025

View reviewed changes

dubbo-plugin/dubbo-mutiny/pom.xml Outdated Show resolved Hide resolved

zrlw requested review from RainYuY and heliang666s July 23, 2025 04:50

zrlw added type/proposal Everything you want Dubbo have component/sdk Related with apache/dubbo labels Jul 23, 2025

Merge branch '3.3' into 3.3-mutiny

82a9865

zrlw requested a review from gnl00 July 28, 2025 02:10

oxsean approved these changes Jul 28, 2025

View reviewed changes

zrlw merged commit 5b9adb0 into apache:3.3 Aug 26, 2025
32 checks passed

redoom mentioned this pull request Nov 13, 2025

docs: Add 3.3.6 version highlights to README #15772

Merged

Support for Mutiny Reactive #15537

Support for Mutiny Reactive #15537

Uh oh!

Conversation

MoritzArena commented Jul 11, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What is the purpose of the change?

Missions

Checklist

Uh oh!

codecov-commenter commented Jul 11, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

This comment was marked as resolved.

Uh oh!

zrlw commented Jul 16, 2025

Uh oh!

MoritzArena commented Jul 16, 2025 • edited by zrlw Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

zrlw commented Jul 16, 2025

Uh oh!

MoritzArena commented Jul 19, 2025

Uh oh!

zrlw commented Jul 20, 2025

Uh oh!

MoritzArena commented Jul 20, 2025

Uh oh!

zrlw commented Jul 20, 2025

Uh oh!

MoritzArena commented Jul 20, 2025

Uh oh!

zrlw commented Jul 20, 2025

Uh oh!

MoritzArena commented Jul 20, 2025

Uh oh!

zrlw commented Jul 20, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

MoritzArena commented Jul 20, 2025

Uh oh!

zrlw commented Jul 20, 2025

Uh oh!

zrlw commented Jul 21, 2025

Uh oh!

MoritzArena commented Jul 21, 2025

Uh oh!

Uh oh!

RainYuY commented Jul 27, 2025

Uh oh!

oxsean left a comment

Choose a reason for hiding this comment

Uh oh!

MoritzArena commented Jul 28, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

MoritzArena commented Jul 11, 2025 •

edited

Loading

codecov-commenter commented Jul 11, 2025 •

edited

Loading

MoritzArena commented Jul 16, 2025 •

edited by zrlw

Loading

zrlw commented Jul 20, 2025 •

edited

Loading