compact1, compact2, compact3

java.lang

Время выполнения класса

java.lang. Объект

java.lang. Время выполнения

public class Runtime
extends Object

У каждого приложения Java есть единственный экземпляр class Runtime это позволяет приложению взаимодействовать через интерфейс со средой, в которой работает приложение. Текущее время выполнения может быть получено из getRuntime метод.

Приложение не может создать свой собственный экземпляр этого class.

С тех пор:

JDK1.0

См. Также:

getRuntime()

Сводка метода

Модификатор и Тип	Метод и Описание
void	addShutdownHook(Thread hook) Регистрирует новый рычаг завершения работы виртуальной машины.
int	availableProcessors() Возвращает число процессоров, доступных виртуальной машине Java.
Процесс	exec(String command) Выполняет указанную строковую команду в отдельном процессе.
Процесс	exec(String[] cmdarray) Выполняет указанную команду и параметры в отдельном процессе.
Процесс	exec(String[] cmdarray, String[] envp) Выполняет указанную команду и параметры в разделять процессе с указанной средой.
Процесс	exec(String[] cmdarray, String[] envp, File dir) Выполняет указанную команду и параметры в разделять процессе с указанной средой и рабочим каталогом.
Процесс	exec(String command, String[] envp) Выполняет указанную строковую команду в разделять процессе с указанной средой.
Процесс	exec(String command, String[] envp, File dir) Выполняет указанную строковую команду в разделять процессе с указанной средой и рабочим каталогом.
void	exit(int status) Завершает в настоящий момент рабочую виртуальную машину Java, инициируя ее последовательность завершения работы.
long	freeMemory() Возвращает количество свободной памяти в виртуальной машине Java.
void	gc() Выполняет сборщик "мусора".
InputStream	getLocalizedInputStream(InputStream in) Осуждаемый. С JDK 1.1, привилегированный способ преобразовать поток байтов в локальном кодировании в символьный поток в Unicode через InputStreamReader и BufferedReader классы.
OutputStream	getLocalizedOutputStream(OutputStream out) Осуждаемый. С JDK 1.1, привилегированный способ преобразовать поток символа Unicode в поток байтов в локальном кодировании через OutputStreamWriter, BufferedWriter, и PrintWriter классы.
static Runtime	getRuntime() Возвращает объект периода выполнения, связанный с текущим приложением Java.
void	halt(int status) Насильственно завершает в настоящий момент рабочую виртуальную машину Java.
void	load(String filename) Загружает собственную библиотеку, определенную параметром имени файла.
void	loadLibrary(String libname) Загружает собственную библиотеку, определенную libname параметр.
long	maxMemory() Возвращает максимальный объем памяти, который виртуальная машина Java попытается использовать.
boolean	removeShutdownHook(Thread hook) Вычеркивает из списка ранее зарегистрированный рычаг завершения работы виртуальной машины.
void	runFinalization() Выполняет методы завершения любых объектов завершение на ожидании.
static void	runFinalizersOnExit(boolean value) Осуждаемый. Этот метод по сути опасен. Это может привести к финализаторам, вызываемым на живых объектах, в то время как другие потоки одновременно управляют теми объектами, приводя к ошибочному поведению или мертвой блокировке.
long	totalMemory() Возвращает общую сумму памяти в виртуальной машине Java.
void	traceInstructions(boolean on) Позволяет/Отключает проследить инструкций.
void	traceMethodCalls(boolean on) Позволяет/Отключает проследить вызовов метода.

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Деталь метода

getRuntime

public static Runtime getRuntime()

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

Возвраты:

Runtime объект связался с текущим приложением Java.

выход

public void exit(int status)

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

Последовательность завершения работы виртуальной машины состоит из двух фаз. В первой фазе все зарегистрированные shutdown hooks, если таковые вообще имеются, запускаются в некотором неуказанном порядке и позволяются работать одновременно, пока они не заканчивают. Во второй фазе все невызванные финализаторы выполняются если finalization-on-exit был включен. Как только это делается виртуальная машина halts.

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

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

Параметры:

status - Состояние завершения. Условно, ненулевой код состояния указывает на аварийное завершение.

Броски:

