Merge pull request #215 from javaevolved/copilot/runtime-exec-to-process-builder

Add tooling pattern: Runtime.exec(String) to ProcessBuilder arguments

Author: brunoborges

content/language/anonymous-classes-to-lambdas.yaml

@@ -33,7 +33,7 @@ whyModernWins:
 support:
   state: "available"
   description: "Available since JDK 8 (March 2014)."
-prev: "tooling/junit6-with-jspecify"
+prev: "tooling/runtime-exec-to-process-builder"
 next: "language/default-interface-methods"
 related:
 - "language/default-interface-methods"

content/tooling/junit6-with-jspecify.yaml

@@ -88,7 +88,7 @@ support:
   state: "available"
   description: "Available since JUnit 6.0 (October 2025, requires Java 17+)"
 prev: "tooling/aot-class-preloading"
-next: "language/anonymous-classes-to-lambdas"
+next: "tooling/runtime-exec-to-process-builder"
 related:
 - "enterprise/spring-null-safety-jspecify"
 - "errors/helpful-npe"

content/tooling/runtime-exec-to-process-builder.yaml

@@ -0,0 +1,52 @@
+---
+id: e27cf2f6-ae52-4d75-a481-0fd04dbf2999
+slug: "runtime-exec-to-process-builder"
+title: "Runtime.exec(String) to ProcessBuilder arguments"
+category: "tooling"
+difficulty: "intermediate"
+jdkVersion: "5"
+oldLabel: "Command string"
+modernLabel: "ProcessBuilder"
+oldApproach: "Runtime.exec(String)"
+modernApproach: "ProcessBuilder"
+oldCode: |-
+  Process process = Runtime.getRuntime()
+          .exec("git show " + revision);
+modernCode: |-
+  Process process = new ProcessBuilder(
+          "git", "show", revision)
+          .redirectErrorStream(true)
+          .start();
+summary: "Launch processes with an explicit argument list and ProcessBuilder configuration."
+explanation: "Runtime.exec(String) applies Java's command-string tokenization, which\
+  \ is easy to misunderstand when arguments contain spaces or quoting. ProcessBuilder\
+  \ accepts program arguments as distinct values and exposes the working directory,\
+  \ environment, input/output redirects, and error-stream policy explicitly. It does\
+  \ not invoke a shell unless the application deliberately launches one."
+whyModernWins:
+- icon: "🎯"
+  title: "Exact arguments"
+  desc: "Each process argument remains a distinct value without command-string tokenization."
+- icon: "🎛"
+  title: "Explicit configuration"
+  desc: "Environment, directory, redirects, and error handling are configured together."
+- icon: "🛡"
+  title: "Safer boundaries"
+  desc: "Avoids constructing a shell-like command string from dynamic values."
+support:
+  state: "available"
+  description: "Widely available since JDK 5 (September 2004)"
+prev: "tooling/junit6-with-jspecify"
+next: "language/anonymous-classes-to-lambdas"
+related:
+- "concurrency/process-api"
+- "io/inputstream-transferto"
+- "security/security-manager-migration"
+tags:
+- tooling
+- security
+docs:
+- title: "ProcessBuilder"
+  href: "https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/lang/ProcessBuilder.html"
+- title: "Runtime.exec(String)"
+  href: "https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/lang/Runtime.html#exec(java.lang.String)"

proof/tooling/RuntimeExecToProcessBuilder.java

@@ -0,0 +1,18 @@
+///usr/bin/env jbang "$0" "$@" ; exit $?
+//JAVA 25+
+
+/// Proof: runtime-exec-to-process-builder
+/// Source: content/tooling/runtime-exec-to-process-builder.yaml
+void main() throws Exception {
+    String revision = "HEAD";
+
+    Process process = new ProcessBuilder(
+            "git", "show", revision)
+            .redirectErrorStream(true)
+            .start();
+
+    try (var output = process.getInputStream()) {
+        output.transferTo(OutputStream.nullOutputStream());
+    }
+    IO.println("exit code: " + process.waitFor());
+}

