Skip to content
/ dubboy Public
forked from dangdangdotcom/dubbox

Dubboy is based dubbox, the 'y' is short for yfss. Dubbox now means Dubbo eXtensions, and it adds features like RESTful remoting, Kyro/FST serialization, etc to the Dubbo service framework.

dangdangdotcom.github.io/dubbox

License

Apache-2.0 license
0 stars 26.5k forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

hotcoffee/dubboy

BranchesTags
 
 

Repository files navigation

Dubboy is based dubbox, the 'y' is short for yfss.

##YFSS 更新部分 作者：BruceZCQ

#####REST协议 修改初始端口为18080

#####添加RestExceptionMapper,主要是

  • RestForbiddenExceptionMapper[403];
  • RestNotAcceptableExceptionMapper[406];
  • RestNotAllowedExceptionMapper[405];
  • RestNotAuthorizedExceptionMapper[403];
  • RestNotFoundExceptionMapper[404];
  • RestNotSupportedExceptionMapper[415];
  • RestRedirectionExceptionMapper[3xx];
  • RestServerErrorExceptionMapper[500];
  • RestServiceUnavailableExceptionMapper[503];

在使用rest协议时会注册(setExtension)到protocol;

#####加入dubbo-apiconfig工具类,主要是 com.alibaba.dubbo.common.service.export.support

  • DubboApplication.java
  • Log4jApplication.java
  • MethodUtils.java
  • PropertiesData.java
  • PropertiesDataUtils.java
  • Protocol.java

com.alibaba.dubbo.config.service.export

  • ServiceExporter.java
  • ServiceExportServer.java
  • ServiceServer.java (用于app的cache和db配置,无需server.properties)

#####ServiceServer 使用方式

	public class Main {
	
	/**
	 * @param args
	 * @throws InterruptedException 
	 */
	public static void main(String[] args) throws InterruptedException {
		new ServiceServer(1) {
			
			@Override
			public void onStart() {
						new FileSystemXmlApplicationContext("provider.xml");
			}
			
			@Override
			public void onInitDb() {
				
			}
			
			@Override
			public void onInitCache() {
				
			}
		};
		Thread.currentThread().join();
	}
}

#####Deploy

  • 目录结构

     	.

