一个案例快速入门Dubbox开发

**一个案例快速入门Dubbox开发**

在之前的 [Dubbox的入门配置](http://tycoding.cn/2018/06/20/Dubbox/) 一文中我们了解如何部署注册中心`zookeeper`。那么接下来我们就该实战快速入门`Dubbox`框架开发。其实，我们这里实现的maven多模块项目无非就是讲各个`package`都拆分成一个个单独的项目，然后各个小项目之间通过依赖关系进行联系。`parent`模块负责管理所有的`jar`。而提供者的业务就需要暴露给注册中心；当消费者调用的时候就随机提供一个提供者地址给消费者。
这里我还要强调一点，`dubbo`在阿里停止维护后，由当当网继续维护，并命名为`dubbox`，而其并没有上传到maven中央仓库，所以我们使用maven中央仓库提供的jar包时不行的，可以用我提供的`2.8.4`版本的。

<!--more-->

项目源码，点击进入我的 [GitHub](https://github.com/TyCoding/dubboxdemo-parent)



**DubboxDemo项目导航帖**

1. [Dubbox入门配置](tycoding.cn/2018/06/20/Dubbox/)

2. [Dubbox入门之环境搭建](tycoding.cn/2018/06/24/DubboxDemo-ready/)

   

**项目注意细节之处**

1. `dubbox-xx.jar`，特别要要注意，我这里提供了一个版本的jar：`dubbo2.8.4.jar`传送门： [百度云](https://pan.baidu.com/s/17l9Bmlxz7vnni96T3rq0LQ)  密码：k8qs。
2. 注意配置各个模块之间的依赖关系。
3. 运行项目首先运行`service`模块，然后再运行`web`模块。且注意两者的Tomcat的端口号不能相同。
4. 运行项目之前首先需要在SecureCRT中打开服务器的`zookeeper`注册中心。

**项目测试环境**

-|:-:|-:

JDK1.8|Tomcat8|maven|IDEA



**项目目录结构**



# pom配置

## 解释

1. 这里不再贴pom的相关依赖，详细内容请查看GitHub上的源码。
2. 注意`parent`父项目中的`pom.xml`中定义的是jar依赖的相关版本，并不是写入进`parent`中`pom`的依赖都会被使用，只有子模块调用了，才会使用相应的依赖。

## 注意

1. 注意`dubbo-xx.jar`不能使用maven仓库中的依赖，可以选择使用我提供版本的jar。
2. 除了上面说的框架提供的相关依赖，我们还需要配置模块间的依赖关系。
3. 配置模块间的依赖关系除了idea的`Module Setting`，还需要手动添加`pom`坐标。
4. `Module Setting`的依赖配置遵循调用那个模块就配置哪个模块，`pom`坐标遵循常见的三层架构设计。

# 服务端配置

## Tomcat

1. 需要注意的就是端口号，部署到服务器上的项目（模块—）必须占用的端口号不同，而在idea中除了有`HTTP port`、还有`JMX port`，这两个端口配置都不能重复出现。
2. 启动项目（模块）时，先启动`service`生产者，再启动`web`消费者。

## zookeeper

1. `zookeeper`称为注册中心，所以启动`service`模块前首先要启动`zookeeper`。启动方式就是进入`bin`目录中输入`./zkServer.sh start`。
2. 需要在`service`以及`web`模块对应的spring配置文件中注册`dubbo`，并且配置连接`zookeeper`的地址。、

# Spring环境配置

## 介绍

Spring的配置其实一共有三个部分：

- `spring-service`
- `spring-dao`
- `springmvc`

分别对应的模块

- `service`模块
- `dao`模块
- `web`模块

**注意** 我们知道配置了`spring.xml`，就需要在`web.xml`中加载这些配置文件，因为我们已经建立了各个模块之间的依赖关系，所以，我们仅需要在`dao`或`service`模块任意一个的`web.xml`中使用通配符的方式加载配置文件即可。

## 代码编写

`beans-dao.xml`

```xml
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
    http://www.springframework.org/schema/beans/spring-beans-4.2.xsd
    http://www.springframework.org/schema/context
    http://www.springframework.org/schema/context/spring-context.xsd">

    <!-- 数据库连接池 -->
    <!-- 加载配置文件 -->
    <context:property-placeholder location="classpath:properties/db.properties"/>

    <!-- 数据库连接池 -->
    <bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" destroy-method="close">
        <property name="url" value="${jdbc.url}"/>
        <property name="username" value="${jdbc.username}"/>
        <property name="password" value="${jdbc.password}"/>
        <property name="driverClassName" value="${jdbc.driver}"/>
        <property name="maxActive" value="10"/>
        <property name="minIdle" value="5"/>
    </bean>

    <!-- 让spring管理sqlsessionfactory 使用mybatis和spring整合包中的 -->
    <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
        <!-- 数据库连接池 -->
        <property name="dataSource" ref="dataSource"/>
    </bean>
    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <property name="basePackage" value="cn.mapper"/>
    </bean>
</beans>
```

`beans-service.xml`

```xml
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       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.xsd
        http://code.alibabatech.com/schema/dubbo
        http://code.alibabatech.com/schema/dubbo/dubbo.xsd">
    <!-- 用dubbo协议在20881端口暴露服务 -->
    <dubbo:protocol name="dubbo" port="20881"/>
    <!-- 当前应用的名称(是注册中心识别的名称) -->
    <dubbo:application name="dubboxdemo-service"/>
    <!-- 注册中心地址(zookeeper) -->
    <dubbo:registry address="zookeeper://192.168.148.128:2181"/>
    <!-- 配置dubbo的包扫描 -->
    <dubbo:annotation package="cn.service.impl"/>
</beans>
```

这里我们需要注意的就是注册中心地址一定要填写正确，首先你需要**打开服务器**，**联网**，并使用SecureCRT**启动`zookeeper`**，这是正常启动项目的前提。第二点就是注意**配置dubbo的包扫描**，可以使用我提供的`dubbox-2.8.4.jar`，一定不要使用maven仓库的jar，那样一定会报错的。这里配置的包扫描，同样会扫描`@Controller`之类的Spring的注解，如果你使用maven仓库的dubbox，你会发现根本不能扫描到`@RequestMapping`，访问项目映射就是404。

对应`service`、`dao`任意一个模块中的`web.xml`

```xml
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xmlns="http://java.sun.com/xml/ns/javaee"
         xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
         version="2.5">

    <!-- 加载spring容器 -->
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath*:spring/beans-*.xml</param-value>
    </context-param>
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>
</web-app>
```



`spring-web.xml`

```xml
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:dubbo="http://code.alibabatech.com/schema/dubbo"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
       http://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/mvc
        http://www.springframework.org/schema/mvc/spring-mvc.xsd
        http://code.alibabatech.com/schema/dubbo
        http://code.alibabatech.com/schema/dubbo/dubbo.xsd">

    <!-- 当前应用名称（是注册中心识别的名称） -->
    <dubbo:application name="dubboxdemo-web"/>
    <!-- 注册中心地址(zookeeper) -->
    <dubbo:registry address="zookeeper://192.168.148.128:2181"/>
    <!-- 配置包扫描（同样不需要SpringMVC的包扫描） -->
    <dubbo:annotation package="cn.controller"/>

    <!-- SpringMVC的基本控制器 -->
    <mvc:annotation-driven/>
    <!-- 配置springmvc的视图解析器 -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/"/>
        <property name="suffix" value=".jsp"/>
    </bean>
</beans>
```



# 功能实现

## 查询功能

`Controller`



**注意**

1. 注意使用`dubbo`的`@Reference`注解完成依赖注入，但绝对不能使用`@Autowird`之类的注解完成注入的，这里调用的服务层是由远端提供的，并不是本地的服务对象，所以不能使用`@Autowird`注入。

我们看一下实际的`web`模块的目录结构：





`service`



如上所说，当我们调用的服务是由远端提供的，比如在这个案例中服务层是由`zookeeper`进行分配管理的，就使用`@REference`进行注入，如果你调用本地的服务，就可以使用`@Autowired`完成注入了。

看一下其目录结构



最后我们再看一下`dao`模块的目录结构





## 启动项目

1. 先连接服务器并打开`zookeeper`



1. 先启动`service`模块，再启动`web`模块

我这里再Tomcat中配置`service`模块的端口是9001；配置`web`模块的端口是9101



1. 在浏览器中查看项目功能





<br/>

# 交流

如果大家有兴趣，欢迎大家加入我的Java交流群：671017003 ，一起交流学习Java技术。博主目前一直在自学JAVA中，技术有限，如果可以，会尽力给大家提供一些帮助，或是一些学习方法，当然群里的大佬都会积极给新手答疑的。所以，别犹豫，快来加入我们吧！

<br/>

# 联系

If you have some questions after you see this article, you can contact me or you can find some info by clicking these links.

- [Blog@TyCoding's blog](http://www.tycoding.cn)
- [GitHub@TyCoding](https://github.com/TyCoding)
- [ZhiHu@TyCoding](https://www.zhihu.com/people/tomo-83-82/activities)