Пакет javax.tools

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

Эти интерфейсы и классы являются обязательными компонентами платформы 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();