Spring Boot

在 ChatGPT 中打开

Spring Boot 是构建 Java 应用的热门选择，提供依赖注入、自动配置和嵌入式服务器模型。当您将 Spring Boot 与 webforJ 一起使用时，可以通过构造函数注入直接将服务、存储库和其他 Spring 管理的 bean 注入到您的 UI 组件中。

使用 Spring Boot 与 webforJ 时，您的应用作为一个可执行的 JAR 文件运行，并在内嵌的 Tomcat 服务器上，而不是将 WAR 文件部署到外部应用服务器。这种打包模型简化了部署，并与云原生部署实践对齐。webforJ 的组件模型和路由与 Spring 的应用上下文一起工作，以管理依赖关系和配置。

创建 Spring Boot 应用

您有两种方式可以使用 Spring Boot 创建新的 webforJ 应用：使用图形化的 startforJ 工具或 Maven 命令行。

选项 1：使用 startforJ

创建新的 webforJ 应用的最简单方法是 startforJ，该工具根据所选的 webforJ 原型生成一个最小化的启动项目。这个启动项目包含所有必需的依赖、配置文件和预制的布局，因此您可以立即开始构建。

当您使用 startforJ 创建应用时，可以通过提供以下信息来定制它：

基本项目元数据（应用名称、组 ID、工件 ID）
webforJ 版本和 Java 版本
主题颜色和图标
原型
Flavor - 选择 webforJ Spring 来创建一个 Spring Boot 项目

使用这些信息，startforJ 将根据您选择的原型为 Spring Boot 创建一个基本项目。您可以选择将项目下载为 ZIP 文件或直接发布到 GitHub。

选项 2：使用命令行

如果您更喜欢使用命令行，可以直接使用官方 webforJ 原型生成一个 Spring Boot webforJ 项目：

mvn -B archetype:generate \
  -DarchetypeGroupId=com.webforj \
  -DarchetypeArtifactId=webforj-archetype-hello-world \
  -DarchetypeVersion=LATEST \
  -DgroupId=org.example \
  -DartifactId=my-app \
  -Dversion=1.0-SNAPSHOT \
  -Dflavor=webforj-spring

flavor 参数告诉原型生成一个 Spring Boot 项目，而不是标准的 webforJ 项目。

这将创建一个完整的 Spring Boot 项目，具有：

Spring Boot 父 POM 配置
webforJ Spring Boot 启动依赖
带有 @SpringBootApplication 和 @Routify 的主应用类
示例视图
Spring 和 webforJ 的配置文件

将 Spring Boot 添加到现有项目

如果您有一个现有的 webforJ 应用，可以通过修改项目配置来添加 Spring Boot。这个过程涉及更新您的 Maven 配置、添加 Spring 依赖和转换主应用类。

仅适用于现有项目

如果您从头开始创建新项目，请跳过此部分。

步骤 1：更新 Maven 配置

对 POM 文件进行以下更改：

将打包从 WAR 更改为 JAR：
pom.xml
```
<packaging>jar</packaging>
```

设置 Spring Boot 为父 POM：

pom.xml
<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>3.5.3</version>
    <relativePath/>
</parent>

删除任何特定于 WAR 的配置，例如：
- maven-war-plugin
- webapp 目录引用
- 与 web.xml 相关的配置

如果您已经有一个父 POM，您需要导入 Spring Boot 物料清单（BOM）：

pom.xml
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-dependencies</artifactId>
            <version>3.5.3</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

步骤 2：添加 Spring 依赖

将 webforJ Spring Boot 启动程序添加到您的依赖中。保留现有的 webforJ 依赖：

pom.xml
<dependencies>
    <!-- 您现有的 webforJ 依赖 -->
    <dependency>
        <groupId>com.webforj</groupId>
        <artifactId>webforj</artifactId>
        <version>${webforj.version}</version>
    </dependency>
    
    <!-- 添加 Spring Boot 启动程序 -->
    <dependency>
        <groupId>com.webforj</groupId>
        <artifactId>webforj-spring-boot-starter</artifactId>
        <version>${webforj.version}</version>
    </dependency>

    <!-- 添加 devtools -->
    <dependency>
      <groupId>com.webforj</groupId>
      <artifactId>webforj-spring-devtools</artifactId>
      <optional>true</optional>
    </dependency>

    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-devtools</artifactId>
      <optional>true</optional>
    </dependency>
