Пакет 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();