Интерфейс 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, 2023, 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/21/docs/api/java.compiler/javax/tools/JavaFileManager.Location.html