Add ability to provide arguments to the JVM when using executable Java apps (#888)

Author: marshalhayes

src/CommunityToolkit.Aspire.Hosting.Java/JavaAppExecutableResourceOptions.cs

@@ -24,4 +24,9 @@ public class JavaAppExecutableResourceOptions
     /// Gets or sets the arguments to pass to the Java application.
     /// </summary>
     public string[]? Args { get; set; } = null;
+
+    /// <summary>
+    /// Gets or sets the arguments to pass to the Java Virtual Machine.
+    /// </summary>
+    public string[]? JvmArgs { get; set; } = null;
 }

src/CommunityToolkit.Aspire.Hosting.Java/JavaAppHostingExtension.Executable.cs

@@ -35,6 +35,9 @@ public static IResourceBuilder<JavaAppExecutableResource> AddJavaApp(this IDistr
             : ["-jar", options.ApplicationName];
 #pragma warning restore CS8601 // Possible null reference assignment.
 
+        if (options.JvmArgs is { Length: > 0 })
+            allArgs = [.. options.JvmArgs, .. allArgs];
+
         workingDirectory = PathNormalizer.NormalizePathForCurrentPlatform(Path.Combine(builder.AppHostDirectory, workingDirectory));
         var resource = new JavaAppExecutableResource(name, "java", workingDirectory);
 

tests/CommunityToolkit.Aspire.Hosting.Java.Tests/ExecutableResourceCreationTests.cs

@@ -77,6 +77,7 @@ public async Task AddJavaAppContainerDetailsSetOnResource()
         {
             ApplicationName = "test.jar",
             Args = ["--test"],
+            JvmArgs = ["-Dtest"],
             OtelAgentPath = "otel-agent",
             Port = 8080
         };
@@ -101,9 +102,8 @@ public async Task AddJavaAppContainerDetailsSetOnResource()
         Assert.True(resource.TryGetLastAnnotation(out CommandLineArgsCallbackAnnotation? argsAnnotations));
         CommandLineArgsCallbackContext context = new([]);
         await argsAnnotations.Callback(context);
-        Assert.All(options.Args, arg => Assert.Contains(arg, context.Args));
-        Assert.Contains("-jar", context.Args);
-        Assert.Contains(options.ApplicationName, context.Args);
+
+        Assert.Equal([..options.JvmArgs, "-jar", options.ApplicationName, ..options.Args], context.Args);
     }
 
     [Fact]