Module org.cryptomator.cryptofs

Package org.cryptomator.cryptofs

Class CryptoFileSystemProvider

java.lang.Object

java.nio.file.spi.FileSystemProvider

org.cryptomator.cryptofs.CryptoFileSystemProvider

public class CryptoFileSystemProvider
extends FileSystemProvider

A FileSystemProvider for CryptoFileSystems.

All FileSystem instances created by CryptoFileSystemProvider are instances of CryptoFileSystem. Usage

It is recommended to use newFileSystem(Path, CryptoFileSystemProperties) to create a CryptoFileSystem. To do this:

 Path storageLocation = Paths.get("/home/cryptobot/vault");
 FileSystem fileSystem = CryptoFileSystemProvider.newFileSystem(
        storageLocation,
    cryptoFileSystemProperties()
                .withPassword("password")
                .withFlags(FileSystemFlags.READONLY)
                .build());
 

Afterwards you can use the created FileSystem to create paths, do directory listings, create files and so on.

To create a new FileSystem from a URI using FileSystems.newFileSystem(URI, Map) you may have a look at CryptoFileSystemUri.

See Also:

• CryptoFileSystemUri
• CryptoFileSystemProperties
• FileSystems
• FileSystem

Constructor Summary

Constructors

Constructor	Description
CryptoFileSystemProvider()

Method Summary

Modifier and Type	Method	Description
void	checkAccess(Path cleartextPath, AccessMode... modes)
static DirStructure	checkDirStructureForVault(Path pathToAssumedVault, String vaultConfigFilename, String masterkeyFilename)	Delegate to DirStructure.checkDirStructure(Path, String, String).
void	copy(Path cleartextSource, Path cleartextTarget, CopyOption... options)
void	createDirectory(Path cleartextDir, FileAttribute<?>... attrs)
void	createSymbolicLink(Path cleartextPath, Path target, FileAttribute<?>... attrs)
void	delete(Path cleartextPath)
<V extends FileAttributeView> V	getFileAttributeView(Path cleartextPath, Class<V> type, LinkOption... options)
FileStore	getFileStore(Path cleartextPath)
CryptoFileSystem	getFileSystem(URI uri)
Path	getPath(URI uri)
String	getScheme()
static void	initialize(Path pathToVault, CryptoFileSystemProperties properties, URI keyId)	Creates a new vault at the given directory path.
boolean	isHidden(Path cleartextPath)
boolean	isSameFile(Path cleartextPath, Path cleartextPath2)
void	move(Path cleartextSource, Path cleartextTarget, CopyOption... options)
AsynchronousFileChannel	newAsynchronousFileChannel(Path cleartextPath, Set<? extends OpenOption> options, ExecutorService executor, FileAttribute<?>... attrs)
SeekableByteChannel	newByteChannel(Path cleartextPath, Set<? extends OpenOption> options, FileAttribute<?>... attrs)
DirectoryStream<Path>	newDirectoryStream(Path cleartextDir, DirectoryStream.Filter<? super Path> filter)
FileChannel	newFileChannel(Path cleartextPath, Set<? extends OpenOption> optionsSet, FileAttribute<?>... attrs)
CryptoFileSystem	newFileSystem(URI uri, Map<String,?> rawProperties)
static CryptoFileSystem	newFileSystem(Path pathToVault, CryptoFileSystemProperties properties)	Typesafe alternative to FileSystems.newFileSystem(URI, Map).
<A extends BasicFileAttributes> A	readAttributes(Path cleartextPath, Class<A> type, LinkOption... options)
Map<String,Object>	readAttributes(Path cleartextPath, String attributes, LinkOption... options)
Path	readSymbolicLink(Path cleartextPath)
void	setAttribute(Path cleartextPath, String attribute, Object value, LinkOption... options)

Methods inherited from class java.nio.file.spi.FileSystemProvider

createLink, deleteIfExists, installedProviders, newFileSystem, newInputStream, newOutputStream

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

CryptoFileSystemProvider

public CryptoFileSystemProvider()

Method Details

newFileSystem

public static CryptoFileSystem newFileSystem(Path pathToVault,
 CryptoFileSystemProperties properties)
                                      throws FileSystemNeedsMigrationException,
IOException,
org.cryptomator.cryptolib.api.MasterkeyLoadingFailedException

Typesafe alternative to FileSystems.newFileSystem(URI, Map). Default way to retrieve a CryptoFS instance.

Parameters:

pathToVault - Path to this vault's storage location

properties - Parameters used during initialization of the file system

Returns:

a new file system

Throws:

FileSystemNeedsMigrationException - if the vault format needs to get updated and properties did not contain a flag for implicit migration.

FileSystemCapabilityChecker.MissingCapabilityException - If the underlying filesystem lacks features required to store a vault

IOException - if an I/O error occurs creating the file system

org.cryptomator.cryptolib.api.MasterkeyLoadingFailedException - if the masterkey for this vault could not be loaded

initialize

public static void initialize(Path pathToVault,
 CryptoFileSystemProperties properties,
 URI keyId)
                       throws NotDirectoryException,
IOException,
org.cryptomator.cryptolib.api.MasterkeyLoadingFailedException

Creates a new vault at the given directory path.

Parameters:

pathToVault - Path to an existing directory