social/queue.txt

@@ -126,3 +126,4 @@ tooling/stack-walker
 collections/map-compute-and-merge
 io/http-websocket-client
 security/security-manager-migration
+tooling/runtime-exec-to-process-builder

social/tweets.yaml

@@ -1277,4 +1277,14 @@ security/security-manager-migration: |-
 
   🔗 https://javaevolved.github.io/security/security-manager-migration.html
 
+  #Java #JavaEvolved
+tooling/runtime-exec-to-process-builder: |-
+  ☕ Runtime.exec(String) to ProcessBuilder arguments
+
+  Launch processes with an explicit argument list and ProcessBuilder configuration.
+
+  Runtime.exec(String) → ProcessBuilder (JDK 5+)
+
+  🔗 https://javaevolved.github.io/tooling/runtime-exec-to-process-builder.html
+
   #Java #JavaEvolved

translations/content/ar/tooling/runtime-exec-to-process-builder.yaml

@@ -0,0 +1,18 @@
+---
+title: "من Runtime.exec(String) إلى وسائط ProcessBuilder"
+oldApproach: "Runtime.exec(String)"
+modernApproach: "ProcessBuilder"
+summary: "شغّل العمليات بقائمة وسائط صريحة وبإعدادات ProcessBuilder."
+explanation: "تطبّق Runtime.exec(String) تقسيم سلسلة الأمر إلى رموز وفق قواعد جافا، وهو أمر يسهل إساءة فهمه عندما تحتوي الوسائط على مسافات أو علامات اقتباس. تقبل ProcessBuilder وسائط البرنامج كقيم منفصلة، وتُظهر بوضوح دليل العمل والبيئة وإعادة توجيه الإدخال والإخراج وسياسة تدفق الأخطاء. ولا تستدعي صدفة إلا إذا شغّلها التطبيق عمداً."
+whyModernWins:
+- icon: "🎯"
+  title: "وسائط دقيقة"
+  desc: "يبقى كل وسيط للعملية قيمة منفصلة دون تقسيم سلسلة الأمر إلى رموز."
+- icon: "🎛"
+  title: "إعداد صريح"
+  desc: "تُضبط البيئة والدليل وإعادة التوجيه ومعالجة الأخطاء معاً."
+- icon: "🛡"
+  title: "حدود أكثر أماناً"
+  desc: "يتجنّب بناء سلسلة أوامر شبيهة بالصدفة من قيم ديناميكية."
+support:
+  description: "متاح على نطاق واسع منذ JDK 5 (سبتمبر 2004)"

translations/content/bn/tooling/runtime-exec-to-process-builder.yaml

@@ -0,0 +1,18 @@
+---
+title: "Runtime.exec(String) থেকে ProcessBuilder আর্গুমেন্টে"
+oldApproach: "Runtime.exec(String)"
+modernApproach: "ProcessBuilder"
+summary: "স্পষ্ট আর্গুমেন্ট তালিকা ও ProcessBuilder কনফিগারেশন দিয়ে প্রসেস চালু করুন।"
+explanation: "Runtime.exec(String) জাভার কমান্ড-স্ট্রিং টোকেনাইজেশন প্রয়োগ করে, আর্গুমেন্টে স্পেস বা উদ্ধৃতি চিহ্ন থাকলে যা সহজেই ভুল বোঝা যায়। ProcessBuilder প্রোগ্রামের আর্গুমেন্টগুলোকে আলাদা মান হিসেবে নেয় এবং কার্যকরী ডিরেক্টরি, এনভায়রনমেন্ট, ইনপুট/আউটপুট রিডাইরেক্ট ও এরর-স্ট্রিম নীতি স্পষ্টভাবে প্রকাশ করে। অ্যাপ্লিকেশন ইচ্ছাকৃতভাবে শেল চালু না করলে এটি কোনো শেল ডাকে না।"
+whyModernWins:
+- icon: "🎯"
+  title: "নির্ভুল আর্গুমেন্ট"
+  desc: "কমান্ড-স্ট্রিং টোকেনাইজেশন ছাড়াই প্রতিটি প্রসেস আর্গুমেন্ট আলাদা মান হিসেবে থাকে।"
+- icon: "🎛"
+  title: "স্পষ্ট কনফিগারেশন"
+  desc: "এনভায়রনমেন্ট, ডিরেক্টরি, রিডাইরেক্ট ও এরর হ্যান্ডলিং একসঙ্গে কনফিগার করা যায়।"
+- icon: "🛡"
+  title: "নিরাপদ সীমানা"
+  desc: "ডায়নামিক মান দিয়ে শেল-সদৃশ কমান্ড স্ট্রিং তৈরি করা এড়ায়।"
+support:
+  description: JDK 5 (সেপ্টেম্বর 2004) থেকে ব্যাপকভাবে উপলব্ধ

