apache/dubbo

[Feature] Add AsyncRpcResult test sample in dubbo-samples

Open

#15567 opened on Jul 20, 2025

View on GitHub
 (6 comments) (0 reactions) (2 assignees)Java (41,524 stars) (26,453 forks)batch import
help wantedtype/enhancementtype/proposal

Description

Pre-check

  • I am sure that all the content I provide is in English.

Search before asking

  • I had searched in the issues and found no similar feature requirement.

Apache Dubbo Component

Java Samples (apache/dubbo-samples)

Descriptions

Background

AsyncRpcResult is the key class for asynchronous calls in Dubbo Java SDK, but the official dubbo-samples repository does not contain any test case or example to demonstrate its correct usage. This makes it hard for users to understand how to:

  1. Obtain the result via AsyncRpcResult after an async call.
  2. Handle timeout and exceptions properly.
  3. Ensure compatibility across Dubbo versions.

Proposal

Create a new sub-module dubbo-samples-async-result under 2-advanced/ with:

  • A provider that exposes an async service.
  • A consumer that uses AsyncRpcResult to get the response and handle timeout/exception.
  • Docker-based integration tests similar to existing samples (dubbo-samples-annotation, etc.).

Acceptance Criteria

  • New module builds and passes ./test/run-tests.sh 2-advanced/dubbo-samples-async-result.
  • README explains how to run the demo and the key points of AsyncRpcResult.
  • No breaking changes to existing samples.

Volunteer

I’m willing to submit a PR once the feature request is accepted.

Related issues

No response

Are you willing to submit a pull request to fix on your own?

  • Yes I am willing to submit a pull request on my own!

Code of Conduct

Contributor guide

Tech stack
javadocker
Domain
backendapideveloper experiencetesting
Issue type
feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-2 days
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
blocked
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
JavaApache Dubbo basicsDocker basics
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
40
Research direction
Start by examining the existing 'dubbo samples annotation' module under '2 advanced/' to understand the project structure and Docker test setup. Then, refer to the Apache Dubbo source code for AsyncRpcResult usage (e.g., the class AsyncRpcResult in the dubbo rpc api module). The sample should include a simple provider and consumer service that demonstrates async invocation and handling of AsyncRpcResult. Additionally, review any linked issues or PRs in the issue comments for further guidance.