Класс Runtime

public static Runtime getRuntime()

Возвращает объект runtime, связанный с текущим приложением Java. Большинство методов класса Runtime являются методами экземпляра и должны вызываться относительно текущего объекта runtime.

public void exit(int status)

Завершает выполнение текущей виртуальной машины Java, инициируя последовательность завершения работы. Этот метод никогда не возвращает результат. Аргумент используется в качестве кода состояния; по соглашению, ненулевой код состояния указывает на аномальное завершение.

Все зарегистрированные обработчики завершения работы, если таковые имеются, запускаются в некотором неопределённом порядке и могут выполняться параллельно до завершения. После этого виртуальная машина останавливается.

Если этот метод вызывается после того, как все обработчики завершения работы уже были выполнены, и статус ненулевой, то этот метод останавливает виртуальную машину с указанным кодом состояния. В противном случае этот метод блокируется неопределённое время.

Метод System.exit является стандартным и удобным способом вызова этого метода.

public void addShutdownHook(Thread hook)

Регистрирует новый обработчик завершения работы виртуальной машины.

Виртуальная машина Java завершает работу в ответ на два вида событий:

• Программа завершается нормально, когда завершается последний нить, не являющаяся демо-нитью, или когда вызывается метод exit (эквивалентно, System.exit), или
• Виртуальная машина останавливается в ответ на прерывание пользователя, такое как нажатие ^C, или системное событие, такое как выход пользователя или выключение системы.

Обработчик завершения работы — это просто инициализированная, но не запущенная нить. Когда виртуальная машина начинает последовательность завершения работы, она запустит все зарегистрированные обработчики завершения работы в некотором неопределённом порядке и позволит им выполняться параллельно. После завершения работы всех обработчиков она остановится. Обратите внимание, что демо-нити будут продолжать выполняться во время последовательности завершения работы, а также нити, не являющиеся демо-нитями, если завершение было инициировано вызовом метода exit.

После начала последовательности завершения работы её можно остановить только путём вызова метода halt, который насильственно завершает работу виртуальной машины.

После начала последовательности завершения работы невозможно зарегистрировать новый обработчик завершения работы или дезактивировать ранее зарегистрированный обработчик. Попытка выполнения любой из этих операций приведёт к возникновению исключения IllegalStateException.

Обработчики завершения работы работают в деликатное время жизненного цикла виртуальной машины и поэтому должны быть запрограммированы с учётом этого. В частности, они должны быть написаны так, чтобы быть потокобезопасными и избегать тупиковых ситуаций по мере возможности. Они также не должны слепо полагаться на службы, которые могут зарегистрировать собственные обработчики завершения работы и, следовательно, сами могут находиться в процессе завершения. Попытки использовать другие службы на основе потоков, такие как поток диспетчеризации событий AWT, например, могут привести к тупиковым ситуациям.

Обработчики завершения работы также должны быстро завершать свою работу. Когда программа вызывает exit, ожидается, что виртуальная машина быстро завершит работу и выйдет. Когда виртуальная машина завершается из-за выхода пользователя или выключения системы, базовая операционная система может позволить только ограниченное количество времени на завершение и выход. Поэтому не рекомендуется пытаться взаимодействовать с пользователем или выполнять длительные вычисления в обработчике завершения работы.

Необработанные исключения обрабатываются в обработчиках завершения работы так же, как и в любой другой нити, путём вызова метода uncaughtException объекта ThreadGroup нити. По умолчанию этот метод печатает трассировку стека исключения в System.err и завершает нить; это не приводит к выходу или остановке виртуальной машины.

В редких случаях виртуальная машина может прерваться, то есть остановиться, не завершив работу должным образом. Это происходит, когда виртуальная машина завершается внешне, например, с сигналом SIGKILL в Unix или вызовом TerminateProcess в Microsoft Windows. Виртуальная машина также может прерваться, если нативный метод работает неправильно, например, повреждая внутренние структуры данных или пытаясь получить доступ к несуществующей памяти. Если виртуальная машина прервётся, то нельзя гарантировать, будут ли запущены какие-либо обработчики завершения работы.

public boolean removeShutdownHook(Thread hook)

Дерегистрирует ранее зарегистрированный обработчик завершения работы виртуальной машины.

