Модуль jdk.zipfs

Предоставляет реализацию поставщика файловой системы ZIP. Поставщик файловой системы ZIP рассматривает содержимое файла ZIP или JAR как файловую систему.

Доступ к файловой системе ZIP

Методы статического фабричного класса FileSystems newFileSystem могут использоваться для:

• Создание файловой системы ZIP
• Открытие существующего файла как файловой системы ZIP

Поставщик файловой системы ZIP не поддерживает открытие существующего файла ZIP, содержащего записи с именами "." или ".." в своих элементах.

Схема URI для идентификации файловой системы ZIP

Схема URI scheme, идентифицирующая файловую систему ZIP, равна jar.

Атрибуты файлов POSIX

Файловая система ZIP поддерживает атрибут файла view с именем "zip", определяющий следующий атрибут файла:

Поддерживаемые атрибуты

Имя	Тип
permissions	Set<PosixFilePermission>

Атрибут "permissions" представляет собой набор разрешений доступа, которые могут храниться для записей в файле ZIP. Значение атрибута равно null для записей, не имеющих разрешений доступа. Файловые системы ZIP не проверяют разрешения доступа.

Атрибут "permissions" может быть прочитан и задан с помощью методов Files.getAttribute и Files.setAttribute. Следующий пример использует эти методы для чтения и задания атрибута:

 
     Set<PosixFilePermission> perms = Files.getAttribute(entry, "zip:permissions");
     if (perms == null) {
         perms = PosixFilePermissions.fromString("rw-rw-rw-");
         Files.setAttribute(entry, "zip:permissions", perms);
     }
  

В дополнение к представлению "zip", файловая система ZIP необязательно поддерживает PosixFileAttributeView ("posix"). Это представление расширяет представление "basic" с помощью безопасного по типу доступа к атрибутам owner, group-owner и permissions. Представление "posix" поддерживается только в том случае, если файловая система ZIP создается со свойством поставщика "enablePosixFileAttributes", установленным в "true". Следующий пример создает файловую систему с этим свойством и считывает разрешения доступа файла:

 
     var env = Map.of("enablePosixFileAttributes", "true");
     try (FileSystem fs = FileSystems.newFileSystem(file, env) {
         Path entry = fs.getPath("entry");
         Set<PosixFilePermission> perms = Files.getPosixFilePermissions(entry);
     }
  

Атрибуты владельца файла и владельца группы не сохраняются, что означает, что они не хранятся в файле zip. Свойства поставщика "defaultOwner" и "defaultGroup" (перечислены ниже) могут использоваться для настройки значений по умолчанию для этих атрибутов. Если эти свойства не установлены, владелец файла по умолчанию устанавливается как владелец файла zip, а владелец группы по умолчанию устанавливается как владелец группы файла zip (или владелец файла на платформах, не поддерживающих владельца группы).

Атрибут "permissions" является не обязательным в представлении "posix", поэтому для записей, не имеющих разрешений доступа, хранящихся в файле ZIP, используется набор разрешений по умолчанию. Набор разрешений по умолчанию

• OWNER_READ
• OWNER_WRITE
• GROUP_READ

Разрешения по умолчанию могут быть настроены с помощью свойства "defaultPermissions", описанного ниже.

Свойства файловой системы ZIP

При создании файловой системы ZIP могут быть указаны следующие свойства:

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

Имя свойства	Тип данных	Значение по умолчанию	Описание
create	String или Boolean	false	Если значение равно true, поставщик файловой системы ZIP создает новый файл ZIP или JAR, если он не существует.
encoding	String	UTF-8	Значение указывает схему кодирования для имен записей в файле ZIP или JAR.
enablePosixFileAttributes	String или Boolean	false	Если значение равно true, файловая система ZIP будет поддерживать PosixFileAttributeView.
defaultOwner	UserPrincipal или String	null/unset	Переопределить владельца по умолчанию для записей в файловой системе ZIP. Значение может быть UserPrincipal или строковое значение, используемое как имя UserPrincipal.
defaultGroup	GroupPrincipal или String	null/unset	Переопределить группу по умолчанию для записей в файловой системе ZIP. Значение может быть GroupPrincipal или строковое значение, используемое как имя GroupPrincipal.
defaultPermissions	Set<PosixFilePermission> или String	null/unset	Переопределить набор разрешений по умолчанию для записей в файловой системе ZIP. Значение может быть Set<PosixFilePermission> или строкой, которая анализируется функцией PosixFilePermissions::fromString
compressionMethod	String	"DEFLATED"	Значение, представляющее метод сжатия, используемый при записи записей в файловую систему ZIP. Если значение равно "STORED", поставщик файловой системы ZIP не будет сжимать записи при записи в файловую систему ZIP. Если значение равно "DEFLATED" или свойство не установлено, поставщик файловой системы ZIP будет использовать сжатие данных при записи записей в файловую систему ZIP. Если значение не равно "STORED" или "DEFLATED", при создании файловой системы ZIP будет брошено IllegalArgumentException.
releaseVersion	String или Integer	null/unset	Значение, представляющее используемую запись версии при доступе к многоверсионным JAR. Если JAR не является многоверсионным JAR, значение будет проигнорировано, и JAR будет считаться неверсионным. Значение должно быть либо строкой "runtime", либо представлять допустимый номер версии Java SE Platform version number, например, 9 или 14, для определения записи версии. Если значение равно null или свойство не установлено, то JAR будет рассматриваться как JAR без версии. Если значение равно "runtime", запись версии будет определяться путем вызова Runtime.Version.feature(). Если значение не представляет допустимый номер версии Java SE Platform version number, будет брошено IllegalArgumentException.

Примеры:

Создайте новую файловую систему ZIP, идентифицированную URI. Если файл ZIP не существует, он будет создан:

 

     URI uri = URI.create("jar:file:/home/luckydog/tennisTeam.zip");
     Map<String, String> env = Map.of("create", "true");
     FileSystem zipfs = FileSystems.newFileSystem(uri, env);
 
 

Создайте новую файловую систему ZIP, указав путь и используя автоматическое определение типа файла. Переберите содержимое JAR, начиная с корневого каталога, отображая каждую найденную запись:

 

     FileSystem zipfs = FileSystems.newFileSystem(Path.of("helloworld.jar"));
     Path rootDir = zipfs.getPath("/");
     Files.walk(rootDir)
            .forEach(System.out::println);