Введение

В силу случайного стечения обстоятельств я столкнулся с JFinal, но поскольку в моей технической практике всегда преобладал SpringBoot, я всё же надеюсь интегрировать JFinal в SpringBoot для использования, ведь экосистема Spring по-прежнему невероятно надёжна. В настоящее время большинство доступных руководств описывают довольно поверхностные способы интеграции SpringBoot и JFinal, которые не приводят к тесному взаимодействию между ними. Именно поэтому появился этот стартер.

Данный проект использует автоматическую конфигурацию SpringBoot для глубокой интеграции JFinal и SpringBoot, позволяя им работать как единое целое.

• Исходный код доступен по адресам:
  • Github: https://github.com/ArtIsLong/jfinal-spring-boot-starter.git
  • Gitee: https://gitee.com/artislong/jfinal-spring-boot-starter.git.
• Мой блог: https://artislong.gitee.io.
• Цзяньшу: https://www.jianshu.com/u/46d989a94f20.

Это самодельный инструмент, который я рекомендую использовать и Star. Если у вас возникнут проблемы при использовании, вы можете создать Issue, и я постараюсь улучшить этот инструмент.

Описание функций

1. Предоставляет аннотацию BeansLoader для сканирования классов и загрузки Bean, таких как классы, наследующие Controller, или классы, реализующие IPlugin, в Spring.
2. Предоставляет аннотацию RouterPath для определения пользовательских маршрутов контроллера controllerKey.
3. Упрощает использование данных JFinal, где ActiveRecordPlugin по умолчанию загружает DataSource из Spring.

Версии фреймворка

• SpringBoot: 2.1.7.
• JFinal: 4.3.
• cron4j: 2.2.5.
• caffeine: 2.6.2.

Как использовать

Добавление зависимостей

pom.xml

<dependency>
    <groupId>com.github.artislong</groupId>
    <artifactId>jfinal-spring-boot-starter</artifactId>
    <version>1.0</version>
</dependency>

build.gradle

compile 'com.github.artislong:jfinal-spring-boot-starter:1.0'

Добавление конфигурации аннотаций

@BeansLoader(
        basePackages = "com.github.artislong",
        markerInterfaces = {
                Interceptor.class,
                Routes.class,
                Handler.class,
                Render.class
        },
        annotationClass = RouterPath.class)
@SpringBootApplication
public class JfinalApplication {
    public static void main(String[] args) {
        SpringApplication.run(JfinalApplication.class, args);
    }
}

Добавление базовой конфигурации

jfinal:
  # 配置数据库 диалекта, если не настроено, по умолчанию используется диалект MySQL
  dialect: com.jfinal.plugin.activerecord.dialect.MysqlDialect
  # Обязательный MappingKit для автоматического создания
  kit-classes:
    - model._MappingKit
  # Путь к шаблонам SQL JFinal
  sql-templates: 
    - classpath:template/*.sql
  # Отображать ли SQL
  show-sql: true
  # Включить настройку CORS
  origin: true

Другие настройки

jfinal:
  dev-mode: true
  date-pattern: yyyy-MM-dd HH:mm:ss
  taskInfoMap:
    test01:
      cron: '*/5 * * * *'
      task: cn.hzsoftware.erp.work.cron.Test01
      daemon: true
      enable: true

Для получения дополнительной информации о конфигурации обратитесь к классу JfinalProperties.

Другие часто используемые пользовательские конфигурации могут быть реализованы через обычный процесс разработки JFinal. Например, если вам нужно добавить пользовательский Interceptor, просто наследуйте от Interceptor и реализуйте свою логику.

Дополнительную информацию о конфигурации можно найти в классе SpringJfinalConfiguration.