public void halt(int status)

Принудительно завершает работу текущей виртуальной машины Java. Этот метод никогда не возвращает результат.

Этот метод следует использовать с большой осторожностью. В отличие от метода exit, этот метод не заставляет запускаться обработчики завершения работы. Если последовательность завершения работы уже началась, то этот метод не ожидает завершения работы ни одного обработчика завершения работы.

public Process exec(String command) throws IOException

Выполняет указанную строковую команду в отдельном процессе.

Это удобный метод. Вызов вида exec(command) ведет себя точно так же, как вызов exec(command, null, null).

public Process exec(String command, String[] envp) throws IOException

Выполняет указанную строковую команду в отдельном процессе с указанной средой.

Это метод-удобство. Вызов вида exec(command, envp) ведет себя точно так же, как вызов exec(command, envp, null).

public Process exec(String command, String[] envp, File dir) throws IOException

Выполняет указанную строковую команду в отдельном процессе с указанной средой и рабочей директорией.

Это метод-удобство. Вызов вида exec(command, envp, dir) ведет себя точно так же, как вызов exec(cmdarray, envp, dir), где cmdarray - массив всех токенов в command.

Более точно, строка command разбивается на токены с помощью StringTokenizer, созданной вызовом new StringTokenizer(command) без дальнейшей модификации категорий символов. Токены, полученные токенизатором, затем помещаются в новый массив строк cmdarray, в том же порядке.

public Process exec(String[] cmdarray) throws IOException

Выполняет указанную команду и аргументы в отдельном процессе.

Это метод-удобство. Вызов вида exec(cmdarray) ведет себя точно так же, как вызов exec(cmdarray, null, null).

public Process exec(String[] cmdarray, String[] envp) throws IOException

Выполняет указанную команду и аргументы в отдельном процессе с указанной средой.

Это метод-удобство. Вызов вида exec(cmdarray, envp) ведет себя точно так же, как вызов exec(cmdarray, envp, null).

public Process exec(String[] cmdarray, String[] envp, File dir) throws IOException

Выполняет указанную команду и аргументы в отдельном процессе с указанной средой и рабочей директорией.

Учитывая массив строк cmdarray, представляющих токены командной строки, и массив строк envp, представляющих настройки переменных среды, этот метод создаёт новый процесс, в котором нужно выполнить указанную команду.

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

Если envp равно null, дочерний процесс наследует настройки среды текущего процесса.

Для запуска процесса на некоторых операционных системах может потребоваться минимальный набор системно-зависимых переменных среды. В результате дочерний процесс может унаследовать дополнительные настройки переменных среды, помимо указанных в среде.

ProcessBuilder.start() теперь является предпочтительным способом запуска процесса с изменённой средой.

Рабочая директория нового дочернего процесса задаётся dir. Если dir равно null, дочерний процесс наследует текущую рабочую директорию текущего процесса.

Если существует менеджер безопасности, его метод checkExec вызывается с первым компонентом массива cmdarray в качестве аргумента. Это может привести к выбрасыванию исключения SecurityException.

Запуск процесса операционной системы сильно зависит от системы. Среди многих возможных проблем:

• Файл программы операционной системы не найден.
• Доступ к файлу программы запрещён.
• Рабочая директория не существует.

В таких случаях будет выбрашено исключение. Точный характер исключения зависит от системы, но оно всегда будет подклассом IOException.

Если операционная система не поддерживает создание процессов, будет выбрашено исключение UnsupportedOperationException.

public int availableProcessors()

Возвращает количество процессоров, доступных для виртуальной машины Java.

Это значение может меняться во время конкретного вызова виртуальной машины. Приложения, чувствительные к количеству доступных процессоров, поэтому должны периодически опрашивать эту свойство и соответствующим образом настраивать использование ресурсов.

public long freeMemory()

Возвращает количество свободной памяти в виртуальной машине Java. Вызов метода gc может привести к увеличению значения, возвращаемого методом freeMemory.

public long totalMemory()

Возвращает общее количество памяти в виртуальной машине Java. Возвращаемое значение этого метода может изменяться со временем в зависимости от среды хоста.

Обратите внимание, что количество памяти, необходимое для хранения объекта любого заданного типа, может зависеть от реализации.

public long maxMemory()

