Введение в JHipster

Эта статья даст вам краткий обзор JHipster, покажет, как создать простое монолитное приложение и пользовательские объекты с помощью инструментов командной строки.

Мы также будем проверять сгенерированный код на каждом этапе, а также рассмотрим команды сборки и автоматизированные тесты.

JHipster, вкратце,a high-level code generator built upon an extensive list of cutting-edge development tools and platforms.

Основными компонентами инструмента являются:

JHipster с помощью всего лишь нескольких команд оболочки создает полноценный веб-проект на Java с дружественным, отзывчивым интерфейсом, документированным REST API, всесторонним охватом тестирования, базовой безопасностью и интеграцией с базой данных! Полученный код хорошо прокомментирован и соответствует лучшим отраслевым практикам.

Другие ключевые технологии, используемые ею:

Мы не обязаны использовать все эти элементы в нашем сгенерированном приложении. Необязательные элементы выбираются при создании проекта.

Прекрасное приложение, созданное JHipster. Это результат работы, которую мы будем проделывать в этой статье.

Чтобы установить JHipster, нам сначала нужно установить все его зависимости:

Этого достаточно, если вы решите использовать AngularJS 2. Однакоif you prefer to go with AngularJS 1 instead, you would also need to install Bower and Gulp.

Теперь, чтобы закончить, нам просто нужно установить сам JHipster. Это самая легкая часть. Поскольку JHipster - этоYeoman generator, который, в свою очередь, является пакетом Javascript, установка так же проста, как запуск простой команды оболочки:

Это оно! Мы использовали менеджер пакетов Yarn для установки генератора JHipster.

To create a JHipster project essentially is to build a Yeoman project. Все начинается с командыyo:

Это создаст нашу папку проекта с именемexample-app и запустит интерфейс командной строки Yeoman, который проведет нас через создание проекта.

Процесс включает в себя 15 шагов. Я рекомендую вам изучить доступные варианты на каждом этапе. В рамках этой статьи мы создадим простое приложениеMonolithic, не слишком отклоняясь от параметров по умолчанию.

Вот шаги, которые наиболее актуальны для этой статьи:

JHipster создаст файлы проекта и затем начнет устанавливать зависимости. В выводе будет показано следующее сообщение:

Установка зависимостей может занять некоторое время. Как только он закончится, он покажет:

Наш проект сейчас создан. Мы можем запустить основные команды в корневой папке нашего проекта:

JHipster generates a README file, placed right in the root folder of our project. Этот файл содержит инструкции для запуска многих других полезных команд, связанных с нашим проектом.

Посмотрите на файлы, автоматически сгенерированные. Вы заметите, что проект немного похож на стандартный проект Java / Spring, но с множеством дополнительных функций.

Поскольку JHipster позаботится и о создании внешнего кода, вы найдете файлpackage.json, папкуwebpack и некоторые другие материалы, связанные с Интернетом.

Давайте быстро рассмотрим некоторые важные файлы.

Объекты являются строительными блоками нашего приложения JHipster. Они представляют бизнес-объекты, такие какUser, aTask, aPost, aComment и т. Д.

Создание сущностей с JHipster - безболезненный процесс. Мы можем создать объект с помощью инструментов командной строки, аналогично тому, как мы создали сам проект, или с помощьюJDL-Studio, онлайн-инструмента, который генерирует JSON-представление сущностей, которые впоследствии могут быть импортированы в наш проект.

В этой статье давайте воспользуемся инструментами командной строки для создания двух сущностей:Post иComment.

Post должен иметь заголовок, текстовое содержимое и дату создания. Он также должен быть связан с пользователем, который является создателемPost. СUser может быть связано многоPosts.

Post также может иметь ноль или многоComments. КаждыйComment имеет текст и дату создания.

Чтобы запустить процесс создания нашей сущностиPost, перейдите в корневую папку нашего проекта и введите:

Теперь следуйте инструкциям интерфейса.

Повторите описанный выше процесс, чтобы создать объект с именемcomment, с двумя полями, текстовыми, типаString, иcreationDate типаLocalDate. Comment также должен иметь требуемую связьmany-to-one сPost.

Это оно! В этом процессе много шагов, но вы увидите, что на их выполнение не требуется много времени.

Вы заметите, что JHipster создает кучу новых файлов и изменяет несколько других, как часть процесса создания сущностей:

Это довольно много кода!

Не стесняйтесь запускать тесты и перепроверить, что все прошло. Теперь мы также можем запускать тесты производительности с помощью Gatling, используя команду (для выполнения этих тестов приложение должно быть запущено):

Если вы хотите проверить интерфейс в действии, запустите приложение с./mvnw, перейдите кhttp://localhost:8080 и войдите в систему как пользовательadmin (пароль:admin ).

ВыберитеPost в верхнем меню под пунктом менюEntities. Вам будет показан пустой список, который позже будет содержать все сообщения. Нажмите кнопкуCreate a new Post, чтобы открыть форму включения:

Обратите внимание, насколько осторожен JHipster для компонентов формы и сообщений проверки. Конечно, мы можем изменять интерфейс настолько, насколько мы хотим, но форма очень хорошо сложена, как есть.

JHipster может автоматически создавать файлы конфигурации для наиболее часто используемых инструментов непрерывной интеграции. Просто запустите эту команду:

И ответь на вопросы. Здесь мы можем выбрать, для каких инструментов CI мы хотим создавать файлы конфигурации, хотим ли мы использовать Docker, Sonar и даже развертывать их в Heroku в рамках процесса сборки.

Командаci-cd может создавать файлы конфигурации для следующих инструментов CI:

Эта статья рассказала о том, на что способен JHipster. Конечно, это гораздо больше, чем мы можем здесь рассказать, так что определенно продолжайте изучатьofficial JHipster website.

И как всегда доступен кодover on GitHub.