properties - Parameters to use when writing the vault configuration

keyId - ID of the master key to use for this vault

Throws:

NotDirectoryException - If the given path is not an existing directory.

IOException - If the vault structure could not be initialized due to I/O errors

org.cryptomator.cryptolib.api.MasterkeyLoadingFailedException - If thrown by the supplied keyLoader

Since:

2.0.0

checkDirStructureForVault

public static DirStructure checkDirStructureForVault(Path pathToAssumedVault,
 String vaultConfigFilename,
 String masterkeyFilename)
                                              throws IOException

Delegate to DirStructure.checkDirStructure(Path, String, String).

Parameters:

pathToAssumedVault -

vaultConfigFilename -

masterkeyFilename -

Returns:

a DirStructure object

Throws:

IOException

Since:

2.0.0

getScheme

public String getScheme()

Specified by:

getScheme in class FileSystemProvider

newFileSystem

public CryptoFileSystem newFileSystem(URI uri,
 Map<String,?> rawProperties)
                               throws IOException,
org.cryptomator.cryptolib.api.MasterkeyLoadingFailedException

Specified by:

newFileSystem in class FileSystemProvider

Throws:

IOException

org.cryptomator.cryptolib.api.MasterkeyLoadingFailedException

getFileSystem

public CryptoFileSystem getFileSystem(URI uri)

Specified by:

getFileSystem in class FileSystemProvider

getPath

public Path getPath(URI uri)

Specified by:

getPath in class FileSystemProvider

newAsynchronousFileChannel

public AsynchronousFileChannel newAsynchronousFileChannel(Path cleartextPath,
 Set<? extends OpenOption> options,
 ExecutorService executor,
 FileAttribute<?>... attrs)
                                                   throws IOException

Overrides:

newAsynchronousFileChannel in class FileSystemProvider

Throws:

IOException

newFileChannel

public FileChannel newFileChannel(Path cleartextPath,
 Set<? extends OpenOption> optionsSet,
 FileAttribute<?>... attrs)
                           throws IOException

Overrides:

newFileChannel in class FileSystemProvider

Throws:

IOException

newByteChannel

public SeekableByteChannel newByteChannel(Path cleartextPath,
 Set<? extends OpenOption> options,
 FileAttribute<?>... attrs)
                                   throws IOException

Specified by:

newByteChannel in class FileSystemProvider

Throws:

IOException

newDirectoryStream

public DirectoryStream<Path> newDirectoryStream(Path cleartextDir,
 DirectoryStream.Filter<? super Path> filter)
                                         throws IOException

Specified by:

newDirectoryStream in class FileSystemProvider

Throws:

IOException

createDirectory

public void createDirectory(Path cleartextDir,
 FileAttribute<?>... attrs)
                     throws IOException

Specified by:

createDirectory in class FileSystemProvider

Throws:

IOException

delete

public void delete(Path cleartextPath)
            throws IOException

Specified by:

delete in class FileSystemProvider

Throws:

IOException

copy

public void copy(Path cleartextSource,
 Path cleartextTarget,
 CopyOption... options)
          throws IOException

Specified by:

copy in class FileSystemProvider

Throws:

IOException

move

public void move(Path cleartextSource,
 Path cleartextTarget,
 CopyOption... options)
          throws IOException

Specified by:

move in class FileSystemProvider

Throws:

IOException

isSameFile

public boolean isSameFile(Path cleartextPath,
 Path cleartextPath2)
                   throws IOException

Specified by:

isSameFile in class FileSystemProvider

Throws:

IOException

isHidden

public boolean isHidden(Path cleartextPath)
                 throws IOException

Specified by:

isHidden in class FileSystemProvider

Throws:

IOException

getFileStore

public FileStore getFileStore(Path cleartextPath)

Specified by:

getFileStore in class FileSystemProvider

checkAccess

public void checkAccess(Path cleartextPath,
 AccessMode... modes)
                 throws IOException

Specified by:

checkAccess in class FileSystemProvider

Throws:

IOException

createSymbolicLink

public void createSymbolicLink(Path cleartextPath,
 Path target,
 FileAttribute<?>... attrs)
                        throws IOException

Overrides:

createSymbolicLink in class FileSystemProvider

Throws:

IOException

readSymbolicLink

public Path readSymbolicLink(Path cleartextPath)
                      throws IOException

Overrides:

readSymbolicLink in class FileSystemProvider

Throws:

IOException

getFileAttributeView

public <V extends FileAttributeView> V getFileAttributeView(Path cleartextPath,
 Class<V> type,
 LinkOption... options)

Specified by:

getFileAttributeView in class FileSystemProvider

readAttributes

public <A extends BasicFileAttributes> A readAttributes(Path cleartextPath,
 Class<A> type,
 LinkOption... options)
                                                 throws IOException

Specified by:

readAttributes in class FileSystemProvider

Throws:

IOException

readAttributes

public Map<String,Object> readAttributes(Path cleartextPath,
 String attributes,
 LinkOption... options)
                                  throws IOException

Specified by:

readAttributes in class FileSystemProvider

Throws:

IOException

setAttribute

public void setAttribute(Path cleartextPath,
 String attribute,
 Object value,
 LinkOption... options)
                  throws IOException

Specified by:

setAttribute in class FileSystemProvider

Throws:

IOException