Класс System

public static final InputStream in

См. также:

• Console.charset()
• Console.reader()

public static final PrintStream out

См. также:

• PrintStream.println()
• PrintStream.println(boolean)
• PrintStream.println(char)
• PrintStream.println(char[])
• PrintStream.println(double)
• PrintStream.println(float)
• PrintStream.println(int)
• PrintStream.println(long)
• PrintStream.println(java.lang.Object)
• PrintStream.println(java.lang.String)
• stdout.encoding

public static final PrintStream err

См. также:

• stderr.encoding

public static void setIn(InputStream in)

Параметры:

in - новый стандартный поток ввода.

С:

1.1

public static void setOut(PrintStream out)

Параметры:

out - новый стандартный поток вывода

С:

1.1

public static void setErr(PrintStream err)

Параметры:

err - новый стандартный поток вывода ошибок.

С:

1.1

public static Console console()

Возвращает:

Консоль системы, если таковая имеется, в противном случае null.

С:

1.6

public static Channel inheritedChannel() throws IOException

Возвращает:

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

Исключения:

IOException - Если возникает ошибка ввода-вывода

С:

1.5

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

Параметры:

sm - игнорируется

Исключения:

UnsupportedOperationException - всегда

См. также:

• getSecurityManager()

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

Возвращает:

null

См. также:

• setSecurityManager(java.lang.SecurityManager)

public static long currentTimeMillis()

Возвращает:

разность, измеренная в миллисекундах, между текущим временем и полуночью 1 января 1970 года по UTC.

См. также:

• Date

public static long nanoTime()

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

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

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

Возвращает:

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

С:

1.5

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

Параметры:

src - исходный массив.

srcPos - начальная позиция в исходном массиве.

dest - целевой массив.

destPos - начальная позиция в целевом массиве.

length - количество элементов массива, которые должны быть скопированы.

Исключения:

IndexOutOfBoundsException - если копирование приведёт к обращению к данным за пределами границ массива.

ArrayStoreException - если элемент в массиве src не может быть сохранён в массиве dest из-за несовпадения типов.

NullPointerException - если либо src, либо dest равны null.

public static int identityHashCode(Object x)

Параметры:

x - объект, для которого нужно вычислить код хэширования

Возвращает:

код хэширования

С:

1.1

См. также:

• Object.hashCode()
• Objects.hashCode(Object)

public static Properties getProperties()

Примечание API:

Изменение стандартного системного свойства может привести к непредсказуемым результатам, если не указано иное. Значения свойств могут кэшироваться во время инициализации или при первом использовании. Установка стандартного свойства после инициализации с помощью getProperties(), setProperties(Properties), setProperty(String, String) или clearProperty(String) может не иметь желаемого эффекта.

Примечание реализации:

В дополнение к стандартным системным свойствам, системные свойства могут включать следующие ключи:

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

Ключ	Описание связанного значения
jdk.module.path	Путь модуля приложения
jdk.module.upgrade.path	Путь модуля обновления
jdk.module.main	Имя модуля начального/главного модуля
jdk.module.main.class	Имя главного класса начального модуля
file.encoding	Имя кодировки по умолчанию, по умолчанию равняется UTF-8. Свойство может быть задано в командной строке со значением UTF-8 или COMPAT. Если оно задано в командной строке со значением COMPAT, то значение заменяется значением свойства native.encoding во время запуска. Установка свойства на значение, отличное от UTF-8 или COMPAT, приводит к неопределенному поведению.

Возвращает:

системные свойства

См. также:

• setProperties(java.util.Properties)
• Properties

public static String lineSeparator()

Возвращает:

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

С момента:

1.7

public static void setProperties(Properties props)

Примечание API:

Изменение стандартного системного свойства может привести к непредсказуемым результатам, если не указано иное. Подробности см. в getProperties.

Параметры:

props - новые системные свойства.

См. также:

• getProperties()
• Properties

public static String getProperty(String key)

API Note:

Изменение стандартной системной переменной может привести к непредсказуемым результатам, если не указано иное. Подробности см. в getProperties.

Параметры:

key - имя системной переменной.

Возвращает:

строковое значение системной переменной или null, если переменной с таким ключом нет.

Исключения:

NullPointerException - если key является null.

IllegalArgumentException - если key пуста.

См. также:

• setProperty(java.lang.String, java.lang.String)
• getProperties()

public static String getProperty(String key, String def)

Параметры:

key - имя системной переменной.

def - значение по умолчанию.

Возвращает:

строковое значение системной переменной или значение по умолчанию, если переменной с таким ключом нет.

Исключения:

NullPointerException - если key является null.

IllegalArgumentException - если key пуста.

См. также:

• setProperty(java.lang.String, java.lang.String)
• getProperties()

public static String setProperty(String key, String value)

API Note:

Изменение стандартной системной переменной может привести к непредсказуемым результатам, если не указано иное. Подробности см. в getProperties.

Параметры:

key - имя системной переменной.

value - значение системной переменной.

Возвращает:

предыдущее значение системной переменной или null, если его не было.

