org.apache.catalina.servlets

Class RangeUtils

java.lang.Object

org.apache.catalina.servlets.RangeUtils

public class RangeUtils
extends Object

This class is based on code from Tomcat's DefaultServlet, available at : http://svn.apache.org/repos/asf/tomcat/tc6.0.x/trunk/java/org/apache/catalina/servlets/DefaultServlet.java

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	RangeUtils.Range

Field Summary

Fields

Modifier and Type	Field and Description
static List<RangeUtils.Range>	FULL Full range marker.
static String	MIME_SEPARATION MIME multipart separation string

Constructor Summary

Constructors

Constructor and Description
RangeUtils()

Method Summary

Modifier and Type	Method and Description
static void	copy(InputStream resourceInputStream, javax.servlet.ServletOutputStream ostream, Iterator<RangeUtils.Range> ranges, String contentType) Copy the contents of the specified input stream to the specified output stream, and ensure that both streams are closed before returning (even in the face of an exception).
static void	copy(InputStream resourceInputStream, javax.servlet.ServletOutputStream ostream, RangeUtils.Range range) Copy the contents of the specified input stream to the specified output stream, and ensure that both streams are closed before returning (even in the face of an exception).
static IOException	copyRange(InputStream istream, javax.servlet.ServletOutputStream ostream, long start, long end) Copy the contents of the specified input stream to the specified output stream, and ensure that both streams are closed before returning (even in the face of an exception).
static int	getInputBufferSize()
static int	getOutput()
static List<RangeUtils.Range>	parseRange(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, String eTag, long lastModified, long fileLength) Parse the range header.
static void	setInputBufferSize(int inputBufferSize)
static void	setOutput(int output)

Methods inherited from class java.lang.Object

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

Field Detail

FULL

public static final List<RangeUtils.Range> FULL

Full range marker.

MIME_SEPARATION

public static final String MIME_SEPARATION

MIME multipart separation string

See Also:

Constant Field Values

Constructor Detail

RangeUtils

public RangeUtils()

Method Detail

parseRange

public static List<RangeUtils.Range> parseRange(javax.servlet.http.HttpServletRequest request,
                                                javax.servlet.http.HttpServletResponse response,
                                                String eTag,
                                                long lastModified,
                                                long fileLength)
                                         throws IOException

Parse the range header.

Parameters:

request - The servlet request we are processing

response - The servlet response we are creating

Returns:

Vector of ranges

Throws:

IOException

copy

public static void copy(InputStream resourceInputStream,
                        javax.servlet.ServletOutputStream ostream,
                        RangeUtils.Range range)
                 throws IOException

Copy the contents of the specified input stream to the specified output stream, and ensure that both streams are closed before returning (even in the face of an exception).

Parameters:

ostream - The output stream to write to

range - Range the client wanted to retrieve

Throws:

IOException - if an input/output error occurs

copy

public static void copy(InputStream resourceInputStream,
                        javax.servlet.ServletOutputStream ostream,
                        Iterator<RangeUtils.Range> ranges,
                        String contentType)
                 throws IOException

Copy the contents of the specified input stream to the specified output stream, and ensure that both streams are closed before returning (even in the face of an exception).

Parameters:

ostream - The output stream to write to

ranges - Enumeration of the ranges the client wanted to retrieve

contentType - Content type of the resource

Throws:

IOException - if an input/output error occurs

copyRange

public static IOException copyRange(InputStream istream,
                                    javax.servlet.ServletOutputStream ostream,
                                    long start,
                                    long end)

Copy the contents of the specified input stream to the specified output stream, and ensure that both streams are closed before returning (even in the face of an exception).

Parameters:

istream - The input stream to read from

ostream - The output stream to write to

start - Start of the range which will be copied

end - End of the range which will be copied

Returns:

Exception which occurred during processing

getInputBufferSize

public static int getInputBufferSize()

setInputBufferSize

public static void setInputBufferSize(int inputBufferSize)

getOutput

public static int getOutput()

setOutput

public static void setOutput(int output)