Класс Runtime
public class Runtime extends Object
Runtime, который позволяет приложению взаимодействовать со средой, в которой оно выполняется. Текущий запуск можно получить из метода getRuntime. Приложение не может создать свой собственный экземпляр этого класса.
Последовательность завершения
Виртуальная машина Java инициирует последовательность завершения в ответ на одно из нескольких событий:
- когда количество активных не-демон-потоков впервые падает до нуля (см. примечание ниже об API вызова JNI);
- когда метод
Runtime.exitилиSystem.exitвызывается впервые; или - когда происходит какое-либо внешнее событие, например, прерывание или получение сигнала от операционной системы.
В начале последовательности завершения зарегистрированные обработчики завершения запускаются в произвольном порядке. Они выполняются параллельно с любыми демон- или не-демон-потоками, которые были активны в начале последовательности завершения.
После начала последовательности завершения регистрация и отмена регистрации обработчиков завершения с помощью addShutdownHook и removeShutdownHook запрещена. Однако создание и запуск новых потоков разрешены. Новые потоки выполняются параллельно с зарегистрированными обработчиками завершения и любыми демон- или не-демон-потоками, которые уже выполняются.
Последовательность завершения завершается, когда все обработчики завершения завершат свою работу. В этот момент виртуальная машина Java завершает работу, как описано ниже.
Возможна ситуация, когда один или несколько обработчиков завершения не завершают свою работу, например, из-за бесконечного цикла. В этом случае последовательность завершения никогда не закончится. Другие потоки и обработчики завершения продолжают выполняться и могут завершить JVM с помощью метода halt.
Перед началом последовательности завершения программа может запустить обработчик завершения, вызвав его метод start явно. Если это произойдёт, поведение последовательности завершения не определено.
Завершение виртуальной машины Java
JVM завершает работу, когда последовательность завершения завершается или когда вызывается halt. В отличие от exit, метод halt не инициирует последовательность завершения.
При завершении JVM все потоки немедленно лишаются возможности выполнения дальнейшего кода Java. Это относится как к обработчикам завершения, так и к демон- и не-демон-потокам. Это означает, например, что:
- текущие методы потоков не завершаются нормально или прерываются;
-
finallyблоки не выполняются; - обработчики необработанных исключений не запускаются; и
- ресурсы, открытые с помощью try-with-resources, не закрываются;
- Примечание о реализации:
- Нативный код обычно использует API вызова JNI для управления запуском и завершением JVM. Такой нативный код вызывает функцию
JNI_CreateJavaVMдля запуска JVM. После этого нативный код вызывает функциюDestroyJavaVMдля ожидания завершения этой JVM. ФункцияDestroyJavaVMотвечает за инициирование последовательности завершения, когда количество активных не-демон-потоков впервые падает до нуля. Когда последовательность завершения завершается и JVM завершает работу, управление возвращается нативному коду, вызвавшемуDestroyJavaVM. Это поведение отличается от методовexitилиhalt. Эти методы обычно завершают процесс ОС, в котором размещена JVM, и не взаимодействуют с API вызова JNI. - См. Спецификацию языка Java:
- 12.8 Выход из программы
- С:
- 1.0
- Внешние спецификации
- См. также:
Краткое описание вложенных классов
| Модификатор и тип | Класс | Описание |
|---|---|---|
static final class |
Runtime.Version |
Представление строки версии реализации платформы Java SE. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
void |
addShutdownHook |
Регистрирует новый обработчик завершения виртуальной машины. |
int |
availableProcessors() |
Возвращает количество процессоров, доступных виртуальной машине Java. |
Process |
exec |
Устарело. |
Process |
exec |
Выполняет указанную команду и аргументы в отдельном процессе. |
Process |
exec |
Выполняет указанную команду и аргументы в отдельном процессе с указанной средой. |
Process |
exec |
Выполняет указанную команду и аргументы в отдельном процессе с указанной средой и каталогом. |
Process |
exec |
Устарело. Этот метод подвержен ошибкам и не должен использоваться, вместо него следует использовать соответствующий метод exec(String[], String[]) или ProcessBuilder. |
Process |
exec |
Устарело. Этот метод подвержен ошибкам и не должен использоваться, вместо него следует использовать соответствующий метод exec(String[], String[], File) или ProcessBuilder. |
void |
exit |
Инициирует последовательность завершения виртуальной машины Java. |
long |
freeMemory() |
Возвращает количество свободной памяти в виртуальной машине Java. |
void |
gc() |
Выполняет сборку мусора в виртуальной машине Java. |
static Runtime |
getRuntime() |
Возвращает объект Runtime, связанный с текущим приложением Java. |
void |
halt |
Немедленно завершает виртуальную машину Java. |
void |
load |
Ограничено. Загружает нативный библиотеку, указанную в аргументе имени файла. |
void |
loadLibrary |
Ограничено. Загружает нативную библиотеку, указанную в аргументе libname. |
long |
maxMemory() |
Возвращает максимальный объем памяти, который виртуальная машина Java попытается использовать. |
boolean |
removeShutdownHook |
Отменяет регистрацию ранее зарегистрированного обработчика завершения виртуальной машины. |
void |
runFinalization() |
Устарело, для удаления: этот элемент API может быть удален в будущей версии. Заключительная обработка устарела для удаления. |
long |
totalMemory() |
Возвращает общий объем памяти в виртуальной машине Java. |
static Runtime.Version |
version() |
Возвращает версию среды выполнения Java в виде Runtime.Version. |
Подробное описание методов
getRuntime
public static Runtime getRuntime()
Runtime являются методами экземпляра и должны вызываться относительно текущего объекта runtime.- Возвращает:
- объект
Runtime, связанный с текущим приложением Java.
exit
public void exit(int status)
Аргумент используется в качестве кода состояния. По соглашению, ненулевой код состояния указывает на аномальное завершение.
Успешные вызовы этого метода сериализуются таким образом, что только один вызов инициирует последовательность завершения и завершает VM с заданным кодом состояния. Все остальные вызовы не будут выполнять никаких действий и будут заблокированы неопределенно.
Поскольку успешный вызов этого метода блокируется неопределенно, если он вызван из обработчика завершения работы, он предотвратит завершение этого обработчика. В результате это предотвратит завершение последовательности завершения.
Метод System.exit является стандартным и удобным способом вызова этого метода.
- Примечание реализации:
- Если системный логгер
java.lang.Runtimeвключен с уровнем ведения журналаLevel.DEBUG, то трассировка стека вызоваRuntime.exit()будет записана в журнал. - Параметры:
-
status- Код завершения. По соглашению, ненулевой код состояния указывает на аномальное завершение. - См. также:
addShutdownHook
public void addShutdownHook(Thread hook)
Обработчик завершения работы — это просто инициализированный, но не запущенный поток. Обработчики завершения работы запускаются в начале последовательности завершения завершения работы. Регистрация и дерегистрация обработчиков завершения работы запрещены после начала последовательности завершения работы.
Необработанные исключения обрабатываются в обработчиках завершения работы так же, как и в любом другом потоке, как указано в Thread.UncaughtExceptionHandler. После завершения обработчика необработанных исключений обработчик завершения работы считается завершенным и не отличается от обработчика, который завершился без выбрасывания необработанного исключения.
- Примечание API:
- Обработчики завершения работы выполняются в деликатное время жизненного цикла виртуальной машины и поэтому должны быть написаны защищенно. В частности, они должны быть потокобезопасными и по возможности избегать тупиков. Они также не должны слепо полагаться на услуги, которые могут зарегистрировать собственные обработчики завершения работы и, следовательно, могут сами находиться в процессе завершения работы. Попытки использования других служб на основе потоков, таких как поток диспетчеризации событий AWT, например, могут привести к тупикам.
Обработчики завершения работы также должны быстро завершать свою работу. Когда программа вызывает
exit, ожидается, что виртуальная машина быстро завершит работу и выйдет. Когда виртуальная машина завершается из-за выхода пользователя или выключения системы, операционная система может разрешить только ограниченное время для завершения работы и выхода. Поэтому не рекомендуется пытаться взаимодействовать с пользователем или выполнять длительные вычисления в обработчике завершения работы. - Параметры:
-
hook- Инициализированный, но не запущенный объектThread - Исключения:
-
IllegalArgumentException- Если тот же обработчик (сравнивается с помощью==), что и указанный обработчик, уже зарегистрирован или если можно определить, что обработчик уже запущен или уже был запущен -
IllegalStateException- Если последовательность завершения уже началась - С момента:
- 1.3
- См. также:
removeShutdownHook
public boolean removeShutdownHook(Thread hook)
==. Регистрация и дерегистрация обработчиков завершения работы запрещены после начала последовательности завершения работы.- Параметры:
-
hook- обработчик для удаления - Возвращает:
-
true, если указанный обработчик был ранее зарегистрирован и успешно де-зарегистрирован,falseв противном случае. - Исключения:
-
IllegalStateException- Если последовательность завершения уже началась - С момента:
- 1.3
- См. также:
halt
public void halt(int status)
- Примечание API:
- Этот метод следует использовать с большой осторожностью. Его использование может обойти или нарушить любые действия по очистке, которые должны быть выполнены обработчиками завершения работы, что может привести к повреждению данных. См. раздел завершения выше для других возможных последствий остановки Java Virtual Machine.
- Параметры:
-
status- Код завершения. По соглашению, ненулевой код состояния указывает на аномальное завершение. Если методexit(эквивалентноSystem.exit) уже был вызван, этот код состояния перепишет код состояния, переданный этому методу. - С момента:
- 1.3
- См. также:
exec
@Deprecated(since="18") public Process exec(String command) throws IOException
exec(String[]) или ProcessBuilder. Строка команды разбивается на токены только с помощью пробельных символов. В случае аргумента с вложенным пробелом, например, имени файла, это может привести к проблемам, поскольку токен не включает весь файл.Это вспомогательный метод. Вызов в форме exec(command) ведет себя точно так же, как вызов exec(command, null, null).
- Примечание реализации:
- В эталонной реализации ведение журнала созданного процесса может быть включено, см.
ProcessBuilder.start()для получения подробной информации. - Параметры:
-
command- указанная системная команда. - Возвращает:
- Новый объект
Processдля управления подпроцессом - Исключения:
-
IOException- Если произошла ошибка ввода-вывода -
NullPointerException- Еслиcommandявляетсяnull -
IllegalArgumentException- Еслиcommandпусто - См. также:
exec
@Deprecated(since="18") public Process exec(String command, String[] envp) throws IOException
exec(String[], String[]) или ProcessBuilder. Строка команды разбивается на токены, используя только пробельные символы. Для аргумента со вложенным пробелом, например, имени файла, это может привести к проблемам, поскольку токен не включает весь путь к файлу.Это метод-удобство. Вызов вида exec(command, envp) ведет себя точно так же, как вызов exec(command, envp, null).
- Примечание реализации:
- В эталонной реализации можно включить протоколирование созданного процесса, см.
ProcessBuilder.start()для подробностей. - Параметры:
-
command- указанная системная команда. -
envp- массив строк, каждый элемент которого содержит настройки переменных среды в формате имя=значение, илиnull, если дочерний процесс должен унаследовать среду текущего процесса. - Возвращает:
- Новый объект
Processдля управления дочерним процессом - Исключения:
-
IOException- Если произошла ошибка ввода-вывода -
NullPointerException- Еслиcommandявляетсяnull, или один из элементовenvpявляетсяnull -
IllegalArgumentException- Еслиcommandпуста - См. также:
exec
@Deprecated(since="18") public Process exec(String command, String[] envp, File dir) throws IOException
exec(String[], String[], File) или ProcessBuilder. Строка команды разбивается на токены, используя только пробельные символы. Для аргумента со вложенным пробелом, например, имени файла, это может привести к проблемам, поскольку токен не включает весь путь к файлу.Это метод-удобство. Вызов вида exec(command, envp, dir) ведет себя точно так же, как вызов exec(cmdarray, envp, dir), где cmdarray - массив всех токенов в command.
Более точно, строка command разбивается на токены с помощью StringTokenizer, созданного вызовом new StringTokenizer(command) без дальнейшего изменения категорий символов. Токены, полученные токенизатором, затем помещаются в новый массив строк cmdarray в том же порядке.
- Примечание реализации:
- В эталонной реализации можно включить протоколирование созданного процесса, см.
ProcessBuilder.start()для подробностей. - Параметры:
-
command- указанная системная команда. -
envp- массив строк, каждый элемент которого содержит настройки переменных среды в формате имя=значение, илиnull, если дочерний процесс должен унаследовать среду текущего процесса. -
dir- рабочая директория дочернего процесса, илиnull, если дочерний процесс должен унаследовать рабочую директорию текущего процесса. - Возвращает:
- Новый объект
Processдля управления дочерним процессом - Исключения:
-
IOException- Если произошла ошибка ввода-вывода -
NullPointerException- Еслиcommandявляетсяnull, или один из элементовenvpявляетсяnull -
IllegalArgumentException- Еслиcommandпуста - С тех пор:
- 1.3
- См. также:
exec
public Process exec(String[] cmdarray) throws IOException
Это метод-удобство. Вызов вида exec(cmdarray) ведет себя точно так же, как вызов exec(cmdarray, null, null).
- Примечание реализации:
- В эталонной реализации можно включить протоколирование созданного процесса, см.
ProcessBuilder.start()для подробностей. - Параметры:
-
cmdarray- массив, содержащий вызываемую команду и ее аргументы. - Возвращает:
- Новый объект
Processдля управления дочерним процессом - Исключения:
-
IOException- Если произошла ошибка ввода-вывода -
NullPointerException- Еслиcmdarrayявляетсяnull, или один из элементовcmdarrayявляетсяnull -
IndexOutOfBoundsException- Еслиcmdarrayявляется пустым массивом (имеет длину0) - См. также:
exec
public Process exec(String[] cmdarray, String[] envp) throws IOException
Это метод-удобство. Вызов вида exec(cmdarray, envp) ведет себя точно так же, как вызов exec(cmdarray, envp, null).
- Примечание реализации:
- В эталонной реализации можно включить протоколирование созданного процесса, см.
ProcessBuilder.start()для подробностей. - Параметры:
-
cmdarray- массив, содержащий вызываемую команду и ее аргументы. -
envp- массив строк, каждый элемент которого содержит настройки переменных среды в формате имя=значение, илиnull, если дочерний процесс должен унаследовать среду текущего процесса. - Возвращает:
- Новый объект
Processдля управления дочерним процессом - Исключения:
-
IOException- Если произошла ошибка ввода-вывода -
NullPointerException- Еслиcmdarrayявляетсяnull, или один из элементовcmdarrayявляетсяnull, или один из элементовenvpявляетсяnull -
IndexOutOfBoundsException- Еслиcmdarrayявляется пустым массивом (имеет длину0) - См. также:
exec
public Process exec(String[] cmdarray, String[] envp, File dir) throws IOException
Учитывая массив строк cmdarray, представляющие токены командной строки, и массив строк envp, представляющие настройки переменных "среды", этот метод создаёт новый процесс для выполнения указанной команды.
Этот метод проверяет, что cmdarray является допустимой командной строкой операционной системы. Какие команды являются допустимыми, зависит от системы, но по крайней мере, команда должна быть непустым списком непустых строк.
Если envp имеет значение null, подпроцесс наследует настройки среды текущего процесса.
Для запуска процесса на некоторых операционных системах может потребоваться минимальный набор системных переменных среды. В результате подпроцесс может унаследовать дополнительные настройки переменных среды сверх тех, что указаны в среде. Минимальный набор системно-зависимых переменных среды может переопределять значения, предоставленные в среде.
ProcessBuilder.start() сейчас является предпочтительным способом запуска процесса с изменённой средой.
Рабочая директория нового подпроцесса задаётся параметром dir. Если dir имеет значение null, подпроцесс наследует текущую рабочую директорию текущего процесса.
Запуск процесса операционной системы сильно зависит от системы. Среди многих возможных проблем:
- Файл программы операционной системы не найден.
- Доступ к файлу программы запрещён.
- Рабочая директория не существует.
В таких случаях будет выброшено исключение. Точный характер исключения зависит от системы, но он всегда будет подклассом IOException.
Если операционная система не поддерживает создание процессов, будет выброшено исключение UnsupportedOperationException.
- Implementation Note:
- В эталонной реализации можно включить логирование созданного процесса, см.
ProcessBuilder.start()для деталей. - Parameters:
-
cmdarray- массив, содержащий команду и её аргументы. -
envp- массив строк, каждый элемент которого содержит настройки переменной среды в формате имя=значение, илиnull, если подпроцесс должен унаследовать среду текущего процесса. -
dir- рабочая директория подпроцесса, илиnull, если подпроцесс должен унаследовать рабочую директорию текущего процесса. - Returns:
- Новый объект
Processдля управления подпроцессом - Throws:
-
UnsupportedOperationException- Если операционная система не поддерживает создание процессов. -
IOException- Если произошла ошибка ввода-вывода -
NullPointerException- Еслиcmdarrayимеет значениеnull, или один из элементовcmdarrayимеет значениеnull, или один из элементовenvpимеет значениеnull -
IndexOutOfBoundsException- Еслиcmdarray- пустой массив (имеет длину0) - Since:
- 1.3
- See Also:
availableProcessors
public int availableProcessors()
Это значение может изменяться во время конкретного вызова виртуальной машины. Приложения, чувствительные к количеству доступных процессоров, должны периодически опрашивать эту свойство и соответствующим образом корректировать использование ресурсов.
- Returns:
- максимальное количество процессоров, доступных виртуальной машине; никогда не меньше одного
- Since:
- 1.4
freeMemory
public long freeMemory()
gc может привести к увеличению значения, возвращаемого freeMemory.
- Returns:
- приблизительное количество памяти, в байтах, доступное для будущих выделенных объектов.
totalMemory
public long totalMemory()
Обратите внимание, что количество памяти, необходимое для хранения объекта любого данного типа, может зависеть от реализации.
- Returns:
- общее количество памяти, в байтах, доступное для текущих и будущих объектов.
maxMemory
public long maxMemory()
Long.MAX_VALUE.- Returns:
- максимальное количество памяти, в байтах, которое виртуальная машина попытается использовать
- Since:
- 1.4
gc
public void gc()
Вызов этого метода предполагает, что виртуальная машина Java затратит ресурсы на рециклирование неиспользуемых объектов, чтобы освободить занимаемую ими память для повторного использования виртуальной машиной Java. Когда управление возвращается из вызова метода, виртуальная машина Java сделает всё возможное для освобождения пространства от всех неиспользуемых объектов. Нет гарантии, что этот процесс рециклирует определённое количество неиспользуемых объектов, освободит определённое количество памяти или завершится в определённый момент времени, вообще. Также нет гарантии, что это повлияет на изменение достижимости определённого числа объектов или что определённое количество объектов Reference будет очищено и помещено в очередь.
Название gc обозначает "сборщик мусора". Виртуальная машина Java выполняет этот процесс рециклирования автоматически по мере необходимости в отдельном потоке, даже если метод gc не вызывается явно.
Метод System.gc() является стандартным и удобным способом вызова этого метода.
runFinalization
@Deprecated(since="18", forRemoval=true) public void runFinalization()
Object.finalize() для дополнительной информации и способов миграции. При работе в JVM, в которой финализация отключена или удалена, нет ожидающих финализации объектов, поэтому этот метод ничего не делает.
finalize объектов, которые были признаны удалёнными, но чьи методы finalize ещё не были выполнены. Когда управление возвращается из вызова метода, виртуальная машина сделает всё возможное, чтобы завершить все ожидающие финализации. Виртуальная машина выполняет процесс финализации автоматически по мере необходимости в отдельном потоке, если метод runFinalization не вызывается явно.
Метод System.runFinalization() является стандартным и удобным способом вызова этого метода.
- See Java Language Specification:
- 12.6 Finalization of Class Instances
- See Also:
load
public void load(String filename)
load это ограниченный метод платформы Java. load только при включенном доступе к ограниченным методам.Runtime.getRuntime().load("/home/avh/lib/libX11.so");). Если аргумент filename, после удаления всех платформно-специфичных префиксов, путей и расширений, указывает на библиотеку, имя которой, например, L, и системная библиотека с именем L статически связана с VM, тогда вызывается функция JNI_OnLoad_L, экспортируемая этой библиотекой, вместо попытки загрузить динамическую библиотеку. Библиотека с указанным именем не обязательно должна существовать в файловой системе. Более подробную информацию см. в спецификации JNI. В противном случае, аргумент filename отображается на системную библиотеку в зависимости от реализации. Это аналогично методу loadLibrary(String)ОГРАНИЧЕННЫЙ, но он принимает в качестве аргумента общее имя файла, а не только имя библиотеки, что позволяет загружать любые файлы с кодом нативных методов.
Метод System.load(String)ОГРАНИЧЕННЫЙ является стандартным и удобным способом вызова этого метода.
- Параметры:
-
filename- файл для загрузки. - Исключения:
-
UnsatisfiedLinkError- если имя файла не является абсолютным путем, системная библиотека не статически связана с VM или библиотека не может быть отображена на системную библиотеку хост-системой. -
NullPointerException- еслиfilenameявляетсяnull -
IllegalCallerException- если вызывающий элемент находится в модуле, в котором не включён доступ к нативным методам. - Внешние спецификации
- См. также:
loadLibrary
public void loadLibrary(String libname)
loadLibrary это ограниченный метод платформы Java. loadLibrary только при включенном доступе к ограниченным методам.libname статически связана с VM, тогда вызывается функция JNI_OnLoad_libname, экспортируемая этой библиотекой. Более подробную информацию см. в спецификации JNI. В противном случае, аргумент libname загружается из системного расположения библиотек и отображается на системную библиотеку в зависимости от реализации. Метод System.loadLibrary(String)ОГРАНИЧЕННЫЙ является стандартным и удобным способом вызова этого метода. Если нативные методы должны быть использованы в реализации класса, стандартная стратегия заключается в том, чтобы поместить код нативных методов в файл библиотеки (назовем его LibFile), а затем поместить статический инициализатор:
static { System.loadLibrary("LibFile"); }
внутри объявления класса. Когда класс загружается и инициализируется, необходимое нативное реализация для нативных методов также загружается. Если этот метод вызывается более одного раза с одним и тем же именем библиотеки, второй и последующие вызовы игнорируются.
- Параметры:
-
libname- имя библиотеки. - Исключения:
-
UnsatisfiedLinkError- если аргумент libname содержит путь к файлу, нативная библиотека не статически связана с VM или библиотека не может быть отображена на нативную библиотеку хост-системой. -
NullPointerException- еслиlibnameявляетсяnull -
IllegalCallerException- если вызывающий элемент находится в модуле, в котором не включён доступ к нативным методам. - Внешние спецификации
version
public static Runtime.Version version()
Runtime.Version.- Возвращает:
- версия
Runtime.VersionJava Runtime Environment - С:
- 9
© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.base/java/lang/Runtime.html
exec(String[])илиProcessBuilder.