Исключения:

NullPointerException - если key или value являются null.

IllegalArgumentException - если key пуста.

С:

1.2

См. также:

• getProperty(java.lang.String)
• getProperty(java.lang.String)
• getProperty(java.lang.String, java.lang.String)

public static String clearProperty(String key)

API Note:

Изменение стандартной системной переменной может привести к непредсказуемым результатам, если не указано иное. Подробности см. в методе getProperties.

Параметры:

key - имя системной переменной для удаления.

Возвращает:

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

Исключения:

NullPointerException - если key является null.

IllegalArgumentException - если key пуста.

С:

1.5

См. также:

• getProperty(java.lang.String)
• setProperty(java.lang.String, java.lang.String)
• Properties

public static String getenv(String name)

Параметры:

name - имя переменной среды

Возвращает:

строковое значение переменной или null, если переменная не определена в системной среде

Исключения:

NullPointerException - если name является null

См. также:

• getenv()
• ProcessBuilder.environment()

public static Map<String,String> getenv()

Возвращает:

среда как отображение имен переменных на значения

С:

1.5

См. также:

• getenv(String)
• ProcessBuilder.environment()

public static System.Logger getLogger(String name)

API Note:

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

Требования к реализации:

Экземпляры, возвращаемые этим методом, направляют сообщения в логгеры, полученные путем вызова LoggerFinder.getLogger(name, module), где module — модуль вызывающего объекта. В случаях, когда System.getLogger вызывается из контекста, где нет кадра вызывающего объекта в стеке (например, при вызове непосредственно из потока, подключенного к JNI), выбрасывается IllegalCallerException. Чтобы получить логгер в таком контексте, используйте вспомогательный класс, который будет неявно идентифицирован как вызывающий, или используйте системный LoggerFinder для получения логгера вместо этого. Обратите внимание, что в последнем случае бэкэнд ведения журнала может быть инициализирован немедленно.

Параметры:

name - имя логгера.

Возвращает:

экземпляр System.Logger, который может быть использован вызывающим классом.

Исключения:

NullPointerException - если name является null.

IllegalCallerException - если в стеке нет кадра вызова Java.

С:

9

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

Примечание API:

Этот метод предназначен для использования после полной инициализации системы. Этот метод может вызвать немедленную загрузку и инициализацию службы System.LoggerFinder, что может привести к проблемам, если Java Runtime ещё не готов к инициализации конкретной реализации службы. Системные классы, которые могут загружаться на ранней стадии запуска и нуждаются в записи локализованных сообщений, должны создавать логгер с помощью getLogger(java.lang.String) и затем использовать методы записи логов, принимающие ресурсный пул в качестве параметра.

Требования к реализации:

Возвращаемый логгер будет выполнять локализацию сообщений, как указано в LoggerFinder.getLocalizedLogger(name, bundle, module), где module — модуль вызывающего объекта. В случаях, когда System.getLogger вызывается из контекста, где на стеке нет фрейма вызывающего объекта (например, когда вызывается напрямую из нити, прикреплённой к JNI), возникает исключение IllegalCallerException. Чтобы получить логгер в таком контексте, используйте вспомогательный класс, который будет неявно идентифицироваться как вызывающий, или используйте системный LoggerFinder для получения логгера вместо этого. Обратите внимание, что последнее может привести к ранней инициализации системного механизма ведения логов.

Параметры:

name - имя логгера.

bundle - ресурсный пул.

Возвращает:

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

Исключения:

NullPointerException - если name является null или bundle является null.

IllegalCallerException - если на стеке нет фрейма Java вызывающего объекта.

С:

9

public static void exit(int status)

    Runtime.getRuntime().exit(n)

Примечание по реализации:

Инициализация последовательности завершения работы регистрируется Runtime.exit(int).

Параметры:

status - код завершения.

См. также:

• Runtime.exit(int)

public static void gc()

См. также:

• Runtime.gc()

@Deprecated(since="18", forRemoval=true) public static void runFinalization()

См. Спецификацию языка Java:

12.6 Финализация экземпляров классов

См. также:

• Runtime.runFinalization()

public static void load(String filename)

Параметры:

filename - файл для загрузки.

Исключения:

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

NullPointerException - если filename является null

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

Внешние спецификации

• Спецификация Java Native Interface

См. также:

• Runtime.load(java.lang.String)^{ОГРАНИЧЕННЫЙ}

public static void loadLibrary(String libname)

Параметры:

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

Исключения:

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

NullPointerException - если libname является null

IllegalCallerException - если вызывающий модуль не имеет включенного доступа к системным библиотекам.

Внешние Спецификации

• Спецификация Java Native Interface

См. также:

• Runtime.loadLibrary(java.lang.String)^{ОГРАНИЧЕННО}

public static String mapLibraryName(String libname)

Параметры:

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

Возвращает:

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

Исключения:

NullPointerException - если libname является null

С:

1.2

См. также:

• loadLibrary(java.lang.String)^{ОГРАНИЧЕННО}
• ClassLoader.findLibrary(java.lang.String)