Spec-Zone .ru
спецификации, руководства, описания, API
|
java.lang.Runtime
public classRuntime
{ public static RuntimegetRuntime
(); public voidexit
(int status) throws SecurityException; public Processexec
(String command) throws
IOException,SecurityException,IndexOutOfBoundsException; public Processexec
(String command, String envp[]) throws
IOException,SecurityException,IndexOutOfBoundsException; public Processexec
(String cmdarray[]) throws
IOException,SecurityException,IndexOutOfBoundsException; public Processexec
(String cmdarray[], String envp[]) throws
IOException,SecurityException,IndexOutOfBoundsException; public longtotalMemory
(); public longfreeMemory
(); public voidgc
(); public voidrunFinalization
(); public voidtraceInstructions
(boolean on); public voidtraceMethodCalls
(boolean on); public voidload
(String filename) throws SecurityException, UnsatisfiedLinkError; public voidloadLibrary
(String libname) throws SecurityException, UnsatisfiedLinkError; public InputStreamgetLocalizedInputStream
(InputStream in); public OutputStream
getLocalizedOutputStream
(OutputStream out); }
20.16.1 public static Runtime
getRuntime
()
Этот метод возвращает ток Runtime
объект. Большинство методов класса Runtime
методы экземпляра и должны быть вызваны относительно текущего объекта периода выполнения.
20.16.2 public void
exit
(int status)
throws SecurityException
Во-первых, если есть менеджер безопасности, checkExit
метод (§20.17.13) вызывают с status
оцените как его параметр.
Этот метод завершает в настоящий момент рабочую виртуальную машину Java. Параметр служит кодом состояния; условно, ненулевой код состояния указывает на аварийное завершение.
Этот метод никогда обычно не возвращается.
См. также метод exit
(§20.18.11) класса System
, который является стандартными и удобными средствами вызова этого метода.
20.16.3 public Process
exec
(String command)
throws IOException, SecurityException,
IndexOutOfBoundsException
command
параметр анализируется в маркеры и затем выполняется как команда в отдельном процессе. Маркерный парсинг делается a StringTokenizer
(§21.10) создал вызовом:
new StringTokenizer(command)без дальнейшей модификации символьных категорий.
Этот метод ведет себя точно, как будто он выполняет вызов:
exec(command, null)
См. §20.16.4. 20.16.4 public Process
exec
(String command, String envp[])
throws IOException, SecurityException,
IndexOutOfBoundsException
command
параметр анализируется в маркеры и затем выполняется как команда в разделять процессе со средой, определенной envp
. Маркерный парсинг делается a StringTokenizer
(§21.10) создал вызовом:
new StringTokenizer(command)без дальнейшей модификации символьных категорий.
Этот метод повреждается command
строка в маркеры и создает новый массив cmdarray
содержа маркеры в порядке, что они были произведены строковым токенизатором; это тогда ведет себя точно, как будто это выполняет вызов:
exec(cmdarray, envp)
См. §20.16.6. 20.16.5 public Process
exec
(String cmdarray[])
throws IOException, SecurityException,
NullPointerException, IndexOutOfBoundsException
Команда, определенная маркерами в cmdarray
выполняется как команда в отдельном процессе.
Этот метод ведет себя точно, как будто он выполняет вызов:
exec(cmdarray, null)
См. §20.16.6. 20.16.6 public Process
exec
(String cmdarray[], String envp[])
throws IOException, SecurityException,
NullPointerException, IndexOutOfBoundsException
Во-первых, если есть менеджер безопасности, checkExec
метод (§20.17.14) вызывают с первым компонентом массива cmdarray
как его параметр.
Если cmdarray
null
, a NullPointerException
бросается. Если cmdarray
пустой массив (имеет длину 0
), IndexOutOfBoundsException
бросается.
Учитывая массив строк cmdarray
, представление маркеров командной строки, и массива строк envp
, представляя "среду", которая определяет системные свойства, этот метод создает новый процесс, в котором можно выполнить указанную команду и можно возвратить a Process
объект (§20.15) представление нового процесса.
20.16.7 public long
totalMemory
()
Общая сумма памяти, в настоящий момент доступной для тока и будущего создаваемые объекты, измеренные в байтах, возвращается. Значение, возвращенное этим методом, может измениться в течение долгого времени, в зависимости от среды узла.
Отметьте, что объем памяти, требуемый содержать объект любого данного типа, может быть зависящим от реализации.
20.16.8 public long
freeMemory
()
Возвращается приближение к общей сумме памяти, в настоящий момент доступной для будущего создаваемые объекты, измеренные в байтах. Это значение всегда является меньше чем текущая стоимость, возвращенная totalMemory
метод. Вызов gc
метод может увеличить значение, возвращенное freeMemory
.
20.16.9 public void
gc
()
Вызов этого метода предлагает, чтобы виртуальная машина Java израсходовала усилие к рециркуляции отброшенных объектов, чтобы сделать память, которую они в настоящий момент занимают доступный для быстрого повторного использования. Когда возвраты управления из вызова метода, виртуальная машина Java сделала максимальные усилия, чтобы переработать все отброшенные объекты. (Имя gc
стенды для "сборщика "мусора".")
Система Среды выполнения Java выполнит этот процесс рециркуляции автоматически как необходимый, в отдельном потоке, если gc
метод не вызывается явно.
См. также метод gc
(§20.18.12) класса System
, который является стандартными и удобными средствами вызова этого метода.
20.16.10 public void
runFinalization
()
Вызов этого метода предлагает, чтобы виртуальная машина Java израсходовала усилие к выполнению finalize
методы объектов, которые, как находили, были отброшены, но чей finalize
методы еще не были выполнены. Когда возвраты управления из вызова метода, виртуальная машина Java сделала максимальные усилия, чтобы завершить все выдающиеся завершения.
Система Среды выполнения Java выполнит процесс завершения автоматически как необходимый, в отдельном потоке, если runFinalization
метод не вызывается явно.
См. также метод runFinalization
(§20.18.13) класса System
, который является стандартными и удобными средствами вызова этого метода.
20.16.11 public void
traceInstructions
(boolean on)
Вызов этого метода с параметром true
предлагает, чтобы виртуальная машина Java испустила отладочную информацию для каждой инструкции, которую это выполняет. Формат этой информации, и файл или другой поток вывода, к которому это испускается, зависит от среды узла.
Вызов этого метода с параметром false
предлагает, чтобы виртуальная машина Java прекратила испускать отладочную информацию на инструкцию.
20.16.12 public void
traceMethodCalls
(boolean on)
Вызов этого метода с параметром true
предлагает, чтобы виртуальная машина Java испустила отладочную информацию для каждого вызова метода, который это выполняет. Формат этой информации, и файл или другой поток вывода, к которому это испускается, зависит от среды узла.
Вызов этого метода с параметром false
предлагает, чтобы виртуальная машина Java прекратила испускать отладочную информацию на вызов.
20.16.13 public void
load
(String filename)
Во-первых, если есть менеджер безопасности, checkLink
метод (§20.17.17) вызывают с filename
как его параметр.
Это подобно методу loadLibrary
(§20.16.14), но принимает общее имя файла как параметр, а не только имя библиотеки, позволяя любой файл собственного кода быть загруженным.
См. также метод load
(§20.18.14) класса System
, который является стандартными и удобными средствами вызова этого метода.
20.16.14 public void
loadLibrary
(String libname)
Во-первых, если есть менеджер безопасности, checkLink
метод (§20.17.17) вызывают с libname
как его параметр.
Файл, содержащий собственный код, загружается из локальной файловой системы от места, где файлы библиотеки традиционно получаются. Детали этого процесса являются зависящими от реализации.
См. также метод loadLibrary
(§20.18.15) класса System
, который является стандартными и удобными средствами вызова этого метода. Если native
методы должны использоваться в реализации класса, стандартная стратегия состоит в том, чтобы поместить собственный код в файл библиотеки (вызовите это LibFile
) и затем помещать статический инициализатор:
static { System.loadLibrary("LibFile"); }в пределах объявления класса. Когда класс загружается и инициализируется (§12.4), необходимая собственная реализация кода для
native
методы будут тогда загружены также. 20.16.15 public InputStream
getLocalizedInputStream
(InputStream in)
Этот метод берет InputStream
(§22.3) и возвраты InputStream
эквивалентный параметру во всех отношениях за исключением того, что это локализуется: поскольку данные читаются из потока, они автоматически преобразовываются от локального формата до Unicode. Если параметром уже будет локализованный поток, то он будет возвращен как результат.
20.16.16 public OutputStream
getLocalizedOutputStream
(OutputStream out)
Этот метод берет OutputStream
(§22.15) и возвраты OutputStream
эквивалентный параметру во всех отношениях за исключением того, что это локализуется: поскольку данные пишутся потоку, они автоматически преобразовываются от Unicode до локального формата. Если параметром уже будет локализованный поток, то он будет возвращен как результат.
Содержание | Предыдущий | Следующий | Индекс
Спецификация языка Java (HTML, сгенерированный Блинчиком "сюзет" Pelouch 24 февраля 1998)
Авторское право © Sun Microsystems, Inc 1996 года. Все права защищены
Пожалуйста, отправьте любые комментарии или исправления к doug.kramer@sun.com