Dubbox框架使用手册

Dubbox框架使用手册

1、概述

1.1、dubbox简介

dubbox是dubbo的扩展，主要在dubbo的基础上进行了一下的改进：

1. 支持REST风格远程调用（HTTP + JSON/XML)：基于非常成熟的JBoss RestEasy框架，在dubbo中实现了REST风格（HTTP + JSON/XML）的远程调用，以显著简化企业内部的跨语言交互，同时显著简化企业对外的Open API、无线API甚至AJAX服务端等等的开发。事实上，这个REST调用也使得Dubbo可以对当今特别流行的“微服务”架构提供基础性支持。 另外，REST调用也达到了比较高的性能，在基准测试下，HTTP + JSON与Dubbo 2.x默认的RPC协议（即TCP + Hessian2二进制序列化）之间只有1.5倍左右的差距，详见文档中的基准测试报告。
2. 支持基于Kryo和FST的Java高效序列化实现：基于当今比较知名的Kryo和FST高性能序列化库，为Dubbo默认的RPC协议添加新的序列化实现，并优化调整了其序列化体系，比较显著的提高了Dubbo RPC的性能，详见文档中的基准测试报告。
3. 支持基于Jackson的JSON序列化：基于业界应用最广泛的Jackson序列化库，为Dubbo默认的RPC协议添加新的JSON序列化实现。
4. 支持基于嵌入式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体系）。
5. 升级Spring：将dubbo中Spring由2.x升级到目前最常用的3.x版本，减少版本冲突带来的麻烦。
6. 升级ZooKeeper客户端：将dubbo中的zookeeper客户端升级到最新的版本，以修正老版本中包含的bug。
7. 支持完全基于Java代码的Dubbo配置：基于Spring的Java Config，实现完全无XML的纯Java代码方式来配置dubbo
8. 调整Demo应用：暂时将dubbo的demo应用调整并改写以主要演示REST功能、Dubbo协议的新序列化方式、基于Java代码的Spring配置等等。
9. 修正了dubbo的bug 包括配置、序列化、管理界面等等的bug。

1.2、Dubbox应用场景：

借用Java过去最流行的宣传语，为dubbo添加REST调用后，可以实现服务的”一次编写，到处访问“，理论上可以面向全世界开放，从而真正实现比较理想化的面向服务架构（SOA）。
当然，传统的WebServices（WSDL/SOAP）也基本同样能满足以上场景（除了场景4）的要求（甚至还能满足那些需要企业级特性的场景），但由于其复杂性等问题，现在已经越来越少被实际采用了。

2、环境与版本说明

2.1、在虚拟机中安装Centos7（安装参见）
2.2、Zookeeper版本3.4.14
2.3、Dubbo版本2.8.4

3、配置Dubbox模板的Demo项目

3.1、 下载Dubbo源代码 下载地址
3.2、 将源代码解压导入到eclipse中
3.3、 修改dubbo-demo模块下的dubbo-demo-provider/src/main/resources/META-INF/
spring/dubbo-demo-provider.xml文件

3.4.、修改dubbo-demo模块下的dubbo-demo-consuer/src/main/resources/META-INF/
spring/dubbo-demo-provider.xml文件
3.5、首先运行dubbo-demo-provider下的Demo Provider.java，运行成功后运行dubbo-demo-consumer下的DemoConsumer.java以及RestClient观察运行结果，成功后再次运行dubbo-demo-consumer下的RestClient.java，观察运行就结果，如果出现如下结构说明已经配置成功。

4.、手动构建简单的Dubbox项目

4.1、 在eclipse上创建一个maven工程
4.2、 修改pom文件的packing为pom形式
4.3、 在pom文件中创建modules
4.4、 修改pom文件
点击dubbo-provider下的pom文件的dependencies选项，在其中添加dependency，并删除pom文件中的packaging标签（如果项目还是报错右键当前项目选择java ee tools中的Generate Deployment Descriptor stub选项）

修改其pom文件，修改后的pom文件如下

4.5、 在dubbox-api项目中新建一个接口

4.6、 在dubbox-provider项目中新建一个接口实现类、项目启动以及配置文件



4.7、 运行provider
4.8、 在浏览器中访问http://localhost:8080/demo/hello观察结果

4.9、 注意事项

1. 实现rest时，配置文件中的协议必须添加rest协议，协议所使用的服务器可以为tomcat也可以使用netty等。
2. 配置rest协议时的端口号必须与服务器相同。
3. Provider中使用的注解path是接口的访问地址
4. Provider中可以通过get与post注解来控制该接口被访问的方式
5. 当时用@Consumes({MediaType.APPLICATION_JSON})注解时是指定了接口接收JSON格式的数据。REST框架会自动将JSON数据反序列化为对象

参考链接
https://blog.csdn.net/nmyphp/article/details/79174225
https://blog.csdn.net/airenone/article/details/61923198