Add Java hosting integration

Aspire-Core.slnf

@@ -29,6 +29,7 @@
       "src\\Aspire.Hosting.EntityFrameworkCore\\Aspire.Hosting.EntityFrameworkCore.csproj",
       "src\\Aspire.Hosting.Go\\Aspire.Hosting.Go.csproj",
       "src\\Aspire.Hosting.Integration.Analyzers\\Aspire.Hosting.Integration.Analyzers.csproj",
+      "src\\Aspire.Hosting.Java\\Aspire.Hosting.Java.csproj",
       "src\\Aspire.Hosting.JavaScript\\Aspire.Hosting.JavaScript.csproj",
       "src\\Aspire.Hosting.PostgreSQL\\Aspire.Hosting.PostgreSQL.csproj",
       "src\\Aspire.Hosting.Python\\Aspire.Hosting.Python.csproj",
@@ -57,6 +58,7 @@
       "tests\\Aspire.Hosting.Analyzers.Tests\\Aspire.Hosting.Analyzers.Tests.csproj",
       "tests\\Aspire.Hosting.Containers.Tests\\Aspire.Hosting.Containers.Tests.csproj",
       "tests\\Aspire.Hosting.EntityFrameworkCore.Tests\\Aspire.Hosting.EntityFrameworkCore.Tests.csproj",
+      "tests\\Aspire.Hosting.Java.Tests\\Aspire.Hosting.Java.Tests.csproj",
       "tests\\Aspire.Hosting.Rust.Tests\\Aspire.Hosting.Rust.Tests.csproj",
       "tests\\Aspire.Hosting.Testing.Tests\\Aspire.Hosting.Testing.Tests.csproj",
       "tests\\Aspire.Hosting.Tests\\Aspire.Hosting.Tests.csproj",

Aspire.slnx

@@ -59,6 +59,7 @@
     <Project Path="src/Aspire.Hosting.GitHub.Models/Aspire.Hosting.GitHub.Models.csproj" />
     <Project Path="src/Aspire.Hosting.Go/Aspire.Hosting.Go.csproj" />
     <Project Path="src/Aspire.Hosting.Integration.Analyzers/Aspire.Hosting.Integration.Analyzers.csproj" />
+    <Project Path="src/Aspire.Hosting.Java/Aspire.Hosting.Java.csproj" />
     <Project Path="src/Aspire.Hosting.JavaScript/Aspire.Hosting.JavaScript.csproj" />
     <Project Path="src/Aspire.Hosting.Kafka/Aspire.Hosting.Kafka.csproj" />
     <Project Path="src/Aspire.Hosting.Keycloak/Aspire.Hosting.Keycloak.csproj" />
@@ -368,6 +369,9 @@
     <Project Path="playground/Redis/Redis.ApiService/Redis.ApiService.csproj" />
     <Project Path="playground/Redis/Redis.AppHost/Redis.AppHost.csproj" />
   </Folder>
+  <Folder Name="/playground/JavaSpringBoot/">
+    <Project Path="playground/JavaSpringBoot/JavaSpringBoot.AppHost/JavaSpringBoot.AppHost.csproj" />
+  </Folder>
   <Folder Name="/playground/rust/">
     <Project Path="playground/rust/Rust.AppHost/Rust.AppHost.csproj" />
   </Folder>
@@ -538,6 +542,7 @@
     <Project Path="tests/Aspire.Hosting.Garnet.Tests/Aspire.Hosting.Garnet.Tests.csproj" />
     <Project Path="tests/Aspire.Hosting.GitHub.Models.Tests/Aspire.Hosting.GitHub.Models.Tests.csproj" />
     <Project Path="tests/Aspire.Hosting.Go.Tests/Aspire.Hosting.Go.Tests.csproj" />
+    <Project Path="tests/Aspire.Hosting.Java.Tests/Aspire.Hosting.Java.Tests.csproj" />
     <Project Path="tests/Aspire.Hosting.JavaScript.Tests/Aspire.Hosting.JavaScript.Tests.csproj" />
     <Project Path="tests/Aspire.Hosting.Kafka.Tests/Aspire.Hosting.Kafka.Tests.csproj" />
     <Project Path="tests/Aspire.Hosting.Keycloak.Tests/Aspire.Hosting.Keycloak.Tests.csproj" />

eng/github-ci/test-trigger-map.yml

@@ -343,6 +343,7 @@ affected_project_rules:
       - Aspire.AppHost.Sdk
       - Aspire.Hosting.CodeGeneration.*
       - Aspire.Hosting.Go
+      - Aspire.Hosting.Java
       - Aspire.Hosting.JavaScript
       - Aspire.Hosting.Python
       - Aspire.Hosting.Rust

extension/package.nls.json

@@ -302,6 +302,8 @@
   "aspire-vscode.strings.rustLaunchConfigurationMissingExecutable": "The Aspire app host did not report which executable the Rust app in {0} produces, so there is nothing to debug.",
   "aspire-vscode.strings.rustWindowsGnuDebuggerUnsupported": "The cppvsdbg debugger cannot debug Rust target {0} because GNU Windows targets use DWARF symbols. Install CodeLLDB or build an MSVC Rust target such as x86_64-pc-windows-msvc.",
   "aspire-vscode.strings.rustDebuggerExtensionNotInstalled": "Rust AppHosts are launched through a native debugger extension. Install {0} from the Extensions view, then start the AppHost again.",
+  "aspire-vscode.strings.javaDisplayName": "Java: {0}",
+  "aspire-vscode.strings.javaLabel": "Java",
   "aspire-vscode.strings.appHostLifecycleStartConfirmationTitle": "Start Aspire AppHost",
   "aspire-vscode.strings.appHostLifecycleStopConfirmationTitle": "Stop Aspire AppHost",
   "aspire-vscode.strings.appHostLifecycleStartConfirmationMessage": "Start the Aspire AppHost {0} in {1} mode?",

