Класс System

public static final InputStream in

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

Обычно для чтения символьных данных объект, обрабатывающий кодировку символов, оборачивает System.in. После этого последующее чтение следует выполнять только через объект-обёртку; дальнейшая работа непосредственно с System.in приводит к неопределённому поведению.

Ниже приведены два распространённых примера. С использованием InputStreamReader:

    new InputStreamReader(System.in, System.getProperty("stdin.encoding"));

Или с использованием Scanner:

    new Scanner(System.in, System.getProperty("stdin.encoding"));

Для обработки интерактивного ввода рассмотрите возможность использования Console.

См. также:

• Console
• stdin.encoding

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(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 — объект, для которого вычисляется hashCode

Возвращает:

значение hashCode

Начиная с версии:

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

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

Параметры:

key — имя системного свойства.

Возвращает:

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

Выбрасывает:

NullPointerException — если key равен null.

IllegalArgumentException — если key пуст.

См. также:

• setProperty(String, String)
• getProperties()

public static String getProperty(String key, String def)

Параметры:

key — имя системного свойства.

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

Возвращает:

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

Выбрасывает:

NullPointerException — если key равен null.

IllegalArgumentException — если key пуст.

См. также:

• setProperty(String, String)
• getProperties()

public static String setProperty(String key, String value)

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

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

Параметры:

key — имя системного свойства.

value — значение системного свойства.

Возвращает:

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

Вызывает:

NullPointerException — если key или value равно null.

IllegalArgumentException — если key пусто.

С версии:

1.2

См. также:

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

public static String clearProperty(String key)

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

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

Параметры:

key — имя удаляемого системного свойства.

Возвращает:

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

Вызывает:

NullPointerException — если key равно null.

IllegalArgumentException — если key пусто.

С версии:

1.5

См. также:

• getProperty(String)
• setProperty(String, 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:

Этот метод может отложить вызов метода 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 ещё не готова к инициализации конкретной реализации службы. Системным классам, которые могут быть загружены на раннем этапе загрузки и которым необходимо записывать локализованные сообщения, следует создавать регистратор с помощью 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 — если имя файла не является абсолютным путём, собственная библиотека не связана с виртуальной машиной статически или библиотека не может быть сопоставлена с образом собственной библиотеки средствами хост-системы.

NullPointerException — если filename равно null

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

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

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

См. также:

• Runtime.load(java.lang.String)^RESTRICTED

public static void loadLibrary(String libname)

Параметры:

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

Вызывает:

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

NullPointerException — если libname равно null

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

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

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

См. также:

• Runtime.loadLibrary(java.lang.String)^RESTRICTED

public static String mapLibraryName(String libname)

Параметры:

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

Возвращает:

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

Вызывает:

NullPointerException — если libname равно null

С версии:

1.2

См. также:

• loadLibrary(java.lang.String)^RESTRICTED
• ClassLoader.findLibrary(java.lang.String)