Как завершить работу программы java

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

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

Краткое описание вложенных классов

Представление строки версии для реализации платформы Java SE.

Method Summary

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

Этот метод подвержен ошибкам и не должен использоваться, вместо него следует использовать соответствующий метод exec(String[]) или ProcessBuilder .

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

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

Deprecated.

Этот метод подвержен ошибкам и не должен использоваться, вместо него следует использовать соответствующий метод exec(String[], String[]) или ProcessBuilder .

Java — класс Scanner, интерактивное консольное приложение в Java, взаимодействие с пользователем

Deprecated.

Этот метод подвержен ошибкам и не должен использоваться, вместо него следует использовать соответствующий метод exec(String[], String[], File) или ProcessBuilder .

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

Загружает родную библиотеку,указанную аргументом filename.
Загружает собственную библиотеку, указанную аргументом libname .
Возвращает максимальный объем памяти,который попытается использовать виртуальная машина Java.
Де-регистрация ранее зарегистрированного крюка выключения виртуальной машины.

Утратил актуальность,подлежит удалению:Этот элемент API подлежит удалению в будущей версии.
Финализация была устаревшей для удаления.
Возвращает общий объем памяти в виртуальной машине Java.
Возвращает версию среды выполнения Java как Runtime.Version .

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

Method Details

getRuntime

public static Runtime getRuntime()

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

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

exit

public void exit(int status)

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

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

Как выполнить программу Java без метода Main

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

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

• SecurityException
• SecurityManager.checkExit(int)
• addShutdownHook(java.lang.Thread)
• removeShutdownHook(java.lang.Thread)
• halt(int)

addShutdownHook

public void addShutdownHook(Thread hook)
Регистрирует новый крюк отключения виртуальной машины.

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

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

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

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

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

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

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

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

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

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

removeShutdownHook

public boolean removeShutdownHook(Thread hook)
Де-регистрация ранее зарегистрированного крюка выключения виртуальной машины.

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

halt

public void halt(int status)

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

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

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

Источник: runebook.dev

Когда мы должны вызывать System.exit в Java

В Java Какая разница с или без System.exit(0) в следующем коде?

public class TestExit < public static void main(String[] args) < System.out.println(«hello world»); System.exit(0); // is it necessary? And when it must be called? >>

В документе говорится: «Этот метод никогда не возвращается нормально». Что это значит?

user115722 15 сен ’10 в 08:39 2010-09-15 08:39
2010-09-15 08:39

10 ответов

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

«Этот метод никогда не возвращается нормально». просто означает, что метод не вернется; как только нить идет туда, она не вернется.

Другой, возможно, более распространенный способ выхода из программы — просто достичь конца main метод. Но если запущены какие-либо потоки, не являющиеся демонами, они не будут закрыты, и, следовательно, JVM не выйдет. Таким образом, если у вас есть такие потоки, не являющиеся демонами, вам нужны другие средства (кроме ловушек завершения), чтобы закрыть все потоки, не являющиеся демонами, и освободить другие ресурсы. Если нет других потоков, не являющихся демонами, возвращается из main выключит JVM и вызовет перехватчики отключения.

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

user59279 15 сен ’10 в 08:45 2010-09-15 08:45
2010-09-15 08:45

В этом случае это не нужно. Никаких дополнительных потоков не будет запущено, вы не меняете код выхода (по умолчанию 0) — в основном это бессмысленно.

Когда в документах говорится, что метод никогда не возвращается нормально, это означает, что следующая строка кода фактически недоступна, даже если компилятор этого не знает:

System.exit(0); System.out.println(«This line will never be reached»);

Либо будет выдано исключение, либо виртуальная машина прекратит работу перед возвратом. Он никогда не «просто вернется».

Очень редко стоит звонить System.exit() IME. Это может иметь смысл, если вы пишете инструмент командной строки и хотите указать ошибку с помощью кода выхода, а не просто выбросить исключение. но я не могу вспомнить, когда в последний раз я использовал его в обычном рабочем коде,

user22656 15 сен ’10 в 08:43 2010-09-15 08:43
2010-09-15 08:43

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

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

System.exit(42);

Кто будет использовать ваш код выхода? Скрипт, который вызывает приложение. Работает в Windows, Unix и других скриптовых средах.

Зачем возвращать код? Сказать что-то вроде «Мне не удалось», «База данных не ответила».

Чтобы узнать, как получить значение кода выхода и использовать его в сценарии оболочки Unix или сценарии Windows cmd, вы можете проверить этот ответ на этом сайте.

Источник: stackru.com

Как завершить работу программы java

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

Платформа Java™
Стандарт Эд. 8
Проект сборка-b92
compact1, compact2, compact3

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

• java.lang. Объект

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

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

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

Все Методы Статические Методы Методы экземпляра Конкретные Методы Устаревшие Методы Модификатор и Тип Метод и Описание

void	addShutdownHook(Thread hook)

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

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

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

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

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

Осуждаемый.

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

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

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

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

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

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

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

getRuntime

public static Runtime getRuntime()

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

выход

public void exit(int status)

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

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

addShutdownHook

public void addShutdownHook(Thread hook)

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

removeShutdownHook

public boolean removeShutdownHook(Thread hook)
Вычеркивает из списка ранее зарегистрированный рычаг завершения работы виртуальной машины.

останов

public void halt(int status)

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

runFinalizersOnExit

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

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

exec

public Process exec(String command) throws IOException

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

exec

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

Выполняет указанную строковую команду в разделять процессе с указанной средой. Это — метод удобства. Вызов формы exec(command, envp) ведет себя точно таким же образом как вызов exec (command, envp, null).

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 , в том же самом порядке.

exec

public Process exec(String[] cmdarray) throws IOException

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

exec

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

Выполняет указанную команду и параметры в разделять процессе с указанной средой. Это — метод удобства. Вызов формы exec(cmdarray, envp) ведет себя точно таким же образом как вызов exec (cmdarray, envp, null).

exec

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

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

availableProcessors

public int availableProcessors()

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

freeMemory

public long freeMemory()

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

totalMemory

public long totalMemory()

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

maxMemory

public long maxMemory()

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

gc

public void gc()

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

Когда возвраты управления из вызова метода, виртуальная машина сделала свои максимальные усилия, чтобы переработать все отброшенные объекты. Имя gc стенды для «сборщика»мусора»». Виртуальная машина выполняет этот процесс рециркуляции автоматически как необходимый, в отдельном потоке, даже если gc метод не вызывается явно. Метод System.gc() стандартные и удобные средства вызова этого метода.

runFinalization

public void runFinalization()

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

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

traceInstructions

public void traceInstructions(boolean on)

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

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

traceMethodCalls

public void traceMethodCalls(boolean on)

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

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

загрузка

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) стандартные и удобные средства вызова этого метода.

loadLibrary

public void loadLibrary(String libname)

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

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

static

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

getLocalizedInputStream

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

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

getLocalizedOutputStream

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

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

Платформа Java™
Стандарт Эд. 8
Проект сборка-b92

Источник: spec-zone.ru