Package com.gengoai.io.resource

Class FileResource

java.lang.Object

com.gengoai.io.resource.BaseResource

com.gengoai.io.resource.FileResource

All Implemented Interfaces:

Resource, Serializable

public class FileResource
extends BaseResource

A Resource implementation that wraps a File.

Author:

David B. Bracewell

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface com.gengoai.io.resource.Resource

Resource.Deserializer

Field Summary

Fields inherited from interface com.gengoai.io.resource.Resource

ALL_FILE_PATTERN

Constructor Summary

Constructors

Constructor	Description
FileResource(File file)	Constructs a Resource backed by a File
FileResource(String path)	Constructs a Resource backed by a File

Method Summary

Modifier and Type	Method	Description
Resource	append(byte[] byteArray)	Appends the given byte array content to the resource.
Optional<File>	asFile()	Gets the resource as a File.
Optional<URI>	asURI()	As uri optional.
Optional<URL>	asURL()	Gets the resource as a URL.
String	baseName()	Gets the name (file name or directory name) of this resource.
boolean	canRead()	Returns true if the resource is readable, false if not.
boolean	canWrite()	Returns true if the resource is writable, false if not.
InputStream	createInputStream()	Create input stream input stream.
OutputStream	createOutputStream()	Create output stream output stream.
boolean	delete(boolean recursively)	Deletes the resource
Resource	deleteOnExit()	Deletes the resource on ext
String	descriptor()	Descriptor string.
boolean	equals(Object obj)
boolean	exists()	Exists boolean.
Resource	getChild(String relativePath)	Creates a new Resource that is relative to this resource.
List<Resource>	getChildren(Pattern pattern, boolean recursive)	Lists all the resources that are directly under this resource.
Resource	getParent()	Gets parent.
int	hashCode()
boolean	isDirectory()	Is directory.
boolean	mkdir()	Mkdir boolean.
boolean	mkdirs()	Mkdirs boolean.
String	path()	Gets path in the same mannar as File.getPath()

Methods inherited from class com.gengoai.io.resource.BaseResource

compressed, getCharset, inputStream, isCompressed, outputStream, setCharset, setCompression, setIsCompressed, toString, uncompressed

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.gengoai.io.resource.Resource

append, asPath, childIterator, childIterator, copy, delete, forEach, getChildren, getChildren, getChildren, getChildren, lines, readBytes, reader, readLines, readObject, readToString, write, write, writeObject, writer

Constructor Detail

FileResource

public FileResource(File file)

Constructs a Resource backed by a File

Parameters:

file - The file to be wrapped.

FileResource

public FileResource(String path)

Constructs a Resource backed by a File

Parameters:

path - The path of the file

Method Detail

append

public Resource append(byte[] byteArray)
                throws IOException

Description copied from interface: Resource

Appends the given byte array content to the resource.

Parameters:

byteArray - The content to append

Returns:

the resource

Throws:

IOException - the io exception

asFile

public Optional<File> asFile()

Description copied from interface: Resource

Gets the resource as a File.

Specified by:

asFile in interface Resource

Overrides:

asFile in class BaseResource

Returns:

A File representing the resource.

asURI

public Optional<URI> asURI()

Description copied from interface: Resource

As uri optional.

Specified by:

asURI in interface Resource

Overrides:

asURI in class BaseResource

Returns:

the optional

asURL

public Optional<URL> asURL()

Description copied from interface: Resource

Gets the resource as a URL.

Returns:

A URL representing the resource.

baseName

public String baseName()

Description copied from interface: Resource

Gets the name (file name or directory name) of this resource.

Specified by:

baseName in interface Resource

Overrides:

baseName in class BaseResource

Returns:

The name of the file or directory

canRead

public boolean canRead()

Description copied from interface: Resource

Returns true if the resource is readable, false if not.

Specified by:

canRead in interface Resource

Overrides:

canRead in class BaseResource

Returns:

True if can read from the resource

canWrite

public boolean canWrite()

Description copied from interface: Resource

Returns true if the resource is writable, false if not.

Specified by:

canWrite in interface Resource

Overrides:

canWrite in class BaseResource

Returns:

True if can write to the resource

createInputStream

public InputStream createInputStream()
                              throws IOException

Description copied from class: BaseResource

Create input stream input stream.

Overrides:

createInputStream in class BaseResource

Returns:

the input stream

Throws:

IOException - the io exception

createOutputStream

public OutputStream createOutputStream()
                                throws IOException

Description copied from class: BaseResource

Create output stream output stream.

Overrides:

createOutputStream in class BaseResource

Returns:

the output stream

Throws:

IOException - the io exception

delete

public boolean delete(boolean recursively)

Description copied from interface: Resource

Deletes the resource

Parameters:

recursively - true if should recursively delete everything under this resource

Returns:

true if the deletion was successful

deleteOnExit

public Resource deleteOnExit()

Description copied from interface: Resource

Deletes the resource on ext

Returns:

the resource

descriptor

public String descriptor()

Description copied from interface: Resource

Descriptor string.

Specified by:

descriptor in interface Resource

Overrides:

descriptor in class BaseResource

Returns:

The string representation of the resource with protocol

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

exists

public boolean exists()

Description copied from interface: Resource

Exists boolean.

Returns:

True if the resource exists, False if the resource does not exist.

getChild

public Resource getChild(String relativePath)

Description copied from interface: Resource

Creates a new Resource that is relative to this resource.

Parameters:

relativePath - The relative path for the new resource.

Returns:

A new resource that is relative to this resource.

getChildren

public List<Resource> getChildren(Pattern pattern,
                                  boolean recursive)

Description copied from interface: Resource

Lists all the resources that are directly under this resource.

Parameters:

pattern - The file matching pattern

recursive - Gets all children recursively

Returns:

A list of all the resources one level under this resource.

getParent

public Resource getParent()

Description copied from interface: Resource

Gets parent.

Returns:

The parent resource (directory for file, parent directory for a directory)

hashCode

public int hashCode()

Overrides:

hashCode in class Object

isDirectory

public boolean isDirectory()

Description copied from interface: Resource

Is directory.

Specified by:

isDirectory in interface Resource

Overrides:

isDirectory in class BaseResource

Returns:

True if the resource is a directory

mkdir

public boolean mkdir()

Description copied from interface: Resource

Mkdir boolean.

Returns:

the boolean

See Also:

java.io.File#mkdir()java.io.File#mkdir()java.io.File#mkdir()java.io.File#mkdir()

mkdirs

public boolean mkdirs()

Description copied from interface: Resource

Mkdirs boolean.

Returns:

the boolean

See Also:

java.io.File#mkdirs()java.io.File#mkdirs()java.io.File#mkdirs()java.io.File#mkdirs()

path

public String path()

Description copied from interface: Resource

Gets path in the same mannar as File.getPath()

Specified by:

path in interface Resource

Overrides:

path in class BaseResource

Returns:

The full path to the resource including name