SecurityException - Если менеджер безопасности присутствует и checkExit метод не разрешает выходить с указанным состоянием

См. Также:

SecurityException, SecurityManager.checkExit(int), addShutdownHook(java.lang.Thread), removeShutdownHook(java.lang.Thread), runFinalizersOnExit(boolean), halt(int)

addShutdownHook

public void addShutdownHook(Thread hook)

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

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

• Программа обычно выходит, когда последний поток недемона выходит или когда exit (эквивалентно, System.exit) метод вызывается, или

• Виртуальная машина завершается в ответ на пользовательское прерывание, такое как ввод ^C, или события в масштабе всей системы, такого как пользовательский выход из системы или завершение работы системы.

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

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

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

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

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

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

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

Параметры:

hook - Инициализированный, но незапущенный Thread объект

Броски:

IllegalArgumentException - Если указанный рычаг был уже зарегистрирован, или если он может быть решен, что рычаг уже работает или был уже выполнен

IllegalStateException - Если виртуальная машина уже находится в процессе завершения работы

SecurityException - Если менеджер безопасности присутствует, и он отрицает RuntimePermission("shutdownHooks")

С тех пор:

1.3

См. Также:

removeShutdownHook(java.lang.Thread), halt(int), exit(int)

removeShutdownHook

public boolean removeShutdownHook(Thread hook)

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

Параметры:

hook - рычаг, чтобы удалить

Возвраты:

true, если указанный рычаг был ранее зарегистрирован и был успешно вычеркнут из списка, false иначе.

Броски:

IllegalStateException - Если виртуальная машина уже находится в процессе завершения работы

SecurityException - Если менеджер безопасности присутствует, и он отрицает RuntimePermission("shutdownHooks")

С тех пор:

1.3

См. Также:

addShutdownHook(java.lang.Thread), exit(int)

останов

public void halt(int status)

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

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

Параметры:

status - Состояние завершения. Условно, ненулевой код состояния указывает на аварийное завершение. Если exit (эквивалентно, System.exit) метод был уже вызван тогда, этот код состояния переопределит код состояния, который передают к тому методу.

Броски:

SecurityException - Если менеджер безопасности присутствует и checkExit метод не разрешает выход с указанным состоянием

С тех пор:

1.3

См. Также:

exit(int), addShutdownHook(java.lang.Thread), removeShutdownHook(java.lang.Thread)

runFinalizersOnExit

@Deprecated
public static void runFinalizersOnExit(boolean value)

Осуждаемый. Этот метод по сути опасен. Это может привести к финализаторам, вызываемым на живых объектах, в то время как другие потоки одновременно управляют теми объектами, приводя к ошибочному поведению или мертвой блокировке.

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

Если есть менеджер безопасности, checkExit метод сначала вызывают с 0 как его параметр, чтобы гарантировать, что выход позволяется. Это могло привести к SecurityException.

Параметры:

value - истина, чтобы позволить завершению на выходе, ложь отключить

Броски:

SecurityException - если менеджер безопасности существует и checkExit метод не позволяет выход.

С тех пор:

JDK1.1

См. Также:

exit(int), gc(), SecurityManager.checkExit(int)

exec

public Process exec(String command)
             throws IOException

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

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

Параметры:

command - указанная системная команда.

Возвраты:

Новое Process объект для того, чтобы управлять подпроцессом

Броски:

SecurityException - Если менеджер безопасности существует и checkExec метод не позволяет создание подпроцесса

IOException - Если ошибка ввода-вывода происходит

NullPointerException - Если command null

IllegalArgumentException - Если command пусто

См. Также:

exec(String[], String[], File), ProcessBuilder

exec

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

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

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

Параметры:

command - указанная системная команда.

envp - массив строк, у каждого элемента которых есть настройки переменной окружения в формате name=value, или null, если подпроцесс должен наследовать среду текущего процесса.

Возвраты:

Новое Process объект для того, чтобы управлять подпроцессом

Броски:

SecurityException - Если менеджер безопасности существует и checkExec метод не позволяет создание подпроцесса

IOException - Если ошибка ввода-вывода происходит

NullPointerException - Если command null, или один из элементов envp null

