# mybatis-ut

**Repository Path**: wangxinxx/mybatis-ut

## Basic Information

- **Project Name**: mybatis-ut
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-10-09
- **Last Updated**: 2021-10-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 项目名称：jhipster

本项目是基于 JHipster 7.1.0,使用 Pro710 蓝图生成，您可以在相应位置找到文档和帮助：[https://www.jhipster.tech/documentation-archive/v7.1.0](https://www.jhipster.tech/documentation-archive/v7.1.0) ， Pro710 蓝图参考文档：[JHipster.Pro](http://www.jhipster.pro/) 。

## 开发说明

在生成此项目之前，必须在计算机上安装和配置以下依赖项：

1. [Node.js][]: 我们使用 Node 来运行开发 Web 服务器并构建项目。
   根据您的系统，可以从源安装或作为预打包的捆绑包安装 Node。

安装 Node 之后，您应该能够运行以下命令来安装开发工具。 仅当[package.json](package.json)中的依赖项发生更改时，才需要运行此命令。

```
npm install
```

如果您的 npm 版本大于 7.0，则可能必须运行以下命令。

```
npm install  --legacy-peer-deps
```

本项目使用 npm 脚本和[Webpack][]作为我们的构建系统。

在两个单独的终端中运行以下命令，以创建愉悦的开发体验，当硬盘驱动器上的文件更改时，浏览器会自动刷新。

```
./mvnw
npm start
```

Npm 还用于管理此应用程序中使用的 CSS 和 JavaScript 依赖项。 您可以通过在[package.json](package.json)中指定较新的版本来升级依赖项。
您还可以运行`npm update`和`npm install`来管理依赖项。
在任何命令上添加`help`参数，以查看如何使用它。 例如，`npm help update`。

The `npm run` 命令将列出可用于该项目的所有脚本。

### PWA 支持

JHipster 附带 PWA（渐进式 Web 应用程序）支持，并且默认情况下处于关闭状态。 PWA 的主要组成部分之一是 service worker。

默认情况下，服务工作者初始化代码被注释掉。 要启用它，请在`src/main/webapp/index.html`中取消注释以下代码：

```html
<script>
  if ('serviceWorker' in navigator) {
    navigator.serviceWorker.register('./service-worker.js').then(function () {
      console.log('Service Worker Registered');
    });
  }
</script>
```

注意：[Workbox](https://developers.google.com/web/tools/workbox/)为 JHipster 的 service worker 提供助力。 它动态生成`service-worker.js`文件。

### 管理依赖

例如，要将[Leaflet][]库添加为应用程序的运行时依赖项，可以运行以下命令：

```
npm install --save --save-exact leaflet
```

要从开发中[DefinitelyTyped][]存储库中的 TypeScript 类型定义中受益，您可以运行以下命令：

```
npm install --save-dev --save-exact @types/leaflet
```

然后，您将导入库的安装说明中指定的 JS 和 CSS 文件，以便[Webpack][]了解它们：
注意：Leaflet 还有其他要做的事情，我们在这里不做详细介绍。

有关如何使用 JHipster 进行开发的更多说明，请参阅在开发中使用[Using JHipster in development][]。

## 系统构建

### 打包为 Jar 包

要构建最终的 Jar 包并优化用于生产的 jhipster 应用程序，请运行：

```
./mvnw -Pprod clean verify
```

上面过程中可能会因为测试失败而无法完成，请暂时忽略测试再运行，测试代码正在整理中。：

```
./mvnw -Pprod clean verify -DskipTests
```

这将打包和压缩客户端 CSS 和 JavaScript 文件。 它还将修改`index.html`，以便它引用这些新文件。
为确保一切正常，请运行：

```
java -jar target/*.jar
```

然后在浏览器中打开[http://localhost:8080](http://localhost:8080)。

有关更多详细信息，请参阅在生产中使用[Using JHipster in production][]。

### 打包为 War 包

要将应用程序打包为 War 包以将其部署到应用程序服务器，请运行：

```
./mvnw -Pprod,war clean verify
```

上面过程中可能会因为测试失败而无法完成，请暂时忽略测试再运行，测试代码正在整理中。

```
./mvnw -Pprod,war clean verify -DskipTests
```

## 测试

要启动应用程序的测试，请运行：

```
./mvnw verify
```

### 前端测试

单元测试由[Jest][]运行。 它们位于[src/test/javascript/](src/test/javascript/)中，可以与以下命令一起运行：

```
npm test
```

有关更多信息，请参阅[Running tests page][]。

### 代码质量

Sonar 用于分析代码质量。 您可以使用以下命令启动本地 Sonar 服务器（可从 http://localhost:9001 访问）：

```
docker-compose -f src/main/docker/sonar.yml up -d
```

注意：我们在尝试 SonarQube 时已关闭[src/main/docker/sonar.yml](src/main/docker/sonar.yml)中的身份验证以提供开箱即用的体验，对于实际用例，请重新打开它。

您可以使用[sonar-scanner](https://docs.sonarqube.org/display/SCAN/Analyzing+with+SonarQube+Scanner)或使用 maven pluginmaven 插件运行 Sonar 分析。

然后，运行 Sonar 分析:

```
./mvnw -Pprod clean verify sonar:sonar
```

如果您需要重新运行 Sonar 阶段，请确保至少指定`initialize`阶段，因为 Sonar 属性是从 sonar-project.properties 文件加载的。

```
./mvnw initialize sonar:sonar
```

有关更多信息，请参阅[Code quality page][]。

## 使用 Docker 简化开发（可选）

您可以使用 Docker 来改善您的 JHipster 开发体验。 [src/main/docker](src/main/docker)文件夹中提供了许多 docker-compose 配置，以启动所需的第三方服务。

例如，要在 Docker 容器中启动 mysql 数据库，请运行：

```
docker-compose -f src/main/docker/mysql.yml up -d
```

要停止并删除容器，请运行：

```
docker-compose -f src/main/docker/mysql.yml down
```

您还可以对应用程序及其依赖的所有服务进行完全 docker 化。
为此，请首先通过运行以下操作为您的应用构建 docker 映像：

```
./mvnw -Pprod verify jib:dockerBuild
```

然后运行：

```
docker-compose -f src/main/docker/app.yml up -d
```

有关更多信息，请参阅[Using Docker and Docker-Compose][]，此页面还包含有关 docker-compose 子生成器（`jhipster docker-compose`）的信息，该子生成器能够为一个或多个 JHipster 应用程序生成 docker 配置。

## 持续集成（可选）

要为您的项目配置 CI，请运行 ci-cd 子生成器（`jhipster ci-cd`），这将使您为许多 Continuous Integration 系统生成配置文件。 有关更多信息，请查阅[Setting up Continuous Integration][]页面。

[jhipster homepage and latest documentation]: https://www.jhipster.tech
[jhipster 7.1.0 archive]: https://www.jhipster.tech/documentation-archive/v7.1.0
[using jhipster in development]: https://www.jhipster.tech/documentation-archive/v7.1.0/development/
[using docker and docker-compose]: https://www.jhipster.tech/documentation-archive/v7.1.0/docker-compose
[using jhipster in production]: https://www.jhipster.tech/documentation-archive/v7.1.0/production/
[running tests page]: https://www.jhipster.tech/documentation-archive/v7.1.0/running-tests/
[code quality page]: https://www.jhipster.tech/documentation-archive/v7.1.0/code-quality/
[setting up continuous integration]: https://www.jhipster.tech/documentation-archive/v7.1.0/setting-up-ci/
[node.js]: https://nodejs.org/
[webpack]: https://webpack.github.io/
[browsersync]: https://www.browsersync.io/
[jest]: https://facebook.github.io/jest/
[jasmine]: https://jasmine.github.io/2.0/introduction.html
[leaflet]: https://leafletjs.com/
[definitelytyped]: https://definitelytyped.org/