io.micronaut.http.server.types.files

Class StreamedFile

java.lang.Object

io.micronaut.http.server.types.files.StreamedFile

All Implemented Interfaces:

CustomizableResponseType, FileCustomizableResponseType

Direct Known Subclasses:

NettyStreamedFileCustomizableResponseType

public class StreamedFile
extends Object
implements FileCustomizableResponseType

A special type for streaming an InputStream representing a file or resource.

Since:

1.0

Author:

James Kleeh

Field Summary

Fields inherited from interface io.micronaut.http.server.types.files.FileCustomizableResponseType

ATTACHMENT_HEADER

Constructor Summary

Constructors

Constructor and Description
StreamedFile(InputStream inputStream, MediaType mediaType)
StreamedFile(InputStream inputStream, MediaType mediaType, long lastModified)
StreamedFile(InputStream inputStream, MediaType mediaType, long lastModified, long contentLength)
StreamedFile(URL url) Immediately opens a connection to the given URL to retrieve data about the connection, including the input stream.

Method Summary

Modifier and Type	Method and Description
StreamedFile	attach(String attachmentName) Sets the file to be downloaded as an attachment.
InputStream	getInputStream()
long	getLastModified()
long	getLength()
MediaType	getMediaType()
void	process(MutableHttpResponse<?> response) Modify the response before it is written to the client.

Methods inherited from class java.lang.Object

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

Constructor Detail

StreamedFile

public StreamedFile(InputStream inputStream,
                    MediaType mediaType)

Parameters:

inputStream - The input stream

mediaType - The media type of the content

StreamedFile

public StreamedFile(InputStream inputStream,
                    MediaType mediaType,
                    long lastModified)

Parameters:

inputStream - The input stream

mediaType - The media type of the content

lastModified - The last modified date

StreamedFile

public StreamedFile(InputStream inputStream,
                    MediaType mediaType,
                    long lastModified,
                    long contentLength)

Parameters:

inputStream - The input stream

mediaType - The media type of the content

lastModified - The last modified date

contentLength - the content length

StreamedFile

public StreamedFile(URL url)

Immediately opens a connection to the given URL to retrieve data about the connection, including the input stream.

Parameters:

url - The URL to resource

Method Detail

getLastModified

public long getLastModified()

Specified by:

getLastModified in interface FileCustomizableResponseType

Returns:

The last modified date of the file

getLength

public long getLength()

Specified by:

getLength in interface FileCustomizableResponseType

Returns:

The length of the file

getMediaType

public MediaType getMediaType()

Specified by:

getMediaType in interface FileCustomizableResponseType

Returns:

The media type of the file

getInputStream

public InputStream getInputStream()

Returns:

The stream used to retrieve data for the file

attach

public StreamedFile attach(String attachmentName)

Sets the file to be downloaded as an attachment. The name is set in the Content-Disposition header.

Parameters:

attachmentName - The attachment name.

Returns:

The same StreamedFile instance

process

public void process(MutableHttpResponse<?> response)

Description copied from interface: CustomizableResponseType

Modify the response before it is written to the client.

Specified by:

process in interface CustomizableResponseType

Parameters:

response - The response to modify