HRM系统1

一 项目介绍

1. 项目背景

我们开发一个人力资源管理系统，让找工作的人，能够选择特定机构的课程学习，并参与平台发布的招聘，而且还能参与一些活动。 让招聘单位入驻进来发布岗位进行招聘，甚至委托培训机构培训合适的人才。对于培训机构可以发布课程，吸收学员来完成学习并通过收取学费获取商业价值。

2. .项目面向的客户

• 找工作人
• 招聘的人
• 培训机构
• 系统运营方

3. 项目原型 - 前后端分离

• 后台管理的前端:elementui+vue

• 门户网站的前端:div+css(前端)

• 2.后台技术架构

  SpringBoot+SpringCloud

4. 功能图

5.项目整体技术架构

二. 后台项目搭建

一.项目基本模块搭建

三.数据字典

一.数据字典分析

1. 什么是数据字典

就是把系统中的一些基础数据(一些不变的数据项)，比如：学校，学历，单位等等用两张表来维护，一个类型表，一个明细表 。类表用来描述数据项的类型 ， 而明细表用来描述数据项的明细列表。

2. 数据字典的原理
   

二.创建数据库 hrm-systemmanage

1. 数据库字典分类表

t_systemdictionary

2. 数据库字典明细表

t_systemdictionaryitem

3. MybatisPlus介绍

一.基本概念

1. 什么是Mybatisplus

使用MybatisPlus，就不用写重复代码，并且还有模板的功能，可以一键生成daomin,query,mapper接口,mapper.xml,service,controller,非常好用。MyBatis-Plus（简称 MP）是一个 MyBatis 的增强工具，在 MyBatis 的基础上只做增强不做改变，为简化开发、提高效率而生。

2. MybatisPlus的特点

• 无侵入
• 损耗小
• 强大的 CRUD 操作
• 支持 Lambda 形式调用
• 支持多种数据库
• 支持主键自动生成
• 支持 XML 热加载
• 内置代码生成器
• 内置分页插件
• 内置性能分析插件
• 内置全局拦截插件
• 内置 Sql 注入剥离器

二.MybatisPlus工作图

五.使用Mybatisplus生成数据字典

一.系统管理微服务集成MybatisPlus - hrm-systemmanage-service-2010

1. 导入依赖

	<dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-boot-starter</artifactId>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
        </dependency>
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>druid</artifactId>
        </dependency>
        ...

2. 创建MybatisPlus的配置类【分页高级查询】

@EnableTransactionManagement    //事务管理
@Configuration
@MapperScan("cn.itsource.hrm.mapper")   //mapper接口的扫描包
public class MybatisPlusConfig {
    /**
     * 分页插件
     */
    @Bean
    public PaginationInterceptor paginationInterceptor() {
        return new PaginationInterceptor();
    }
}

3. 配置文件

server:
  port: 2010 #配置端口号
eureka:
  client:
    serviceUrl:
      defaultZone: http://localhost:1010/eureka/ #注册中心地址
      prefer-ip-address: true
      instance-id: systemmanage-server
spring:
  application:
    name: systemmanage-server
  datasource:
    username: root
    type: com.alibaba.druid.pool.DruidDataSource
    password: 123456
    driver-class-name: com.mysql.jdbc.Driver
    url: jdbc:mysql:///hrm-systemmanage