</dependencies>

webforJ DevTools 用于自动刷新浏览器

webforj-spring-devtools 依赖扩展了 Spring DevTools，提供自动刷新浏览器的功能。当您在 IDE 中保存更改时，浏览器会自动重新加载，无需手动干预。请参阅 Spring DevTools 指南以获取配置详细信息。

步骤 3：更新构建插件

用 Spring Boot Maven 插件替换 Jetty 插件。删除任何现有的 Jetty 配置并添加：

pom.xml
<build>
    <plugins>
      <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
        <configuration>
          <excludeDevtools>true</excludeDevtools>
        </configuration>
      </plugin>
    </plugins>
</build>

步骤 4：转换您的应用类

通过添加必要的 Spring 注释和主方法，将主 App 类转换为 Spring Boot 应用：

Application.java
package com.example;

import com.webforj.App;
import com.webforj.annotation.Routify;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
@Routify(packages = "com.example.views")
public class Application extends App {
    
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
    
    // 如果您有现有的 run() 方法，请保留
    @Override
    public void run() throws WebforjException {
      // 您现有的初始化代码 
    }
}

@SpringBootApplication 注释启用 Spring 的自动配置和组件扫描。@Routify 注释保持不变，继续扫描您的视图包以获取路由。

步骤 5：添加 Spring 配置

在 src/main/resources 中创建 application.properties：

application.properties
# 应用入口点的完全限定类名
webforj.entry = org.example.Application

# 应用名称
spring.application.name=Hello World Spring

# 服务器配置
server.port=8080
server.shutdown=immediate

# webforJ DevTools 配置
spring.devtools.livereload.enabled=false
webforj.devtools.livereload.enabled=true
webforj.devtools.livereload.static-resources-enabled=true

运行 Spring Boot 应用

配置完成后，使用以下命令运行您的应用：

mvn spring-boot:run

应用默认在端口 8080 启动并使用内嵌的 Tomcat 服务器。您现有的 webforJ 视图和路由仍然完全正常工作，但现在您可以注入 Spring beans 并使用 Spring 功能。

配置

使用 src/main/resources 中的 application.properties 文件来配置您的应用。有关 webforJ 配置属性的信息，请参见属性配置。

以下 webforJ application.properties 设置是特定于 Spring 的：

属性	类型	描述	默认值
`webforj.servletMapping`	字符串	webforJ servlet 的 URL 映射模式。	`/*`
`webforj.excludeUrls`	列表	在映射到根时不应由 webforJ 处理的 URL 模式。当 webforJ 映射到根上下文（`/*`）时，这些 URL 模式将被排除在 webforJ 处理之外，并可以由 Spring MVC 控制器处理。这允许 REST 端点和其他 Spring MVC 映射与 webforJ 路由共存。	`[]`

配置差异

当您切换到 Spring Boot 时，几个配置方面会发生变化：

方面	标准 webforJ	Spring Boot webforJ
打包	WAR 文件	可执行 JAR
服务器	外部（Jetty、Tomcat）	内嵌 Tomcat
运行命令	`mvn jetty:run`	`mvn spring-boot:run`
主要配置	仅 `webforj.conf`	`application.properties` + `webforj.conf`
配置文件	`webforj-dev.conf`， `webforj-prod.conf`	Spring 配置文件，使用 `application-{profile}.properties`
端口配置	在插件配置中	属性中的 `server.port`

创建 Spring Boot 应用​

选项 1：使用 startforJ​

选项 2：使用命令行​

将 Spring Boot 添加到现有项目​

步骤 1：更新 Maven 配置​

步骤 2：添加 Spring 依赖​

步骤 3：更新构建插件​

步骤 4：转换您的应用类​

步骤 5：添加 Spring 配置​

运行 Spring Boot 应用​

配置​

配置差异​