Package org.apache.wicket.resource

Class FileSystemResource

java.lang.Object

org.apache.wicket.request.resource.AbstractResource

org.apache.wicket.resource.FileSystemResource

All Implemented Interfaces:

java.io.Serializable, IResource, org.apache.wicket.util.io.IClusterable

public class FileSystemResource
extends AbstractResource

Used to provide resources based on the on Java NIO FileSystem API.

For more information see FileSystemResourceReference

Author:

Tobias Soloschenko

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.wicket.request.resource.AbstractResource

AbstractResource.ContentRangeType, AbstractResource.ResourceResponse, AbstractResource.WriteCallback

Nested classes/interfaces inherited from interface org.apache.wicket.request.resource.IResource

IResource.Attributes

Field Summary

Fields inherited from class org.apache.wicket.request.resource.AbstractResource

CONTENT_DISPOSITION_HEADER_NAME, CONTENT_RANGE_ENDBYTE, CONTENT_RANGE_STARTBYTE, INTERNAL_HEADERS

Constructor Summary

Constructors

Constructor	Description
FileSystemResource()	Creates a new file system resource
FileSystemResource(java.nio.file.Path path)	Creates a new file system resource based on the given path

Method Summary

Modifier and Type	Method	Description
protected AbstractResource.ResourceResponse	createResourceResponse(IResource.Attributes attributes, java.nio.file.Path path)	Creates a resource response based on the given attributes
protected java.io.InputStream	getInputStream()	Gets the input stream of the given path
protected java.lang.String	getMimeType()	Gets the mime type to be used for the response it first uses the URL connection to get the mime type and after this the FileTypeDetector SPI is used.
protected long	getSize()	Gets the size of the resource
protected AbstractResource.ResourceResponse	newResourceResponse(IResource.Attributes attributes)	Creates a new resource response and reads the given path
void	respond(IResource.Attributes attributes)	Renders this resource to response using the provided attributes.

Methods inherited from class org.apache.wicket.request.resource.AbstractResource

configureCache, getCachingStrategy, setRequestMetaData, setRequestRangeMetaData, setResponseContentRangeHeaderFields, setResponseHeaders

Methods inherited from class java.lang.Object

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

Constructor Detail

FileSystemResource

public FileSystemResource(java.nio.file.Path path)

Creates a new file system resource based on the given path

Parameters:

path - the path to be read for the resource

FileSystemResource

public FileSystemResource()

Creates a new file system resource

Method Detail

newResourceResponse

protected AbstractResource.ResourceResponse newResourceResponse(IResource.Attributes attributes)

Creates a new resource response and reads the given path

Specified by:

newResourceResponse in class AbstractResource

Parameters:

attributes - request attributes

Returns:

resource data instance

respond

public void respond(IResource.Attributes attributes)

Description copied from interface: IResource

Renders this resource to response using the provided attributes.

Specified by:

respond in interface IResource

Overrides:

respond in class AbstractResource

See Also:

IResource.respond(org.apache.wicket.request.resource.IResource.Attributes)

createResourceResponse

protected AbstractResource.ResourceResponse createResourceResponse(IResource.Attributes attributes,
                                                                   java.nio.file.Path path)

Creates a resource response based on the given attributes

Parameters:

path - the path to create the resource response with

attributes - request attributes

Returns:

the actual resource response

getSize

protected long getSize()
                throws java.io.IOException

Gets the size of the resource

Returns:

the size of the resource

Throws:

java.io.IOException - if the size attribute can't be read

getMimeType

protected java.lang.String getMimeType()
                                throws java.io.IOException

Gets the mime type to be used for the response it first uses the URL connection to get the mime type and after this the FileTypeDetector SPI is used.

Returns:

the mime type to be used for the response

Throws:

java.io.IOException - if the mime type couldn't be resolved

getInputStream

protected java.io.InputStream getInputStream()
                                      throws java.io.IOException

Gets the input stream of the given path

Returns:

the input stream of the given path

Throws:

java.io.IOException - if there is an exception while receiving the input stream