dubbo/dubbo-compatible
ken.lj 1f193b9952 [Dubbo-3570] repackage compatible enhancement. (#3622)
* Fixes #3570, NoSuchMethodError are thrown when add custorm Filter using dubbo2.6.5 and JDK1.6 and upgrade to dubbo2.7.0
* Add compatible UT
* fix UT
2019-03-11 22:42:40 +08:00
..
src [Dubbo-3570] repackage compatible enhancement. (#3622) 2019-03-11 22:42:40 +08:00
README.md add README for compatible module (#2019) 2018-07-05 10:38:09 +08:00
pom.xml [maven-release-plugin] prepare for next development iteration 2019-01-18 11:05:09 +08:00

README.md

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.