Пакет javax.tools

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

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

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

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

Нет требования наличия компилятора во время выполнения. Однако, если предоставляется компилятор по умолчанию, его можно найти с помощью 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();