org.apache.commons.vfs2.provider.http4

Class Http4FileObject<FS extends Http4FileSystem>

java.lang.Object

org.apache.commons.vfs2.provider.AbstractFileObject<FS>

org.apache.commons.vfs2.provider.http4.Http4FileObject<FS>

Type Parameters:

FS - An Http4FileSystem subclass

All Implemented Interfaces:

Closeable, AutoCloseable, Comparable<FileObject>, Iterable<FileObject>, FileObject

public class Http4FileObject<FS extends Http4FileSystem>
extends AbstractFileObject<FS>

A file object backed by Apache HttpComponents HttpClient.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Http4FileObject(AbstractFileName name, FS fileSystem) Construct Http4FileObject.
protected	Http4FileObject(AbstractFileName name, FS fileSystem, Http4FileSystemConfigBuilder builder) Construct Http4FileObject.

Method Summary

Modifier and Type	Method and Description
protected void	doDetach() Detaches this file object from its file resource.
protected long	doGetContentSize() Returns the size of the file content (in bytes).
protected InputStream	doGetInputStream() Creates an input stream to read the file content from.
protected long	doGetLastModifiedTime() Returns the last modified time of this file.
protected RandomAccessContent	doGetRandomAccessContent(RandomAccessMode mode) Creates access to the file for random i/o.
protected FileType	doGetType() Determines the type of this file.
protected boolean	doIsWriteable() Determines if this file can be written to.
protected String[]	doListChildren() Lists the children of this file.
protected FileContentInfoFactory	getFileContentInfoFactory() Creates the FileContentInfo factory.
protected URI	getInternalURI() Return the internal URI object mapped to this file object.
protected String	getUrlCharset() Return URL charset string.

Methods inherited from class org.apache.commons.vfs2.provider.AbstractFileObject

canRenameTo, childrenChanged, close, compareTo, copyFrom, createFile, createFolder, delete, delete, deleteAll, doAttach, doCreateFileContent, doCreateFolder, doDelete, doGetAttributes, doGetCertificates, doGetOutputStream, doIsExecutable, doIsHidden, doIsReadable, doIsSameFile, doListChildrenResolved, doRemoveAttribute, doRename, doSetAttribute, doSetExecutable, doSetLastModifiedTime, doSetReadable, doSetWritable, endOutput, exists, finalize, findFiles, findFiles, getAbstractFileSystem, getChild, getChildren, getContent, getFileOperations, getFileSystem, getInputStream, getName, getOutputStream, getOutputStream, getParent, getPublicURIString, getRandomAccessContent, getType, getURL, handleChanged, handleCreate, handleDelete, holdObject, injectType, isAttached, isContentOpen, isExecutable, isFile, isFolder, isHidden, isReadable, isSameFile, isWriteable, iterator, listFiles, moveTo, notifyAllStreamsClosed, onChange, onChildrenChanged, refresh, resolveFile, resolveFile, setExecutable, setReadable, setWritable, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

Http4FileObject

protected Http4FileObject(AbstractFileName name,
                          FS fileSystem)
                   throws FileSystemException,
                          URISyntaxException

Construct Http4FileObject.

Parameters:

name - file name

fileSystem - file system

Throws:

FileSystemException - if any error occurs

URISyntaxException - if given file name cannot be converted to a URI due to URI syntax error

Http4FileObject

protected Http4FileObject(AbstractFileName name,
                          FS fileSystem,
                          Http4FileSystemConfigBuilder builder)
                   throws FileSystemException,
                          URISyntaxException

Construct Http4FileObject.

Parameters:

name - file name

fileSystem - file system

builder - Http4FileSystemConfigBuilder object

Throws:

FileSystemException - if any error occurs

URISyntaxException - if given file name cannot be converted to a URI due to URI syntax error

Method Detail

doGetType

protected FileType doGetType()
                      throws Exception

Description copied from class: AbstractFileObject

Determines the type of this file. Must not return null. The return value of this method is cached, so the implementation can be expensive.

Specified by:

