快速入门

快速入门以Jeecg-Boot快速开发框架为例。

1. 从BizMDA中Clone下载项目源码；

2. 在Eclipse或IDEA中作为MAVEN项目导入；

3. 设置model/mda.yml中代码和资源文件输出目录：

   #代码作者名
   author: Steven
   #代码作者邮箱
   email: [e-mail]
   #版本号
   version: V1.0
   #生成代码所属java包名
   packageName: com.bizmda
   #生成代码文件所在目录
   sourcePath: tmp/src
   #生成资源文件所在目录
   resourcePath: tmp/resource
   #生成代码所用的模板名
   template: Jeecg-Boot

   主要需要设置参数：

   "sourcePath"和"resourcePath"这2个参数——分别对应代码文件和资源文件的生成输出目录；

   "template"——指定使用Jeecg-Boot模板进行代码生成，这套代码只适用用Jeecg Boot框架。

4. 数据建模，在model/data/crm目录下增加customer(顾客)实体的数据建模文件customer.yml

#标签
label: 客户
#主键
primaryKey: cust_no
#主键生成规则（MANUAL-手工输入(缺省) UUID-UUID AUTO_INCREMENT-自增）
primaryKeyType: UUID
#是否物理删除,会自动生成mda_status域（0正常 1删除 2停用）
hasStatus: false
#是否跟踪创建和更新，会自动生成create_by,create_date,update_by,update_date
hasCreateUpdate: false
#域列表
fields:
   #域名
 - name: cust_no
   #域标签
   label: 客户编号
   #数据类型：int,float,decimal(19,2)-money,date,datetime,tinyint-boolean,varchar(100),char(10),blob
   type: char(32)
   #输入类型：text,textarea,checkbox,radiobox,select
   inputType: text
   #相关字典名
   dictName:
   #允许为空
   isNull: false
 - name: cust_name
   label: 客户名称
   type: varchar(20)
   inputType: text
   isNull: false
 - name: cust_region
   #域标签
   label: 所在地区
   #数据类型：int,float,decimal(19,2)-money,date,datetime,tinyint-boolean,varchar(100),char(10),blob
   type: varchar(5)
   #输入类型：text,textarea,checkbox,radiobox,select
   inputType: select
   #相关字典名
   dictName: region
   #允许为空
   isNull: true
 - name: cust_address
   #域标签
   label: 地址
   #数据类型：int,float,decimal(19,2)-money,timestamp,tinyint-boolean,varchar(100),char(10),blob
   type: varchar(100)
   #输入类型：text,textarea,checkbox,radiobox,select
   inputType: text
 - name: cust_registered_capital
   #域标签
   label: 注册资金
   #数据类型：int,float,decimal(19,2)-money,timestamp,tinyint-boolean,varchar(100),char(10),blob
   type: decimal(19,2)
   #输入类型：text,textarea,checkbox,radiobox,select
   inputType: text
   #允许为空
   isNull: true

主要设置参数：

数据实体属性——表名、主键等；

数据实体项下各数据域属性——包括域存储属性和视图呈现属性。

1. 视图建模，在model/view/crm目录下增加customer(顾客)实体的列表样式视图建模文件customer-list-1.yml

#标签
label: 客户列表
#视图展现模块
model: LIST-1
#查询条件域列表
components:
  #视图类型：查询条件组件
  - type: QUERY
    #相关数据表
    tableName: customer
    #视图扩展属性
    view:
    fields:
      #域名
    - name: cust_no
      #视图扩展属性
      view:
        #提示信息
        placeholder: 输入客户编号
        #查询条件类型: EQ GE LE LIKE BETWEEN
        queryType: EQ
        #跨度
        span: 6
      #域名
    - name: cust_name
      view:
        #提示信息
        placeholder: 输入客户名称
        #查询条件类型: EQ GE LE LIKE BETWEEN
        queryType: EQ
        #跨度
        span: 6
    actions:
    #视图类型：数据列表组件
  - type: LIST
    #相关数据表
    tableName: customer
    #视图扩展属性
    view:
      modalView: /crm/CustomerFormModal1
    fields:
      #域名
      - name: cust_no
      - name: cust_name
      - name: cust_region
      - name: cust_address
      - name: cust_registered_capital
    #按钮动作
    actions:
      #动作类型
      - type: LIST-OPEN-VIEW
        label: 查看
        icon: read
        params:
          view: /crm/CustomerForm1
          query: "{mda_id: record.custNo}"
      - type: LIST-DO-SERVICE
        label: 删除服务
        icon: delete
        params:
          method: delete
          url: /crm/customer/delete
          data: "{id: record.custNo}"
          confirm: true
      - type: LIST-DELETE
        label: 删除
        icon: delete
      - type: LIST-EDIT-WITH-MODAL
      - type: ADD-WITH-MODAL
      - type: BATCH-DELETE
      - type: OPEN-VIEW
        label: 打开视图
        icon: folder-open"
        params:
          view: /crm/CustomerForm1
          confirm: true
      - type: DO-SERVICE
        label: 执行服务
        icon: interation
        params:
          method: delete
          url: /crm/customer/delete
      - type: EXPORT-EXCEL
        label: 导出
        icon: download
      - type: IMPORT-EXCEL
        label: 导入
        icon: import

主要设置参数：

视图属性——视图名称、视图采用的样式模板等；

视图项下组件属性——一个视图包括多个组件，这里会设置组件关联的数据实体以及组件的样式参数等；

组件项下域属性——一个组件会包括多个域（从组件关联的数据实体和服务实体中选择），这里会设置域的视图样式。

1. 运行src/com/bizmda/CodeGen.java；

2. 你可以在你所设置的代码和资源文档输出目录（根据mda.yml的设置，代码输出目录为当前项目目录的tmp/src，资源文件输出目录为tmp/resource）中，看到生成的代码和资源文档；

3. 用生成的tmp/resource/db/crm/customer.sql文件，在Jeecg-Boot框架项目关联的MySQL数据库中，创建customer表；

4. 把生成的tmp/src目录下所有文件，拷贝到Jeecg-Boot项目中的jeecg-boot/src/main/java目录中；

5. 把resources/Jeecg-Boot/ant-design-jeecg-vue/src目录下文件，拷贝到Jeecg-Boot项目中的对应ant-design-jeecg-vue/src目录中；

6. 把生成的tmp/resource/views目录下所有文件，拷贝到Jeecg-Boot项目中的对应ant-design-jeecg-vue/src/views目录中；

7. 在Jeecg-Boot项目启动类JeecgApplication.java中，增加并修改以下二行：

   @ComponentScan({"org.jeecg","com.bizmda"})
   @MapperScan({"com.bizmda.**.mapper"})

8. 启动Jeecg-Boot，在菜单管理中配置CustomerList.vue的菜单入口，并配置针对此菜单的使用权限；

image

1. 重新登录后，即可点击刚才配置好的菜单入口，呈现针对customer表的增、删、改、查功能。

image