编辑 | blame | 历史 | 原始文档

模块介绍

框架的模块结构如下:
BladeX ├── blade-auth -- 授权服务提供 ├── blade-common -- 常用工具封装包 ├── blade-gateway -- Spring Cloud 网关 ├── blade-ops -- 运维中心 ├ ├── blade-admin -- 服务监控 ├ ├── blade-develop -- 代码生成 ├ ├── blade-flow -- 工作流 ├ ├── blade-flow-design -- 工作流设计器 ├ ├── blade-log -- 日志模块 ├ ├── blade-resource -- 资源模块 ├ ├── blade-turbine -- 监控控制台 ├ ├── blade-xxljob -- 分布式任务调度 ├ ├── blade-xxljob-admin -- 分布式任务调度后端 ├ └── blade-zipkin -- 分布式链路追踪 ├── blade-service -- 业务模块 ├ ├── blade-desk -- 工作台模块 ├ ├── blade-system -- 系统模块 ├ └── blade-user -- 用户模块 ├── blade-service-api -- 业务模块api封装 ├ ├── blade-desk-api -- 工作台api ├ ├── blade-dict-api -- 字典api ├ ├── blade-scope-api -- 数据权限api ├ ├── blade-system-api -- 系统api └── └── blade-user-api -- 用户api
日常开发中,我们用的最多的模块则是blade-service以及blade-service-api.
* blade-service主要编写业务模块
* blade-service-api主要为其他业务模块提供本模块的api

那么目的很明确了,要开发一个业务模块,我们就需要到blade-service以及blade-service-api中新建相关的代码啦!下面我们就开始重要的第一步:子工程的新建

新建子工程

  1. 注意:服务创建大同小异,若使用的是Boot版本,直接在package内再建package即可,无需再建工程
  2. blade-service上右击依次选则 New -> Module
    ![](../../images/screenshot_1579249533581.png)
  3. New Module界面选中左侧的Maven并且点击Next
    ![](../../images/screenshot_1579249552140.png)
  4. 接着我们可以给ArtifactId起个名,这里使用了blade-demo,parent选择blade-service(大家可以根据实际的业务模块命名)
    ![](../../images/screenshot_1579252047316.png)
  5. 点击Finish,并点击右下角的Import Changes,等待maven工程加载完毕
    ![](../../images/screenshot_1579249718096.png)
  6. 我们以同样的方式在blade-service-api下新建blade-demo-api工程,最后效果如下
    ![](../../images/screenshot_1579252232807.png)

工程版本依赖设置

  1. 打开blade-demo-api工程下的pom.xml设置基本信息
    加上红框内的信息
    ![](../../images/screenshot_1579252282352.png)
  2. 打开blade-demo工程下的pom.xml设置基本信息
    加上红框内的信息
    ![](../../images/screenshot_1579252357270.png)
  3. 以下依赖为刚刚新建的blade-demo-api工程,代码组成主要是entity,vo,dto,feign等模块
    ~~~xml

    org.springblade
    blade-demo-api
    ${bladex.project.version}

    ~~~
  4. 以下依赖为Blade-Tool封装的模块启动依赖,只需引入一个,便解决了所有常用的配置
    ~~~xml

    org.springblade
    blade-core-boot

    ~~~
  5. 以下依赖为Blade-Tool封装的swagger模块依赖,引入后便可以使用swagger文档
    ~~~xml

    org.springblade
    blade-starter-swagger

    ~~~
  6. BladeX核心依赖使用了bom架构,将所有固定的版本统一管理,自动依赖,无需再配置bladex-tool内的版本,所以blade-core-xxxblade-starter-xxx 不需要加version,只需给刚新建的blade-demo-api加上version即可
  7. 以上步骤操作完毕,请点击maven刷新按钮重新刷新构建,载入新建的工程。

工程配置

  1. 参考blade-desk模块,将resource下的文件拷贝到blade-demoresources文件夹下
    ![](../../images/screenshot_1579253667150.png)
  2. 修改下application-dev.ymlserver.port的值为9101(可以定义为其他端口,但必须不冲突)
    ![](../../images/screenshot_1579253690413.png)
  3. blade-demojava包下新建package
    ![](../../images/screenshot_1579253760767.png)
  4. 推荐命名为org.springblade.demo
    ![](../../images/screenshot_1579253782255.png)
  5. 参考blade-desk模块,将DeskApplication拷贝至刚新建的包下并重命名为DemoApplication
    ![](../../images/screenshot_1579253867930.png)
    ![](../../images/screenshot_1579253889649.png)
  6. 修改对应代码(后续会详细介绍)
    ![](../../images/screenshot_1579253924147.png)
  7. 为了让代码更加优雅,我们可以到blade-common模块的LauncherConstant下新建常量
    ![](../../images/screenshot_1579253973236.png)
  8. 再次修改DemoApplication
    ![](../../images/screenshot_1579253997250.png)
  9. 右击DemoApplication启动,查看服务是否注册到了Nacos.
  10. 我们先启动Demo服务,并访问 http://localhost:8848/nacos 查看效果
    ![](../../images/screenshot_1579254070020.png)
  11. 如果我们看到blade-demo在注册列表中,说明一个新的微服务已经诞生!
    ![](../../images/screenshot_1579254093896.png)