code-gen

Инструмент генерации кода с возможностью создания различных шаблонов для генерации кода. Поддерживает MySQL, Oracle, SQL Server, PostgreSQL.

• Необходимо наличие Java 8 окружения. После скачивания можно сразу использовать.
• Процесс простой: достаточно конфигурировать один источник данных и выбрать нужные шаблоны для генерации кода.
• По умолчанию предоставляются универсальные шаблоны для сущностей, mybatis интерфейсов и конфигурационных файлов, что позволяет быстро развивать приложения на основе mybatis.

Используемые технологии: Solon + Mybatis + Vue

Шаги использования

Метод 1: локальная установка через zip

• Перейти на страницу выпусков и скачать последнюю версию zip файла
• Распаковать zip архив. Для Mac/Linux операционной системы запустите файл run.sh, для Windows дважды щелкните по файлу run.bat.
• Открыть браузер и перейти по адресу http://localhost:6969/.

По умолчанию порт 6969. Изменение номера порта производится следующими способами:

Откройте файл conf/app.yml и измените значение server.port.

или

Установите JVM параметр -Dserver.port=6666

Обновление: для последующего обновления достаточно заменить файлы gen.jar и папку dist.

Метод 2: запуск через Docker

• Скачайте общедоступный образ

docker pull registry.cn-hangzhou.aliyuncs.com/tanghc/gen:latest

После завершения загрузки выполните команду

docker run --name gen --restart=always \
  -p 6969:6969 \
  -v /opt/gen/:/opt/gen/ \
  -v /opt/gen/conf/:/gen/conf/ \
  -v /opt/gen/ext:/gen/ext \
  -d registry.cn-hangzhou.aliyuncs.com/tanghc/gen:latest

Откройте браузер и перейдите по адресу http://ip:6969/.

Локальное создание образа Docker

Клонируйте код и выполните скрипт docker-build.sh

Выполните команду

docker run --name gen --restart=always \
  -p 6969:6969 \
  -v /opt/gen/:/opt/gen/ \
  -v /opt/gen/conf/:/gen/conf/ \
  -v /opt/gen/ext:/gen/ext \
  -d <образ ID>

Поддержка других баз данных

По умолчанию поддерживаются базы данных MySQL. Чтобы подключиться к другим базам данных, таким как Oracle, выполните следующие шаги:

• Docker

1. Установите драйвер базы данных в директорию /opt/gen/ext.
2. Перезапустите Docker.

• Локальный запуск

1. Установите драйвер базы данных в директорию gen/ext.
2. Установите переменную окружения JAVA_HOME, указывающую на каталог установки Java.
3. Редактируйте файл run.sh, добавьте параметры запуска: -Djava.ext.dirs=$JAVA_HOME/jre/lib/ext:./ext.

Пример после добавления:

java -Djava.ext.dirs=$JAVA_HOME/jre/lib/ext:./ext -Dsolon.config.add=./conf/app.yml -Duser.timezone=Asia/Shanghai -jar -Xms64m -Xmx64m gen.jar

Запустите с помощью команды sh run.sh.

Использование MySQL для хранения

По умолчанию используется SQLite3 для хранения. Чтобы использовать MySQL, выполните следующие действия:

• Создайте базу данных, используя SQL файл.
• Откройте файл app.yml. В Docker среде создайте новый файл app.yml в директории /opt/gen/conf.
• Добавьте/измените следующие параметры:

dbms:
  # Установите значение true
  enable: true
  # Укажите адрес сервера, имя базы данных, учетные данные пользователя
  host: localhost:3306
  database: gen
  username: root
  password: root

Перезапустите сервис.

Другое

• Быстрый старт SpringBoot+Mybatis приложений
• Дополнительные шаблоны
• Принцип работы генератора кода

Описание проекта

• front: фронтенд Vue
• gen: backend сервис
• db: файлы инициализации базы данных
• script: вспомогательные скрипты

Локальное развитие

• Запустите com.gitee.gen.App в папке gen (solon-web проект)
• Запустите фронтенд проект в папке front. Подробнее см.: readme.

Участие в развитии

Приветствуем ваши вклады в улучшение функционала. PR отправляйте в ветку pr.

Самостоятельное сборка

Необходимо иметь установленные Maven3 и Java8.

• Автоматическая сборка [рекомендуется]:

На Mac/Linux системах можно просто выполнить build.sh для сборки. Результат будет доступен в папке dist/gen.

• Ручная сборка:

  Предварительно установите nodejs12, Java8, maven3.

  cd front

  • Выполните npm install
  • Выполните npm run build:prod

  cd ..

  • Выполните mvn clean package, результат будет доступен в папке target/gen.
  • Откройте браузер и перейдите по адресу http://localhost:6969/.

Сборка для нескольких платформ

• Установите многоплатформенный buildx: docker buildx create --use --name m1_builder

• Проверьте и запустите builder: docker buildx inspect --bootstrap

• Одним действием соберите несколько платформ и отправьте

  • Соберите образы для нескольких платформ и отправьте: docker buildx build -t registry.cn-hangzhou.aliyuncs.com/tanghc/gen --platform=linux/amd64,linux/arm64/v8 . --push

• Или соберите и сохраните локально

  • Соберите образ x64 платформы локально: docker buildx build -t registry.cn-hangzhou.aliyuncs.com/tanghc/gen --platform=linux/amd64 -o type=docker .
  • Соберите образ arm64 платформы локально: docker buildx build -t registry.cn-hangzhou.aliyuncs.com/tanghc/gen --platform=linux/arm64/v8 -o type=docker .

• Быстрый запуск: docker run -d -p 6969:6969 registry.cn-hangzhou.aliyuncs.com/tanghc/gen

Примеры экранов