dubbo 入门

时间 2019-12-08

标签 dubbo 入门栏目 Dubbo 繁體版

原文原文链接

1 介绍

1.1 背景

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

1.2 说明

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

1.3 功能

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

1.4 支持的协议

dubbo
rmi
http
webservice
thrift
memcached
redis

2 环境准备

Java七、Java8
ZooKeeper
Maven
Tomcat7
Eclipse

3 架构图

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

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-demogithub

4 开始搭建项目

4.1 说明

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

4.2 建立maven项目

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

<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <junit.version>4.12</junit.version>
    <spring.version>4.3.8.RELEASE</spring.version>
    <dubbo.version>2.5.3</dubbo.version>
    <zookeeper.version>3.4.10</zookeeper.version>
    <zkclient.version>0.10</zkclient.version>
    <jackson.version>2.7.4</jackson.version>
</properties>

<dependencies>
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>${junit.version}</version>
        <scope>test</scope>
    </dependency>

    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>${spring.version}</version>
    </dependency>

    <!--Spring MVC集成slf4j-logback -->
    <dependency>
        <groupId>ch.qos.logback</groupId>
        <artifactId>logback-classic</artifactId>
        <version>1.1.3</version>
    </dependency>
    <dependency>
        <groupId>org.logback-extensions</groupId>
        <artifactId>logback-ext-spring</artifactId>
        <version>0.1.2</version>
    </dependency>
    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>jcl-over-slf4j</artifactId>
        <version>1.7.12</version>
    </dependency>

    <dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>dubbo</artifactId>
        <version>${dubbo.version}</version>
        <exclusions>
            <exclusion>
                <!-- 排除传递spring依赖，防止冲突 -->
                <artifactId>spring</artifactId>
                <groupId>org.springframework</groupId>
            </exclusion>
        </exclusions>
    </dependency>

    <!-- 导入zookeeper依赖 -->
    <dependency>
        <groupId>org.apache.zookeeper</groupId>
        <artifactId>zookeeper</artifactId>
        <version>${zookeeper.version}</version>
    </dependency>
    <dependency>
        <groupId>com.github.sgroschupf</groupId>
        <artifactId>zkclient</artifactId>
        <version>0.1</version>
    </dependency>

    <dependency>
        <groupId>org.jboss.netty</groupId>
        <artifactId>netty</artifactId>
        <version>3.2.10.Final</version>
    </dependency>
    <dependency>
        <groupId>com.101tec</groupId>
        <artifactId>zkclient</artifactId>
        <version>${zkclient.version}</version>
    </dependency>

    <!-- jackson -->
    <dependency>
        <groupId>com.fasterxml.jackson.core</groupId>
        <artifactId>jackson-databind</artifactId>
        <version>${jackson.version}</version>
    </dependency>
    <dependency>
        <groupId>com.fasterxml.jackson.core</groupId>
        <artifactId>jackson-core</artifactId>
        <version>${jackson.version}</version>
    </dependency>
    <dependency>
        <groupId>com.fasterxml.jackson.core</groupId>
        <artifactId>jackson-annotations</artifactId>
        <version>${jackson.version}</version>
    </dependency>
</dependencies>

4.3 dubbo-demo-api

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

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<User> queryAll();
}

4.4 dubbo-demo-provider

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

一、须要添加dubbo-demo-api这个依赖，pom.xml以下apache

<dependency>
    <groupId>zxy.demo</groupId>
    <artifactId>dubbo-demo-api</artifactId>
    <version>${project.parent.version}</version>
</dependency>

二、UserService的实现

public class UserServiceImpl implements UserService {
    /**
     * 这里经过模拟查询数据库返回用户信息
     */
    @Override
    public List<User> queryAll() {
        List<User> list = new ArrayList<User>();
        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;
    }
}

三、Spring配置