doGetType in class AbstractFileObject<FS extends Http4FileSystem>

Returns:

the type of the file.

Throws:

Exception - if an error occurs.

doGetContentSize

protected long doGetContentSize()
                         throws Exception

Description copied from class: AbstractFileObject

Returns the size of the file content (in bytes). Is only called if AbstractFileObject.doGetType() returns FileType.FILE.

Specified by:

doGetContentSize in class AbstractFileObject<FS extends Http4FileSystem>

Returns:

The size of the file in bytes.

Throws:

Exception - if an error occurs.

doGetLastModifiedTime

protected long doGetLastModifiedTime()
                              throws Exception

Description copied from class: AbstractFileObject

Returns the last modified time of this file. Is only called if AbstractFileObject.doGetType() does not return FileType.IMAGINARY.

This implementation throws an exception.

Overrides:

doGetLastModifiedTime in class AbstractFileObject<FS extends Http4FileSystem>

Returns:

The last modification time.

Throws:

Exception - if an error occurs.

doGetInputStream

protected InputStream doGetInputStream()
                                throws Exception

Description copied from class: AbstractFileObject

Creates an input stream to read the file content from. Is only called if AbstractFileObject.doGetType() returns FileType.FILE.

It is guaranteed that there are no open output streams for this file when this method is called.

The returned stream does not have to be buffered.

Specified by:

doGetInputStream in class AbstractFileObject<FS extends Http4FileSystem>

Returns:

An InputStream to read the file content.

Throws:

Exception - if an error occurs.

doGetRandomAccessContent

protected RandomAccessContent doGetRandomAccessContent(RandomAccessMode mode)
                                                throws Exception

Description copied from class: AbstractFileObject

Creates access to the file for random i/o. Is only called if AbstractFileObject.doGetType() returns FileType.FILE.

It is guaranteed that there are no open output streams for this file when this method is called.

Overrides:

doGetRandomAccessContent in class AbstractFileObject<FS extends Http4FileSystem>

Parameters:

mode - The mode to access the file.

Returns:

The RandomAccessContext.

Throws:

Exception - if an error occurs.

doListChildren

protected String[] doListChildren()
                           throws Exception

Description copied from class: AbstractFileObject

Lists the children of this file. Is only called if AbstractFileObject.doGetType() returns FileType.FOLDER. The return value of this method is cached, so the implementation can be expensive.

Specified by:

doListChildren in class AbstractFileObject<FS extends Http4FileSystem>

Returns:

a possible empty String array if the file is a directory or null or an exception if the file is not a directory or can't be read.

Throws:

Exception - if an error occurs.

doIsWriteable

protected boolean doIsWriteable()
                         throws Exception

Description copied from class: AbstractFileObject

Determines if this file can be written to. Is only called if AbstractFileObject.doGetType() does not return FileType.IMAGINARY.

This implementation always returns true.

Overrides:

doIsWriteable in class AbstractFileObject<FS extends Http4FileSystem>

Returns:

true if the file is writable.

Throws:

Exception - if an error occurs.

getFileContentInfoFactory

protected FileContentInfoFactory getFileContentInfoFactory()

Description copied from class: AbstractFileObject

Creates the FileContentInfo factory.

Overrides:

getFileContentInfoFactory in class AbstractFileObject<FS extends Http4FileSystem>

Returns:

The FileContentInfoFactory.

doDetach

protected void doDetach()
                 throws Exception

Description copied from class: AbstractFileObject

Detaches this file object from its file resource.

Called when this file is closed. Note that the file object may be reused later, so should be able to be reattached.

This implementation does nothing.

Overrides:

doDetach in class AbstractFileObject<FS extends Http4FileSystem>

Throws:

Exception - if an error occurs.

getUrlCharset

protected String getUrlCharset()

Return URL charset string.

Returns:

URL charset string

getInternalURI

protected URI getInternalURI()
                      throws FileSystemException

Return the internal URI object mapped to this file object.

Returns:

the internal URI object mapped to this file object

Throws:

FileSystemException - if any error occurs