Интерфейс Tool
- Все известные подинтерфейсы:
DocumentationTool, JavaCompiler
public interface Tool
Общий интерфейс для инструментов, которые можно вызывать из программы. Традиционно инструмент — это программа командной строки, например компилятор. Набор инструментов, доступных на платформе, определяется поставщиком.
Инструменты можно найти с помощью ServiceLoader.load(Class).
- Начиная с версии:
- 1.6
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
Set |
getSourceVersions() |
Возвращает версии исходного кода языка программирования Java, поддерживаемые этим инструментом. |
default String |
name() |
Возвращает имя этого инструмента или пустую строку, если имя не задано. |
int |
run |
Запускает инструмент с указанными каналами ввода-вывода и аргументами. |
Подробное описание методов
name
default String name()
Возвращает имя этого инструмента или пустую строку, если имя не задано.
- Примечание к API:
- Рекомендуется, чтобы имя совпадало с тем, которое используется в командной строке: например, "javac", "jar", "jlink".
- Примечание к реализации:
- Эта реализация возвращает пустую строку.
- Возвращает:
- имя этого инструмента
- Начиная с версии:
- 9
run
int run(InputStream in, OutputStream out, OutputStream err, String... arguments)
Запускает инструмент с указанными каналами ввода-вывода и аргументами. По соглашению инструмент возвращает 0 при успешном выполнении и ненулевое значение при ошибке. Все созданные диагностические сообщения записываются либо в
out, либо в err в формате, который не определён спецификацией.- Параметры:
-
in— «стандартный» ввод; если значение равно null, используется System.in -
out— «стандартный» вывод; если значение равно null, используется System.out -
err— «стандартный» поток ошибок; если значение равно null, используется System.err -
arguments— аргументы, передаваемые инструменту - Возвращает:
- 0 при успешном выполнении; в противном случае — ненулевое значение
- Вызывает:
-
NullPointerException— если массив аргументов содержит элементыnull.
getSourceVersions
Set<SourceVersion> getSourceVersions()
Возвращает версии исходного кода языка программирования Java, поддерживаемые этим инструментом.
- Возвращает:
- набор поддерживаемых версий исходного кода
© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.compiler/javax/tools/Tool.html
