Runtime.getRuntime: примеры (JAVA)

Короткие примеры использования

Примеры демонстрируют самые распространённые сценарии: получение памяти, запуск процесса и регистрация shutdown hook.

1) Получение информации о памяти:

public class MemInfo {
    public static void main(String[] args) {
        Runtime rt = Runtime.getRuntime();
        System.out.println("availableProcessors: " + rt.availableProcessors());
        System.out.println("freeMemory: " + rt.freeMemory());
        System.out.println("totalMemory: " + rt.totalMemory());
        System.out.println("maxMemory: " + rt.maxMemory());
    }
}

availableProcessors: 8
freeMemory: 12345678
totalMemory: 67108864
maxMemory: 123456789

2) Запуск внешней команды (простая команда, вывод читается):

import java.io.*;

public class ExecSample {
    public static void main(String[] args) throws Exception {
        Runtime rt = Runtime.getRuntime();
        Process p = rt.exec(new String[]{"echo", "hello"});
        try (BufferedReader r = new BufferedReader(new InputStreamReader(p.getInputStream()))) {
            System.out.println(r.readLine());
        }
    }
}

hello

3) Регистрация shutdown hook:

public class HookDemo {
    public static void main(String[] args) {
        Runtime rt = Runtime.getRuntime();
        Thread hook = new Thread(() -> System.out.println("Завершение JVM"));
        rt.addShutdownHook(hook);
        System.out.println("Программа работает");
    }
}

Программа работает
Завершение JVM

Похожая функциональность в Java

Для управления процессами и получения расширённой информации существуют альтернативы внутри Java:

• ProcessBuilder - более гибкий API для запуска внешних процессов: позволяет задавать окружение, рабочую директорию, перенаправлять потоки. Предпочтительнее при сложной настройке процесса.
• java.lang.management.ManagementFactory и RuntimeMXBean / MemoryMXBean - для детальной информации о JVM, использовании памяти и статистике; лучше использовать для мониторинга и диагностики.
• ProcessHandle (Java 9+) - для управления и наблюдения за процессами (PID, завершение, дочерние процессы). Подходит для асинхронного контроля процессов.

Выбор между Runtime.exec, ProcessBuilder и ProcessHandle зависит от требований к конфигурации процесса, обработке входа/выхода и мониторингу.

Аналоги в других языках

Краткое сравнение альтернатив реализации запуска процессов и работы с окружением в популярных языках.

• PHP: exec(), shell_exec(), proc_open(). proc_open даёт детальный контроль над потоками, похож на ProcessBuilder.

  // PHP
  $output = shell_exec('echo hello');
  echo $output;

  hello
  

• JavaScript (Node.js): модуль child_process, методы exec, spawn, execFile. spawn предпочтителен для потоковых данных.

  // Node.js
  const { exec } = require('child_process');
  exec('echo hello', (err, stdout) => console.log(stdout));

  hello
  

• Python: модуль subprocess, функции run, Popen. subprocess.run прост, Popen даёт контроль над потоками.

  # Python
  import subprocess
  print(subprocess.run(['echo', 'hello'], capture_output=True, text=True).stdout)

  hello
  

• C# (.NET): System.Diagnostics.Process для запуска и настройки процессов. Предоставляет свойства для перенаправления ввода/вывода и управления жизненным циклом.

  // C#
  using System.Diagnostics;
  var p = Process.Start(new ProcessStartInfo("cmd", "/c echo hello") { RedirectStandardOutput = true });
  Console.WriteLine(p.StandardOutput.ReadLine());

  hello
  

• Go: пакет os/exec, функция Command и методы Run, Output. Предпочтителен для многопоточных задач и стриминга.

  // Go
  package main
  import (
      "fmt"
      "os/exec"
  )
  func main() {
      out, _ := exec.Command("echo", "hello").Output()
      fmt.Println(string(out))
  }

  hello
  