extension/src/capabilities.ts

@@ -24,6 +24,8 @@ export type Capability =
     | 'browser' // Support for browser debugging (built-in to VS Code via js-debug)
     | 'maui' // Support for running .NET MAUI projects
     | 'ms-dotnettools.dotnet-maui' // MAUI debug adapter extension identifier
+    | 'java' // Support for running Java projects
+    | 'vscjava.vscode-java-debug' // Java debug adapter extension identifier
     | 'azure-functions'; // Support for running Azure Functions projects
 
 export type Capabilities = Capability[];
@@ -88,6 +90,19 @@ export function isBunInstalled() {
     return isExtensionInstalled("oven.bun-vscode");
 }
 
+// The Java debug adapter cannot launch anything on its own: it resolves main classes, the
+// classpath and project metadata through the redhat.java language server, which is why
+// vscjava.vscode-java-debug declares redhat.java as an extension dependency and both ship together
+// in the "Extension Pack for Java". java.ts also calls the redhat.java API directly to refresh the
+// project configuration, so advertise Java support only when both are present.
+// https://github.com/microsoft/vscode-java-debug#requirements
+export const javaLanguageExtensionId = 'redhat.java';
+export const javaDebugExtensionId = 'vscjava.vscode-java-debug';
+
+export function isJavaInstalled(extensionInstalled: (extensionId: string) => boolean = isExtensionInstalled) {
+    return extensionInstalled(javaLanguageExtensionId) && extensionInstalled(javaDebugExtensionId);
+}
+
 export function getSupportedCapabilities(platform: NodeJS.Platform = process.platform): Capabilities {
     const capabilities: Capabilities = ['prompting', 'baseline.v1', 'secret-prompts.v1', 'file-pickers.v1', 'build-dotnet-using-cli'];
 
@@ -138,6 +153,11 @@ export function getSupportedCapabilities(platform: NodeJS.Platform = process.pla
         capabilities.push("ms-dotnettools.dotnet-maui");
     }
 
+    if (isJavaInstalled()) {
+        capabilities.push("java");
+        capabilities.push(javaDebugExtensionId);
+    }
+
     return capabilities;
 }
 

extension/src/dcp/types.ts

@@ -134,6 +134,28 @@ export function isMauiLaunchConfiguration(obj: any): obj is MauiLaunchConfigurat
     return obj && obj.type === 'maui';
 }
 
+export interface JavaLaunchConfiguration extends ExecutableLaunchConfiguration {
+    type: "java";
+    request?: "launch" | "attach";
+    working_directory?: string;
+    // A fully qualified class name, optionally prefixed with a Java module name
+    // ("[module/]com.example.Api"), or the path of the .java source file declaring main. Absent when
+    // the IDE should resolve the entry point from the project's build files. A JAR path is never
+    // valid here; an executable JAR is sent on class_paths with its manifest Main-Class here.
+    // See src/Aspire.Hosting.Java/JavaLaunchConfiguration.cs.
+    main_class?: string;
+    // Classpath entries to launch the JVM with, used when the resource runs a prebuilt JAR. Absent
+    // when the IDE should resolve the classpath from the project itself.
+    class_paths?: string[];
+    // "maven" or "gradle", or absent when the resource runs a prebuilt JAR and therefore has no
+    // build files whose classpath the Java language server could refresh.
+    build_tool?: string;
+}
+
+export function isJavaLaunchConfiguration(obj: any): obj is JavaLaunchConfiguration {
+    return obj && obj.type === 'java';
+}
+
 export interface EnvVar {
     name: string;
     value: string;

extension/src/debugger/debuggerExtensions.ts

@@ -4,14 +4,15 @@ import { debugProject, runProject } from "../loc/strings";
 import { getEnvironmentWithoutE2EBridgeVariables, mergeEnvs } from "../utils/environment";
 import { extensionLogOutputChannel } from "../utils/logging";
 import { projectDebuggerExtension } from "./languages/dotnet";
-import { isAzureFunctionsExtensionInstalled, isBunInstalled, isCsharpInstalled, isGoInstalled, isMauiInstalled, isPythonInstalled, isRustInstalled } from '../capabilities';
+import { isAzureFunctionsExtensionInstalled, isBunInstalled, isCsharpInstalled, isGoInstalled, isJavaInstalled, isMauiInstalled, isPythonInstalled, isRustInstalled } from '../capabilities';
 import { pythonDebuggerExtension } from "./languages/python";
 import { nodeDebuggerExtension } from "./languages/node";
 import { browserDebuggerExtension } from "./languages/browser";
 import { azureFunctionsDebuggerExtension } from "./languages/azureFunctions";
 import { goDebuggerExtension } from "./languages/go";
 import { createDefaultRustDebuggerExtension } from "./languages/rust";
 import { bunDebuggerExtension } from "./languages/bun";
+import { javaDebuggerExtension } from "./languages/java";
 import { mauiDebuggerExtension } from "./languages/maui";
 import { isDirectory } from "../utils/io";
 import { waitForRunStartIdle } from "./runStartRegistry";
@@ -114,6 +115,10 @@ export function getResourceDebuggerExtensions(platform: NodeJS.Platform = proces
         extensions.push(createDefaultRustDebuggerExtension(platform));
     }
 
+    if (isJavaInstalled()) {
+        extensions.push(javaDebuggerExtension);
+    }
+
     extensions.push(nodeDebuggerExtension);
     extensions.push(browserDebuggerExtension);