现已发布！阅读有关 11 月的新功能和修复的信息。

使用 Visual Studio Code 开发 Java Web 应用程序

本教程演示如何使用 Visual Studio Code 创建 Java Web 应用程序。你将学习如何在本地以及最终在云端运行、调试和编辑 Java Web 应用程序。

场景

一个简单的 Spring Boot 入门 Web 应用程序

Greeting from Java

开始之前

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

下载并安装Java 扩展包，其中包含 JDK 11。

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

下载 Apache Maven 3 或更高版本

下载 Apache Maven

为你的本地开发环境安装 Apache Maven

安装 Apache Maven

下载并测试 Spring Boot 应用程序

将Spring Boot 入门示例项目克隆到你的本地计算机。你可以使用命令面板（⇧⌘P (Windows, Linux Ctrl+Shift+P)）中的 Git: 克隆命令克隆 Git 存储库。粘贴 https://github.com/spring-guides/gs-spring-boot.git 作为远程存储库的 URL，然后决定将本地存储库放置在哪个父目录中。之后，通过导航到该文件夹并键入 code .，在 VS Code 中打开克隆存储库中的 complete 文件夹。

注意：你可以从https://vscode.js.cn安装 Visual Studio Code，并从https://git-scm.cn安装 Git。

Clone Spring Repository

在 VS Code 中，打开 complete 文件夹中的任何 Java 文件（例如 src\main\java\hello\Application.java）。如果没有为 VS Code 安装 Java 语言扩展，系统会提示你安装 Microsoft Java 扩展包。按照说明进行操作，并在安装后重新加载 VS Code。

Install Java Extensions

安装 Java 扩展包后，它会自动为你构建项目（这可能需要几分钟）。你可以通过按 F5 并选择 Java 环境在 VS Code 中运行应用程序。Java 调试扩展将在项目的 .vscode 文件夹下为你生成一个调试配置文件 launch.json。你可以在 VS Code 状态栏中查看构建进度，当一切完成后，将显示最终的活动调试配置。

debug configuration in the Status Bar

你可以在调试启动配置中了解有关 VS Code 如何启动应用程序的详细信息。再次按 F5 以启动调试器。

Run Spring Boot

通过使用 Web 浏览器浏览到 https://127.0.0.1:8080 来测试 Web 应用程序。你应该看到以下消息：“Greetings from Spring Boot!”。

Greeting from Spring

进行更改

现在，让我们编辑 HelloController.java，将“Greetings from Spring Boot!”更改为其他内容，例如“Hello World”。VS Code 为 Java 提供了出色的编辑体验，请查看导航和编辑 Java，了解有关 VS Code 的编辑和代码导航功能的更多信息。

单击编辑器顶部的重新启动按钮以重新启动应用程序，并通过重新加载浏览器查看结果。

Restart Application

调试应用程序

在应用程序源代码中设置断点（F9），然后重新加载浏览器以命中该断点。

Debug Application

如果你想了解更多关于使用 VS Code 调试 Java 的信息，可以阅读Java 调试。

恭喜，你的第一个 Spring Boot Web 应用程序已在本地运行！继续阅读，了解如何将其托管在云端。

将 Web 应用程序部署到云端

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

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

创建你的免费 Azure 帐户

安装 Azure 应用服务扩展

Azure 应用服务扩展用于创建、管理和部署到 Azure 应用服务，其主要功能包括

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

要安装 Azure 应用服务扩展，请打开“扩展”视图（⇧⌘X (Windows, Linux Ctrl+Shift+X)）并搜索 azure app service 以筛选结果。选择 Microsoft Azure 应用服务扩展。为了获得更以命令行 Maven 为中心的体验，你还可以查看适用于 Azure 应用服务 Linux 的 Maven 插件教程。

登录到你的 Azure 订阅

要登录到 Azure，请从命令面板（⇧⌘P (Windows, Linux Ctrl+Shift+P)）运行 Azure: 登录。或者，你可以通过单击资源资源管理器中的登录到 Azure...来登录到你的 Azure 帐户。

Azure sign in code

在 Azure 上创建新的 Web 应用程序

安装扩展后，你可以执行以下步骤在 Azure 上创建新的 Web 应用程序。

  1. 单击资源资源管理器视图上的创建按钮，然后选择创建应用服务 Web 应用...。

  2. 输入新 Web 应用程序的唯一名称。

  3. 选择 Web 应用程序的运行时任务，例如 Java 17。

  4. 选择 Java Web 服务器堆栈，例如 Java SE。

  5. 选择一个定价层。

Create a Web App

构建并部署到 Web 应用程序

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

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

mvn clean package

构建项目后，在 VS Code 资源管理器中打开 target 目录。右键单击该构件，选择部署到 Web 应用，然后按照提示选择用于部署的 Web 应用。

Deploy to Web App

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

Greeting from Spring Boot

注意：有关应用服务更高级的功能，你可以查看 Azure 应用服务 扩展。

连接数据服务

Azure Cosmos DB 是一种全球分布式数据库服务，允许开发人员使用各种标准 API（例如 SQL、MongoDB、Cassandra、Graph 和 Table）处理数据。

Spring Boot Starter 使你可以轻松地将数据存储到 Azure Cosmos DB for NoSQL 数据库中并从中检索数据。

在 Azure 上创建一个 Azure Cosmos DB 实体

  1. 转到 Azure 门户，然后单击“+”来创建资源。
  2. 单击数据库，然后单击 Azure Cosmos DB 以创建你的数据库。
  3. 选择 SQL (Document DB) API 并输入你数据库的其他信息。
  4. 导航到你创建的数据库，单击密钥，然后复制你数据库的 URI 和 主密钥。

配置你的项目

  1. 你可以从 Spring Data Azure Cosmos DB 示例项目 开始。

  2. 导航到 src/main/resources 并打开 application.properties。将 application.properties 中的以下属性替换为你数据库的信息。

    azure.documentdb.uri=your-documentdb-uri
azure.documentdb.key=your-documentdb-key
azure.documentdb.database=your-documentdb-databasename

运行并调试应用程序

你可以按 F5 运行你的应用程序。要检查结果，请打开 Azure 门户 并访问你的 Azure Cosmos DB 实例。选择数据资源管理器，然后选择文档。如果数据已成功写入 Azure Cosmos DB，则会显示数据。你还可以使用 Azure 数据库扩展在 Azure Cosmos DB 中浏览你的数据条目。

在源代码中设置断点后 (F9)，刷新你的浏览器以命中断点。有关调试的详细信息，请参阅 Java 调试

或者，你也可以使用 Maven 打包和运行你的项目，步骤如下

  1. 导航到 azure-spring-boot 目录并运行命令。

    mvn install

  2. 导航到 azure-documentdb-spring-boot-sample 目录并运行命令。

    mvn package
java -jar target/azure-documentdb-spring-boot-sample-0.0.1-SNAPSHOT.jar

后续步骤

3/2/2023