在 OCI 代码编辑器中使用 Oracle GraalVM

本指南介绍了如何在 Oracle 云基础设施 (OCI) 代码编辑器中开始使用 Oracle GraalVM。

OCI 代码编辑器提供丰富、基于控制台的编辑环境，使您无需在 Oracle 云控制台和本地开发环境之间切换即可编辑代码。代码编辑器支持您直接从 OCI 控制台编辑和部署 OCI 服务的代码。

适用于 JDK 17 的 Oracle GraalVM 已预安装在 Cloud Shell 中，因此您无需安装和配置开发计算机。代码编辑器与 Cloud Shell 的集成使您可以直接访问它。

注意：Oracle GraalVM 许可和支持已包含在 Oracle 云基础设施订阅中，无需额外费用。

在 OCI 代码编辑器中创建和运行 Java 应用程序

步骤 1：在代码编辑器中打开终端

  1. 登录 Oracle 云控制台并启动代码编辑器.
  2. 在代码编辑器中打开终端，方法是点击**终端**菜单中的**新建终端**。

步骤 2：选择 GraalVM JDK 作为默认 JDK

  1. 使用 csruntimectl java list 命令列出已安装的 JDK。
     csruntimectl java list

    输出列出了 Cloud Shell 中预安装的 JDK：适用于 JDK 17 的 Oracle GraalVM、Oracle JDK 11 和 Oracle JDK 8。标有星号的 JDK 是当前 JDK。

  2. 选择适用于 JDK 17 的 Oracle GraalVM 作为当前 JDK
     csruntimectl java set graalvmjdk-17

    您将看到以下确认消息：“The current managed java version is set to graalvmjdk-17”。

  3. 现在确认环境变量 PATH 和 JAVA_HOME 的值，以及 java 和 native-image 工具的版本
     echo $JAVA_HOME

     echo $PATH

     java -version

     native-image --version

步骤 3：设置 Java 项目并运行

  1. 克隆一个演示仓库并在 OCI 代码编辑器中打开。为此，请逐一运行以下命令
     git init graalvmee-java-hello-world

     cd graalvmee-java-hello-world

     git remote add origin https://github.com/oracle-devrel/oci-code-editor-samples.git

     git config core.sparsecheckout true

     echo "java-samples/graalvmee-java-hello-world/*">>.git/info/sparse-checkout

     git pull --depth=1 origin main

     cd java-samples/graalvmee-java-hello-world/

    您现在可以在代码编辑器中查看/编辑示例代码。

  2. 将示例应用程序打包为可运行的 JAR 文件
     mvn clean package
  3. 运行 JAR 文件
     java -jar target/my-app-1.0-SNAPSHOT.jar

    它将输出“Hello World!”。

步骤 4：构建并运行本机可执行文件

此 Java 应用程序集成了GraalVM Native Image 的 Maven 插件，该插件支持使用 Apache Maven 构建本机可执行文件。为进行测试，请先启用快速构建模式，然后再禁用该模式来构建本机可执行文件。

快速构建模式已启用

  1. 要启用快速构建模式，请取消注释 pom.xml 中的此行，如下所示
     <quickBuild>true</quickBuild>
  2. 使用 native Maven 配置文件构建本机可执行文件
     mvn clean -Pnative -DskipTests package

    这将在 target 目录中为 Linux 生成一个名为 my-app 的本机可执行文件。

  3. 在后台运行应用程序本机可执行文件
     ./target/my-app

快速构建模式已禁用

  1. 要禁用快速构建模式，请注释掉 pom.xml 中的此行，如下所示
     <!-- <quickBuild>true</quickBuild> -->
  2. 再次构建本机可执行文件
     mvn clean -Pnative -DskipTests package

    这将在 target 目录中生成一个本机可执行文件 my-app，替换上一个文件。您可能已经注意到，快速构建模式减少了生成本机可执行文件所需的时间，从而使在典型开发周期（编译、测试和调试）中使用 Native Image 变得更容易。但是，生成的可执行文件大小更大，峰值性能更差。快速构建模式仅建议用于开发目的。

  3. 运行本机可执行文件：
     ./target/my-app

恭喜！您已成功地在 OCI 代码编辑器中使用 Oracle GraalVM 构建并运行了本机可执行文件，而无需在 Oracle 云控制台和本地开发环境之间切换。代码编辑器允许您直接从 OCI 控制台完成快速编码任务和运行应用程序。