Spec-Zone .ru
спецификации, руководства, описания, API
Содержание | Предыдущий | Следующий | Индекс

20.16 Класс java.lang.Runtime

public class Runtime {
	public static Runtime getRuntime();
	public void exit(int status) throws SecurityException;
	public Process exec(String command) throws
IOException,SecurityException,IndexOutOfBoundsException; public Process exec(String command, String envp[]) throws
IOException,SecurityException,IndexOutOfBoundsException; public Process exec(String cmdarray[]) throws
IOException,SecurityException,IndexOutOfBoundsException; public Process exec(String cmdarray[], String envp[]) throws
IOException,SecurityException,IndexOutOfBoundsException; public long totalMemory(); public long freeMemory(); public void gc(); public void runFinalization(); public void traceInstructions(boolean on); public void traceMethodCalls(boolean on); public void load(String filename) throws SecurityException, UnsatisfiedLinkError; public void loadLibrary(String libname) throws SecurityException, UnsatisfiedLinkError; public InputStream getLocalizedInputStream(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

free hit counter