├── cfg │   ├── log4j.properties │   └── server.properties ├── lib │   ├── FastInfoset-1.2.12.jar ... │   ├── zkclient-0.1.jar │   └── zookeeper-3.4.6.jar └── sfs-mobile.sh ```

  • 启动脚本
#!/usr/bin/env bash

JAVA_CMD="java"
CPATH="./:lib/*"
ID="1"
if [ "x$2" != "x" ]
then 
	ID="$2";
fi
PIDFILE="cfg/sfsmobileserver${ID}.pid"

case $1 in
start)
	echo "Starting Server${ID}..."
	if [ -f "$PIDFILE" ]; then
      if kill -0 `cat "$PIDFILE"` > /dev/null 2>&1; then
         echo $command already running as process `cat "$PIDFILE"`. 
         exit 0
      fi
    fi
	${JAVA_CMD} -cp ${CPATH} -server com.ikaihuo.bis.mobile.server.Main ${ID} &
	;;
stop)
	echo "Stoping Server${ID}..."
	if [ ! -f "$PIDFILE" ]
    then
      echo "no server to stop (could not find file $PIDFILE)"
    else
		kill `cat "$PIDFILE"`
		rm "$PIDFILE"
		echo "Stoped Server${ID}!"
	fi
	exit 0
	;;
*)
    echo "Usage: $0 {start|stop} [server_id=1] [debug|release]" 
    ;;
esac

说明：com.ikaihuo.bis.mobile.server.Main为启动函数入口; PIDFILE="cfg/sfsmobileserver${ID}.pid"为生成 pid 的位置和命名

工具类主要完成对apiconfig的封装，以及对一台服务器多个dubbo节点的支持(实际使用中可能不会在一台机器上部署多个dubbo节点，这里只是为了满足可以在一台机器上运行多个节点——多个节点本质就是端口不一样)；

#####配置说明(使用ServiceExportServer时) 配置主要在server.properties中

#application 配置application相关信息
#application的name
application.name=
#application的版本号，此信息会作为dubbo的provider的版本号，同时也会作为rest的contextpath[http://localhost:restport/application.version/xxx]
application.version=v1
#日志存放目录
application.logdir=/var/log/

#registry注册中心信息
registry.address=zookeeper://127.0.0.1:2181
registry.username=
registry.password=
#serviceserialization 序列化类型
dubbo.serialization=kryo
#service protocols with start port协议及其起始端口，在不同的dubbo节点有特定的id，对于当前dubbo节点的port就是起始port+id，多个协议使用“,”分割,每个协议的起始端口使用"dubbo:20880"的格式
dubbo.protocols=dubbo:20880,rest:8080
#线程数量
dubbo.threads=500
#service conf，rest server类型，使用不同的server需要加入响应的lib
dubbo.rest.server=netty

Dubbox now means Dubbo eXtensions. If you know java, javax and dubbo, you know what dubbox is :)

Dubbox adds features like RESTful remoting, Kyro/FST serialization, etc to the popular dubbo service framework. It's been used by several projects of dangdang.com, which is one of the major e-commerce companies in China.

主要贡献者

讨论QQ群：258792161 （不限于dubbox，包括SOA设计、互联网技术等等兴趣交流）

Dubbox当前的主要功能

  • 支持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倍左右的差距，详见文档中的基准测试报告。

  • 支持基于Kryo和FST的Java高效序列化实现：基于当今比较知名的Kryo和FST高性能序列化库，为Dubbo默认的RPC协议添加新的序列化实现，并优化调整了其序列化体系，比较显著的提高了Dubbo RPC的性能，详见文档中的基准测试报告。

  • 支持基于Jackson的JSON序列化：基于业界应用最广泛的Jackson序列化库，为Dubbo默认的RPC协议添加新的JSON序列化实现。

  • 支持基于嵌入式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体系）。

  • 升级Spring：将dubbo中Spring由2.x升级到目前最常用的3.x版本，减少版本冲突带来的麻烦。

  • 升级ZooKeeper客户端：将dubbo中的zookeeper客户端升级到最新的版本，以修正老版本中包含的bug。

  • 支持完全基于Java代码的Dubbo配置：基于Spring的Java Config，实现完全无XML的纯Java代码方式来配置dubbo

  • 调整Demo应用：暂时将dubbo的demo应用调整并改写以主要演示REST功能、Dubbo协议的新序列化方式、基于Java代码的Spring配置等等。

  • 修正了dubbo的bug 包括配置、序列化、管理界面等等的bug。

注：dubbox和dubbo 2.x是兼容的，没有改变dubbo的任何已有的功能和配置方式（除了升级了spring之类的版本）

文档资料

在Dubbo中开发REST风格的远程调用（RESTful Remoting）

在Dubbo中使用高效的Java序列化（Kryo和FST）

使用JavaConfig方式配置dubbox

Dubbo Jackson序列化使用说明

Demo应用简单运行指南

Dubbox@InfoQ

Dubbox Wiki （由社区志愿者自由编辑的）

版本

详见：https://github.com/dangdangdotcom/dubbox/releases

  • dubbox-2.8.0：主要支持REST风格远程调用、支持Kryo和FST序列化、升级了Spring和Zookeeper客户端、调整了demo应用等等
  • dubbox-2.8.1：主要支持基于嵌入式tomcat的http-remoting，优化了REST客户端性能，在REST中支持限制服务端接纳的最大HTTP连接数等等
  • dubbox-2.8.2：
    • 支持REST中的HTTP logging，包括HTTP header的字段和HTTP body中的消息体，方便调试、日志纪录等等
    • 提供辅助类便于REST的中文处理
    • 改变使用@Reference annotation配置时的异常处理方式，即当用annotation配置时，过去dubbo在启动期间不抛出依赖服务找不到的异常，而是在具体调用时抛出NPE，这与用XML配置时的行为不一致。
    • 较大的充实了Dubbo REST的文档
  • dubbox-2.8.3：
    • 在REST中支持dubbo统一的方式用bean validation annotation作参数校验（沈理）
    • 在RpcContext上支持获取底层协议的Request/Response（沈理）
    • 支持采用Spring的Java Config方式配置dubbo（马金凯）
    • 在Dubbo协议中支持基于Jackson的json序列化（Dylan）
    • 在Spring AOP代理过的对象上支持dubbo annotation配置（Dylan）
    • 修正Dubbo管理界面中没有consumer时出现空指针异常（马金凯）
    • 修正@Reference annotation中protocol设置不起作用的bug（沈理）
    • 修正@Reference annotation放在setter方法上即会出错的bug（Dylan）

依赖

从dubbox-2.8.4开始，所有依赖库的使用方式将和dubbo原来的一样：即如果要使用REST、Kyro、FST、Jackson等功能，需要用户自行手工添加相关的依赖。例如：

REST风格远程调用

<dependency>
    <groupId>org.jboss.resteasy</groupId>
    <artifactId>resteasy-jaxrs</artifactId>
    <version>3.0.7.Final</version>
</dependency>
<dependency>
    <groupId>org.jboss.resteasy</groupId>
    <artifactId>resteasy-client</artifactId>
    <version>3.0.7.Final</version>
</dependency>
<dependency>
    <groupId>javax.validation</groupId>
    <artifactId>validation-api</artifactId>
    <version>1.0.0.GA</version>
</dependency>

<!-- 如果要使用json序列化 -->
<dependency>
    <groupId>org.jboss.resteasy</groupId>
    <artifactId>resteasy-jackson-provider</artifactId>
    <version>3.0.7.Final</version>
</dependency>

<!-- 如果要使用xml序列化 -->
<dependency>
    <groupId>org.jboss.resteasy</groupId>
    <artifactId>resteasy-jaxb-provider</artifactId>
    <version>3.0.7.Final</version>
</dependency>

<!-- 如果要使用netty server -->
<dependency>
    <groupId>org.jboss.resteasy</groupId>
    <artifactId>resteasy-netty</artifactId>
    <version>3.0.7.Final</version>
</dependency>

<!-- 如果要使用Sun HTTP server -->
<dependency>
    <groupId>org.jboss.resteasy</groupId>
    <artifactId>resteasy-jdk-http</artifactId>
    <version>3.0.7.Final</version>
</dependency>

<!-- 如果要使用tomcat server -->
<dependency>
    <groupId>org.apache.tomcat.embed</groupId>
    <artifactId>tomcat-embed-core</artifactId>
    <version>8.0.11</version>
</dependency>
<dependency>
    <groupId>org.apache.tomcat.embed</groupId>
    <artifactId>tomcat-embed-logging-juli</artifactId>
    <version>8.0.11</version>
</dependency>

Kyro序列化

<dependency>
    <groupId>com.esotericsoftware.kryo</groupId>
    <artifactId>kryo</artifactId>
    <version>2.24.0</version>
</dependency>
<dependency>
    <groupId>de.javakaffee</groupId>
    <artifactId>kryo-serializers</artifactId>
    <version>0.26</version>
</dependency>

FST序列化

<dependency>
    <groupId>de.ruedigermoeller</groupId>
    <artifactId>fst</artifactId>
    <version>1.55</version>
</dependency>

Jackson序列化

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-core</artifactId>
    <version>2.3.3</version>
</dependency>
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.3.3</version>
</dependency>

FAQ（暂存）

Dubbox需要什么版本的JDK？

目前最好在JDK 1.7以上运行

Dubbo REST的服务能和Dubbo注册中心、监控中心集成吗？

可以的，而且是自动集成的，也就是你在dubbo中开发的所有REST服务都会自动注册到服务册中心和监控中心，可以通过它们做管理。

但是，只有当REST的消费端也是基于dubbo的时候，注册中心中的许多服务治理操作才能完全起作用。而如果消费端是非dubbo的，自然不受注册中心管理，所以其中很多操作是不会对消费端起作用的。

Dubbo REST中如何实现负载均衡和容错（failover）？

如果dubbo REST的消费端也是dubbo的，则Dubbo REST和其他dubbo远程调用协议基本完全一样，由dubbo框架透明的在消费端做load balance、failover等等。

如果dubbo REST的消费端是非dubbo的，甚至是非java的，则最好配置服务提供端的软负载均衡机制，目前可考虑用LVS、HAProxy、 Nginx等等对HTTP请求做负载均衡。

JAX-RS中重载的方法能够映射到同一URL地址吗？

http://stackoverflow.com/questions/17196766/can-resteasy-choose-method-based-on-query-params

JAX-RS中作POST的方法能够接收多个参数吗？

http://stackoverflow.com/questions/5553218/jax-rs-post-multiple-objects

About

Dubboy is based dubbox, the 'y' is short for yfss. Dubbox now means Dubbo eXtensions, and it adds features like RESTful remoting, Kyro/FST serialization, etc to the Dubbo service framework.

dangdangdotcom.github.io/dubbox

Resources

Readme

License

Apache-2.0 license
Activity

Stars

0 stars

Watchers

1 watching

Forks

0 forks
Report repository

Releases

51 tags

Packages

No packages published

Languages

  • Java 98.3%
  • JavaScript 1.1%
  • CSS 0.3%
  • Shell 0.2%
  • Batchfile 0.1%
  • Lex 0.0%