Возвращает максимальное количество памяти, которое виртуальная машина Java попытается использовать. Если нет внутреннего ограничения, то будет возвращено значение Long.MAX_VALUE.

public void gc()

Выполняет сборщик мусора в виртуальной машине Java.

Вызов этого метода предполагает, что виртуальная машина Java потратит ресурсы на переработку неиспользуемых объектов, чтобы освободить память, которую они в настоящее время занимают, для повторного использования виртуальной машиной Java. При возврате управления из вызова метода виртуальная машина Java сделает всё возможное, чтобы освободить место от всех неиспользуемых объектов. Нет гарантии, что эти усилия приведут к переработке определённого количества неиспользуемых объектов, освобождению определённого количества памяти или завершению в определённое время, если вообще. Также нет гарантии, что эти усилия приведут к изменению доступности определённого количества объектов или что определённое количество объектов Reference будет очищено и помещено в очередь.

Имя gc означает "сборщик мусора". Виртуальная машина Java выполняет этот процесс переработки автоматически по мере необходимости в отдельном потоке, даже если метод gc не вызывается явно.

Метод System.gc() является общепринятым и удобным способом вызова этого метода.

public void runFinalization()

Выполняет методы finalization любых объектов, ожидающих finalization. Вызов этого метода предполагает, что виртуальная машина Java потратит ресурсы на выполнение методов finalize объектов, которые были обнаружены как удалённые, но чьи методы finalize ещё не были выполнены. При возврате управления из вызова метода виртуальная машина сделает всё возможное для завершения всех ожидающих finalization.

Виртуальная машина выполняет процесс finalization автоматически по мере необходимости в отдельном потоке, если метод runFinalization не вызывается явно.

Метод System.runFinalization() является общепринятым и удобным способом вызова этого метода.

public void load(String filename)

Загружает системную библиотеку, указанную аргументом filename. Аргумент filename должен быть абсолютным именем файла. (например Runtime.getRuntime().load("/home/avh/lib/libX11.so");). Если аргумент filename, после удаления всех платформно-специфических префиксов, путей и расширений, указывает на библиотеку, имя которой, например, L, и системная библиотека с именем L статически связана с VM, то вызывается функция JNI_OnLoad_L, экспортируемая библиотекой, а не попытка загрузить динамическую библиотеку. Файл, соответствующий аргументу, не обязательно должен существовать в файловой системе. См. Спецификацию JNI для получения дополнительной информации. В противном случае аргумент filename отображается на изображение системной библиотеки способом, зависящим от реализации.

Сначала, если существует менеджер безопасности, его метод checkLink вызывается с filename в качестве аргумента. Это может привести к исключению безопасности.

Это аналогично методу loadLibrary(String), но принимает в качестве аргумента общее имя файла, а не только имя библиотеки, что позволяет загружать любой файл кода нативных функций.

Метод System.load(String) является общепринятым и удобным способом вызова этого метода.

public void loadLibrary(String libname)

Загружает нативную библиотеку, указанную аргументом libname. Аргумент libname не должен содержать никаких платформозависимых префиксов, расширений файлов или путей. Если нативная библиотека, называемая libname, статически связана с виртуальной машиной, то вызывается функция JNI_OnLoad_libname, экспортируемая библиотекой. См. Спецификацию JNI для получения более подробной информации. В противном случае, аргумент libname загружается из системного расположения библиотек и сопоставляется с образом нативной библиотеки способом, зависящим от реализации.

Сначала, если существует менеджер безопасности, вызывается его метод checkLink с аргументом libname. Это может привести к исключению безопасности.

Метод System.loadLibrary(String) является стандартным и удобным способом вызова этого метода. Если нативные методы должны использоваться в реализации класса, стандартная стратегия заключается в размещении нативного кода в файле библиотеки (назовите его LibFile) и затем добавлении статического инициализатора:

 static { System.loadLibrary("LibFile"); }
 

внутри объявления класса. Когда класс загружается и инициализируется, необходимое нативное кодовое реализация для нативных методов также загружается.

Если этот метод вызывается более одного раза с тем же именем библиотеки, второй и последующие вызовы игнорируются.

public static Runtime.Version version()

Возвращает версию Java Runtime Environment в виде Runtime.Version.