跳至主要内容

HelloWorld 原型

在 ChatGPT 中打开

该原型创建一个简单的 hello world 应用程序,以演示使用 webforJ 构建 UI 的基础知识。此模板非常适合初学者快速入门。它提供了一个简单明了的示例,展示如何设置和运行基本的 webforJ 应用程序,使其成为新开发人员的绝佳起点。

从头开始

该原型创建一个具有少量组件和一些样式的简约应用程序。对于希望创建最少脚手架的项目的开发人员,请参见 blank 原型

使用 startforJ

为了获得更好的自定义和配置控制,您可以使用 startforJ 创建您的项目 - 只需在选择配置选项时选择 HelloWorld 原型即可。

使用 hello-world 原型

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

  1. 导航到正确的目录: 打开终端并移动到您想创建新项目的文件夹。
  2. 运行 archetype:generate 命令: 使用下面的Maven命令,并根据您的项目需求自定义groupId、artifactId和版本。
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 - webforJ 应用,支持 Spring Boot(需要 webforJ 25.02 或更高版本)。
appName项目 POM 文件中可选的参数。根据使用的 webforJ 原型,它可以作为应用程序的默认标题。

运行命令后,Maven将生成运行项目所需的项目文件。

Running the app

Before running your app, install the prerequisites if you haven't yet. Then, navigate to the project's root directory and run the following command:

mvn
Full maven command

The shorthand mvn command works because the archetype's POM file includes a <defaultGoal> configuration that automatically runs the appropriate goal for your project type. If your project doesn't have <defaultGoal>, run the following:

# for a standard webforJ app
mvn jetty:run
# for a webforJ + Spring Boot app
mvn spring-boot:run

Once the server is running, open your browser and go to http://localhost:8080 to view the app.