Класс System

public static final InputStream in

public static final PrintStream out

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

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

System.out.println(data)

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

public static final PrintStream err

Стандартный поток вывода ошибок. Этот поток уже открыт и готов для приема выходных данных.

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

public static void setIn(InputStream in)

Переназначает стандартный поток ввода.

Сначала, если установлен менеджер безопасности, вызывается его метод checkPermission с разрешением RuntimePermission("setIO"), чтобы проверить, разрешено ли переназначение стандартного потока ввода.

public static void setOut(PrintStream out)

Переназначает стандартный поток вывода.

Сначала, если установлен менеджер безопасности, вызывается его метод checkPermission с разрешением RuntimePermission("setIO"), чтобы проверить, разрешено ли переназначение стандартного потока вывода.

public static void setErr(PrintStream err)

Переназначает стандартный поток вывода ошибок.

Сначала, если установлен менеджер безопасности, вызывается его метод checkPermission с разрешением RuntimePermission("setIO"), чтобы проверить, разрешено ли переназначение стандартного потока вывода ошибок.

public static Console console()

public static Channel inheritedChannel()
                                throws IOException

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

Этот метод возвращает канал, полученный путем вызова метода inheritedChannel объекта системного по умолчанию SelectorProvider.

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

public static void setSecurityManager(SecurityManager s)

Устанавливает системную безопасность.

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

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

public static SecurityManager getSecurityManager()

public static long currentTimeMillis()

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

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

public static long nanoTime()

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

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

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

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

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

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

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

Для сравнения двух значений nanoTime

long t0 = System.nanoTime();
 ...
 long t1 = System.nanoTime();

следует использовать t1 - t0 < 0, а не t1 < t0, из-за возможности переполнения.

public static void arraycopy(Object src,
                             int srcPos,
                             Object dest,
                             int destPos,
                             int length)

Копирует массив из указанного исходного массива, начиная с указанной позиции, в указанную позицию целевого массива. Подпоследовательность элементов массива копируется из исходного массива, на который ссылается src, в целевой массив, на который ссылается dest. Количество скопированных элементов равно аргументу length. Элементы с позициями srcPos по srcPos+length-1 в исходном массиве копируются соответственно в позиции destPos по destPos+length-1 целевого массива.

Если аргументы 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, а другие позиции целевого массива не изменятся. (Из-за уже перечисленных ограничений этот абзац фактически применим только к ситуации, когда оба массива имеют типы элементов, которые являются ссылочными типами.)

public static int identityHashCode(Object x)

public static Properties getProperties()

Определяет текущие системные свойства.

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

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

Ключ	Описание связанного значения
java.version	Версия Java Runtime Environment
java.vendor	Производитель Java Runtime Environment
java.vendor.url	URL поставщика Java
java.home	Директория установки Java
java.vm.specification.version	Версия спецификации Java Virtual Machine
java.vm.specification.vendor	Производитель спецификации Java Virtual Machine
java.vm.specification.name	Имя спецификации Java Virtual Machine
java.vm.version	Версия реализации Java Virtual Machine
java.vm.vendor	Поставщик реализации Java Virtual Machine
java.vm.name	Имя реализации Java Virtual Machine
java.specification.version	Версия спецификации Java Runtime Environment
java.specification.vendor	Поставщик спецификации Java Runtime Environment
java.specification.name	Имя спецификации Java Runtime Environment
java.class.version	Номер версии формата класса Java
java.class.path	Путь класса Java
java.library.path	Список путей для поиска при загрузке библиотек
java.io.tmpdir	Путь по умолчанию для временных файлов
java.compiler	Имя используемого JIT-компилятора
java.ext.dirs	Путь к каталогу или каталогам расширений Устаревшее. Это свойство и механизм, его реализующий, могут быть удалены в будущих версиях.
os.name	Имя операционной системы
os.arch	Архитектура операционной системы
os.version	Версия операционной системы
file.separator	Разделитель файлов ("/" в UNIX)
path.separator	Разделитель путей (":" в UNIX)
line.separator	Разделитель строк ("\n" в UNIX)
user.name	Имя учетной записи пользователя
user.home	Домашний каталог пользователя
user.dir	Текущая рабочая директория пользователя

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

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

public static String lineSeparator()

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

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

public static void setProperties(Properties props)

Устанавливает системные свойства в аргумент Properties.

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

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

public static String getProperty(String key)

Получает системное свойство, указанное заданным ключом.

Сначала, если существует менеджер безопасности, вызывается его метод checkPropertyAccess с ключом в качестве аргумента. Это может привести к исключению SecurityException.

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

public static String getProperty(String key,
                                 String def)

Получает системное свойство, указанное заданным ключом.

Сначала, если менеджер безопасности существует, вызывается его метод checkPropertyAccess с key в качестве аргумента.

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

public static String setProperty(String key,
                                 String value)

Устанавливает системное свойство, указанное заданным ключом.

Сначала, если менеджер безопасности существует, вызывается его метод SecurityManager.checkPermission с разрешением PropertyPermission(key, "write"). Это может привести к выбрасыванию исключения SecurityException. Если исключение не выбрасывается, указанное свойство устанавливается в заданное значение.

public static String clearProperty(String key)

Удаляет системное свойство, указанное заданным ключом.

Сначала, если менеджер безопасности существует, вызывается его метод SecurityManager.checkPermission с разрешением PropertyPermission(key, "write"). Это может привести к выбрасыванию исключения SecurityException. Если исключение не выбрасывается, указанное свойство удаляется.

public static String getenv(String name)

Получает значение указанной переменной среды. Переменная среды — это зависящее от системы внешнее именованное значение.

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

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

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

public static Map<String,String> getenv()

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

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

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

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

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

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

При передаче информации в подпроцесс Java системные свойства предпочтительнее переменных среды.

public static void exit(int status)

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

Этот метод вызывает метод exit в классе Runtime. Этот метод никогда не возвращается нормально.

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

Runtime.getRuntime().exit(n)

public static void gc()

Выполняет сборщик мусора.

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

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

Runtime.getRuntime().gc()

public static void runFinalization()

Выполняет методы завершения для любых объектов, ожидающих завершения.

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

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

Runtime.getRuntime().runFinalization()

@Deprecated
public static void runFinalizersOnExit(boolean value)

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

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

public static void load(String filename)

Загружает нативный библиотеку, указанную аргументом filename. Аргумент filename должен быть полным путем. Если аргумент filename, очищенный от любых платформоспецифичных префиксов, пути и расширений файлов, указывает библиотеку, имя которой, например, L, и нативный библиотека с именем L статически связана с VM, то функция JNI_OnLoad_L, экспортируемая библиотекой, вызывается, а не попытка загрузить динамическую библиотеку. Файл, соответствующий аргументу, не обязательно должен существовать в файловой системе. Подробнее см. спецификацию JNI. В противном случае аргумент filename отображается на изображение нативной библиотеки способом, зависящим от реализации.

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

Runtime.getRuntime().load(name)

public static void loadLibrary(String libname)

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

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

Runtime.getRuntime().loadLibrary(name)

public static String mapLibraryName(String libname)