HOS基础开发平台

# 新建模块★

经过前两章的学习，我们了解了HOS基础平台中后端工程的工程结构和运行环境，在本章节我们以新建用户服务为例演示如何在后端工程中创建一个新模块、如何开发简单的CRUD以及一些复杂操作。那么下面我们就开始正式学习项目从0到1的开发过程吧！

开发人员需要在HOS基础平台的后端工程上新建模块，如果你手中没有HOS基础平台的后端相关代码，请从下载工程章节下载工程。后端工程代码中和本文档中提到的hos仅作为业务示例，开发人员在创建相关目录或文件时可以修改成其它名称，比如his、hrp、oa等，请根据自己实际业务进行修改。

在后端工程中，根据实际业务需要在oa-business-parent下新建相应的功能模块，这里以oa-user为例， 其包含模块是下5个子模块：

  • oa-user-model 里面主要存放的是业务相关实体内容
  • oa-user-controller 里面主要存放的是业务相关的controller，并且在配置文件中配置相关信息
  • oa-user-service 里面主要存放的是业务相关的service、serviceImpl、mapper及mapper.xml以及工具类配置类等
  • oa-user-api 里面主要存放的是该模块提供给其他模块的业务相关接口
  • oa-user-cloud-runner 里面主要存放的以微服务方式启动的相关配置类、配置文件和启动类

下面我们就开始进行第一步操作：子模块的新建

# 新建子模块（以用户模块为例）

1.新建oa-user模块，在oa-business-parent上右击依次选择 New -> Module

create_nudule_1

2.输入模块名oa-user,然后点击创建

create_nudule_2

3.新建oa-user-model模块，在oa-user上右击依次选择 New -> Module

create_nudule_3

4.输入模块名oa-user-model,然后点击创建

create_nudule_4

5.新建model包，在com.mediway.hos上右击依次选择 New -> Package

create_project_1

6.输入包名为com.mediway.oa.user.model，点击Enter回车。

create_project_2

7.在com.mediway.oa.user.model上右击依次选择 New -> Package

create_project_3

8.输入包名为com.mediway.oa.user.model.entity，点击Enter回车。

create_project_4

以同样方式创建包com.mediway.oa.user.model.vo

create_project_4_2

9.至此用户的oa-user-model模块创建完毕， 接下来以同样方式创建oa-user-service模块,创建service包、 com.mediway.oa.user.service、 com.mediway.oa.user.mapper及resources/mapper/user等， 创建oa-user-controller模块并创建包com.mediway.oa.user.controller。 创建oa-user-api模块并创建包com.mediway.oa.user.api。 此处不一一赘述，建完后oa-user-service模块结果如下

create_project_5

oa-user-controller模块如下

create_project_5_2

oa-user-api模块如下

create_project_5_3

10.创建oa-user-cloud-runner模块并创建包com.mediway.hos， 模块以及包的创建参考上方模块以及包的创建，启动类、配置类以及配置文件可参考示例代码中的oa-user-cloud-runner, 结果如下

create_project_5_3

← 第一个CRUD★ →