ch.pontius.nio.smb

Class SMBFileSystemProvider

java.lang.Object

java.nio.file.spi.FileSystemProvider

ch.pontius.nio.smb.SMBFileSystemProvider

public final class SMBFileSystemProvider
extends FileSystemProvider

This class acts as a service-provider class for SMB/CIFS based file systems. Internally, it uses jCIFS to provide all the file access functionality.

Since:

1.0

Version:

1.1

Author:

Ralph Gasser

Constructor Summary

Constructors

Constructor and Description
SMBFileSystemProvider() Default constructor for SMBFileSystemProvider.

Method Summary

Modifier and Type	Method and Description
void	checkAccess(Path path, AccessMode... modes) Checks access to file under the provided SMBPath.
void	copy(Path source, Path target, CopyOption... options) Copies the file under provided source SMBPath to the destination SMBPath.
void	createDirectory(Path dir, FileAttribute<?>... attrs) Creates a directory under the provided SMBPath
void	delete(Path path) Deletes the file under the provided SMBPath
<V extends FileAttributeView> V	getFileAttributeView(Path path, Class<V> type, LinkOption... options) Reads the file attributes view of the file under the provided SMBPath and returns it.
FileStore	getFileStore(Path path)
SMBFileSystem	getFileSystem(URI uri) Retrieves a SMBFileSystem instance for the provided URI from fileSystemCache and returns it.
SMBPath	getPath(URI uri) Converts the provided URI to an SMBPath instance and returns it.
String	getScheme() Returns the default scheme for SMBFileSystemProvider.
boolean	isHidden(Path path) Returns true, if the resource specified by the provided SMBPath instance is hidden..
boolean	isSameFile(Path path1, Path path2) Returns true, if the resources specified by the two SMBPath instance are the same.
void	move(Path source, Path target, CopyOption... options) Moves the file under the provided source SMBPath to the destination SMBPath.
SeekableByteChannel	newByteChannel(Path path, Set<? extends OpenOption> options, FileAttribute<?>... attrs) Creates and returns a new SeekableSMBByteChannel instance.
DirectoryStream<Path>	newDirectoryStream(Path dir, DirectoryStream.Filter<? super Path> filter) Creates and returns a new SMBDirectoryStream for the specified path.
SMBFileSystem	newFileSystem(URI uri, Map<String,?> env) Creates a new SMBFileSystem instance for the provided URI.
<A extends BasicFileAttributes> A	readAttributes(Path path, Class<A> type, LinkOption... options) Reads the file attributes of the file under the provided SMBPath and returns it.
Map<String,Object>	readAttributes(Path path, String attributes, LinkOption... options)
void	setAttribute(Path path, String attribute, Object value, LinkOption... options)

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

createLink, createSymbolicLink, deleteIfExists, installedProviders, newAsynchronousFileChannel, newFileChannel, newFileSystem, newInputStream, newOutputStream, readSymbolicLink

Methods inherited from class java.lang.Object

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

Constructor Detail

SMBFileSystemProvider

public SMBFileSystemProvider()

Default constructor for SMBFileSystemProvider.

Method Detail

getScheme

public String getScheme()

Returns the default scheme for SMBFileSystemProvider.

Specified by:

getScheme in class FileSystemProvider

Returns:

URI Scheme - 'smb'

newFileSystem

public SMBFileSystem newFileSystem(URI uri,
                                   Map<String,?> env)