translations/content/de/tooling/runtime-exec-to-process-builder.yaml

@@ -0,0 +1,18 @@
+---
+title: "Von Runtime.exec(String) zu ProcessBuilder-Argumenten"
+oldApproach: "Runtime.exec(String)"
+modernApproach: "ProcessBuilder"
+summary: "Starte Prozesse mit einer expliziten Argumentliste und ProcessBuilder-Konfiguration."
+explanation: "Runtime.exec(String) wendet die Tokenisierung von Java-Befehlszeichenketten an, die leicht missverstanden wird, wenn Argumente Leerzeichen oder Anführungszeichen enthalten. ProcessBuilder nimmt Programmargumente als eigenständige Werte entgegen und macht Arbeitsverzeichnis, Umgebung, Ein-/Ausgabeumleitungen sowie die Behandlung des Fehlerstroms explizit. Eine Shell wird nur gestartet, wenn die Anwendung dies ausdrücklich möchte."
+whyModernWins:
+- icon: "🎯"
+  title: "Exakte Argumente"
+  desc: "Jedes Prozessargument bleibt ein eigenständiger Wert ohne Tokenisierung der Befehlszeichenkette."
+- icon: "🎛"
+  title: "Explizite Konfiguration"
+  desc: "Umgebung, Verzeichnis, Umleitungen und Fehlerbehandlung werden gemeinsam konfiguriert."
+- icon: "🛡"
+  title: "Sicherere Grenzen"
+  desc: "Vermeidet den Aufbau einer shell-ähnlichen Befehlszeichenkette aus dynamischen Werten."
+support:
+  description: "Weitgehend verfügbar seit JDK 5 (September 2004)"

translations/content/es/tooling/runtime-exec-to-process-builder.yaml

@@ -0,0 +1,18 @@
+---
+title: "De Runtime.exec(String) a argumentos de ProcessBuilder"
+oldApproach: "Runtime.exec(String)"
+modernApproach: "ProcessBuilder"
+summary: "Lanza procesos con una lista de argumentos explícita y la configuración de ProcessBuilder."
+explanation: "Runtime.exec(String) aplica la tokenización de cadenas de comando de Java, que es fácil de malinterpretar cuando los argumentos contienen espacios o comillas. ProcessBuilder acepta los argumentos del programa como valores distintos y expone de forma explícita el directorio de trabajo, el entorno, las redirecciones de entrada/salida y la política del flujo de error. No invoca un shell salvo que la aplicación lo lance deliberadamente."
+whyModernWins:
+- icon: "🎯"
+  title: "Argumentos exactos"
+  desc: "Cada argumento del proceso sigue siendo un valor distinto sin tokenización de la cadena de comando."
+- icon: "🎛"
+  title: "Configuración explícita"
+  desc: "El entorno, el directorio, las redirecciones y el manejo de errores se configuran en conjunto."
+- icon: "🛡"
+  title: "Límites más seguros"
+  desc: "Evita construir una cadena de comando similar a un shell a partir de valores dinámicos."
+support:
+  description: "Ampliamente disponible desde JDK 5 (septiembre de 2004)"