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

Все известные реализующие классы:: DocumentationTool.Location, StandardLocation

Включающий интерфейс:: JavaFileManager

public static interface JavaFileManager.Location

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

В неформальном смысле Location соответствует «пути поиска», например пути классов или пути модулей, используемому инструментами командной строки, работающими с файловой системой по умолчанию.

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

Получить доступ к классам в расположении, ориентированном на пакеты, можно с помощью таких методов, как JavaFileManager.getJavaFileForInput(JavaFileManager.Location, String, JavaFileObject.Kind) или JavaFileManager.list(JavaFileManager.Location, String, Set, boolean). Непосредственно перечислить классы в расположении, ориентированном на модули, нельзя. Вместо этого можно получить расположение, ориентированное на пакеты, для конкретного модуля с помощью таких методов, как JavaFileManager.getLocationForModule(JavaFileManager.Location, String) или JavaFileManager.listLocationsForModules(JavaFileManager.Location).

С момента появления:: 1.6

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

Модификатор и тип	Метод	Описание
`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, 2025, 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/25/docs/api/java.compiler/javax/tools/JavaFileManager.Location.html