Java Web Apps with Visual Studio Code

本教程向您展示如何使用 Visual Studio Code 创建 Java Web 应用程序。您将学习如何将 Java Web 应用程序部署到 Azure App Service 中的 Linux Tomcat 服务器。

场景

一个简单的 Hello World Web 应用。

开始之前

在运行和部署此示例之前，您的本地开发环境中必须安装 Java SE Development Kit (JDK) 和 Apache Maven 构建工具。如果没有，请安装它们。

下载并安装 Extension Pack for Java，其中包含 JDK 11。

注意：必须将 JAVA_HOME 环境变量设置为 JDK 的安装位置才能完成本教程。

下载 Apache Maven 3 或更高版本

下载 Apache Maven

为本地开发环境安装 Apache Maven

安装 Apache Maven

创建 Maven Web App 项目

maven-archetype-webapp 是一个用于生成 Maven Web App 项目的 archetype。要了解更多信息，您可以访问 此文档。

1. 在一个空文件夹中，运行以下命令从 Maven archetype 生成一个新项目。

   mvn archetype:generate -DarchetypeGroupId=org.apache.maven.archetypes -DarchetypeArtifactId=maven-archetype-webapp -DarchetypeVersion=1.4

1. Maven 要求您提供完成项目生成所需的部署值。在出现提示时提供以下值

   提示	值	描述
   groupId	com.webappproject	一个值，根据 Java 的 包命名规则，在所有项目中唯一标识您的项目。
   artifactId	webapp-project	一个值，即 jar 的名称，不带版本号。
   version	1.0-SNAPSHOT	选择默认值。
   package	com.webappproject	一个值，即生成的函数代码的 Java 包。使用默认值。

2. 键入 Y 或按 Enter 确认。

   Maven 会在一个新文件夹中创建项目文件，文件夹名称为 artifactId，在本例中为 webapp-project。

3. 导航到项目文件夹

   cd webapp-project
   

将 Web App 部署到云端

我们刚刚构建了一个 Java Web 应用程序并在本地运行它。现在您将学习如何从 Visual Studio Code 部署它并在云中的 Azure 上运行它。

如果您没有 Azure 订阅，可以注册一个 免费 Azure 帐户。

创建免费 Azure 帐户

安装 Azure App Service 扩展

Azure App Service 扩展用于创建、管理和部署到 Azure App Service，主要功能包括

• 创建新的 Azure Web App/部署槽位
• 部署到 Azure Web App/部署槽位
• 启动、停止和重新启动 Azure Web App/部署槽位
• 查看 Web App 的日志文件
• 交换部署槽位

要安装 Azure App Service 扩展，请打开扩展视图 (⇧⌘X (Windows、Linux Ctrl+Shift+X)) 并搜索 azure app service 以筛选结果。选择 Microsoft Azure App Service 扩展。如需更以 Maven 命令行体验为中心的方式，您还可以查看 Azure App Service Linux 教程的 Maven 插件。

登录 Azure 订阅

要登录 Azure，请从命令面板 (⇧⌘P (Windows、Linux Ctrl+Shift+P)) 运行 Azure: Sign In。或者，您也可以通过点击 RESOURCES Explorer 中的 Sign in to Azure... 登录您的 Azure 帐户。

在 Azure 上创建新的 Web App

安装扩展后，您可以执行以下步骤在 Azure 上创建新的 Web App。

1. 点击 RESOURCES Explorer 视图上的 Create 按钮，然后选择 Create App Service Web App...。

2. 输入新 Web App 的唯一名称。

3. 选择 Web App 的运行时任务，例如 Java 17。

4. 选择 Java Web 服务器堆栈，例如 Apache Tomcat 10.0。

5. 选择定价层，例如 Free(F1)。

构建并部署到 Web App

部署过程利用了 Azure Resources 扩展（作为依赖项与 Azure App Service 扩展一起安装），您需要使用 Azure 订阅登录。如果您没有 Azure 订阅，请立即注册一个 30 天的免费帐户，并获得 200 美元的 Azure 积分来试用任意组合的 Azure 服务。

登录后，您可以打开命令提示符或终端窗口，并使用 Maven 命令构建项目。这将在 target 目录中生成一个新的 war 或 jar artifact。

mvn clean package

构建项目后，在 VS Code Explorer 中打开 target 目录。右键单击 artifact 并选择 Deploy to Web App，然后按照提示选择用于部署的 Web App。

打开 VS Code 中的 Output 窗口以查看部署日志。部署完成后，它将打印出您的 Web App 的 URL。单击链接在浏览器中打开它，您可以看到 Web 应用正在 Azure 上运行！

注意：有关 App Service 的更高级功能，您可以查看 Azure App Service 扩展。

清理资源

1. 要删除您的 Web 应用，请导航到 RESOURCES Explorer 并找到 App Services 项。

2. 右键单击您要删除的 Web 应用并单击 Delete。

3. 要删除您的应用服务计划或资源组，请访问 Azure 门户 并手动删除您订阅下的资源。

后续步骤

• 要容器化和部署 Web 应用程序，请查看 VS Code 中的 Docker。
• 要了解有关 Java 调试功能的更多信息，请参阅 Java 调试教程。