mybatis-plus:
  mapper-locations: classpath:cn/itsource/hrm/mapper/*Mapper.xml
  type-aliases-package: cn.itsource.hrm.domain,cn.itsource.hrm.query

二.创建代码生成器项目 - hrm-basic-mybatisplus-generator

1. 导入依赖

<dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-boot-starter</artifactId>
        </dependency>

        <!--模板引擎-->
        <dependency>
            <groupId>org.apache.velocity</groupId>
            <artifactId>velocity-engine-core</artifactId>
        </dependency>

        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
        </dependency>

2. 创建配置文件 resources/mybatisplus-config.properties

#此处为本项目src所在路径（代码生成器输出路径）,注意一定是当前项目所在的目录哟
OutputDir=D:/Mysoft/IDEAworkspace/hrm-parent/hrm-systemmanage-parent/hrm-systemmanage-service-2010/src/main/java
#mapper.xml SQL映射文件目录
OutputDirXml=D:/Mysoft/IDEAworkspace/hrm-parent/hrm-systemmanage-parent/hrm-systemmanage-service-2010/src/main/resources

#domain的输出路径
OutputDirBase=D:/Mysoft/IDEAworkspace/hrm-parent/hrm-systemmanage-parent/hrm-systemmanage-common/src/main/java

#设置作者
author=tangqingfeng
#自定义包路径
parent=cn.itsource.hrm

#数据库连接信息
jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql:///hrm-systemmanage
jdbc.user=root
jdbc.pwd=123456

3. 拷贝模板

resources /templates /controller.java.vm
resources /templates /query.java.vm

4. 拷贝一个代码生成主类

• 注意是否需要调整domain的输出路径
• 注意是否需要调整Mapper.xml的输出路径
• 增加controller的输出生成模板和输出路径调整
• 增加query的输出生成模板和输出路径调整

public class GenteratorCode {

    public static void main(String[] args) throws InterruptedException {

        //用来获取Mybatis-Plus.properties文件的配置信息
        ResourceBundle rb = ResourceBundle.getBundle("mybatiesplus-config"); //不要加后缀
        AutoGenerator mpg = new AutoGenerator();
        // 全局配置
        GlobalConfig gc = new GlobalConfig();
        gc.setOutputDir(rb.getString("OutputDir"));
        gc.setFileOverride(true);
        gc.setActiveRecord(true);// 开启 activeRecord 模式
        gc.setEnableCache(false);// XML 二级缓存
        gc.setBaseResultMap(true);// XML ResultMap
        gc.setBaseColumnList(false);// XML columList
        gc.setAuthor(rb.getString("author"));
        mpg.setGlobalConfig(gc);
        // 数据源配置
        DataSourceConfig dsc = new DataSourceConfig();
        dsc.setDbType(DbType.MYSQL);
        dsc.setTypeConvert(new MySqlTypeConvert());
        dsc.setDriverName(rb.getString("jdbc.driver"));
        dsc.setUsername(rb.getString("jdbc.user"));
        dsc.setPassword(rb.getString("jdbc.pwd"));
        dsc.setUrl(rb.getString("jdbc.url"));
        mpg.setDataSource(dsc);
        // 策略配置
        StrategyConfig strategy = new StrategyConfig();
        strategy.setTablePrefix(new String[] { "t_" });// 此处可以修改为您的表前缀
        strategy.setNaming(NamingStrategy.underline_to_camel);// 表名生成策略
        strategy.setInclude(new String[]{"t_systemdictionary","t_systemdictionaryitem"}); // 需要生成的表
        mpg.setStrategy(strategy);
        // 包配置
        PackageConfig pc = new PackageConfig();
        pc.setParent(rb.getString("parent"));
        pc.setController("web.controller");
        pc.setService("service");
        pc.setServiceImpl("service.impl");
        pc.setEntity("domain");
        pc.setMapper("mapper");
        mpg.setPackageInfo(pc);

        // 注入自定义配置，可以在 VM 中使用 cfg.abc 【可无】
        InjectionConfig cfg = new InjectionConfig() {
            @Override
            public void initMap() {
                Map<String, Object> map = new HashMap<String, Object>();
                map.put("abc", this.getConfig().getGlobalConfig().getAuthor() + "-rb");
                this.setMap(map);
            }
        };

        List<FileOutConfig> focList = new ArrayList<FileOutConfig>();

        //controller的输出配置
        focList.add(new FileOutConfig("/templates/controller.java.vm") {
            @Override
            public String outputFile(TableInfo tableInfo) {
                return rb.getString("OutputDir")+ "/cn/itsource/hrm/web/controller/" + tableInfo.getEntityName() + "Controller.java";
            }
        });
        //query的输出配置
        focList.add(new FileOutConfig("/templates/query.java.vm") {
            @Override
            public String outputFile(TableInfo tableInfo) {
                return rb.getString("OutputDirBase")+ "/cn/itsource/hrm/query/" + tableInfo.getEntityName() + "Query.java";
            }
        });

        // 调整 domain 生成目录演示
        focList.add(new FileOutConfig("/templates/entity.java.vm") {
            @Override
            public String outputFile(TableInfo tableInfo) {
                return rb.getString("OutputDirBase")+ "/cn/itsource/hrm/domain/" + tableInfo.getEntityName() + ".java";
            }
        });

        // 调整 xml 生成目录演示
        focList.add(new FileOutConfig("/templates/mapper.xml.vm") {
            @Override
            public String outputFile(TableInfo tableInfo) {
                return rb.getString("OutputDirXml")+ "/cn/itsource/hrm/mapper/" + tableInfo.getEntityName() + "Mapper.xml";
            }
        });
        cfg.setFileOutConfigList(focList);
        mpg.setCfg(cfg);

        // 自定义模板配置，可以 copy 源码 mybatis-plus/src/main/resources/templates 下面内容修改，
        // 放置自己项目的 src/main/resources/templates 目录下, 默认名称一下可以不配置，也可以自定义模板名称
        TemplateConfig tc = new TemplateConfig();
        tc.setService("/templates/service.java.vm");
        tc.setServiceImpl("/templates/serviceImpl.java.vm");
        tc.setMapper("/templates/mapper.java.vm");
        tc.setEntity(null);
        tc.setController(null);
        tc.setXml(null);
        // 如上任何一个模块如果设置 空 OR Null 将不生成该模块。
        mpg.setTemplate(tc);

        // 执行生成
        mpg.execute();
    }

}

5.在hrm-basic-utils中拷贝工具类

query
util

六.Swagger的集成

一.系统管理集成swagger - hrm-systemmanage-service-2010

1. 导入依赖的包

 <!--引入swagger支持-->
            <dependency>
                <groupId>io.springfox</groupId>
                <artifactId>springfox-swagger2</artifactId>
                <version>2.9.2</version>
            </dependency>
            <!-- https://mvnrepository.com/artifact/io.springfox/springfox-swagger-ui -->
            <dependency>
                <groupId>io.springfox</groupId>
                <artifactId>springfox-swagger-ui</artifactId>
                <version>2.9.2</version>
            </dependency>

2. 创建配置类

@Configuration
@EnableSwagger2 //开启swagger2的支持
public class Swagger2 {
 
    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .select()
                //对外暴露服务的包,以controller的方式暴露,所以就是controller的包.
                .apis(RequestHandlerSelectors.basePackage("cn.itsource.hrm.web.controller"))
                .paths(PathSelectors.any())
                .build();
    }


    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("系统管理服务api")
                .description("系统管理服务接口文档说明")
                .contact(new Contact("luo", "", "luo@itsource.cn"))
                .version("1.0")
                .build();
    }
}
注意：basePackage要改成你项目的controller的路径

3. 测试接口

http://localhost:2010/swagger-ui.html

二.zuul集成swagger

1. 导入依赖，同上

 <!--引入swagger支持-->
            <dependency>
                <groupId>io.springfox</groupId>
                <artifactId>springfox-swagger2</artifactId>
                <version>2.9.2</version>
            </dependency>
            <!-- https://mvnrepository.com/artifact/io.springfox/springfox-swagger-ui -->
            <dependency>
                <groupId>io.springfox</groupId>
                <artifactId>springfox-swagger-ui</artifactId>
                <version>2.9.2</version>
            </dependency>

2. 创建配置类
   DocumentationConfig

@Component
@Primary
public class DocumentationConfig implements SwaggerResourcesProvider {
    @Override
    public List<SwaggerResource> get() {
        List resources = new ArrayList<>();
        //添加所有的微服务的文档资源
        /**
         * 参数:
         * name：自定义的服务的名字
         * location:指定是微服务的路径   /前缀/服务名/v2/api-docs
         */
        resources.add(swaggerResource("系统管理", "/hrm/system/v2/api-docs", "2.0"));

        return resources;
    }

    private SwaggerResource swaggerResource(String name, String location, String version) {
        SwaggerResource swaggerResource = new SwaggerResource();
        swaggerResource.setName(name);
        swaggerResource.setLocation(location);
        swaggerResource.setSwaggerVersion(version);
        return swaggerResource;
    }
}
注意： resources.add .. 要修改成自己的微服务的配置

SwaggerConfig

@Configuration
@EnableSwagger2
public class SwaggerConfig {

    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo());
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("源码人力资源综合平台")
                .description("源码人力资源综合平台接口文档说明")
                .termsOfServiceUrl("http://localhost:1020")
                .contact(new Contact("luo", "", "luo@itsoruce.cn"))
                .version("1.0")
                .build();
    }
}
注意： termsOfServiceUrl 要修改成网关的地址