空白原型
blank 原型是 webforJ 应用程序的基础启动项目。该模板为您从头开始构建应用程序提供了一个干净的起点。它非常适合希望对应用程序的结构和组件拥有完全控制权的开发人员,没有任何预定义的限制。
使用 startforJ
为了更好地控制自定义和配置,您可以使用 startforJ 创建项目 - 在选择配置选项时选择 Blank 原型。
使用 blank 原型
要创建和搭建一个新的 blank 项目,请按照以下步骤进行:
- 导航到正确的目录: 打开终端并移动到您想创建新项目的文件夹。
- 运行 archetype:generate 命令: 使用下面的Maven命令,并根据您的项目需求自定义groupId、artifactId和版本。
- Bash/Zsh
- PowerShell
- Command Prompt
mvn -B archetype:generate \
-DarchetypeGroupId=com.webforj \
-DarchetypeArtifactId=webforj-archetype-blank \
-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-blank" `
-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-blank" ^
-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 | 选择项目风味:
|
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.