1.1 Введение

Hirundapus — это инструмент для быстрой разработки, предназначенный для малых и средних предприятий. Он генерирует бизнес-код на основе структуры таблиц: контроллеры, сервисы, DAO (Mappers) и страницы. Для простых операций CRUD не требуется писать код.

Особенности: — автоматическое создание RESTful API-документации на основе Swagger2; — генерация системных журналов операций; — динамическое управление правами доступа на основе базы данных; — настройка периодических задач с помощью Quartz-Scheduler.

1.2 Используемые технологии в Hirundapus

Основные: SpringBoot 1.5.3, Maven.

Уровень данных: MyBatis Plus 2.1.6.

Контроль доступа: Spring Security 4.

Периодические задачи: Quartz Scheduler 2.3.0.

Обработка журналов: Logback.

Шаблоны страниц: Thymeleaf.

Фронтенд-технологии: jQuery, Layui 2.3.0.

Генерация RESTful документов: Swagger 2.7.0.

1.3 Использование инструмента

1.3.1 Структура проекта

Структура проекта:

Модуль base_common:

Модуль base_admin:

1.3.2 Генерация кода для бэкенда и фронтенда

Инструмент генерирует код для бэкенда и фронтенда на основе дизайна таблицы. Рекомендуется добавлять комментарии к таблицам и полям для создания более дружественного кода.

1.3.2.1 Конфигурационный файл для генерации кода

Конфигурационный файл: resources/mybatis-plus-generator.properties.

Параметры конфигурации:

— output.dir — каталог вывода Java-файлов; — output.dir.mapper — каталог вывода файлов MyBatis Mapper XML; — output.dir.page — каталог вывода шаблонов страниц; — author — автор кода; — db.driverName — имя драйвера базы данных; — db.url — URL подключения к базе данных; — db.username — имя пользователя базы данных; — db.password — пароль базы данных; — table.prefix — префикс таблицы; — include.tables — список таблиц для генерации; — module.name — название модуля; — module.parent.pkg — пакет родительского класса модуля; — parent.package.name — пакет родительского класса бизнес-класса; — ui.template — шаблон пользовательского интерфейса.

1.3.2.2 Процесс генерации кода

1. Запустите класс WorkshopMysqlGenerator с функцией main. Этот способ поддерживает только скрытые поля, текстовые поля и элементы управления временем.
2. Запустите проект base_admin. Перейдите на страницу конфигурации сущности.
3. Выберите элементы конфигурации страницы сущности и перейдите на страницу генерации кода.
4. На странице генерации кода настройте параметры генерации.

1.3.3 SQL-скрипты проекта

SQL-скрипты находятся в папке docs/sql.

1.3.4 Запуск проекта и вход в систему

После запуска проекта войдите в систему как суперпользователь с именем «supervisor» и паролем «123456».

1.3.5 RESTful-документы

Для просмотра RESTful-документов перейдите по адресу http://localhost:8080/contextPath/swagger-ui.html.

1.4 Благодарности

Авторы благодарят команды MyBatis-Plus и Layui за их работу.