JHipster生成微服务架构的应用栈（四）- 网关微服务示例

本系列文章演示如何用JHipster生成一个微服务架构风格的应用栈。
环境需求：安装好JHipster开发环境的CentOS 7.4（参考这里）
应用栈名称：appstack
认证微服务： uaa
业务微服务：microservice1
网关微服务：gateway
实体名：role
主机IP：192.168.220.120

1 生成网关微服务的工程代码

进入appstack/gateway目录，输入命令后回车：

$ cd gateway/
$ jhipster

命令行输出JHipster启动信息

如今开始问答环节

1.1 Which type of application would you like to create?

选择生成的应用类型
这是一个单选题，有4个选项，使用上下键切换选项。
这里选择Microservice gateway，也就是网关微服务。

单击回车继续。

1.2 What is the base name of your application?

输入应用的名称
默认名称是当前目录名gateway，也能够本身输入名称；这里使用默认名称。
注意：名称只能是大小写字母，数字和下划线的任意组合，不容许任何其它字符。

单击回车继续。

1.3 As you are running in a microservice architecture, on which port would like your server to run? It should be unique to avoid port conflicts.

输入微服务的端口号
默认端口号是8080，也能够本身输入端口号，注意不要和别的微服务和进程的端口号冲突。

单击回车继续。

1.4 What is your default Java package name?

输入应用的java包名
默认java包名是com.mycompany.myapp，也能够本身输入包名；这里使用默认包名。
注意：包名要符合Java标准规范的要求。

单击回车继续。

1.5 Which service discovery server do you want to use?

选择一个服务发现组件
这是一个单选题，有3个选项，使用上下键切换选项。
根据微服务体系规划，这里选择JHipster Registry。

单击回车继续。

1.6 Which type of authentication would you like to use?

选择使用的认证类型
这是一个单选题，有3个选项，使用上下键切换选项。
根据微服务体系规划，这里选择Authentication with JHipster UAA server (the server must be generated separately)。

单击回车继续。

1.7 What is the folder path of your UAA application?

输入uaa微服务所在的目录
这是一个相对于gateway的相对路径，默认路径是../uaa，这就是咱们以前生成uaa工程的目录所在；若是以前生成的uaa目录名是myuaa，那么这里要输入../myuaa。
注意：这个问题和上一个问题(1.6)的选择有关联性，上一个问题的不一样选择，会致使后续不一样问题的出现。

单击回车继续。

1.8 Which type of database would you like to use?

选择使用的数据库类型
这是一个单选题，有4个选项，使用上下键切换选项。
能够看到支持的数据库类型不少，这里选择默认选项SQL。

单击回车继续。

1.9 Which production database would you like to use?

选择生产环境中使用的数据库
这是一个单选题，有5个选项，使用上下键切换选项。
能够看到目前支持5种SQL数据库，这里选择默认选项MySQL。

单击回车继续。

1.10 Which development database would you like to use?

选择开发环境中使用的数据库
这是一个单选题，有3个选项，使用上下键切换选项。
H2调试起来简单，但为了和生产环境保持一致性，这里选择MySQL。

单击回车继续。

1.11 Do you want to use Hibernate 2nd level cache?

是否须要使用Hibernate 2级缓存？
默认选择是Y，若是不须要，输入n；这里选择默认选项Y。

单击回车继续。

1.12 Would you like to use Maven or Gradle for building the backend?

选择使用Maven仍是Gradle来构建微服务
这是一个单选题，有2个选项，使用上下键切换选项。
根据本身的开发环境须要，选择相应的构建工具，这里选择默认选项Maven。

单击回车继续。

1.13 Which other technologies would you like to use?

选择须要用到的技术组件
这是一个多选题，有4个选项，使用上下键切换选项，使用空格键选中选项，使用a键全选，使用i键取消全选。
根据本身的技术架构规划，选择相应的技术组件，也能够都不选择。

单击回车继续。

1.14 Which Framework would you like to use for the client?

选择前端框架
这是一个单选题，有2个选项，使用上下键切换选项。
根据本身的技术架构规划，选择相应的前端框架，这里选择默认选项Angular 6。

单击回车继续。

1.15 Would you like to enable SASS support using the LibSass stylesheet preprocessor?

是否须要启用样式表预处理来支持SASS？
默认选择是N，若是须要启用，输入y；这里选择默认选项N。

单击回车继续。

1.16 Would you like to enable internationalization support?

是否须要国际化支持？
默认选择是Y，若是不须要，输入n；这里选择默认选项Y。

单击回车继续。

1.17 Please choose the native language of the application

选择国际化支持中的母语
这是一个单选题，有37个选项，使用上下键切换选项。
注意：这个问题和上一个问题(1.16)的选择有关联性，上一个问题若是选择n，这个问题不会出现。

单击回车继续。

1.18 Please choose additional languages to install

选择国际化支持中的其它语言
这是一个多选题，有37个选项，使用上下键切换选项，使用空格键选中选项，使用a键全选，使用i键取消全选。
根据本身的业务规划，选择相应的语言，也能够都不选择。

单击回车继续。

1.19 Besides JUnit and Jest, which testing frameworks would you like to use?

选择单元测试工具
这是一个多选题，有2个选项，使用上下键切换选项，使用空格键选中选项，使用a键全选，使用i键取消全选。
根据本身的技术架构规划，选择相应的技术组件，也能够都不选择。

单击回车继续。

1.20 Would you like to install other generators from the JHipster Marketplace?

是否须要从JHipster市场中安装其它的开发工具？
默认选择是N，若是须要启用，输入y；这里选择默认选项N。

单击回车继续。

问答结束，开始生成工程代码

这个过程可能会有点长，根据电脑性能和网速的不一样，一般须要3-5分钟。

