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