{"id":18866924,"url":"https://github.com/asurateam/dubbos","last_synced_at":"2025-10-11T17:22:53.140Z","repository":{"id":68843108,"uuid":"92006355","full_name":"AsuraTeam/dubbos","owner":"AsuraTeam","description":null,"archived":false,"fork":false,"pushed_at":"2017-05-25T09:15:33.000Z","size":6647,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-07-12T09:39:31.649Z","etag":null,"topics":["dubbox","java-dubbo","spring4"],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AsuraTeam.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-05-22T03:11:23.000Z","updated_at":"2019-07-15T03:18:44.000Z","dependencies_parsed_at":"2023-04-25T01:02:37.719Z","dependency_job_id":null,"html_url":"https://github.com/AsuraTeam/dubbos","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/AsuraTeam/dubbos","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AsuraTeam%2Fdubbos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AsuraTeam%2Fdubbos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AsuraTeam%2Fdubbos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AsuraTeam%2Fdubbos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AsuraTeam","download_url":"https://codeload.github.com/AsuraTeam/dubbos/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AsuraTeam%2Fdubbos/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267780336,"owners_count":24143202,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-29T02:00:12.549Z","response_time":2574,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dubbox","java-dubbo","spring4"],"created_at":"2024-11-08T05:07:57.926Z","updated_at":"2025-10-11T17:22:48.111Z","avatar_url":"https://github.com/AsuraTeam.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"Dubbox now means Dubbo eXtensions. If you know java, javax and dubbo, you know what dubbox is :)\n\nDubbox adds features like RESTful remoting, Kyro/FST serialization, etc to the popular [dubbo service framework](http://github.com/alibaba/dubbo). It's been used by several projects of [dangdang.com](http://www.dangdang.com), which is one of the major e-commerce companies in China.\n\n## 主要贡献者\n\n* 沈理 [当当网](http://www.dangdang.com/) shenli@dangdang.com\n* 王宇轩 [当当网](http://www.dangdang.com/) wangyuxuan@dangdang.com\n* 马金凯 [韩都衣舍](http://www.handu.com/) majinkai@handu.com\n* Dylan 独立开发者 dinguangx@163.com\n* Kangfoo 独立开发者\n\n有技术问题请移步此处讨论 https://github.com/dangdangdotcom/dubbox/issues\n\n## Dubbox当前的主要功能\n\n* **支持REST风格远程调用（HTTP + JSON/XML)**：基于非常成熟的JBoss [RestEasy](http://resteasy.jboss.org/)框架，在dubbo中实现了REST风格（HTTP + JSON/XML）的远程调用，以显著简化企业内部的跨语言交互，同时显著简化企业对外的Open API、无线API甚至AJAX服务端等等的开发。事实上，这个REST调用也使得Dubbo可以对当今特别流行的“微服务”架构提供基础性支持。 另外，REST调用也达到了比较高的性能，在基准测试下，HTTP + JSON与Dubbo 2.x默认的RPC协议（即TCP + Hessian2二进制序列化）之间只有1.5倍左右的差距，详见文档中的基准测试报告。\n\n* **支持基于Kryo和FST的Java高效序列化实现**：基于当今比较知名的[Kryo](https://github.com/EsotericSoftware/kryo)和[FST](https://github.com/RuedigerMoeller/fast-serialization)高性能序列化库，为Dubbo默认的RPC协议添加新的序列化实现，并优化调整了其序列化体系，比较显著的提高了Dubbo RPC的性能，详见文档中的基准测试报告。\n\n* **支持基于Jackson的JSON序列化**：基于业界应用最广泛的[Jackson](http://jackson.codehaus.org/)序列化库，为Dubbo默认的RPC协议添加新的JSON序列化实现。\n\n* **支持基于嵌入式Tomcat的HTTP remoting体系**：基于嵌入式tomcat实现dubbo的HTTP remoting体系（即dubbo-remoting-http），用以逐步取代Dubbo中旧版本的嵌入式Jetty，可以显著的提高REST等的远程调用性能，并将Servlet API的支持从2.5升级到3.1。（注：除了REST，dubbo中的WebServices、Hessian、HTTP Invoker等协议都基于这个HTTP remoting体系）。\n\n* **升级Spring**：将dubbo中Spring由2.x升级到目前最常用的3.x版本，减少版本冲突带来的麻烦。\n\n* **升级ZooKeeper客户端**：将dubbo中的zookeeper客户端升级到最新的版本，以修正老版本中包含的bug。\n\n* **支持完全基于Java代码的Dubbo配置**：基于Spring的Java Config，实现完全无XML的纯Java代码方式来配置dubbo\n\n* **调整Demo应用**：暂时将dubbo的demo应用调整并改写以主要演示REST功能、Dubbo协议的新序列化方式、基于Java代码的Spring配置等等。\n\n* **修正了dubbo的bug** 包括配置、序列化、管理界面等等的bug。\n\n**注：dubbox和dubbo 2.x是兼容的，没有改变dubbo的任何已有的功能和配置方式（除了升级了spring之类的版本）**\n\n## 文档资料\n\n[在Dubbo中开发REST风格的远程调用（RESTful Remoting）](https://dangdangdotcom.github.io/dubbox/rest.html)\n\n[在Dubbo中使用高效的Java序列化（Kryo和FST）](https://dangdangdotcom.github.io/dubbox/serialization.html)\n\n[使用JavaConfig方式配置dubbox](https://dangdangdotcom.github.io/dubbox/java-config.html)\n\n[Dubbo Jackson序列化使用说明](https://dangdangdotcom.github.io/dubbox/jackson.html)\n\n[Demo应用简单运行指南](https://dangdangdotcom.github.io/dubbox/demo.html)\n\n[Dubbox@InfoQ](http://www.infoq.com/cn/news/2014/10/dubbox-open-source) \n\n[Dubbox Wiki](https://github.com/dangdangdotcom/dubbox/wiki) （由社区志愿者自由编辑的）\n\n## 版本\n\n详见：https://github.com/dangdangdotcom/dubbox/releases\n\n* **dubbox-2.8.0**：主要支持REST风格远程调用、支持Kryo和FST序列化、升级了Spring和Zookeeper客户端、调整了demo应用等等\n* **dubbox-2.8.1**：主要支持基于嵌入式tomcat的http-remoting，优化了REST客户端性能，在REST中支持限制服务端接纳的最大HTTP连接数等等\n* **dubbox-2.8.2**：\n    * 支持REST中的HTTP logging，包括HTTP header的字段和HTTP body中的消息体，方便调试、日志纪录等等\n    * 提供辅助类便于REST的中文处理\n    * 改变使用`@Reference` annotation配置时的异常处理方式，即当用annotation配置时，过去dubbo在启动期间不抛出依赖服务找不到的异常，而是在具体调用时抛出NPE，这与用XML配置时的行为不一致。\n    * 较大的充实了Dubbo REST的文档\n* **dubbox-2.8.3**：\n    * 在REST中支持dubbo统一的方式用bean validation annotation作参数校验（沈理）\n    * 在RpcContext上支持获取底层协议的Request/Response（沈理）\n    * 支持采用Spring的Java Config方式配置dubbo（马金凯）\n    * 在Dubbo协议中支持基于Jackson的json序列化（Dylan）\n    * 在Spring AOP代理过的对象上支持dubbo annotation配置（Dylan）\n    * 修正Dubbo管理界面中没有consumer时出现空指针异常（马金凯）\n    * 修正@Reference annotation中protocol设置不起作用的bug（沈理）\n    * 修正@Reference annotation放在setter方法上即会出错的bug（Dylan）\n\n## 依赖\n\n从dubbox-2.8.4开始，所有依赖库的使用方式将和dubbo原来的一样：即如果要使用REST、Kyro、FST、Jackson等功能，需要用户自行手工添加相关的依赖。例如：\n\n### REST风格远程调用\n\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003eorg.jboss.resteasy\u003c/groupId\u003e\n    \u003cartifactId\u003eresteasy-jaxrs\u003c/artifactId\u003e\n    \u003cversion\u003e3.0.7.Final\u003c/version\u003e\n\u003c/dependency\u003e\n\u003cdependency\u003e\n    \u003cgroupId\u003eorg.jboss.resteasy\u003c/groupId\u003e\n    \u003cartifactId\u003eresteasy-client\u003c/artifactId\u003e\n    \u003cversion\u003e3.0.7.Final\u003c/version\u003e\n\u003c/dependency\u003e\n\u003cdependency\u003e\n    \u003cgroupId\u003ejavax.validation\u003c/groupId\u003e\n    \u003cartifactId\u003evalidation-api\u003c/artifactId\u003e\n    \u003cversion\u003e1.0.0.GA\u003c/version\u003e\n\u003c/dependency\u003e\n\n\u003c!-- 如果要使用json序列化 --\u003e\n\u003cdependency\u003e\n    \u003cgroupId\u003eorg.jboss.resteasy\u003c/groupId\u003e\n    \u003cartifactId\u003eresteasy-jackson-provider\u003c/artifactId\u003e\n    \u003cversion\u003e3.0.7.Final\u003c/version\u003e\n\u003c/dependency\u003e\n\n\u003c!-- 如果要使用xml序列化 --\u003e\n\u003cdependency\u003e\n    \u003cgroupId\u003eorg.jboss.resteasy\u003c/groupId\u003e\n    \u003cartifactId\u003eresteasy-jaxb-provider\u003c/artifactId\u003e\n    \u003cversion\u003e3.0.7.Final\u003c/version\u003e\n\u003c/dependency\u003e\n\n\u003c!-- 如果要使用netty server --\u003e\n\u003cdependency\u003e\n    \u003cgroupId\u003eorg.jboss.resteasy\u003c/groupId\u003e\n    \u003cartifactId\u003eresteasy-netty\u003c/artifactId\u003e\n    \u003cversion\u003e3.0.7.Final\u003c/version\u003e\n\u003c/dependency\u003e\n\n\u003c!-- 如果要使用Sun HTTP server --\u003e\n\u003cdependency\u003e\n    \u003cgroupId\u003eorg.jboss.resteasy\u003c/groupId\u003e\n    \u003cartifactId\u003eresteasy-jdk-http\u003c/artifactId\u003e\n    \u003cversion\u003e3.0.7.Final\u003c/version\u003e\n\u003c/dependency\u003e\n\n\u003c!-- 如果要使用tomcat server --\u003e\n\u003cdependency\u003e\n    \u003cgroupId\u003eorg.apache.tomcat.embed\u003c/groupId\u003e\n    \u003cartifactId\u003etomcat-embed-core\u003c/artifactId\u003e\n    \u003cversion\u003e8.0.11\u003c/version\u003e\n\u003c/dependency\u003e\n\u003cdependency\u003e\n    \u003cgroupId\u003eorg.apache.tomcat.embed\u003c/groupId\u003e\n    \u003cartifactId\u003etomcat-embed-logging-juli\u003c/artifactId\u003e\n    \u003cversion\u003e8.0.11\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n### Kyro序列化\n\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.esotericsoftware.kryo\u003c/groupId\u003e\n    \u003cartifactId\u003ekryo\u003c/artifactId\u003e\n    \u003cversion\u003e2.24.0\u003c/version\u003e\n\u003c/dependency\u003e\n\u003cdependency\u003e\n    \u003cgroupId\u003ede.javakaffee\u003c/groupId\u003e\n    \u003cartifactId\u003ekryo-serializers\u003c/artifactId\u003e\n    \u003cversion\u003e0.26\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n### FST序列化\n\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003ede.ruedigermoeller\u003c/groupId\u003e\n    \u003cartifactId\u003efst\u003c/artifactId\u003e\n    \u003cversion\u003e1.55\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n### Jackson序列化\n\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.fasterxml.jackson.core\u003c/groupId\u003e\n    \u003cartifactId\u003ejackson-core\u003c/artifactId\u003e\n    \u003cversion\u003e2.3.3\u003c/version\u003e\n\u003c/dependency\u003e\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.fasterxml.jackson.core\u003c/groupId\u003e\n    \u003cartifactId\u003ejackson-databind\u003c/artifactId\u003e\n    \u003cversion\u003e2.3.3\u003c/version\u003e\n\u003c/dependency\u003e\n```\n   \n## FAQ（暂存）\n\n### Dubbox需要什么版本的JDK？\n\n目前最好在JDK 1.7以上运行\n\n### Dubbo REST的服务能和Dubbo注册中心、监控中心集成吗？\n\n可以的，而且是自动集成的，也就是你在dubbo中开发的所有REST服务都会自动注册到服务册中心和监控中心，可以通过它们做管理。\n\n但是，只有当REST的消费端也是基于dubbo的时候，注册中心中的许多服务治理操作才能完全起作用。而如果消费端是非dubbo的，自然不受注册中心管理，所以其中很多操作是不会对消费端起作用的。\n\n### Dubbo REST中如何实现负载均衡和容错（failover）？\n\n如果dubbo REST的消费端也是dubbo的，则Dubbo REST和其他dubbo远程调用协议基本完全一样，由dubbo框架透明的在消费端做load balance、failover等等。\n\n如果dubbo REST的消费端是非dubbo的，甚至是非java的，则最好配置服务提供端的软负载均衡机制，目前可考虑用LVS、HAProxy、 Nginx等等对HTTP请求做负载均衡。\n\n### JAX-RS中重载的方法能够映射到同一URL地址吗？\n\nhttp://stackoverflow.com/questions/17196766/can-resteasy-choose-method-based-on-query-params\n\n### JAX-RS中作POST的方法能够接收多个参数吗？\n\nhttp://stackoverflow.com/questions/5553218/jax-rs-post-multiple-objects\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasurateam%2Fdubbos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fasurateam%2Fdubbos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasurateam%2Fdubbos/lists"}