IllegalArgumentException - Если command пусто

См. Также:

exec(String[], String[], File), ProcessBuilder

exec

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

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

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

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

Параметры:

command - указанная системная команда.

envp - массив строк, у каждого элемента которых есть настройки переменной окружения в формате name=value, или null, если подпроцесс должен наследовать среду текущего процесса.

dir - рабочий каталог подпроцесса, или null, если подпроцесс должен наследовать рабочий каталог текущего процесса.

Возвраты:

Новое Process объект для того, чтобы управлять подпроцессом

Броски:

SecurityException - Если менеджер безопасности существует и checkExec метод не позволяет создание подпроцесса

IOException - Если ошибка ввода-вывода происходит

NullPointerException - Если command null, или один из элементов envp null

IllegalArgumentException - Если command пусто

С тех пор:

1.3

См. Также:

ProcessBuilder

exec

public Process exec(String[] cmdarray)
             throws IOException

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

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

Параметры:

cmdarray - массив, содержащий команду, чтобы вызвать и ее параметры.

Возвраты:

Новое Process объект для того, чтобы управлять подпроцессом

Броски:

SecurityException - Если менеджер безопасности существует и checkExec метод не позволяет создание подпроцесса

IOException - Если ошибка ввода-вывода происходит

NullPointerException - Если cmdarray null, или один из элементов cmdarray null

IndexOutOfBoundsException - Если cmdarray пустой массив (имеет длину 0)

См. Также:

ProcessBuilder

exec

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

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

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

Параметры:

cmdarray - массив, содержащий команду, чтобы вызвать и ее параметры.

envp - массив строк, у каждого элемента которых есть настройки переменной окружения в формате name=value, или null, если подпроцесс должен наследовать среду текущего процесса.

Возвраты:

Новое Process объект для того, чтобы управлять подпроцессом

Броски:

SecurityException - Если менеджер безопасности существует и checkExec метод не позволяет создание подпроцесса

IOException - Если ошибка ввода-вывода происходит

NullPointerException - Если cmdarray null, или один из элементов cmdarray null, или один из элементов envp null

IndexOutOfBoundsException - Если cmdarray пустой массив (имеет длину 0)

См. Также:

ProcessBuilder

exec

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

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

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

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

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

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

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

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

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

Запуск процесса операционной системы очень системно-зависим. Среди многих вещей, которые могут пойти не так, как надо:

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

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

Параметры:

cmdarray - массив, содержащий команду, чтобы вызвать и ее параметры.

envp - массив строк, у каждого элемента которых есть настройки переменной окружения в формате name=value, или null, если подпроцесс должен наследовать среду текущего процесса.

dir - рабочий каталог подпроцесса, или null, если подпроцесс должен наследовать рабочий каталог текущего процесса.

Возвраты:

Новое Process объект для того, чтобы управлять подпроцессом

Броски:

SecurityException - Если менеджер безопасности существует и checkExec метод не позволяет создание подпроцесса

IOException - Если ошибка ввода-вывода происходит

NullPointerException - Если cmdarray null, или один из элементов cmdarray null, или один из элементов envp null

IndexOutOfBoundsException - Если cmdarray пустой массив (имеет длину 0)

С тех пор:

1.3

См. Также:

ProcessBuilder

availableProcessors

public int availableProcessors()

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

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

Возвраты:

максимальное количество процессоров, доступных виртуальной машине; никогда меньший чем один

С тех пор:

1.4

freeMemory

public long freeMemory()

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

Возвраты:

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

totalMemory

public long totalMemory()

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

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

Возвраты:

общая сумма памяти, в настоящий момент доступной для текущих и будущих объектов, измеренных в байтах.

maxMemory

public long maxMemory()

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

Возвраты:

максимальный объем памяти, который виртуальная машина попытается использовать, измеренный в байтах

С тех пор:

1.4

gc

public void gc()

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

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

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

runFinalization

public void runFinalization()

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

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

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

См. Также:

Object.finalize()

traceInstructions

public void traceInstructions(boolean on)