• Kotlin: использует JVM, те же API Runtime и ProcessBuilder. Синтаксис компактнее, поведение идентично Java.

  // Kotlin
  fun main() {
    val p = Runtime.getRuntime().exec(arrayOf("echo", "hello"))
    println(p.inputStream.bufferedReader().readText())
  }

  hello
  

• Lua: функция os.execute, ограниченная по управлению потоками; для расширенного управления требуется FFI или библиотеки.

  -- Lua
  os.execute('echo hello')

  hello
  

• SQL: запуск системных команд напрямую не предусмотрен стандартом SQL; возможен через расширения СУБД или хранимые процедуры.

Отличия от Java: в языках с нативными средствами процессов (Go, Node.js, Python) управление потоками и асинхронность часто удобнее; в JVM-языках (Kotlin) применяется та же модель, что и в Java.

Типичные ошибки и примеры

Ниже перечислены часто встречающиеся ошибки при использовании Runtime и способы проявления.

1) IOException при запуске команды (команда не найдена или недостаточно прав):

public class BadExec {
    public static void main(String[] args) throws Exception {
        Runtime.getRuntime().exec("nonexistent_command");
    }
}

Exception in thread "main" java.io.IOException: Cannot run program "nonexistent_command": error=2, No such file or directory
	at java.base/java.lang.ProcessBuilder.start(ProcessBuilder.java:1128)
	... (stacktrace)

2) Блокировка из-за непрочитанных потоков вывода/ошибок процесса. Пример проблемы и симптомов:

// Запуск команды, которая пишет много в stdout, но поток не читается
Process p = Runtime.getRuntime().exec(new String[]{"some-command-producing-large-output"});
int exit = p.waitFor(); // программа может зависнуть

(программа зависает из-за заполнения буфера STDOUT)

3) SecurityException при отсутствии нужных прав в среде с SecurityManager:

// В среде с ограниченным SecurityManager
Runtime.getRuntime().exec("somecmd");

Exception in thread "main" java.lang.SecurityException: access denied ("java.lang.RuntimePermission" "exec")

4) UnsatisfiedLinkError при загрузке нативной библиотеки не с тем именем или без нужного пути:

System.loadLibrary("missingLib");

Exception in thread "main" java.lang.UnsatisfiedLinkError: no missingLib in java.library.path

Рекомендации по избеганию ошибок: обрабатывать исключения, читать stdout и stderr процессов в отдельных потоках, предпочитать ProcessBuilder для сложных сценариев.

Изменения в последних версиях

API Runtime.getRuntime() как таковой оставался стабильным в большинстве версий Java. Основные заметные эволюции вокруг работы с процессами и мониторинга JVM:

• Java 5 и выше: ProcessBuilder стал предпочтительным для гибкого управления процессами.
• Java 9: введён ProcessHandle для управления процессами и получения PID/информации о процессе, что дополняет функциональность Runtime.exec.
• Java 9+: модульная система (JPMS) повлияла на доступ к некоторым внутренним API; использование нативных библиотек и доступ к внутренним классам стало требовать явных модульных деклараций.
• Java 17: SecurityManager помечен на удаление в будущих релизах, что влияет на схемы контроля прав в управляемых средах.

В целом рекомендуется использовать современные API (ProcessBuilder, ProcessHandle, классы из java.lang.management) для расширенных сценариев; сам Runtime продолжает работать и не имеет существенных изменений.

Расширенные и редкие сценарии

Ниже представлены подробные примеры с пояснениями: обработка потоков процесса, запуск с окружением и рабочей директорией, получение PID JVM, использование halt и graceful shutdown.

1) Правильная обработка stdout и stderr, чтобы избежать блокировок:

import java.io.*;

