Пакет javax.tools

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

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

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

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

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

JavaCompiler compiler = ToolProvider.getSystemJavaCompiler();

Возможно предоставить альтернативные компиляторы или инструменты через механизм поставщиков сервисов service provider mechanism.

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

com.vendor.VendorJavaCompiler

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

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