Module org.omnifaces

Package org.omnifaces.resourcehandler

Class CombinedResourceInputStream

java.lang.Object

java.io.InputStream

org.omnifaces.resourcehandler.CombinedResourceInputStream

All Implemented Interfaces:

Closeable, AutoCloseable

public final class CombinedResourceInputStream
extends InputStream

This InputStream implementation takes care that all in the constructor given resources are been read in sequence.

Author:

Bauke Scholtz

Constructor Summary

Constructors

Constructor	Description
CombinedResourceInputStream(Set<Resource> resources, String contentType)	Creates an instance of CombinedResourceInputStream based on the given resources.

Method Summary

Modifier and Type	Method	Description
void	close()	Closes the InputStream of each resource.
int	read()	For each resource, read until its InputStream.read() returns -1 and then iterate to the InputStream of the next resource, if any available, else return -1.
int	read(byte[] b, int offset, int length)	For each resource, read until its InputStream.read() returns -1 and then iterate to the InputStream of the next resource, if any available, else return -1.

Methods inherited from class java.io.InputStream

available, mark, markSupported, nullInputStream, read, readAllBytes, readNBytes, readNBytes, reset, skip, skipNBytes, transferTo

Methods inherited from class java.lang.Object

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

Constructor Details

CombinedResourceInputStream

public CombinedResourceInputStream(Set<Resource> resources,
 String contentType)
                            throws IOException

Creates an instance of CombinedResourceInputStream based on the given resources. For each resource, the InputStream will be obtained and hold in an iterable collection.

Parameters:

resources - The resources to be read.

contentType - The content type of the combined resource; must not be null. When this is a JavaScript type (ending in /javascript), "use strict" directives will be stripped from the preamble of each resource to prevent them from ending up in the middle of the combined output.

Throws:

NullPointerException - When content type is null.

IOException - If something fails at I/O level.

Method Details

read

public int read()
         throws IOException

For each resource, read until its InputStream.read() returns -1 and then iterate to the InputStream of the next resource, if any available, else return -1.

Specified by:

read in class InputStream

Throws:

IOException

read

public int read(byte[] b,
 int offset,
 int length)
         throws IOException

For each resource, read until its InputStream.read() returns -1 and then iterate to the InputStream of the next resource, if any available, else return -1.

Overrides:

read in class InputStream

Throws:

IOException

close

public void close()
           throws IOException

Closes the InputStream of each resource. Whenever the InputStream.close() throws an IOException for the first time, it will be caught and be thrown after all resources have been closed. Any IOException which is thrown by a subsequent close will be ignored by design.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Overrides:

close in class InputStream

Throws:

IOException