Пакет javax.tools

Эти интерфейсы и классы входят в состав Java Platform, Standard Edition (Java SE), однако предоставлять какие-либо инструменты, реализующие их, не требуется.

Если это явно не разрешено, все методы в этом пакете могут выбрасывать NullPointerException, если им передан аргумент null или если им передан список или коллекция, содержащие элементы null. Аналогично, ни один метод не может возвращать null, если это явно не разрешено.

В этом пакете находится платформа компилятора языка программирования Java. Она позволяет клиентам находить и запускать компиляторы из программ. Платформа также предоставляет интерфейсы поставщиков служб (SPI) для структурированного доступа к диагностическим сообщениям (DiagnosticListener), а также абстракцию файлов для переопределения доступа к файлам (JavaFileManager и JavaFileObject). Дополнительные сведения об использовании SPI см. в разделе JavaCompiler.

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

JavaCompiler compiler = ToolProvider.getSystemJavaCompiler();

Альтернативные компиляторы или инструменты можно предоставлять с помощью механизма поставщиков служб.

Например, если com.vendor.VendorJavaCompiler является поставщиком инструмента JavaCompiler, его JAR-файл будет содержать файл META-INF/services/javax.tools.JavaCompiler. Этот файл будет содержать единственную строку:

com.vendor.VendorJavaCompiler

Если JAR-файл находится в пути к классам, VendorJavaCompiler можно найти с помощью такого кода:

JavaCompiler compiler = ServiceLoader.load(JavaCompiler.class).iterator().next();