Класс System

Для простых автономных приложений Java типичный способ записи строки выходных данных выглядит так:

     System.out.println(data)
 

См. методы println в классе PrintStream.

Обычно этот поток соответствует выводу на экран или другому пункту назначения вывода, указанному средой или пользователем. По соглашению, этот поток вывода используется для отображения сообщений об ошибках или другой информации, которая должна быть немедленно обработана пользователем, даже если основной поток вывода, значение переменной out, был перенаправлен в файл или другое место, которое обычно не отслеживается непрерывно. Кодировка, используемая при преобразовании символов в байты, эквивалентна Console.charset(), если Console существует, в противном случае - stderr.encoding.

Помимо сетевых каналов, описанных в inheritedChannel, этот метод может возвращать другие типы каналов в будущем.

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

См. описание класса Date для обсуждения незначительных расхождений, которые могут возникнуть между «временем компьютера» и координированным всемирным временем (UTC).

Этот метод обеспечивает наносекундную точность, но не обязательно наносекундное разрешение (то есть, как часто изменяется значение) - не гарантируется ничего, кроме того, что разрешение не хуже, чем у currentTimeMillis().

Различия в последовательных вызовах, охватывающие более примерно 292 лет (2⁶³ наносекунд), не будут правильно вычислять прошедшее время из-за переполнения.

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

Например, для измерения того, сколько времени занимает выполнение некоторого кода:

 
 long startTime = System.nanoTime();
 // ... the code being measured ...
 long elapsedNanos = System.nanoTime() - startTime;

Для сравнения прошедшего времени с таймаутом используйте

 
 if (System.nanoTime() - startTime >= timeoutNanos) ...

 
 if (System.nanoTime() >= startTime + timeoutNanos) ...

Если аргументы src и dest ссылаются на один и тот же объект массива, то копирование выполняется так, как если бы элементы с позиций srcPos по srcPos+length-1 были сначала скопированы во временный массив с length элементами, а затем содержимое временного массива было скопировано в позиции destPos по destPos+length-1 целевого массива.

Если dest равно null, то выбрасывается NullPointerException.

Если src равно null, то выбрасывается NullPointerException и целевой массив не изменяется.

В противном случае, если выполняется любое из следующих условий, выбрасывается ArrayStoreException и целевой массив не изменяется:

• Аргумент src ссылается на объект, который не является массивом.
• Аргумент dest ссылается на объект, который не является массивом.
• Аргументы src и dest ссылаются на массивы с разными типами компонентных примитивных типов.
• Аргумент src ссылается на массив с примитивным типом компонента, а аргумент dest ссылается на массив со ссылочным типом компонента.
• Аргумент src ссылается на массив со ссылочным типом компонента, а аргумент dest ссылается на массив с примитивным типом компонента.

В противном случае, если выполняется любое из следующих условий, выбрасывается IndexOutOfBoundsException и целевой массив не изменяется:

• Аргумент srcPos отрицательный.
• Аргумент destPos отрицательный.
• Аргумент length отрицательный.
• srcPos+length больше, чем src.length, длина исходного массива.
• destPos+length больше, чем dest.length, длина целевого массива.

В противном случае, если какой-либо фактический элемент исходного массива с позиции srcPos по srcPos+length-1 не может быть преобразован в тип компонента целевого массива путем присваивания, то выбрасывается ArrayStoreException. В этом случае пусть k будет наименьшим неотрицательным целым числом, меньшим длины, таким что src[srcPos+k] не может быть преобразовано в тип компонента целевого массива; когда исключение выбрасывается, элементы исходного массива с позиций srcPos по srcPos+k-1 уже будут скопированы в позиции целевого массива destPos по destPos+k-1, и другие позиции целевого массива не будут изменены. (Из-за уже упомянутых ограничений этот абзац фактически применяется только к ситуации, когда оба массива имеют типы компонентов, которые являются ссылочными типами.)

Текущий набор системных свойств для использования методом getProperty(String) возвращается как объект Properties. Если текущего набора системных свойств нет, то сначала создается и инициализируется набор системных свойств. Этот набор системных свойств включает значение для каждого из следующих ключей, если только описание соответствующего значения не указывает, что значение является необязательным.

Свойство java.specification.maintenance.version определено, если спецификация, реализованная этим runtime на момент его создания, подверглась релизу обслуживания. При определении значение указывает выпуск обслуживания. Для обозначения первого выпуска обслуживания значение свойства будет "1", для обозначения второго выпуска обслуживания – "2", и так далее.

Несколько путей в значении системного свойства разделены символом разделителя путей платформы.

Обратите внимание, что даже если менеджер безопасности не разрешает операцию getProperties, он может разрешить операцию getProperty(String).

В системах UNIX она возвращает "\n"; в системах Microsoft Windows — "\r\n".

Аргумент становится текущим набором системных свойств для использования методом getProperty(String). Если аргумент равен null, тогда текущий набор системных свойств забывается.

Если в настоящее время нет набора системных свойств, набор системных свойств сначала создается и инициализируется так же, как и для метода getProperties.

Если в настоящее время нет набора системных свойств, набор системных свойств сначала создается и инициализируется так же, как и для метода getProperties.

Если менеджер безопасности существует, вызывается его метод checkPermission с разрешением RuntimePermission("getenv."+name). Это может привести к исключению SecurityException. Если исключение не произошло, возвращается значение переменной name.

Системные свойства и переменные среды — это концептуально отображения между именами и значениями. Оба механизма могут использоваться для передачи пользовательской информации в процесс Java. Переменные среды имеют более глобальное воздействие, поскольку они видны для всех потомков процесса, который их определяет, а не только для непосредственного подпроцесса Java. У них могут быть немного разные семантики, например, чувствительность к регистру, в разных операционных системах. По этим причинам переменные среды чаще всего имеют непреднамеренные побочные эффекты. Лучше использовать системные свойства, где это возможно. Переменные среды следует использовать, когда требуется глобальное воздействие или когда внешний интерфейс системы требует переменной среды (например, PATH).

В системах UNIX регистр букв name обычно имеет значение, а в системах Microsoft Windows обычно нет. Например, выражение System.getenv("FOO").equals(System.getenv("foo")), скорее всего, будет истинным в системах Microsoft Windows.

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

Возвращаемая карта никогда не будет содержать null-ключи или null-значения. Попытка запросить наличие null-ключа или null-значения вызовет исключение NullPointerException. Попытка запросить наличие ключа или значения, которые не являются типа String, вызовет исключение ClassCastException.

Возвращаемая карта и её представления коллекций могут не следовать общему соглашению методов Object.equals(java.lang.Object) и Object.hashCode().

Возвращаемая карта, как правило, чувствительна к регистру на всех платформах.

Если существует менеджер безопасности, его метод checkPermission вызывается с разрешением RuntimePermission("getenv.*"). Это может привести к выбросу исключения SecurityException.

При передаче информации дочернему Java-процессу, обычно предпочтительнее использовать системные свойства, а не переменные среды.

Аргумент служит в качестве кода состояния. По соглашению, ненулевой код состояния указывает на аварийное завершение.

Вызов System.exit(n) фактически эквивалентен вызову:

    Runtime.getRuntime().exit(n)

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

Вызов System.gc() фактически эквивалентен вызову:

 Runtime.getRuntime().gc()
 

Вызов System.runFinalization() фактически эквивалентен вызову:

 Runtime.getRuntime().runFinalization()
 

Вызов System.load(name) фактически эквивалентен вызову:

 Runtime.getRuntime().load(name)
 

Вызов System.loadLibrary(name) фактически эквивалентен вызову

 Runtime.getRuntime().loadLibrary(name)