# DubboM

**Repository Path**: jindoudou/DubboM

## Basic Information

- **Project Name**: DubboM
- **Description**: dubbo微服务容器
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 9
- **Created**: 2016-03-30
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

#DubboM——Dubbo Micro

##目的
通过利用`Dubbo`的扩展性以及RPC的模型开发一个满足微服务的要求，通过构建一个RPC的环境，让应用在不依赖外部第三方容器能够进行服务的发布和调用，从而打到应用的隔离以及完整性。应用应该只需要关注与它的服务实现以及服务的调用，而不需要关注服务在处于什么样的一个环境，基于这个便构建了`DubboM(Dubbo Micro)`。
##和其他的RPC框架有什么不同
可以说`DubboM`是基于RPC框架而开发的，是一次进一步的升华。由于企业需要用的不只是一个进行具备RPC功能的框架，而是需要一个基于RPC可实施的方案。框架本身可以理解为一个种工具，而方案则是解决某些业务场景。那么`DubboM`是解决什么场景呢？那就是微服务。微服务可以理解是一种拆分，一种解耦，一种更细致的服务化途径，同时也是让应用更加轻巧。`DubboM`提供微服务运行需要的RPC通信环境，并且不依赖外部传统的servlet容器，从而让应用更加清爽。
##项目获取
如果你还不熟悉git，或者不知道git是什么，请百度，根据相关文档完成git安装以及基本使用

通过一下命令获取`DubboM`源码：

`git clone https://git.oschina.net/bieber/DubboM.git`

##构建项目

此处假设你通过上面的`git`命令把源码下载到本地的`/git/DubboM`下（后面均以`${DubboM_Source_Home}`）.

`cd ${DubboM_Source_Home}`到该目录下面,执行如下目录

`./install-${rpc_type}.bat(sh)`其中`${rpc_type}`分别是`dubbo`，`restful`,`dubbo-netty4`和`all`，主要是围绕两种协议来做打包，分别是`dubbo`和`restful`，而`all`是同时打一个包含`dubbo`和`restful`协议的包，并且此时`dubbo`协议是通过`netty4`来实现，`dubbo-netty4`是打出netty4实现的`dubbo`协议。

执行完上面脚本之后，在`${DubboM_Source_Home}/target`下面会有`DubboM-launcher`目录，该目录下有如下几个文件夹：

`bin`:启动该DubboM-launcher脚本

`conf`:该应用相关的配置，会加载到`classpath`下面

`libs`:DubboM依赖的相关jar文件

`apps`:该DubboM-launcher负责启动的dubbom应用，将该应用的jar以及相关依赖的jar添加到该目录下

###什么是DubboM-launcher

你可能会问什么是`DubboM-launcher`,`DubboM-launcher`可以理解为是一个DubboM应用的启动器，可以简单理解为和servlet容器的tomcat或者jetty类似，但是唯一不同的是tomcat可以管理多个应用实体，但是`DubboM-launcher`有且只能有一个应用，只要你把你的应用jar拷贝到apps目录下，你可以把`DubboM-launcer`
拷贝到任何地方，任何物理节点，或者虚机或者是docker，因为它已经具备了该应用运行的完整环境。

##搭建DubboM项目
首先创建一个`maven`项目，并且在`pom`中添加如下依赖：

```xml
<dependency>
    <groupId>net.dubboclub</groupId>
    <artifactId>DubboM-all</artifactId>
    <version>BF-EF-1.0.1</version>
    <scope>provide</scope>
</dependency>

```

注意此时的`scope`是`provide`，因为这只是为了让代码编译通过，并不是涉及项目的打包。

接下来需要进行的就是和用`dubbo`框架开发RPC服务或者消费服务一样以及应用自身的业务开发。

###依赖dubbom的插件

为了更加便捷的进行`DubboM`的开发，这边提供了一个maven的插件。需要在你的项目pom中添加如下信息

```xml
<build>
        <plugins>
            <plugin>
                <groupId>net.dubboclub.maven</groupId>
                <artifactId>dubbom-maven-plugin</artifactId>
                <version>1.0.4</version>
                <configuration>
                		<!--配置dubbom的配置文件，该配置文件的配置内容和dubbo.properties一样,默认是classpath下面的dubbom.properties-->
                    <dubbomProperties>dubbo.properties</dubbomProperties>
                    <!--配置spring相关xml的配置文件路径，默认是classpath*:META-INF/spring/*.xml-->
                    <springXMLPath>classpath*:META-INF/spring/*.xml</springXMLPath>
                    <!--项目输出目录，默认是在项目的target下的项目名下(target/${projectname})-->
                    <targetDir>/User/bieber/dubbom-provider</targetDir>
                </configuration>
            </plugin>
        </plugins>
</build>
```
注意：上面添加的插件依赖，必须是添加在你`maven`项目的主模块里面。

同时在maven的`setting.xml`中添加相关配置

```xml
<setting>
......
 <pluginGroups>
    <pluginGroup>net.dubboclub.maven</pluginGroup>
  </pluginGroups>
......
</setting>
```

依赖这些便完成了对`DubboM`项目开发所需要准备的信息。

##对DubboM项目进行打包
通过上面依赖`dubbom`的maven插件，可以通过运行该插件来进行打包。

通过执行`mvn install dubbom:pack`，那么就会把项目编译后的jar输出在配置的`targetDir`下面

##对DubboM项目开发调试
同样通过`dubbom`的maven插件，也可以进行开发调试

执行`mvn install dubbom:run`

##对DubboM项目发布部署

项目的发布比较简单，只需要将上面执行打包的输出在`targetDir`下面的`jar`全部拷贝到`DubboM-launcher`(后面成为`${DubboM-launcher-HOME}`)的`apps`下面。然后执行`${DubboM-launcher-HOME}/bin`目录下的`start.sh(bat)`则启动了该应用。

注意：在启动应用之前，请确认是否将`${DubboM-launcher-HOME}/conf/dubbom.properties`文件配置完毕。

这里有一个`DubboM`的demo的地址：https://git.oschina.net/bieber/dubbom-demo.git