<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:context="http://www.springframework.org/schema/context" xmlns:p="http://www.springframework.org/schema/p"
    xmlns:aop="http://www.springframework.org/schema/aop" xmlns:tx="http://www.springframework.org/schema/tx"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:dubbo="http://code.alibabatech.com/schema/dubbo"
    xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-4.0.xsd
    http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsd
    http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-4.0.xsd http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-4.0.xsd
    http://code.alibabatech.com/schema/dubbo http://code.alibabatech.com/schema/dubbo/dubbo.xsd">

    <!-- 提供方应用信息,用于计算依赖关系 -->
    <dubbo:application name="dubbo-demo-provider"/>
    
    <!-- 这里使用的注册中心是zookeeper -->
    <dubbo:registry address="zookeeper://127.0.0.1:2181" client="zkclient" />
    
    <!-- 用dubbo协议在20880端口暴露服务 -->
    <dubbo:protocol name="dubbo" port="20880" />
    
    <!-- 将该接口暴露到dubbo中 -->
    <dubbo:service interface="zxy.demo.dubbo.api.service.UserService" ref="userServiceImpl"/>

    <!-- 将具体的实现类加入到Spring容器中 -->
    <bean id="userServiceImpl" class="zxy.demo.dubbo.provider.service.UserServiceImpl" />
</beans>

注：若是<dubbo:标签有报错的，可下载一个dubbo.xsd文件（可从个人git上找到），在Eclipse上windows->preferrence->XML->XML Catalog->add->catalog entry->file system，选择刚刚下载的文件路径，修改key值（dubbo.xsd），保存。在xml文件右键validate便可解决。

四、编写启动方法

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进行运行。

一、须要添加dubbo-demo-api这个依赖，pom.xml以下

<dependency>
    <groupId>zxy.demo</groupId>
    <artifactId>dubbo-demo-api</artifactId>
    <version>${project.parent.version}</version>
</dependency>

二、Spring的配置

appContext.xml，主配置文件

<context:component-scan base-package="zxy.demo.dubbo.consumer">
</context:component-scan>

<import resource="classpath*:spring/dubbo-*.xml"/>
<import resource="classpath*:spring/springmvc-servlet.xml"/>

springmvc-servlet.xml

<mvc:annotation-driven />

dubbo-consumer.xml

<!-- 提供方应用信息，用于计算依赖关系 -->
<dubbo:application name="dubbo-demo-consumer" />

<!-- 这里使用的注册中心是zookeeper -->
<dubbo:registry address="zookeeper://127.0.0.1:2181"
    client="zkclient" />

<!-- 从注册中心中查找服务 -->
<dubbo:reference id="userService"
    interface="zxy.demo.dubbo.api.service.UserService" />

三、web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="3.0" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
    http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd">
    
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:spring/appContext.xml</param-value>
    </context-param>
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>
    <listener>
        <listener-class>ch.qos.logback.ext.spring.web.LogbackConfigListener</listener-class>
    </listener>

    <servlet>
        <servlet-name>springmvc</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value></param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>

    <servlet-mapping>
        <servlet-name>springmvc</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>
    
</web-app>

四、controller

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

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

4.6 运行

先启动ZooKeeper
启动dubbo-demo-provider
启动dubbo-demo-consumer，mvn jetty:run -Djetty.port=8083
访问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"

6 参考

http://dubbo.io/
http://dubbo.io/User+Guide-zh.htm
http://dubbo.io/Developer+Guide-zh.htm
https://github.com/alibaba/dubbo
https://github.com/alibaba/dubbo/issues/50
http://www.jianshu.com/p/302001c1c21f

1. dubbo入门zookeeper入门
2. dubbo入门
3. Dubbo 入门
4. Dubbo,Zookeeper入门
5. Dubbo入门Demo
6. Dubbo入门（一）
7. Dubbo入门
8. 1.Dubbo入门
9. dubbo入门(1)——dubbo-demo
10. Dubbo——Dubbo入门概述
更多相关文章...
• Memcached入门教程 - NoSQL教程
• Neo4j数据库入门教程 - NoSQL教程
• YAML 入门教程
• Java Agent入门实战（一）-Instrumentation介绍与使用