Интерфейс JavaFileManager.Location

Все известные классы-реализации:: DocumentationTool.Location, StandardLocation

Вложенный интерфейс:: JavaFileManager

public static interface JavaFileManager.Location

Интерфейс для расположения объектов файлов. Используется менеджерами файлов для определения места размещения или поиска объектов файлов.

Неформально, Location соответствует "пути поиска", такому как путь к классам или путь к модулю, используемый инструментами командной строки, использующими стандартную файловую систему.

Некоторые расположения обычно используются для определения места, где инструмент может найти файлы для чтения; другие обычно используются для определения места, где инструмент может записывать файлы. Если расположение используется для определения места для чтения файлов, эти файлы могут быть организованы в простой иерархии пакет/класс: такие расположения описываются как ориентированные на пакеты. В противном случае файлы могут быть организованы в иерархии модуль/пакет/класс: такие расположения описываются как ориентированные на модули. Если расположение обычно используется для определения места, где инструмент может записывать файлы, инструмент, который записывает файлы, должен указать, как эти файлы будут организованы.

Вы можете получить доступ к классам в расположении, ориентированном на пакеты, используя методы, такие как JavaFileManager.getJavaFileForInput(javax.tools.JavaFileManager.Location, java.lang.String, javax.tools.JavaFileObject.Kind) или JavaFileManager.list(javax.tools.JavaFileManager.Location, java.lang.String, java.util.Set<javax.tools.JavaFileObject.Kind>, boolean). Невозможно напрямую перечислить классы в расположении, ориентированном на модули. Вместо этого вы можете получить расположение, ориентированное на пакеты, для любого конкретного модуля, используя методы, такие как JavaFileManager.getLocationForModule(javax.tools.JavaFileManager.Location, java.lang.String) или JavaFileManager.listLocationsForModules(javax.tools.JavaFileManager.Location).

Краткое описание методов

Модификатор и тип	Метод	Описание
`String`	`getName()`	Возвращает имя данного расположения.
`default boolean`	`isModuleOrientedLocation()`	Указывает, является ли это расположение ориентированным на модули и, следовательно, ожидается, что оно будет содержать классы в иерархии модуль/пакет/класс, в отличие от расположения, ориентированного на пакеты, которое ожидается, что оно будет содержать классы в иерархии пакет/класс.
`boolean`	`isOutputLocation()`	Определяет, является ли это расположение расположением вывода.

Подробное описание методов

getName

String getName()

Возвращает имя данного расположения.

Возвращает:: имя

isOutputLocation

boolean isOutputLocation()

Определяет, является ли это расположение расположением вывода. Расположение вывода — это расположение, которое обычно используется для вывода.

Примечание API:: Расположение вывода может быть использовано для записи файлов в организации, ориентированной на пакеты, или в организации, ориентированной на модули.
Возвращает:: true, если это расположение вывода, false в противном случае

isModuleOrientedLocation

default boolean isModuleOrientedLocation()

Указывает, является ли это расположение ориентированным на модули и, следовательно, ожидается, что оно будет содержать классы в иерархии модуль/пакет/класс, в отличие от расположения, ориентированного на пакеты, которое ожидается, что оно будет содержать классы в иерархии пакет/класс. Результат этого метода не определен, если это расположение вывода.

Примечание о реализации:: Эта реализация возвращает true, если имя включает слово "MODULE".
Возвращает:: true, если это расположение ожидается, что оно будет содержать модули
С:: 9

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.compiler/javax/tools/JavaFileManager.Location.html