public class ExecWithStreams {
    public static void main(String[] args) throws Exception {
        Process p = Runtime.getRuntime().exec(new String[]{"bash", "-c", "for i in {1..1000}; do echo line$i; done"});

        Thread outReader = new Thread(() -> {
            try (BufferedReader r = new BufferedReader(new InputStreamReader(p.getInputStream()))) {
                r.lines().forEach(System.out::println);
            } catch (IOException e) { e.printStackTrace(); }
        });
        outReader.start();

        Thread errReader = new Thread(() -> {
            try (BufferedReader r = new BufferedReader(new InputStreamReader(p.getErrorStream()))) {
                r.lines().forEach(System.err::println);
            } catch (IOException e) { e.printStackTrace(); }
        });
        errReader.start();

        int exit = p.waitFor();
        outReader.join();
        errReader.join();
        System.out.println("Exit: " + exit);
    }
}

line1
line2
...
line1000
Exit: 0

Комментарий: чтение потоков в отдельных потоках предотвращает блокировку процесса при переполнении внутреннего буфера.

2) Запуск с окружением и рабочей директорией:

import java.io.*;

public class ExecEnvDir {
    public static void main(String[] args) throws Exception {
        String[] envp = {"MYVAR=123"};
        File dir = new File("/tmp");
        Process p = Runtime.getRuntime().exec(new String[]{"bash", "-c", "echo $MYVAR; pwd"}, envp, dir);
        try (BufferedReader r = new BufferedReader(new InputStreamReader(p.getInputStream()))) {
            r.lines().forEach(System.out::println);
        }
    }
}

123
/tmp

Комментарий: при необходимости сложной конфигурации окружения и перенаправления проще использовать ProcessBuilder.directory и processBuilder.environment().

3) Получение PID текущего JVM процесса (через RuntimeMXBean):

import java.lang.management.ManagementFactory;

public class GetPid {
    public static void main(String[] args) {
        String name = ManagementFactory.getRuntimeMXBean().getName();
        // формат обычно: pid@hostname
        String pid = name.split("@")[0];
        System.out.println("PID: " + pid);
    }
}

PID: 12345

Комментарий: не существует стандартного метода в Runtime для получения PID, но RuntimeMXBean даёт удобный обходной путь; в Java 9+ можно использовать ProcessHandle.current().pid().

4) Использование addShutdownHook для корректного завершения ресурсов и отправки сигналов внешним процессам:

import java.io.*;

public class Graceful {
    public static void main(String[] args) throws Exception {
        Runtime rt = Runtime.getRuntime();
        Process p = rt.exec(new String[]{"sleep", "60"});

        rt.addShutdownHook(new Thread(() -> {
            System.out.println("Shutdown hook: destroy process");
            p.destroy();
        }));

        System.out.println("Sleeping. Send SIGINT or terminate the JVM to see hook.");
        Thread.sleep(60000);
    }
}

Sleeping. Send SIGINT or terminate the JVM to see hook.
(при завершении JVM)
Shutdown hook: destroy process

Комментарий: shutdown hook не выполняется при вызове halt или при принудительном завершении ОС.

5) Принудительное завершение процесса без выполнения корректировок: Runtime.getRuntime().halt(status)

public class HaltDemo {
    public static void main(String[] args) {
        Runtime.getRuntime().addShutdownHook(new Thread(() -> System.out.println("Hook")));
        System.out.println("Before halt");
        Runtime.getRuntime().halt(1);
        System.out.println("After halt (не будет выполнено)");
    }
}

Before halt
(программа аварийно завершается, hook не выполняется)

Комментарий: halt завершает JVM немедленно, минуя финализаторы и shutdown hooks; применяется в крайних случаях.

6) Измерение и симуляция памяти в тестах (осмотр значений free/total/max):

public class MemPressure {
    public static void main(String[] args) {
        Runtime rt = Runtime.getRuntime();
        System.out.println("free: " + rt.freeMemory());
        byte[] arr = new byte[50_000_000]; // потребление памяти
        System.out.println("free after alloc: " + rt.freeMemory());
        arr = null;
        rt.gc();
        System.out.println("free after gc: " + rt.freeMemory());
    }
}

free: 20000000
free after alloc: 1000000
free after gc: 15000000