开始使用

在 ChatGPT 中打开

本文概述了使用 webforJ 原型创建新 webforJ 应用的步骤。原型提供了预配置的项目结构和启动代码，以便您能够快速启动和运行项目。

要从原型创建一个新的 webforJ 应用，您可以使用 startforJ 或命令行。

必备条件

在开始之前，请查看设置和使用 webforJ 所需的必备条件。

使用 startforJ

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

使用 startforJ 定制

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

基本项目元数据（应用名称、组 ID、构件 ID）
webforJ 版本和 Java 版本
主题颜色和图标
原型
运行环境

运行环境 的选择决定了应用的运行方式，默认选项为 Servlet 容器：

Servlet 容器：一个适用于 Jetty、Tomcat 或其他 Servlet 容器的 WAR
Spring Boot：带有嵌入式服务器的可执行 JAR
BBjServices：通过 BBjShip 运行的应用

可用原型

webforJ 附带多个预定义的原型，帮助您快速入门。有关可用原型的完整列表，请参见原型目录。

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

下载项目后，在 IDE 中打开项目文件夹。

使用命令行

如果您更喜欢使用命令行，可以直接使用 Maven 原型生成项目：

要创建和搭建一个新的 hello-world 项目，请按照以下步骤进行：

导航到正确的目录: 打开终端并移动到您想创建新项目的文件夹。
运行 archetype:generate 命令: 使用下面的Maven命令，并根据您的项目需求自定义groupId、artifactId和版本。

Bash/Zsh
PowerShell
Command Prompt

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 \
-DappName=MyApp

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" `
-DappName="MyApp"

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" ^
-DappName="MyApp"

参数	解释
`archetypeGroupId`	该原型的组ID为com.webforj。
`archetypeArtifactId`	指定要使用的原型名称。
`archetypeVersion`	指定要使用的原型版本。这确保生成的项目与特定的原型版本兼容。使用 LATEST 选择最新可用版本。
`groupId`	表示生成项目的命名空间。通常结构类似于Java包，例如org.example，用于唯一识别您的组织或项目域。
`artifactId`	指定生成项目的名称。它将是生成的工件和项目文件夹的名称。
`version`	定义生成项目的版本。常见约定为 MAJOR.MINOR-SNAPSHOT，例如 1.0-SNAPSHOT，其中 SNAPSHOT 表示项目仍在开发中。
`flavor`	选择项目风味: `webforj` - 标准 webforJ 应用。 `webforj-spring` 25.02- 支持 Spring Boot 的 webforJ 应用。 `webforj-bbj` 26.03- 通过 BBjShip 在 BBjServices 中运行的 webforJ 应用
`appName`	项目 POM 文件中可选的参数。根据使用的 webforJ 原型，它可以作为应用程序的默认标题。