dubbo 入门

1 介绍

1.1 背景

随着互联网的发展，网站应用的规模不断扩大，常规的垂直应用架构已无法应对，分布式服务架构以及流动计算架构势在必行，亟需一个治理系统确保架构有条不紊的演进。

1.2 说明

DUBBO是一个分布式服务框架，致力于提供高性能和透明化的RPC远程服务调用方案，是阿里巴巴SOA服务化治理方案的核心框架。

1.3 功能

启动时检查、集群容错、负载均衡、线程模型、直连提供者、只订阅、只注册、静态服务、多协议、多注册中心、服务分组、多版本、分组聚合、参数验证、结果缓存、泛化引用、泛化实现、回声测试、上下文信息、隐式传参、异步调用、本地调用、参数回调、事件通知、本地存根、本地伪装、延迟暴露、并发控制、连接控制、延迟连接、粘滞连接、令牌验证、路由规则、配置规则、服务降级、优雅停机、主机绑定、日志适配、访问日志、服务容器、Reference Config缓存、分布式事务

1.4 支持的协议

• dubbo

• rmi

• http

• webservice

• thrift

• memcached

• redis

---

2 环境准备

• Java7、Java8

• ZooKeeper

• Maven

• Tomcat7

• Eclipse

---

3 架构图

节点角色说明及对应demo模块：

• Provider: 暴露服务的服务提供方。对应dubbo-demo-provider。

• Consumer: 调用远程服务的服务消费方。对应dubbo-demo-consumer

• Registry: 服务注册与发现的注册中心。这个demo使用ZooKeeper，关于ZooKeeper的搭建可参考这篇文章。

• Monitor: 统计服务的调用次调和调用时间的监控中心。需要搭建dubbo-admin，对应的war包可从这里下载，也可自行编译运行。

• Container: 服务运行容器。使用Tomcat跟Jetty。

我的demo代码：https://github.com/JasperZXY/dubbo-demo

---

4 开始搭建项目

4.1 说明

下面的代码是在Java8下运行通过的。

4.2 创建maven项目

名称为dubbo-demo，加入需要的jar，这里把各个项目需要的jar包都放入了父pom中，实际项目最好做好分类，如下

    UTF-8
    4.12
    4.3.8.RELEASE
    2.5.3
    3.4.10
    0.10
    2.7.4
    
        junit
        junit
        ${junit.version}
        test
    

    
        org.springframework
        spring-webmvc
        ${spring.version}
    

    
    
        ch.qos.logback
        logback-classic
        1.1.3
    
    
        org.logback-extensions
        logback-ext-spring
        0.1.2
    
    
        org.slf4j
        jcl-over-slf4j
        1.7.12
    

    
        com.alibaba
        dubbo
        ${dubbo.version}
        
            
                
                spring
                org.springframework
            
        
    

    
    
        org.apache.zookeeper
        zookeeper
        ${zookeeper.version}
    
    
        com.github.sgroschupf
        zkclient
        0.1
    

    
        org.jboss.netty
        netty
        3.2.10.Final
    
    
        com.101tec
        zkclient
        ${zkclient.version}
    

    
    
        com.fasterxml.jackson.core
        jackson-databind
        ${jackson.version}
    
    
        com.fasterxml.jackson.core
        jackson-core
        ${jackson.version}
    
    
        com.fasterxml.jackson.core
        jackson-annotations
        ${jackson.version}
    

4.3 dubbo-demo-api

这个模块用于定义接口以及交互的实体对象，创建一个User跟UserService

public class User implements java.io.Serializable {    private static final long serialVersionUID = -2218791253527448503L;    private Long id;    private String username;    private String password;    private Integer age;    // 这里省略了get set 方法

    @Override
    public String toString() {        return "User [id=" + id + ", username=" + username + ", password=" + password + ", age=" + age + "]";
    }

}

public interface UserService {    public List queryAll();
}

4.4 dubbo-demo-provider

这个模块用于提供服务，是使用main方法直接运行的。

1、需要添加dubbo-demo-api这个依赖，pom.xml如下

    zxy.demo
    dubbo-demo-api
    ${project.parent.version}

2、UserService的实现

public class UserServiceImpl implements UserService {    /**     * 这里通过模拟查询数据库返回用户信息     */
    @Override
    public List queryAll() {
        List list = new ArrayList();        for (int i = 0; i < 3; i++) {
            Random random = new Random();
            User user = new User();
            user.setAge(random.nextInt(10) + 18);
            user.setId(Long.valueOf(i + 1));
            user.setPassword("123456");
            user.setUsername("name_" + i);
            list.add(user);
        }        return list;
    }
}

3、Spring配置

注：如果preferrence->XML->XML Catalog->add->catalog entry->file system，选择刚刚下载的文件路径，修改key值（dubbo.xsd），保存。在xml文件右键validate即可解决。

4、编写启动方法

ublic class Application {    @SuppressWarnings("resource")    public static void main(String[] args) throws Exception {
        (new ClassPathXmlApplicationContext(new String[] { "spring/provider.xml" })).start();        // 保持main方法不退出
        CountDownLatch latch = new CountDownLatch(1);
        latch.await();
    }

}

4.5 dubbo-demo-consumer

这个模块用于调用dubbo-demo-provider提供的服务，使用SpringMVC进行运行。

1、需要添加dubbo-demo-api这个依赖，pom.xml如下

    zxy.demo
    dubbo-demo-api
    ${project.parent.version}

2、Spring的配置

appContext.xml，主配置文件

springmvc-servlet.xml

    
        
            text/html;charset=UTF-8
        
    

dubbo-consumer.xml

3、web.xml

    
    
        contextConfigLocation
        classpath:spring/appContext.xml
    
    
        org.springframework.web.context.ContextLoaderListener
    
    
        ch.qos.logback.ext.spring.web.LogbackConfigListener
    

    
        springmvc
        org.springframework.web.servlet.DispatcherServlet
        
            contextConfigLocation
            
        
        1
    

    
        springmvc
        /
    
    

4、controller

调用远程服务并返回前端数据。

@Controller@RequestMapping("/user")public class UserController {    @Autowired
    private UserService userService;    
    @RequestMapping("/list")    @ResponseBody
    public Object listAll() {        return userService.queryAll();
    }
}

4.6 运行

1. 先启动ZooKeeper

2. 启动dubbo-demo-provider

3. 启动dubbo-demo-consumer，mvn jetty:run -Djetty.port=8083

4. 访问http://127.0.0.1:8083/user/list获取数据

---

5 监控

自行编译运行dubbo-admin或从我的git上下载dubbo-admin-2.5.3.war，放入tomcat中运行。默认用的注册中心是zookeeper://127.0.0.1:2181，可修改，在WEB-INF/dubbo.properties中进行修改。

启动后访问http://127.0.0.1:8080/dubbo-admin-2.5.3，如果war包是改名为ROOT.war后运行的，则访问http://127.0.0.1:8080/，输入账号密码（root/root）。

注意，由于现在很多机器都安装了高版本的Java8，运行这个dubbo-admin将导致出错，报错信息为“Bean property 'URIType'
is not writable or has an invalid setter method”，详见官方的issues。我自己的解决方法是下载一个低版本的Java，修改tomcat对应的Java版本，找到setclasspath.bat中的set _RUNJAVA，set _RUNJDB这两行，修改如下：

set _RUNJAVA="C:\Program Files\Java\jdk1.7.0_80\bin\java.exe"set _RUNJDB="C:\Program Files\Java\jdk1.7.0_80\bin\jdb.exe"