oracle.javatools.filesystem

Class PathImpl

java.lang.Object

oracle.javatools.filesystem.PathImpl

All Implemented Interfaces:

java.lang.Comparable<java.nio.file.Path>, java.lang.Iterable<java.nio.file.Path>, java.nio.file.Path, java.nio.file.Watchable

public final class PathImpl
extends java.lang.Object
implements java.nio.file.Path

Basic Path implementation.

Since:

13.0.0.1.0

Field Summary

Fields

Modifier and Type	Field and Description
protected java.nio.file.FileSystem	fileSystem

Constructor Summary

Constructors

Constructor and Description
PathImpl(java.nio.file.FileSystem fileSystem, java.lang.String first, java.lang.String... more) Create a PathImpl.

Method Summary

Modifier and Type	Method and Description
int	compareTo(java.nio.file.Path other)
boolean	endsWith(java.nio.file.Path other)
boolean	endsWith(java.lang.String other)
boolean	equals(java.lang.Object o)
java.nio.file.attribute.FileTime	getCreationTime() Get the creation time.
PathImpl	getFileName()
java.nio.file.FileSystem	getFileSystem()
java.nio.file.attribute.FileTime	getLastAccessTime() Get the last accessTime, which for directories is the creation time, and for files the last time the file was read.
java.nio.file.attribute.FileTime	getLastModifiedTime() Get the last modifiedTime, which for directories is the creation time, and for files the last time the file was modified.
PathImpl	getName(int index)
int	getNameCount()
PathImpl	getParent()
PathImpl	getRoot()
int	hashCode()
boolean	isAbsolute()
boolean	isDirectory() Determine if this path is a directory path.
java.util.Iterator<java.nio.file.Path>	iterator()
PathImpl	normalize()
java.nio.file.WatchKey	register(java.nio.file.WatchService watcher, java.nio.file.WatchEvent.Kind<?>... events)
java.nio.file.WatchKey	register(java.nio.file.WatchService watcher, java.nio.file.WatchEvent.Kind<?>[] events, java.nio.file.WatchEvent.Modifier... modifiers)
java.nio.file.Path	relativize(java.nio.file.Path other) Note that this only works when other starts with this Path and this Path is a directory.
PathImpl	resolve(java.nio.file.Path other)
PathImpl	resolve(java.lang.String other)
PathImpl	resolveSibling(java.nio.file.Path other)
PathImpl	resolveSibling(java.lang.String other)
void	setLastAccessTime(long lastAccessTime) Set the last access time, which for directories is the creation time, and for files the last time the file was read.
void	setLastModifiedTime(long lastModifiedTime) Set the last modified time, which for directories is the creation time, and for files the last time the file was modified.
boolean	startsWith(java.nio.file.Path other)
boolean	startsWith(java.lang.String other)
PathImpl	subpath(int beginIndex, int endIndex)
PathImpl	toAbsolutePath()
java.io.File	toFile()
java.nio.file.Path	toRealPath(java.nio.file.LinkOption... options)
java.lang.String	toString()
java.net.URI	toUri()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Field Detail

fileSystem

protected java.nio.file.FileSystem fileSystem

Constructor Detail

PathImpl

public PathImpl(java.nio.file.FileSystem fileSystem,
                java.lang.String first,
                java.lang.String... more)

Create a PathImpl. The "first' and "more" parameters are concatenated to form the final path of this Path. Path elements are separated by '/'. Any '\\' char in the path is converted to '/'. Consecutive '/' chars are collapsed into one. The create a Path at the root, prefix it with DriveLetter:\ on Windows or '/' on another OS. To create a directory, postfix it with '/', otherwise it's a file.

Parameters:

fileSystem - The FileSystem associated with this path

first - The first part of the path

more - Zero or more subsequent parts of the path

Throws:

java.lang.IllegalArgumentException - if fileSystem or first is null

Method Detail

getFileSystem

public java.nio.file.FileSystem getFileSystem()

Specified by:

getFileSystem in interface java.nio.file.Path

Returns:

The associated FileSystem

isAbsolute

public boolean isAbsolute()

Specified by:

isAbsolute in interface java.nio.file.Path

Returns:

True if the path begins with a root directory

getRoot

public PathImpl getRoot()

Specified by:

getRoot in interface java.nio.file.Path

Returns:

the root as a Path IFF this is an absolute path, otherwise null

getFileName

public PathImpl getFileName()

Specified by:

getFileName in interface java.nio.file.Path

Returns:

the last element of this path or null if there are no elements

getParent

public PathImpl getParent()

Specified by:

getParent in interface java.nio.file.Path

Returns:

The parent of this path or null if there is no parent

getNameCount

public int getNameCount()

Specified by:

getNameCount in interface java.nio.file.Path

Returns:

the number of elements in this path

getName

public PathImpl getName(int index)

Specified by:

getName in interface java.nio.file.Path

Returns:

a zero-based indexed element of this path

Throws:

java.lang.IllegalArgumentException - if index is invalid

subpath

public PathImpl subpath(int beginIndex,
                        int endIndex)

Specified by:

subpath in interface java.nio.file.Path

Returns:

A Path consisting of one or more elements of this path. Returns either a file or directory

Throws:

java.lang.IllegalArgumentException - if beginIndex or endIndex is invalid

startsWith

public boolean startsWith(java.nio.file.Path other)

Specified by:

startsWith in interface java.nio.file.Path

Returns:

true if this path starts with the same elements that compose the other path.

startsWith

public boolean startsWith(java.lang.String other)

Specified by:

startsWith in interface java.nio.file.Path

Returns:

true if this Path starts with the other String when made into a Path

Throws:

java.lang.IllegalArgumentException - if other cannot be made into a valid PathImpl