至此，生成工程代码成功完成。能够在appstack/gateway目录下查看全部生成的文件。

2 生成实体代码

接下来，是为microservice1中的实体表role生成前端资源。
在开始以前，确保microservice1已经为实体role生成事后端代码。
进入appstack/gateway目录，输入命令后回车：

$ cd gateway/
$ jhipster entity role

命令行输出实体已建立

如今开始问答环节

2.1 Do you want to generate this entity from an existing microservice?

是否为一个现有的业务微服务的实体生成前端资源？
默认选择是Y，若是不须要添加，输入n；这里选择默认选项Y。

单击回车继续。

2.2 Enter the path to the microservice root directory:

输入这个现有的业务微服务的路径
这是一个相对于gateway的相对路径，对于microservice1工程来讲，这里要输入../microservice1。

单击回车继续。

2.3 Do you want to update the entity? This will replace the existing files for this entity, all your custom code will be overwritten

是否要更新这个实体
这是一个单选题，有4个选项，使用上下键切换选项。
4个选项的意思分别是是的，从新生成这个实体；是的，增长字段和关系；是的，删除字段和关系；不，退出。这里选择Yes, re generate the entity。

单击回车继续。

问答结束，开始生成实体代码

这个过程当中会提示与已有文件有冲突，须要选择处理方式，提示的输入选项是Ynaxdh，说明以下：

Y: yes (Default)
n: no
a: yes to this question and all others (or always yes).
x: abort (exit)
d: show the differences between the old and the new file
h: help, list all options

这里选择a；

单击回车。这里主要是生成实体对应的前端资源，根据实体的复杂程度不一样，耗时也不尽相同，咱们这个示例只有1个字段，生成很快，一般1-2分钟就能完成。

至此，生成实体代码成功完成。能够执行maven测试命令来验证整个工程代码（若是生成工程代码时选择的构建工具是Maven）

$ mvn test

若是一切正常，命令行会输出成功信息：

3 生成前端资源

以前在生成工程代码时选择的前端组件是Angular，因此前端资源会按以下流程生成：
a, 生成工程代码或者实体代码的任务完成后，会自动触发执行yarn install；
b, yarn install执行完成后，会自动触发执行webpack:build；
c, webpack:build执行完成后，全部前端资源就已经生成了，默认是在gateway/target/www目录下。

调试前端页面

进入gateway目录，输入命令后回车：

$ cd gateway/
$ yarn start

若是一切正常，会启动Webpack dev-server；

可经过浏览器访问http://192.168.220.120:9000查看前端调试页面。此时全部前端资源的修改，都会同步更新到浏览器上。

4 数据库配置

4.1 启动一个数据库容器

在命令行，任意目录下，启动一个mysql容器；若是本地没有mysql:5的镜像，容器启动时会自动去docker store下载镜像。

$ docker container run --name gateway-mysql -e MYSQL_ROOT_PASSWORD=my-secret-pw -d -p 32800:3306 mysql:5

4.2 在数据库中建立schema

经过客户端链接上刚启动的数据库容器，添加一个名为gateway的schema。应用启动时会自动在这个schema里面建立数据表。

4.3 修改应用的数据库配置

spring.datasource.url中的端口号32800，与步骤4.1中-p参数指定的值保持一致。
spring.datasource.url中的schema名称gateway，与步骤4.2中添加的schema名称保持一致。
spring.datasource.password的值my-secret-pw，与步骤4.1中MYSQL_ROOT_PASSWORD参数指定的值保持一致。

$ cd gateway/
$ vi src/main/resources/config/application-dev.yml
# 修改数据库链接相关配置
spring:
    datasource:
        url: jdbc:mysql://localhost:32800/gateway?useUnicode=true&characterEncoding=utf8&useSSL=false
        username: root
        password: my-secret-pw

5 构建和启动

5.1 构建

进入gateway目录，输入命令后回车：

$ cd gateway/
$ mvn -Pdev package

若是一切正常，命令行会输出构建成功信息：

5.2 启动

进入gateway目录，输入命令后回车：

$ nohup ./target/gateway-0.0.1-SNAPSHOT.war &

经过tail命令，查看启动日志：

$ tail -f nohup.out

若是一切正常，日志会输出启动成功信息：

5.3 注册到JHipster Registry

启动完成后，能够经过浏览器访问http://192.168.220.120:8761，登陆名和密码默认都是admin：

能够看到在Instances Registered区域，gateway已经注册。

6 访问网关微服务UI

6.1 访问首页

经过浏览器访问http://192.168.220.120:8080，进入网关微服务的首页：

点击右上角帐号 - 登陆， 默认用户名和密码都是admin。

6.2 实体页面

登陆以后能够看到页头上的菜单，数据菜单下就是全部实体的操做页面，这里能看到生成的实体role的子菜单：

点击role子菜单，进入role实体的操做页面，这里已经生成了基本的增删改查功能，若是须要更多功能，就要定制开发了：

6.3 管理页面

这里包括了以下功能页面：

• 网关
• 用户管理
• 资源监控
• 服务状态
• 配置
• 审核
• 日志
• API

页面功能都很直观，点进去看一看就知道了。

6.4 语言页面

这里就是国际化支持的页面，生成工程代码时选择了哪些语言，这里就会提供哪些语言的子菜单：

源码

jhi-example-appstack

系列文章

JHipster生成微服务架构的应用栈（一）- 准备工做
JHipster生成微服务架构的应用栈（二）- 认证微服务示例
JHipster生成微服务架构的应用栈（三）- 业务微服务示例
JHipster生成微服务架构的应用栈（四）- 网关微服务示例
JHipster生成微服务架构的应用栈（五）- 容器编排示例