jhipster/jhipster-dotnetcore

generator-jhipster-dotnetcore

概述

JHipster是Java领域用于生成现代应用的知名平台，其蓝图系统允许覆盖生成器的默认行为。JHipster.NET作为官方蓝图，将原本基于Spring Boot的后端替换为ASP.NET Core后端，前端则支持Angular、React、Vue.js等常见框架。alpha版本中还提供了Blazor或Xamarin作为前端的选择。

核心功能与特性

• 通用应用生成：支持JWT和OAuth2认证方式
• 实体生成：通过命令行创建实体
• JDL实体模型支持：导入JDL文件生成实体模型
• 多前端框架支持：Angular、React、Vue.js，以及alpha版的Blazor和Xamarin

前提条件

作为JHipster蓝图，需先安装JHipster及相关工具：

• https://www.jhipster.tech/installation/

安装

使用NPM

安装蓝图：

bash
npm install -g generator-jhipster-dotnetcore

更新蓝图：

bash
npm update -g generator-jhipster-dotnetcore

使用Yarn

安装蓝图：

bash
yarn global add generator-jhipster-dotnetcore

更新蓝图：

bash
yarn global upgrade generator-jhipster-dotnetcore

使用方法

基本使用

运行以下命令使用蓝图：

bash
jhipster --blueprints dotnetcore

使用Docker

1. 下载Dockerfile：

bash
mkdir docker
cd docker
wget https://github.com/jhipster/jhipster-dotnetcore/raw/main/docker/Dockerfile

2. 构建Docker镜像：

bash
docker build -t jhipster-generator-dotnetcore:latest .

3. 创建应用目录并生成服务：

bash
mkdir service
cd service
docker run -it --rm -v $PWD:/home/jhipster/app docker.xuanyuan.run/jhipster-generator-dotnetcore

开发环境设置

本地蓝图开发版本运行

1. 全局链接蓝图：

bash
cd dotnetcore
npm link

2. （可选）链接JHipster开发版本到蓝图：

bash
cd generator-jhipster
npm link

cd dotnetcore
npm link generator-jhipster

3. 创建应用目录并链接依赖：

bash
mkdir my-app && cd my-app

npm link generator-jhipster-dotnetcore
npm link generator-jhipster  # 可选：仅在使用非发布版JHipster时需要

jhipster -d --blueprint dotnetcore

生成应用的Docker部署

构建并运行应用镜像

1. 构建应用Docker镜像：

bash
docker build -f "[Dockerfile路径]" -t [镜像名称]:[标签] "[应用根路径]"

2. 运行容器：

bash
docker run -d -p [主机端口]:80 [镜像名称]:[标签]

3. 在浏览器中访问 localhost:[指定主机端口] 即可使用应用。

使用Docker Compose

构建镜像：

bash
docker-compose -f docker/app.yml build

启动服务：

bash
docker-compose -f docker/app.yml up

对于Oracle数据库，请参考https://github.com/oracle/docker-images/blob/main/OracleDatabase/SingleInstance/README.md

文档与资源

• JHipster.NET文档：https://jhipsternet.readthedocs.io/en/latest/
• JHipster官方文档：https://www.jhipster.tech/
• 示例项目分析：https://github.com/jhipster/jhipster-sample-app-dotnetcore
• Gitter社区：https://gitter.im/JHipster-NET/jhipster-dotnetcore

许可证

Apache-2.0 © JHipster.NET