endsWith

public boolean endsWith(java.nio.file.Path other)

Specified by:

endsWith in interface java.nio.file.Path

Returns:

true if this Path ends with the same elements that compose the other Path

endsWith

public boolean endsWith(java.lang.String other)

Specified by:

endsWith in interface java.nio.file.Path

Returns:

true if this Path ends with the other String when made into a Path

Throws:

java.lang.IllegalArgumentException - if other cannot be made into a valid PathImpl

normalize

public PathImpl normalize()

Specified by:

normalize in interface java.nio.file.Path

Returns:

Always this Path

resolve

public PathImpl resolve(java.nio.file.Path other)

Specified by:

resolve in interface java.nio.file.Path

Returns:

null if other is an unknown path, otherwise other if other is absolute, otherwise a new Path that is made by concatenating this Path and the other Path

Throws:

java.lang.IllegalStateException - if this is not a directory

resolve

public PathImpl resolve(java.lang.String other)

Specified by:

resolve in interface java.nio.file.Path

Returns:

After turning other into a Path, return other if other is absolute, otherwise a new Path that is made by concatenating this Path and the other Path

Throws:

java.lang.IllegalArgumentException - if other cannot be made into a valid Path

java.lang.IllegalStateException - if this is not a directory

resolveSibling

public PathImpl resolveSibling(java.nio.file.Path other)

Specified by:

resolveSibling in interface java.nio.file.Path

Returns:

null if other is an unknown path, otherwise other if other is absolute, otherwise a new Path consisting of the parent of this path and the other path

resolveSibling

public PathImpl resolveSibling(java.lang.String other)

Specified by:

resolveSibling in interface java.nio.file.Path

Returns:

after other is made in to a Path, return other if other is absolute, otherwise a new Path consisting of the parent of this path and the other path

Throws:

java.lang.IllegalArgumentException - if other is not a valid path

relativize

public java.nio.file.Path relativize(java.nio.file.Path other)

Note that this only works when other starts with this Path and this Path is a directory.

Specified by:

relativize in interface java.nio.file.Path

Returns:

if possible a new Path that is relative to this Path

Throws:

java.lang.IllegalArgumentException - if other is not a PathImpl or if it's not possible to make a relative path

toUri

public java.net.URI toUri()

Specified by:

toUri in interface java.nio.file.Path

Returns:

the URK of this Path

toAbsolutePath

public PathImpl toAbsolutePath()

Specified by:

toAbsolutePath in interface java.nio.file.Path

Returns:

this Path if it's absolute, otherwise a new Path resolved against the first root directory of the file system

toRealPath

public java.nio.file.Path toRealPath(java.nio.file.LinkOption... options)
                              throws java.io.IOException

Specified by:

toRealPath in interface java.nio.file.Path

Returns:

toAbsolutePath()

Throws:

java.io.IOException

toFile

public java.io.File toFile()

Specified by:

toFile in interface java.nio.file.Path

Throws:

java.lang.UnsupportedOperationException

register

public java.nio.file.WatchKey register(java.nio.file.WatchService watcher,
                                       java.nio.file.WatchEvent.Kind<?>[] events,
                                       java.nio.file.WatchEvent.Modifier... modifiers)
                                throws java.io.IOException

Specified by:

register in interface java.nio.file.Path

Specified by:

register in interface java.nio.file.Watchable

Throws:

java.lang.UnsupportedOperationException

java.io.IOException

register

public java.nio.file.WatchKey register(java.nio.file.WatchService watcher,
                                       java.nio.file.WatchEvent.Kind<?>... events)
                                throws java.io.IOException

Specified by:

register in interface java.nio.file.Path

Specified by:

register in interface java.nio.file.Watchable

Throws:

java.lang.UnsupportedOperationException

java.io.IOException

iterator

public java.util.Iterator<java.nio.file.Path> iterator()

Specified by:

iterator in interface java.lang.Iterable<java.nio.file.Path>

Specified by:

iterator in interface java.nio.file.Path

Returns:

an Iterator of the elements of this Path

compareTo

public int compareTo(java.nio.file.Path other)

Specified by:

compareTo in interface java.lang.Comparable<java.nio.file.Path>

Specified by:

compareTo in interface java.nio.file.Path

Throws:

java.lang.ClassCastException - if other is not a PathImpl

isDirectory

public boolean isDirectory()

Determine if this path is a directory path.

Returns:

True if this is a directory path

toString

public java.lang.String toString()

Specified by:

toString in interface java.nio.file.Path

Overrides:

toString in class java.lang.Object

equals

public boolean equals(java.lang.Object o)

Specified by:

equals in interface java.nio.file.Path

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Specified by:

hashCode in interface java.nio.file.Path

Overrides:

hashCode in class java.lang.Object

setLastModifiedTime

public void setLastModifiedTime(long lastModifiedTime)

Set the last modified time, which for directories is the creation time, and for files the last time the file was modified.

Parameters:

lastModifiedTime - The last modified time

getLastModifiedTime

public java.nio.file.attribute.FileTime getLastModifiedTime()

Get the last modifiedTime, which for directories is the creation time, and for files the last time the file was modified.

Returns:

The last modified time

setLastAccessTime

public void setLastAccessTime(long lastAccessTime)

Set the last access time, which for directories is the creation time, and for files the last time the file was read.

Parameters:

lastAccessTime - The last access time

getLastAccessTime

public java.nio.file.attribute.FileTime getLastAccessTime()

Get the last accessTime, which for directories is the creation time, and for files the last time the file was read.

Returns:

The last access time

getCreationTime

public java.nio.file.attribute.FileTime getCreationTime()

Get the creation time.

Returns:

The creation time