forked from apache/dubbo
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
add README for compatible module (apache#2019)
- Loading branch information
1 parent
9da66d4
commit bed691b
Showing
1 changed file
with
30 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,30 @@ | ||
### dubbo-compatible | ||
|
||
Hi, all | ||
|
||
From 2.7.x, `Dubbo` has renamed package to `org.apache.dubbo`, so `dubbo-compatible` module is provided. | ||
|
||
For compatibility with older versions, we provider the following most popular APIs(classes/interfaces): | ||
|
||
* com.alibaba.dubbo.rpc.Filter / Invocation / Invoker / Result / RpcContext / RpcException | ||
* com.alibaba.dubbo.config.annotation.Reference / Service | ||
* com.alibaba.dubbo.config.spring.context.annotation.EnableDubbo | ||
* com.alibaba.dubbo.common.Constants / URL | ||
* com.alibaba.dubbo.common.extension.ExtensionFactory | ||
* com.alibaba.dubbo.common.serialize.Serialization / ObjectInput / ObjectOutput | ||
* com.alibaba.dubbo.cache.CacheFactory / Cache | ||
* com.alibaba.dubbo.rpc.service.EchoService / GenericService | ||
|
||
The above APIs work fine with some unit tests in the test root. | ||
|
||
Except these APIs, others provided in `dubbo-compatible` are just bridge APIs without any unit tests, they may work with wrong. If you have any demand for them, you could: | ||
|
||
* Implement your own extensions with new APIs. (RECOMMENDED) | ||
* Follow `com.alibaba.dubbo.rpc.Filter` to implement bridge APIs, and then contribute to community. | ||
* Open issue on github. | ||
|
||
By the way, We will remove this module some day, so it's recommended that implementing your extensions with new APIs at the right time. | ||
|
||
Now we need your help: Any other popular APIs are missing? | ||
|
||
For compatible module, any suggestions are welcome. Thanks. |