Hzero入门部署

Hzero目的是沉淀大量通用标准组件、服务,目标是搭建各种产品快速组件、开发的融合平台,减少成本浪费。

Hzero代码体系

  1. 代码架构
    • hzero-parent 同一管理所有组件、服务版本
    • hzero-starter 基础通用组件(源码开发)
    • choerodon-starter 猪齿鱼基础组件(开源)
    • hzero-boot 客户端组件
    • hzero-plugin 服务插件
    • hzero-service 服务(可依赖包)
    • hzero-resource 建表脚本及初期数据
    • hzero-front 前端工程

Hzero基础服务架构

  1. hzero基础服务
    • hzero-register 注册中心(多版本支持)
    • hzero-config 配置中心中心(多版本支持)
    • hzero-gatway 网关服务,合并hzero-gateway-helper鉴权
    • hzero-oauth 认证服务
    • hzero-swaggr API测试服务
    • hzero-iam 用户身份服务
  2. 访问网关、鉴权
    • API访问gateway网关服务,所有请求都会经过GateWayHelperFilter过滤器,在过滤器中,会调用gateway-helper鉴权。进入gateway-helper,根过滤器RootServletFilter包含了一系列过滤器来对请求进行鉴权,将按途中的过滤器顺序进行校验,其中任何一步返回false都会直接返回,一般服务出现403、500等问题可先检查hzero-gateway-helper的日志,看是哪一步校验不通过。校验通过后携带jwt返回到gateway
      a

Hzero本地部署(准备工作)参考文档

  • 本地部署

    本地安装方式一般用于搭建开发环境,在服务器上部署好基础服务后,开发人员在本地只需要关注自己的服务,进行API测试。在本地电脑安装6个基础服务搭建起基础开发环境。

  • 基础服务

    • hzero-register 注册中心
    • hzero-config 配置中心
    • hzero-gateway 网关服务
    • hzero-oauth 认证服务
    • hzero-swaggr API测试服务
    • hzero-iam 用户身份服务
  • 环境准备

    • 基础环境:
      • JDK1.8
      • Maven3.0+
      • Redis
      • 数据库
    • Hosts域名映射
      • 虚拟机地址 db.hzero.org
      • 虚拟机地址 redis.hzero.org
      • 127.0.0.1 dev.hzero.org

Hzero本地部署(数据库初始化)

  1. 数据初始化

    • 创建用户

      create user 'hzero'@'%' identified by 'hzero'

    • 创建库

      create database hzero_platform default character set utf8mb4

      create database hzero_governace default character set utf8mb4

      grant all privileges on hzero_platform.* to 'hzero'@'%'

      grant all privileges on hzero_governance.* to 'hzero'@'%'

      flush privileges

    • 初始化表结构

      修改脚本文件,需要注意的是先要看jar包的对应目录是否存在,再修改数据库连接信息,再根据你是要初始化表结构(service值需要替换、dir也要替换;替换的目录是建表脚本的目录)还是初始化数据替换service和dir。如下就是初始化hzero_platform库中的表结构。

      service=hzero_platform
      schema=$service
      dir=groovy/$service
      
    • 初始化数据

    • 表更新规范

    • ‘0’租户处理

      手工修改fd_organization hpfm_tenant hpfm_group三张表的数据,需手动将Hzero这个租户的id设置为0

Hzero项目demo 后端项目搭建教程

  1. 先看项目骨架:
    四层架构
    该项目使用DDD代码架构(Domain-Driven Design 参考https://blog.csdn.net/ityouknow/article/details/81572072https://blog.csdn.net/liangcan1995/article/details/85093219
    )。
    应用分层
    至少需要包含如下的结构,将业务和流程分开,应用服务专注用例调度,反应用户故事;领域对象/服务专注核心业务。整个模块通用的放到基础设施层,资源库和外部服务实现也放到基础设施层,屏蔽实现细节。
    • api 向外提供接口
    • app 负责用例调度,事务控制
    • domain 领域对象和领域服务,专注核心业务
    • infra 基础设施,保持数据的持久化、防腐层、第三方库、消息等
