oracle.javatools.filesystem

Class BufferFileSystemProvider

java.lang.Object

java.nio.file.spi.FileSystemProvider

oracle.javatools.filesystem.FileSystemProviderImpl

oracle.javatools.filesystem.BufferFileSystemProvider

Direct Known Subclasses:

ByteBufferFileSystemProvider

public abstract class BufferFileSystemProvider
extends FileSystemProviderImpl

FileSystemProvider implementation suitable for use in the custom BufferFileSystem.

This BufferFileSystem concentrates on storing directories created with FileSystemProviderImpl.createDirectory(Path, FileAttribute[]) and files created by FileSystemProviderImpl.newByteChannel(Path, Set, FileAttribute[]) which automatically creates all parent directories of that file. The implementation of FileSystemProviderImpl.newByteChannel(Path, Set, FileAttribute...) defines what kind of Buffer is stored in each file. See the implementation of ByteBufferFileSystemProvider which uses ByteBuffers.

This BufferFileSystem exclusively uses PathImpl objects which can be created by calling FileSystemProviderImpl.getPath(URI) OR by calling getFileSystem() first and then calling FileSystem.getPath(String, String[]) next. PathImpl's can be freely created, but to create actual directories and files in this BufferFileSystem, FileSystemProviderImpl.createDirectory(Path, FileAttribute[]) and FileSystemProviderImpl.newByteChannel(Path, Set, FileAttribute[]) need to be used.

Files and directories are held onto until they are deleted or the FileSystem of this provider is closed or this provider is garbage collected.

Access to the file system is not synchronized.

Since:

13.0.0.1.0

See Also:

ByteBufferFileSystemProvider

Field Summary

Fields inherited from class oracle.javatools.filesystem.FileSystemProviderImpl

fileSystem, scheme

Constructor Summary

Constructors

Constructor and Description
BufferFileSystemProvider(java.lang.String scheme) Create a new provider that can create a BufferFileSystem.

Method Summary

Modifier and Type	Method and Description
protected java.nio.Buffer	getBuffer(PathImpl path) Get the buffer associated with the PathImpl.
BufferFileSystem	getFileSystem() Get the BufferFileSystem associated with this provider.
BufferFileSystem	getFileSystem(java.net.URI uri)
BufferFileSystem	newFileSystem(java.nio.file.Path path, java.util.Map<java.lang.String,?> env)
BufferFileSystem	newFileSystem(java.net.URI uri, java.util.Map<java.lang.String,?> env)
protected java.nio.Buffer	putBuffer(PathImpl path, java.nio.Buffer buffer) Put a buffer that will be asscoiated with the PathImpl.

Methods inherited from class oracle.javatools.filesystem.FileSystemProviderImpl

checkAccess, checkURI, copy, createDirectory, delete, getFileAttributeView, getFileStore, getPath, getScheme, isHidden, isSameFile, move, newByteChannel, newByteChannelImpl, newDirectoryStream, readAttributes, readAttributes, setAttribute

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

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

Methods inherited from class java.lang.Object

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

Constructor Detail

BufferFileSystemProvider

public BufferFileSystemProvider(java.lang.String scheme)

Create a new provider that can create a BufferFileSystem.

Parameters:

scheme - The scheme for the FileSystem

Throws:

java.lang.IllegalArgumentException - if scheme is null or empty

Method Detail

getFileSystem

public BufferFileSystem getFileSystem()

Get the BufferFileSystem associated with this provider.

Specified by:

getFileSystem in class FileSystemProviderImpl

Returns:

A BufferFileSystem

getBuffer

protected java.nio.Buffer getBuffer(PathImpl path)

Get the buffer associated with the PathImpl.

Parameters:

path - A PathImpl

Returns:

A Buffer or null if there is no Buffer associated with this PathImpl

putBuffer

protected java.nio.Buffer putBuffer(PathImpl path,
                                    java.nio.Buffer buffer)
                             throws java.io.IOException

Put a buffer that will be asscoiated with the PathImpl.

Parameters:

path - A PathImpl

buffer - The new Buffer

Returns:

The old Buffer associated with the PathImpl or null if there was none

Throws:

java.io.IOException

newFileSystem

public BufferFileSystem newFileSystem(java.net.URI uri,
                                      java.util.Map<java.lang.String,?> env)
                               throws java.io.IOException

Specified by:

newFileSystem in class java.nio.file.spi.FileSystemProvider

Returns:

A new BufferFileSystem

Throws:

java.lang.IllegalArgumentException - if uri is null or if the scheme of the uri is not the same as the scheme associated with this FileSystemProvider

java.io.IOException

newFileSystem

public BufferFileSystem newFileSystem(java.nio.file.Path path,
                                      java.util.Map<java.lang.String,?> env)
                               throws java.io.IOException

Overrides:

newFileSystem in class java.nio.file.spi.FileSystemProvider

Returns:

A new BufferFileSystem

Throws:

java.lang.UnsupportedOperationException - Path is not a PathImpl

java.io.IOException

getFileSystem

public BufferFileSystem getFileSystem(java.net.URI uri)

Specified by:

getFileSystem in class java.nio.file.spi.FileSystemProvider

Returns:

A new BufferFileSystem

Throws:

java.lang.IllegalArgumentException - if uri is null or if the scheme of the uri is not the same as the scheme associated with this FileSystemProvider