Creates a new SMBFileSystem instance for the provided URI. SMBFileSystem instances are cached based on the authority part of the URI (i.e. URI's with the same authority share the same SMBFileSystem instance). Credentials for connecting with the SMB/CIFS server can be provided in several ways:

1. Encode in the URI, e.g. smb://WORKGROUP;admin:1234@192.168.1.10
2. Provide in the env Map. To do so, you have to set the keys 'workgroup', 'username' and 'password'.
3. Provide in the jCIFS config. See jCIFS documentation for more information.

The above options will be considered according to precedence. That is, if the credentials are encoded in the URI those provided in the env map or the jCIFS config will be ignored.

Specified by:

newFileSystem in class FileSystemProvider

Parameters:

uri - URI for which to create SMBFileSystem

env - Map containing configuration parameters.

Returns:

Newly created SMBFileSystem instance

Throws:

FileSystemAlreadyExistsException - If an instance of SMBFileSystem already exists for provided URI.

IllegalArgumentException - If provided URI is not an SMB URI.

getFileSystem

public SMBFileSystem getFileSystem(URI uri)

Retrieves a SMBFileSystem instance for the provided URI from fileSystemCache and returns it. SMBFileSystem instances are cached based on the authority part of the URI (i.e. URI's with the same authority share the same SMBFileSystem instance).

Specified by:

getFileSystem in class FileSystemProvider

Parameters:

uri - URI for which to fetch SMBFileSystem

Returns:

SMBFileSystem instance

Throws:

FileSystemNotFoundException - If no instance of SMBFileSystem could be retrieved from fileSystemCache.

IllegalArgumentException - If provided URI is not an SMB URI.

getPath

public SMBPath getPath(URI uri)

Converts the provided URI to an SMBPath instance and returns it. Automatically links the SMBPath with the SMBFileSystem associated with its authority.

Specified by:

getPath in class FileSystemProvider

Parameters:

uri - The URI from which to create the SMBPath

Returns:

Newly created SMBPath.

Throws:

IllegalArgumentException - If URI is not an SMB URI.

newByteChannel

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

Creates and returns a new SeekableSMBByteChannel instance.

Specified by:

newByteChannel in class FileSystemProvider

Parameters:

path - The SMBPath for which a byte channel should be opened.

options - A set of StandardOpenOptions.

attrs - An optional list of file attributes to set when creating the file.

Returns:

An instance of SeekableSMBByteChannel.

Throws:

IllegalArgumentException - If provided path is not an SMBPath instance.

IOException - If an I/O error occurs

UnsupportedOperationException - If an unsupported open option is specified (DSYNC, SYNC or SPARSE)

newDirectoryStream

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

Creates and returns a new SMBDirectoryStream for the specified path.

Specified by:

newDirectoryStream in class FileSystemProvider

Parameters:

dir - The SMBPath for which to create a new DirectoryStream.

filter - An optional filter that should be applied to filter entries in the stream.

Returns:

An instance of SMBDirectoryStream.

Throws:

IllegalArgumentException - If provided path is not an SMBPath instance.

NotDirectoryException - If provided SMBPath does not point to a directory

IOException - If an I/O error occurs

createDirectory

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

Creates a directory under the provided SMBPath

Specified by:

createDirectory in class FileSystemProvider

Parameters:

dir - SMBPath to folder that should be created.

Throws:

IllegalArgumentException - If provided path is not an SMBPath instance.

IOException - If creating the folder fails for some reason.

delete

public void delete(Path path)
            throws IOException

Deletes the file under the provided SMBPath

Specified by:

delete in class FileSystemProvider

Parameters:

path - SMBPath to file that should be deleted.

Throws:

IllegalArgumentException - If provided path is not an SMBPath instance.

IOException - If deleting the file fails for some reason.

copy

public void copy(Path source,
                 Path target,
                 CopyOption... options)
          throws IOException

Copies the file under provided source SMBPath to the destination SMBPath. CopyOptions are ignored!

Specified by:

copy in class FileSystemProvider

Parameters:

source - Source SMBPath

target - Destination SMBPath

options - CopyOptions (no effect)

Throws:

IllegalArgumentException - If provided paths are not SMBPath instances.

IOException - If copying fails for some reason.

move

public void move(Path source,
                 Path target,
                 CopyOption... options)
          throws IOException

Moves the file under the provided source SMBPath to the destination SMBPath. CopyOptions are ignored!

Specified by:

move in class FileSystemProvider

Parameters:

source - Source SMBPath

target - Destination SMBPath

options - CopyOptions (no effect)

Throws:

IllegalArgumentException - If provided paths are not SMBPath instances.

IOException - If moving fails for some reason.

isSameFile

public boolean isSameFile(Path path1,
                          Path path2)
                   throws IOException

Returns true, if the resources specified by the two SMBPath instance are the same.

Specified by:

isSameFile in class FileSystemProvider

Parameters:

path1 - First SMBPath

path2 - Second SMBPath

Returns:

True if the two paths point to the same resource.

Throws:

IllegalArgumentException - If provided paths are not SMBPath instances.

IOException - If moving fails for some reason.

isHidden

public boolean isHidden(Path path)
                 throws IOException

Returns true, if the resource specified by the provided SMBPath instance is hidden..

Specified by:

isHidden in class FileSystemProvider

Parameters:

path - SMBPath that should be checked.

Returns:

True if the resource under SMBPath is hidden.

Throws:

IllegalArgumentException - If provided paths are not SMBPath instances.

IOException - If moving fails for some reason.

checkAccess

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

Checks access to file under the provided SMBPath.

Specified by:

checkAccess in class FileSystemProvider

Parameters:

path - SMBPath for which access should be checked.

modes - AccessModes that should be checked. Onl yREAD and WRITE are supported.

Throws:

NoSuchFileException - If file or folder specified by SMBPath does not exist.

AccessDeniedException - If requested access cannot be provided for file or folder under SMBPath.

IllegalArgumentException - If provided path is not a SMBPath instance.

IOException - If checking accessfails for some reason.

getFileAttributeView

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

Reads the file attributes view of the file under the provided SMBPath and returns it. LinkOption will be ignored as the SMB filesystem does not support symlinks.

Specified by:

getFileAttributeView in class FileSystemProvider

Type Parameters:

V - Type of the class that's being returned.

Parameters:

path - SMBPath for which attributes view should be created.

type - Class of the attributes view. Must be either BasicFileAttributeView or SMBFileAttributeView

options - LinkOptions; will be ignored.

Returns:

SMBFileAttributeView

Throws:

IllegalArgumentException - If provided paths is not a SMBPath instance.

readAttributes

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

Reads the file attributes of the file under the provided SMBPath and returns it. LinkOption will be ignored as the SMB filesystem does not support symlinks.

Specified by:

readAttributes in class FileSystemProvider

Type Parameters:

A - Type of the class that's being returned.

Parameters:

path - SMBPath for which attributes should be read.

type - Class of the attribute. Must be either BasicFileAttributes or SMBFileAttributes

options - LinkOptions; will be ignored.

Returns:

SMBFileAttributes

Throws:

IllegalArgumentException - If provided paths is not a SMBPath instance.

IOException - If reading attributes fails for some reason.

readAttributes

public Map<String,Object> readAttributes(Path path,
                                         String attributes,
                                         LinkOption... options)

Specified by:

readAttributes in class FileSystemProvider

setAttribute

public void setAttribute(Path path,
                         String attribute,
                         Object value,
                         LinkOption... options)

Specified by:

setAttribute in class FileSystemProvider

getFileStore

public FileStore getFileStore(Path path)

Specified by:

getFileStore in class FileSystemProvider