JHipster框架的简要搭建与说明

JHipster的亮点

1. 风头超劲，席卷欧美，最新全能Java Web开发程式产生器 (java web generator)。
2. 由Java专家累积的开发经验，配上各类实用的框架技术，去繁取精的运用，全方位的配置，制成出完备的开发应用程式。
3. 完美Java体系架构，适合各行各业项目，尤其以适用于面向服务的体系结构(SOA)更为胜任。
4. 不论菜鸟，老牛或专家，极容易上手，只要你可以下载及建立以下要求的工作环境。
5. 快速建成一个制作就绪的基本项目工作模版，令你可以用有限的精力专注业务上的运作。
6. 使用技术：jHipster3.8+Spring4.2.6+Spring Boot1.3.5+Hibernate4.3.11+MySQL5.7.12+AngularJs1.5.8

JHipster或者称Java Hipster，是一个应用代码产生器，能够创建Spring Boot + AngularJS的应用。开源项目地址：JHipster/Github。

JHipster使用Node.js和Yeoman产生Java应用代码，使用Maven(Gradle)运行产生的代码，产生代码有如下关键特征：

• src/main/java 目录有Spring Boot 配置类在config包中，JHipster使用Spring的Java 配置，没有
• JPA实体或MongoDB文档类是在domain包. JPA实体使用缓存和auto-generated 主键配置. 如果你使用JHipster产生你的JPA实体, 可以创建1:N和N:N关系。
• 在repostiory包中是Spring Data 仓储.
• 可选，你有通常@Service-beans 在服务层. 这些服务通常是配置为事务的 安全的业务对象。
• REST 端点存在web.rest 包中, 支持Spring MVC的REST
• JHipster也产生 Liquibase 改变日志文件，用来处理数据库更新，增加一个实体将创建特定的schema更新，这将会版本化，当应用重启时可被执行。
• 集成Spring的 Test 上下文测试支持.
• JHipster 创建完整可用的AngularJS 前端，使用CRUD来管理你产生的实体。

客户端技术栈

单页面Web应用:

• 响应式页面设计
• HTML5 Boilerplate
• Twitter Bootstrap
• AngularJS
• 兼容 IE9+ 和其他现代浏览器
• 完整的国际化支持，基于 Angular Translate
• 可选 Sass 用于 CSS 设计
• 可选 Spring Websocket 来实现 WebSocket

强大的 Yeoman 开发工作流:

• 使用 Bower 可以轻松的安装 JavaScript 类库
• 使用 Gulp.js 构建, 优化项目, 支持 live reload
• 使用 Karma and PhantomJS 进行测试

那么，如果单页面应用不能满足你的需求呢？

• 支持 Thymeleaf 模板引擎, 用于在服务端渲染页面

服务端技术栈

一个完整的 Spring 应用:

• Spring Boot 用于简化应用配置
• Maven 或者 Gradle 用于构建，测试和运行应用
• "development" 和 "production" 配置文件 (支持 Maven 和 Gradle)
• Spring Security
• Spring MVC REST + Jackson
• 可选的 WebSocket 支持 -- 基于 Spring Websocket
• Spring Data JPA + Bean 验证
• 使用 Liquibase 实现数据库自动更新
• Elasticsearch 支持对数据库的搜索功能
• 支持像MongoDB 这样的 document-oriented NoSQL 数据库
• 支持像Cassandra 这样的 column-oriented NoSQL 数据库

支持生产环境：

• Monitoring with Metrics 监控运行状态
• 支持 ehcache (本地缓存) 或者 hazelcast (分布式缓存)
• 可选的 HTTP session 集群 -- 基于 hazelcast
• 优化的静态资源(gzip filter, HTTP cache headers)
• 日志管理 Logback, 可在运行时配置
• HikariCP 连接池，用于性能优化
• 可以将应用构建成一个标准的 WAR 文件或者一个可执行的 JAR 文件

安装

安装前置条件

• JDK 8+
• Maven或者Gradle
• NodeJs
• PhantomJS(见下文安装说明)
• MySql
• Git
• Spring Tool Suite或Eclipse或Intellij IDEA
• get='_blank'>window 管理员权限的 CMD或者PowerShell(推荐用PowerShell)

1. 全局安装 Yeoman : npm install -g yo
2. 全局安装 Bower:npm install -g bower
3. 全局安装 Gulp ：npm install -g gulp-cli
4. 全局安装 JHipster：npm install -g generator-jhipster

假如已经安装完毕则软件各版本如下

• yo@1.8.5
• bower@1.7.9
• gulp-cli@1.2.2
• npm@3.10.3
• generator-jhipster@3.8.0

至此，JHipster已经安装完毕

准备工作安装phantomjs

注意先确保已经设置好PhantomJS环境变量，以Windows为例，右键我的电脑-》属性-》高级系统设置-》高级-》环境变量-》新建用户或者系统变量

变量名：PHANTOMJS_HOME

变量值：解压的phantomjs路径

修改系统变量path追加

;%PHANTOMJS_HOME%\bin;

生成代码

JHipster通过 entity sub-generator 自动创建前后端相应代码

JHipster entity sub-generator 根据项目类型，和选项，自动创建相应代码（gateway和Monolithic application 会创建前后端代码，uaa,microservice创建后端代码）

对于关联关系可以参加 管理实体间映射关系

对于简单(字段少)，实体类数量少的实体创建，建议使用命令行，打开项目文件夹

yo jhipster:entity <实体类名> [options] 可以通过yo jhipster:entity --help 查看支持的选项