详细目录
  1. api
    • controller 提供接口服务
    • dto 用来封装复杂的数据对象,多用来给需要多个实体组合时提供数据传输
  2. app
    • service 应用服务,事务控制、流程调度
      • impl 实现
    • assembler dto组装器
  3. domain
    • entity 表的体现,能简单自治(限制长度,限制主键等等)
    • service 封装领域内复杂的业务逻辑
    • repository 资源库接口,提供数据资源的操作方法,简单的增删改查和redis的增删查改
    • vo 值对象,封装没有实体但是又会在领域内用的数据
  4. infra
    • mapper 接口
    • repository.impl repository的实现,业务不能入侵到这里

开发步骤

  1. 实体
    • 类继承AuditDomain,添加@ModifyAudit、@VersionAudit、@Table、@JsonInclude(JsonInclude.Include.NON_NULL)、@ApiModel注解。
    • 与该表对应的属性添加注解@Id、@GeneratedValue、@NotNull、@ApiModelProperty、@Length
    • 非该表属性,但是能用到的添加@Transient、@ApiModelProperty注解
      代码如下:
package com.hzero.test.domaindriverdesign.domain.entity;

import com.fasterxml.jackson.annotation.JsonInclude;
import io.choerodon.mybatis.annotation.ModifyAudit;
import io.choerodon.mybatis.annotation.VersionAudit;
import io.choerodon.mybatis.domain.AuditDomain;
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
import org.hibernate.validator.constraints.Length;

import javax.persistence.GeneratedValue;
import javax.persistence.Id;
import javax.persistence.Table;
import javax.persistence.Transient;
import javax.validation.constraints.NotNull;
import java.util.UUID;

/**
 * @date 2019/7/30
 */
@ApiModel("任务信息")
@ModifyAudit
@VersionAudit
@Table(name = "todo_task")
@JsonInclude(JsonInclude.Include.NON_NULL)
@Data
public class Task extends AuditDomain {

    public static final String FIELD_ID = "id";
    public static final String FIELD_EMPLOYEE_ID = "employeeId";
    public static final String FIELD_STATE = "state";
    public static final String FIELD_TASK_DESCRIPTION = "taskDescription";

    @Id
    @GeneratedValue
    private Long id;
    @NotNull(message = "用户ID不能为空")
    @ApiModelProperty("用户ID")
    private Long employeeId;
    @ApiModelProperty("任务状态")
    private String state;
    @ApiModelProperty("任务编号")
    private String taskNumber;
    @Length(max = 240)
    @ApiModelProperty("任务描述")
    private String taskDescription;
    @NotNull
    @ApiModelProperty("租户ID")
    private Long tenantId;

    @Transient
    @ApiModelProperty("员工编号")
    private String employeeNumber;
    @Transient
    @ApiModelProperty("员工姓名")
    private String employeeName;

    /**
     * 生成任务编号
     */
    public void generateTaskNumber() {
        this.taskNumber = UUID.randomUUID().toString().replace("-", "");
    }
}
  1. 资源库(repository)
    • 都是接口,接口继承BaseRepository<>接口,BaseRepository中提供了一些基本的crud方法
    • controller中能直接调用这里的接口,不用再app中service里再封装
  2. 开发服务(app.service)
  3. 开发controller(controller)
  4. 开发mapper和mapper.xml(mapper)
    • 一般单表操作使用jpa就够了
  5. 资源库实现(repository.impl)
  6. 应用服务实现(service.impl)
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 211,423评论 6 491
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,147评论 2 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,019评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,443评论 1 283
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,535评论 6 385
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,798评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,941评论 3 407
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,704评论 0 266
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,152评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,494评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,629评论 1 340
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,295评论 4 329
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,901评论 3 313
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,742评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,978评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,333评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,499评论 2 348

推荐阅读更多精彩内容