Класс 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

См. также:

• Console

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

Возвращает:

хеш-код

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

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

См. также:

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

public static void loadLibrary(String libname)

Параметры:

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

Вызывает:

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

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

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

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

• Спецификация интерфейса Java Native

См. также:

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