Позволяет/Отключает проследить инструкций. Если boolean параметр true, этот метод предлагает, чтобы виртуальная машина Java испустила отладочную информацию для каждой инструкции в виртуальной машине, поскольку это выполняется. Формат этой информации, и файл или другой поток вывода, к которому это испускается, зависит от среды узла. Виртуальная машина может проигнорировать этот запрос, если это не поддерживает эту функцию. Место назначения вывода трассировки системно-зависимо.

Если boolean параметр false, этот метод заставляет виртуальную машину прекращать выполнять подробную трассировку инструкции, которую это выполняет.

Параметры:

on - true включать трассировке инструкции; false отключать эту опцию.

traceMethodCalls

public void traceMethodCalls(boolean on)

Позволяет/Отключает проследить вызовов метода. Если boolean параметр true, этот метод предлагает, чтобы виртуальная машина Java испустила отладочную информацию для каждого метода в виртуальной машине, как это вызывают. Формат этой информации, и файл или другой поток вывода, к которому это испускается, зависит от среды узла. Виртуальная машина может проигнорировать этот запрос, если это не поддерживает эту функцию.

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

Параметры:

on - true включать трассировке инструкции; false отключать эту опцию.

загрузка

public void load(String filename)

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

Во-первых, если есть менеджер безопасности, checkLink метод вызывают с filename как его параметр. Это может привести к исключению безопасности.

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

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

Параметры:

filename - файл, чтобы загрузиться.

Броски:

SecurityException - если менеджер безопасности существует и checkLink метод не позволяет загружаться указанной динамической библиотеки

UnsatisfiedLinkError - если или имя файла не является абсолютным путем, собственная библиотека статически не соединяется с VM, или библиотека не может быть отображена на собственное изображение библиотеки хост-системой.

NullPointerException - если filename null

См. Также:

getRuntime(), SecurityException, SecurityManager.checkLink(java.lang.String)

loadLibrary

public void loadLibrary(String libname)

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

Во-первых, если есть менеджер безопасности, checkLink метод вызывают с libname как его параметр. Это может привести к исключению безопасности.

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

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

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

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

Параметры:

libname - имя библиотеки.

Броски:

SecurityException - если менеджер безопасности существует и checkLink метод не позволяет загружаться указанной динамической библиотеки

UnsatisfiedLinkError - если или libname параметр содержит путь к файлу, собственная библиотека статически не соединяется с VM, или библиотека не может быть отображена на собственное изображение библиотеки хост-системой.

NullPointerException - если libname null

См. Также:

SecurityException, SecurityManager.checkLink(java.lang.String)

getLocalizedInputStream

@Deprecated
public InputStream getLocalizedInputStream(InputStream in)

Осуждаемый. С JDK 1.1, привилегированный способ преобразовать поток байтов в локальном кодировании в символьный поток в Unicode через InputStreamReader и BufferedReader классы.

Создает локализованную версию входного потока. Этот метод берет InputStream и возвраты InputStream эквивалентный параметру во всех отношениях за исключением того, что это локализуется: поскольку символы в локальном наборе символов читаются из потока, они автоматически преобразовываются от локального набора символов до Unicode.

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

Параметры:

in - InputStream, чтобы локализовать

Возвраты:

локализованный входной поток

См. Также:

InputStream, BufferedReader.BufferedReader(java.io.Reader), InputStreamReader.InputStreamReader(java.io.InputStream)

getLocalizedOutputStream

@Deprecated
public OutputStream getLocalizedOutputStream(OutputStream out)

Осуждаемый. С JDK 1.1, привилегированный способ преобразовать поток символа Unicode в поток байтов в локальном кодировании через OutputStreamWriter, BufferedWriter, и PrintWriter классы.

Создает локализованную версию потока вывода. Этот метод берет OutputStream и возвраты OutputStream эквивалентный параметру во всех отношениях за исключением того, что это локализуется: поскольку символы Unicode пишутся потоку, они автоматически преобразовываются в локальный набор символов.

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

Параметры:

out - OutputStream, чтобы локализовать

Возвраты:

локализованный поток вывода

См. Также:

OutputStream, BufferedWriter.BufferedWriter(java.io.Writer), OutputStreamWriter.OutputStreamWriter(java.io.OutputStream), PrintWriter.PrintWriter(java.io.OutputStream)