yo jhipster:entity --help

Usage:

  yo jhipster:entity [options] <name>

Options:

  -h,   --help            # Print the generator's options and usage(打印生成器支持的选项)

        --skip-cache      # Do not remember prompt answers(不记住之前选项，默认记住)                        Default: false

        --skip-install    # Do not automatically install dependencies(不自动安装依赖项，默认安装)           Default: false

        --regenerate      # Regenerate the entity without presenting an option to update it(重新生成)     Default: false

        --table-name      # Specify table name that will be used by the entity(指定生成的表名)

        --fluent-methods  # Generate fluent methods in entity beans to allow chained object construction  Default: true

        --angular-suffix  # Use a suffix to generate AngularJS routes and files, to avoid name clashes(增加angular文件后缀，防止文件名字冲突)

        --skip-server     # Skip the server-side code generation(不生成服务端代码，默认生成)                 Default: false

        --skip-client     # Skip the client-side code generation(不生成客户端代码，默认生成)                 Default: false

Arguments:

  name    Type: String  Required: true

Description:

    Creates a new JHipster entity: JPA entity, Spring MVC REST controller, AngularJS controller, service and view, all wired up together

Example:

    yo jhipster:entity Foo

    This will create:

        .jhipster.Foo.json

        src/main/java/package/domain/Foo.java

        src/main/java/package/repository/FooRepository.java

        src/main/java/package/web/rest/FooResource.java

        src/main/resources/config/liquibase/changelog/20150128232313_added_entity_Foo.

        src/main/webapp/app/entities/foo/foos.html

        src/main/webapp/app/entities/foo/foo-detail.html

        src/main/webapp/app/entities/foo/foo.js

        src/main/webapp/app/entities/foo/foo.controller.js

        src/main/webapp/app/entities/foo/foo-detail.controller.js

        src/main/webapp/app/entities/foo/foo.service.js

        src/test/java/package/web/rest/FooResourceTest.java

        src/main/webapp/i18n/en/foo.json

        src/main/webapp/i18n/fr/foo.json

对于比较复杂的实体（数量多，关系复杂，字段多），建议使用JHipster UML 和JDL Studio

例如生成 Author和Book两个实体

创建实体类

 yo jhipster:entity author (创建author实体类)

The entity Author is being created.

Generating field #1 (第一个字段)

? Do you want to add a field to your entity? Yes

? What is the name of your field? name

? What is the type of your field? String

? Do you want to add validation rules to your field? No

================= Author =================

Fields

name (String)

Generating field #2

? Do you want to add a field to your entity? Yes

? What is the name of your field? birthDate

? What is the type of your field? LocalDate

? Do you want to add validation rules to your field? No

================= Author =================

Fields

name (String)

birthDate (LocalDate)

Generating field #3

? Do you want to add a field to your entity? No (停止创建)

================= Author =================

Fields

name (String)

birthDate (LocalDate)

Generating relationships to other entities

? Do you want to add a relationship to another entity? Yes(创建关联关系)

? What is the name of the other entity? book

? What is the name of the relationship? book

? What is the type of the relationship? one-to-many

? What is the name of this relationship in the other entity? author

================= Author =================

Fields

name (String)

birthDate (LocalDate)

Relationships

book (Book) one-to-many

Generating relationships to other entities

? Do you want to add a relationship to another entity? No

================= Author =================

Fields

name (String)

birthDate (LocalDate)

Relationships

book (Book) one-to-many

? Do you want to use a Data Transfer Object (DTO)? No, use the entity directly (是否创建DTO?)

? Do you want to use separate service class for your business logic? No, the REST controller should use the repository directly (对于业务逻辑是否使用分离的服务类,使用REST controller和repository)

? Do you want pagination on your entity? No(是否分页)

Everything is configured, generating the entity...

   create .jhipster\Author.json

   create src\main\java\com\shunneng\app\domain\Author.java

   create src\main\java\com\shunneng\app\repository\AuthorRepository.java

   create src\main\java\com\shunneng\app\web\rest\AuthorResource.java

 conflict src\main\resources\ehcache.

? Overwrite src\main\resources\ehcache.

    force src\main\resources\ehcache.

   create src\main\resources\config\liquibase\changelog\20160926160804_added_entity_Author.

    force src\main\resources\config\liquibase\master.

   create src\main\webapp\app\entities\author\authors.html

   create src\main\webapp\app\entities\author\author-detail.html

   create src\main\webapp\app\entities\author\author-dialog.html

   create src\main\webapp\app\entities\author\author-delete-dialog.html

    force src\main\webapp\app\layouts\navbar\navbar.html

   create src\main\webapp\app\entities\author\author.state.js

   create src\main\webapp\app\entities\author\author.controller.js

   create src\main\webapp\app\entities\author\author-dialog.controller.js

   create src\main\webapp\app\entities\author\author-delete-dialog.controller.js

   create src\main\webapp\app\entities\author\author-detail.controller.js

   create src\main\webapp\app\entities\author\author.service.js

   create src\main\webapp\i18n\zh-cn\author.json

    force src\main\webapp\i18n\zh-cn\global.json

   create src\test\javascript\spec\app\entities\author\author-detail.controller.spec.js

   create src\test\javascript\e2e\entities\author.js

   create src\test\java\com\shunneng\app\web\rest\AuthorResourceIntTest.java

   create src\test\gatling\simulations\AuthorGatlingTest.scala

Running gulp Inject to add javascript to index