Unlock Dubbo’s Hidden Features: Direct Provider, Versioning, Echo Test, and More

Direct Provider

In development or test environments you may want to bypass the registry and connect directly to a specific provider. The point‑to‑point mode configures a single interface to ignore the registry’s provider list while other interfaces can still use the registry.

<dubbo:reference id="demoService" interface="com.alibaba.dubbo.demo.DemoService" version="1.0.0" url="dubbo://172.18.1.205:20888/" />

Multi‑Version

When an interface implementation changes incompatibly, you can use version numbers to transition. Services with different versions do not call each other.

<dubbo:service interface="com.alibaba.dubbo.demo.DemoService" ref="demoService" version="1.0.0" />

Using this feature you can implement gray releases:

Define the old implementation with version="1.0.0" and the new one with version="2.0.0".

Set the consumer side version="*".

After defining providers and consumers, each version handles 50% of the traffic.

You can also migrate incompatible versions by upgrading half of the providers during low‑traffic periods, then upgrading all consumers, and finally upgrading the remaining providers.

Echo Test

Echo testing checks service availability by executing a normal request flow, useful for monitoring. All services automatically implement the EchoService interface; simply cast any service reference to EchoService to use it.

EchoService echoService = (EchoService) demoService;
System.out.println(echoService.$echo("hello"));

Implicit Parameters

Implicit parameters can be passed between consumer and provider via RpcContext using setAttachment() and getAttachment(). For example, a controller can intercept a login token, extract a memberId, and attach it to the RPC call.

Provider side set:

RpcContext.getContext().setAttachment("CRT_MEMBER_ID", "13828886888");

Consumer side get:

RpcContext.getContext().getAttachment("CRT_MEMBER_ID");

Context

RpcContext stores environment information for the current call. All configuration is converted to URL parameters. It is a ThreadLocal recorder that changes state when a request is received or sent, allowing you to trace the call chain.

boolean isConsumerSide = RpcContext.getContext().isConsumerSide();

Local Mock (Fallback)

Local mock is used for service degradation. When a provider throws RpcException, the mock implementation returns a predefined result instead of propagating the exception.

<dubbo:reference id="demoService" interface="com.alibaba.dubbo.demo.DemoService" version="1.0.0" mock="com.alibaba.dubbo.demo.consumer.mock.DemoServiceMock"/>

Mock implementation example:

public class DemoServiceMock implements DemoService {
    public String sayHello(String name) {
        return "mock-value";
    }
}

Generic Invocation

Generic invocation is useful when the client does not have the API interface or model classes. Parameters and return values are represented as Map objects.

<dubbo:reference id="demoService" interface="com.alibaba.dubbo.demo.DemoService" generic="true"/>

Example code:

ReferenceConfig<GenericService> reference = new ReferenceConfig<>();
reference.setInterface("com.alibaba.dubbo.demo.DemoService");
reference.setVersion("1.0.0");
reference.setGeneric(true);
GenericService genericService = reference.get();
Object result = genericService.$invoke("sayYes", new String[]{"java.lang.String"}, new Object[]{"afei"});
System.out.println("result --> " + result);

Map<String, Object> teacher = new HashMap<>();
teacher.put("id", "1");
teacher.put("name", "admin");
teacher.put("age", "18");
teacher.put("level", "3");
teacher.put("remark", "测试");
result = genericService.$invoke("justTest", new String[]{"com.alibaba.dubbo.demo.bean.HighTeacher"}, new Object[]{teacher});
System.out.println("result --> " + result);

Access Log

To record each request, enable access logging similar to Nginx access logs. Be aware of the large log volume.

<dubbo:provider accesslog="/app/dubbo-demo.log"/>

Local configuration example:

<dubbo:service interface="com.alibaba.dubbo.demo.DemoService" ref="demoService" accesslog="/app/demo.log"/>
<dubbo:service interface="com.alibaba.dubbo.demo.TestService" ref="testService" accesslog="/app/test.log"/>

Log format example:

[2017-11-22 10:23:20] 172.18.1.205:56144 -> 172.18.1.205:20886 - com.alibaba.dubbo.demo.DemoService:1.0.0 sayHello(java.lang.String) ["afei"]

Delay Exposure

If a service needs warm‑up time (e.g., initializing local cache), you can delay its exposure using the delay attribute. The service will be exposed after the specified milliseconds once the Spring container is initialized.

<dubbo:provider delay="5000"/>

<dubbo:service delay="5000" interface="com.alibaba.dubbo.demo.DemoService" ref="demoService" version="1.0.0"/>