Project Setup
要开始本教程,您需要一个项目位置,以便管理您的类和资源。以下部分描述了您可以为本教程创建 webforJ 项目的不同方法。
使用源代码
按照本教程的最简单方法是参考其源代码。您可以从 GitHub 下载整个项目或克隆它:
- 下载 ZIP: webforj-tutorial.zip
- GitHub 仓库: 从 GitHub 直接克隆项目
git clone https://github.com/webforj/webforj-tutorial.git
项目结构
该项目包含六个子目录,每个子目录对应于教程中的一个步骤,并且每个目录都包含一个可运行的应用程序。按照教程进行,可以看到应用程序从基本设置逐步发展到一个完整的客户管理系统。
webforj-tutorial
│ .gitignore
│ LICENSE
│ README.md
│
├───1-creating-a-basic-app
├───2-working-with-data
├───3-routing-and-composites
├───4-observers-and-route-parameters
├───5-validating-and-binding-data
└───6-integrating-an-app-layout
使用 startforJ
如果您更愿意创建一个新项目,可以使用 startforJ 生成一个最小的起始项目。有关使用 startforJ 的详细信息,请参阅 入门指南。
必需设置
- 在 webforJ 版本 下拉菜单中,选择 webforJ 版本 26.00 或更高版本。
- 在 Flavor 下拉菜单中,选择 webforJ + Spring Boot。
使用命令行
您还可以使用以下命令生成一个新项目:
- Bash/Zsh
- PowerShell
- 命令提示符
mvn -B archetype:generate \
-DarchetypeGroupId=com.webforj \
-DarchetypeArtifactId=webforj-archetype-hello-world \
-DarchetypeVersion=LATEST \
-DgroupId=com.webforj.tutorial \
-DartifactId=customer-app \
-Dversion=1.0-SNAPSHOT \
-Dflavor=webforj-spring
mvn -B archetype:generate `
-DarchetypeGroupId="com.webforj" `
-DarchetypeArtifactId="webforj-archetype-hello-world" `
-DarchetypeVersion="LATEST" `
-DgroupId="com.webforj.tutorial" `
-DartifactId="customer-app" `
-Dversion="1.0-SNAPSHOT" `
-Dflavor="webforj-spring"
mvn -B archetype:generate ^
-DarchetypeGroupId="com.webforj" ^
-DarchetypeArtifactId="webforj-archetype-hello-world" ^
-DarchetypeVersion="LATEST" ^
-DgroupId="com.webforj.tutorial" ^
-DartifactId="customer-app" ^
-Dversion="1.0-SNAPSHOT" ^
-Dflavor="webforj-spring"
配置
创建新项目的这两种方式都使用 webforJ 原型,它们会自动将所需的配置添加到您的项目中,例如 Spring 依赖关系 到您的 POM 以及以下属性在 src/main/resources/application.properties 中:
spring.application.name=CustomerApplication
server.port=8080
webforj.entry = com.webforj.tutorial.Application
webforj.debug=true
运行应用程序
要在您进行教程时查看应用程序的实际运行情况:
-
导航到所需步骤的目录。这里应该是该步骤的顶层目录,包含
pom.xml。 -
使用以下 Maven 命令在本地运行 Spring Boot 应用程序:
mvn
运行该应用程序会自动在 http://localhost:8080 打开一个新浏览器。