Класс System

public static final InputStream in

Стандартный поток ввода. Этот поток уже открыт и готов к предоставлению входных данных. Как правило, этот поток соответствует вводу с клавиатуры или другому источнику ввода, указанному средой хоста или пользователем. В случае, если этот поток обернут в InputStreamReader, для кодировки следует использовать Console.charset(), или рассмотрите использование Console.reader().

public static final PrintStream out

Стандартный поток вывода. Этот поток уже открыт и готов принимать выходные данные. Обычно этот поток соответствует выводу на дисплей или другому месту назначения вывода, указанному средой хоста или пользователем. Кодировка, используемая при преобразовании символов в байты, эквивалентна Console.charset(), если Console существует, в противном случае Charset.defaultCharset().

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

     System.out.println(data)
 

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

public static final PrintStream err

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

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

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()

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

public static Channel inheritedChannel() throws IOException

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

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

@Deprecated(since="17", forRemoval=true) public static void setSecurityManager(SecurityManager sm)

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

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

@Deprecated(since="17", forRemoval=true) public static SecurityManager getSecurityManager()

Gets the system-wide security manager.

public static long currentTimeMillis()

Returns the current time in milliseconds. Note that while the unit of time of the return value is a millisecond, the granularity of the value depends on the underlying operating system and may be larger. For example, many operating systems measure time in units of tens of milliseconds.

See the description of the class Date for a discussion of slight discrepancies that may arise between "computer time" and coordinated universal time (UTC).

public static long nanoTime()

Returns the current value of the running Java Virtual Machine's high-resolution time source, in nanoseconds. This method can only be used to measure elapsed time and is not related to any other notion of system or wall-clock time. The value returned represents nanoseconds since some fixed but arbitrary origin time (perhaps in the future, so values may be negative). The same origin is used by all invocations of this method in an instance of a Java virtual machine; other virtual machine instances are likely to use a different origin.

This method provides nanosecond precision, but not necessarily nanosecond resolution (that is, how frequently the value changes) - no guarantees are made except that the resolution is at least as good as that of currentTimeMillis().

Differences in successive calls that span greater than approximately 292 years (2⁶³ nanoseconds) will not correctly compute elapsed time due to numerical overflow.

The values returned by this method become meaningful only when the difference between two such values, obtained within the same instance of a Java virtual machine, is computed.

For example, to measure how long some code takes to execute:

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

To compare elapsed time against a timeout, use

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

instead of

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

because of the possibility of numerical overflow.

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

Copies an array from the specified source array, beginning at the specified position, to the specified position of the destination array. A subsequence of array components are copied from the source array referenced by src to the destination array referenced by dest. The number of components copied is equal to the length argument. The components at positions srcPos through srcPos+length-1 in the source array are copied into positions destPos through destPos+length-1, respectively, of the destination array.

If the src and dest arguments refer to the same array object, then the copying is performed as if the components at positions srcPos through srcPos+length-1 were first copied to a temporary array with length components and then the contents of the temporary array were copied into positions destPos through destPos+length-1 of the destination array.

If dest is null, then a NullPointerException is thrown.

If src is null, then a NullPointerException is thrown and the destination array is not modified.

Otherwise, if any of the following is true, an ArrayStoreException is thrown and the destination is not modified:

• The src argument refers to an object that is not an array.
• The dest argument refers to an object that is not an array.
• The src argument and dest argument refer to arrays whose component types are different primitive types.
• The src argument refers to an array with a primitive component type and the dest argument refers to an array with a reference component type.
• The src argument refers to an array with a reference component type and the dest argument refers to an array with a primitive component type.

Otherwise, if any of the following is true, an IndexOutOfBoundsException is thrown and the destination is not modified:

• The srcPos argument is negative.
• The destPos argument is negative.
• The length argument is negative.
• srcPos+length is greater than src.length, the length of the source array.
• destPos+length is greater than dest.length, the length of the destination array.

Otherwise, if any actual component of the source array from position srcPos through srcPos+length-1 cannot be converted to the component type of the destination array by assignment conversion, an ArrayStoreException is thrown. In this case, let k be the smallest nonnegative integer less than length such that src[srcPos+k] cannot be converted to the component type of the destination array; when the exception is thrown, source array components from positions srcPos through srcPos+k-1 will already have been copied to destination array positions destPos through destPos+k-1 and no other positions of the destination array will have been modified. (Because of the restrictions already itemized, this paragraph effectively applies only to the situation where both arrays have component types that are reference types.)

public static int identityHashCode(Object x)

Returns the same hash code for the given object as would be returned by the default method hashCode(), whether or not the given object's class overrides hashCode(). The hash code for the null reference is zero.

public static Properties getProperties()

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

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

Показывает ключи свойств и соответствующие значения

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

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

Обратите внимание, что даже если менеджер безопасности не разрешает операцию 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 System.Logger getLogger(String name)

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

public static System.Logger getLogger(String name, ResourceBundle bundle)

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

public static void exit(int status)

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

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

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

 Runtime.getRuntime().exit(n)
 

public static void gc()

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

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

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

 Runtime.getRuntime().gc()
 

public static void runFinalization()

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

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

 Runtime.getRuntime().runFinalization()
 

public static void load(String filename)

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

public static void loadLibrary(String libname)

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

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

 Runtime.getRuntime().loadLibrary(name)
 

public static String mapLibraryName(String libname)

Преобразует имя библиотеки в платформозависимую строку, представляющую нативную библиотеку.