ch.pontius.nio.smb.SMBPath Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of smb-nio Show documentation
Show all versions of smb-nio Show documentation
This is a Java NIO.2 file system provider that can be used to access CIFS/SMB (SMB 1 and SMB 2) file systems.
The newest version!
package ch.pontius.nio.smb;
import jcifs.CIFSContext;
import jcifs.smb.SmbFile;
import java.io.File;
import java.io.IOException;
import java.net.URI;
import java.net.URISyntaxException;
import java.nio.file.*;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Iterator;
import java.util.List;
/**
* A {@link Path} implementation that can be used with SMBNio
*
* @author Ralph Gasser
* @version 1.1
*/
public final class SMBPath implements Path {
/** Reference to the {@link SMBFileSystem}. */
private final SMBFileSystem fileSystem;
/** A list of path components that make up the current implementation of {@link SMBPath}. */
private final String[] components;
/** Flag indicating whether the current instance of {@link SMBPath} is an absolute path. */
private final boolean absolute;
/** Flag indicating whether the current instance of {@link SMBPath} points to a folder. */
private final boolean folder;
/**
* Convenience method used to check and cast a {@link Path} to an {@link SMBPath} instance.
*
* @param path {@link Path} that should be checked and cast.
* @return {@link SMBPath}
* @throws IllegalArgumentException If path is not an instance of {@link SMBPath}.
*/
static SMBPath fromPath(Path path) {
if (path instanceof SMBPath) {
return (SMBPath)path;
} else {
throw new IllegalArgumentException("The provided path '" + path.toString() + "' is not an SMB path.");
}
}
/**
* Constructor for {@link SMBPath}. Creates a new, absolute path to a SMB resource from the provided URI.
*
* @param fileSystem {@link SMBFileSystem} object this {@link SMBPath} is associated with.
* @param uri The URI pointing to the desired file or folder on the SMB file system.
*/
SMBPath(SMBFileSystem fileSystem, URI uri) {
if (!uri.getScheme().equals(SMBFileSystem.SMB_SCHEME)) throw new IllegalArgumentException("The provided URI does not point to an SMB resource.");
this.folder = SMBPathUtil.isFolder(uri.getPath());
this.absolute = SMBPathUtil.isAbsolutePath(uri.getPath());
this.components = SMBPathUtil.splitPath(uri.getPath());
this.fileSystem = fileSystem;
}
/**
* Constructor for {@link SMBPath}. Constructs a new path to a SMB resource from the provided host and path string.
*
* @param fileSystem {@link SMBFileSystem} object this {@link SMBPath} is associated with.
* @param path The path. It can either be relative or absolute.
*/
SMBPath(SMBFileSystem fileSystem, String path) {
/* Make sure that path is absolute. */
this.absolute = SMBPathUtil.isAbsolutePath(path);
this.folder = SMBPathUtil.isFolder(path);
this.components = SMBPathUtil.splitPath(path);
this.fileSystem = fileSystem;
}
/**
* Getter for {@link SMBFileSystem} this {@link SMBPath} belongs to.
*
* @return {@link SMBFileSystem}
*/
@Override
public FileSystem getFileSystem() {
return this.fileSystem;
}
/**
* {@link SMBPath} is always absolute!
*
* @return true
*/
@Override
public boolean isAbsolute() {
return this.absolute;
}
/**
* Returns the root component of this {@link SMBPath} or null, if the path is relative.
*
* @return Root component of this {@link SMBPath}
*/
@Override
public Path getRoot() {
if (this.absolute) {
return new SMBPath(this.fileSystem, "/");
} else {
return null;
}
}
/**
* Returns a new, relative {@link SMBPath} instance that just contains the last path component of the current {@link SMBPath}'s path.
*
* @return {@link SMBPath} for the file name.
*/
@Override
public Path getFileName() {
return new SMBPath(this.fileSystem, this.components[this.components.length-1]);
}
/**
* Returns a new {@link SMBPath} that points to the parent of the current {@link SMBPath}. If the current
* {@link SMBPath} instance does not have a parent, this method returns null.
*
* @return Parent {@link SMBPath}.
*/
@Override
public Path getParent() {
if (this.components.length > 1) {
String reduced = SMBPathUtil.mergePath(this.components, 0, this.components.length-1, this.absolute, true);
return new SMBPath(this.fileSystem, reduced);
} else {
return null;
}
}
/**
* Returns the number of path components in the current {@link SMBPath}'s path.
*
* @return Number of path components.
*/
@Override
public int getNameCount() {
return this.components.length;
}
/**
* Returns a name element of this {@link SMBPath} as a new {@link SMBPath} object.
*
* The index parameter is the index of the name element to return. The element that is closest to the root in the directory hierarchy has index 0.
* The element that is farthest from the root has index count-1.
*
* @param index The index of the element
* @return The name element.
*/
@Override
public Path getName(int index) {
if (index < 0 || index >= this.components.length) throw new IllegalArgumentException("The provided index is out of bounds.");
String reduced = SMBPathUtil.mergePath(this.components, index, index, false, index == this.components.length - 1 && this.folder);
return new SMBPath(this.fileSystem, reduced);
}
/**
* Returns a relative Path that is a subsequence of the name elements of this path.
*
* @param beginIndex The index of the first element, inclusive
* @param endIndex The index of the last element, exclusive
* @return The resulting subpath.
* @throws IllegalArgumentException If beginIndex is negative, or greater than or equal to the number of elements. If endIndex is less than or equal to beginIndex, or larger than the number of elements.
*/
@Override
public Path subpath(int beginIndex, int endIndex) {
if (beginIndex < 0 || endIndex >= this.components.length) throw new IllegalArgumentException("The provided indices are out of bounds.");
if (beginIndex > endIndex) throw new IllegalArgumentException("The beginIndex must be smaller than the endIndex.");
String reduced = SMBPathUtil.mergePath(this.components, beginIndex, endIndex, false, endIndex == this.components.length - 1 && this.folder);
return new SMBPath(this.fileSystem, reduced);
}
/**
* Tests if this path starts with the given path. If the two paths belong to a different {@link FileSystem} then this
* method always returns false. Otherwise, a string comparison is performed.
*
* @param other The given path
* @return True if this path starts with the given path; otherwise false
*/
@Override
public boolean startsWith(Path other) {
return other.getFileSystem() == this.fileSystem && this.startsWith(other.toString());
}
/**
* Tests if this path starts with the provided string. The path separators will be taken into account.
*
* @param other The given path
* @return True if this path starts with the given string; otherwise false
*/
@Override
public boolean startsWith(String other) {
String path = SMBPathUtil.mergePath(this.components, 0, this.components.length, this.absolute, this.folder);
return path.startsWith(other);
}
/**
* Tests if this path ends with the given path. If the two paths belong to a different {@link FileSystem} then this
* method always returns false. Otherwise, a string comparison is performed.
*
* @param other The given path
* @return True if this path starts with the given path; otherwise false
*/
@Override
public boolean endsWith(Path other) {
return other.getFileSystem() == this.fileSystem && this.endsWith(other.toString());
}
/**
* Tests if this path ends with the provided string. The path separators will be taken into account.
*
* @param other The given path
* @return True if this path starts with the given string; otherwise false
*/
@Override
public boolean endsWith(String other) {
String path = SMBPathUtil.mergePath(this.components, 0, this.components.length, this.absolute, this.folder);
return path.endsWith(other);
}
/**
* Returns a path that is this path with redundant name elements, like "." or ".." eliminated.
*
* @return Normalized {@link SMBPath}.
*/
@Override
public Path normalize() {
final ArrayList normalized = new ArrayList<>();
for (String component: this.components) {
if (component.equals(".")) {
continue;
} else if (component.equals("..") && normalized.size() > 1) {
normalized.remove(normalized.size()-1);
} else if (component.equals("..") && normalized.size() > 0) {
continue;
} else {
normalized.add(component);
}
}
String path = SMBPathUtil.mergePath(normalized.toArray(new String[0]), 0, normalized.size(), this.absolute, this.folder);
return new SMBPath(this.fileSystem, path);
}
/**
* Resolve the given path against this {@link SMBPath}.
*
* If the other parameter is an absolute path then this method trivially returns other. If other is an empty path then this method trivially returns this path.
*
* @param other The path to resolve against this path
* @return The resulting {@link SMBPath}
*
* @throws IllegalArgumentException If other path is not a {@link SMBPath} OR does not belong to the same {@link SMBFileSystem} OR if this path points to a file.
*/
@Override
public Path resolve(Path other) {
/* Check if other path is on the same filesystem. */
if (!(other instanceof SMBPath)) throw new IllegalArgumentException("You can only resolve an SMB path against another SMB path.");
if (((SMBPath)other).fileSystem != this.fileSystem) throw new IllegalArgumentException("You can only resolve an SMB path against another SMB path on the same file system.");
/* Check if current path is a folder (Important!). */
if (!this.isFolder()) throw new IllegalArgumentException("The current path appears to be a file. You cannot resolve another path against a file path. Either add a trailing '/' to indicate that this is a folder or use resolveSibling() instead.");
/* If other is absolute, return other else resolve. */
if (other.isAbsolute()) {
return other;
} else {
String[] components = new String[other.getNameCount() + this.getNameCount()];
System.arraycopy(this.components, 0, components, 0, this.getNameCount());
System.arraycopy(((SMBPath)other).components, 0, components, this.getNameCount(), other.getNameCount());
String path = SMBPathUtil.mergePath(components, 0, components.length, this.absolute, ((SMBPath) other).folder);
return new SMBPath(this.fileSystem, path);
}
}
/**
* Resolve the given path string against this {@link SMBPath}.
*
* If the other parameter is an absolute path then this method trivially returns other. If other is an empty path then this method trivially returns this path.
*
* @param other The path to resolve against this path
* @return The resulting {@link SMBPath}
*
* @throws IllegalArgumentException If other path is not a {@link SMBPath} OR does not belong to the same {@link SMBFileSystem} OR if this path points to a file.
*/
@Override
public Path resolve(String other) {
/* Check if current path is a folder (Important!). */
if (!this.isFolder()) throw new IllegalArgumentException("The current path appears to be a file. You cannot resolve another path against a file path. Either add a trailing '/' to indicate that this is a folder or use resolveSibling() instead.");
if (SMBPathUtil.isAbsolutePath(other)) {
return new SMBPath(this.fileSystem, other);
} else {
String[] split = SMBPathUtil.splitPath(other);
String[] components = new String[split.length + this.components.length];
System.arraycopy(this.components, 0, components, 0, this.components.length);
System.arraycopy(split, 0, components, this.components.length, split.length);
String path = SMBPathUtil.mergePath(components, 0, components.length, this.absolute, SMBPathUtil.isFolder(other));
return new SMBPath(this.fileSystem, path);
}
}
/**
* Resolve the given path against this {@link SMBPath}'s parent.
*
* If the other parameter is an absolute path then this method trivially returns other. If other is an empty path then this method trivially returns this path.
*
* @param other The path to resolve against this path
* @return The resulting {@link SMBPath}
*
* @throws IllegalArgumentException If other path is not a {@link SMBPath} OR does not belong to the same {@link SMBFileSystem}.
*/
@Override
public Path resolveSibling(Path other) {
/* Check if other path is on the same filesystem. */
if (!(other instanceof SMBPath)) throw new IllegalArgumentException("You can only resolve an SMB path against another SMB path.");
if (((SMBPath)other).fileSystem != this.fileSystem) throw new IllegalArgumentException("You can only resolve an SMB path against another SMB path on the same file system.");
if (other.isAbsolute()) {
return other;
} else {
String[] components = new String[other.getNameCount() + this.getNameCount() - 1];
System.arraycopy(this.components, 0, components, 0, this.components.length-1);
System.arraycopy(((SMBPath)other).components, 0, components, this.components.length-1, ((SMBPath) other).components.length);
String path = SMBPathUtil.mergePath(components, 0, components.length, this.absolute, ((SMBPath) other).folder);
return new SMBPath(this.fileSystem, path);
}
}
/**
* Resolve the given path string against this {@link SMBPath}.
*
* If the other parameter is an absolute path then this method trivially returns other. If other is an empty path then this method trivially returns this path.
*
* @param other The path to resolve against this path
* @return The resulting {@link SMBPath}
*
* @throws IllegalArgumentException If other path is not a {@link SMBPath} OR does not belong to the same {@link SMBFileSystem} OR if this path points to a file.
*/
@Override
public Path resolveSibling(String other) {
/* Check if current path is a folder (Important!). */
if (!this.isFolder()) throw new IllegalArgumentException("The current path appears to be a file. You cannot resolve another path against a file path. Either add a trailing '/' to indicate that this is a folder or use resolveSibling() instead.");
if (SMBPathUtil.isAbsolutePath(other)) {
return new SMBPath(this.fileSystem, other);
} else {
String[] split = SMBPathUtil.splitPath(other);
String[] components = new String[split.length + this.components.length - 1];
System.arraycopy(this.components, 0, components, 0, this.components.length - 1);
System.arraycopy(split, 0, components, this.components.length - 1, split.length);
String path = SMBPathUtil.mergePath(components, 0, components.length, this.absolute, SMBPathUtil.isFolder(other));
return new SMBPath(this.fileSystem, path);
}
}
/**
* Constructs a relative path between this path and a given path.
*
* @param other The other path.
*
* @throws IllegalArgumentException If other path is not a {@link SMBPath} OR does not belong to the same {@link SMBFileSystem} OR if this path points to a file.
*/
@Override
public Path relativize(Path other) {
/* Check type. */
if (!(other instanceof SMBPath)) throw new IllegalArgumentException("The provided path is not a SMBPath.");
SMBPath target = (SMBPath)other;
/* Check if both paths are of the same type. */
if (this.fileSystem != target.fileSystem) throw new IllegalArgumentException("The two paths do not belong to the same filesystem.");
if (this.absolute != target.absolute) throw new IllegalArgumentException("The two paths are of a different type (absolute vs. relative).");
/* Construct the relative path. */
boolean common = true;
int lastIndex = 0;
final List newPath = new ArrayList<>();
for (int i=0;i iterator() {
final List elements = new ArrayList<>(this.components.length);
for (int i=0;i[] events, WatchEvent.Modifier... modifiers) {
throw new UnsupportedOperationException("FileWatchers are currently not supported by SMB paths.");
}
@Override
public WatchKey register(WatchService watcher, WatchEvent.Kind... events) {
throw new UnsupportedOperationException("FileWatchers are currently not supported by SMB paths.");
}
}