File	Doc	Category	Size	Date	Package
ThresholdingOutputStream.java	API Doc	Apache Tomcat 6.0.14	7224	Fri Jul 20 04:20:36 BST 2007	org.apache.tomcat.util.http.fileupload

ThresholdingOutputStream

• java.lang.Object
  • java.io.OutputStream

Fields Summary
private int	threshold The threshold at which the event will be triggered.
private long	written The number of bytes written to the output stream.
private boolean	thresholdExceeded Whether or not the configured threshold has been exceeded.

Constructors Summary
public ThresholdingOutputStream(int threshold) Constructs an instance of this class which will trigger an event at the specified threshold. param threshold The number of bytes at which to trigger an event. this.threshold = threshold;

Methods Summary
protected void	checkThreshold(int count) Checks to see if writing the specified number of bytes would cause the configured threshold to be exceeded. If so, triggers an event to allow a concrete implementation to take action on this. param count The number of bytes about to be written to the underlying output stream. exception IOException if an error occurs. if (!thresholdExceeded && (written + count > threshold)) { thresholdReached(); thresholdExceeded = true; }
public void	close() Closes this output stream and releases any system resources associated with this stream. exception IOException if an error occurs. try { flush(); } catch (IOException ignored) { // ignore } getStream().close();
public void	flush() Flushes this output stream and forces any buffered output bytes to be written out. exception IOException if an error occurs. getStream().flush();
public long	getByteCount() Returns the number of bytes that have been written to this output stream. return The number of bytes written. return written;
protected abstract java.io.OutputStream	getStream() Returns the underlying output stream, to which the corresponding OutputStream methods in this class will ultimately delegate. return The underlying output stream. exception IOException if an error occurs.
public int	getThreshold() Returns the threshold, in bytes, at which an event will be triggered. return The threshold point, in bytes. return threshold;
public boolean	isThresholdExceeded() Determines whether or not the configured threshold has been exceeded for this output stream. return true if the threshold has been reached; false otherwise. return (written > threshold);
protected abstract void	thresholdReached() Indicates that the configured threshold has been reached, and that a subclass should take whatever action necessary on this event. This may include changing the underlying output stream. exception IOException if an error occurs.
public void	write(int b) Writes the specified byte to this output stream. param b The byte to be written. exception IOException if an error occurs. checkThreshold(1); getStream().write(b); written++;
public void	write(byte[] b) Writes b.length bytes from the specified byte array to this output stream. param b The array of bytes to be written. exception IOException if an error occurs. checkThreshold(b.length); getStream().write(b); written += b.length;
public void	write(byte[] b, int off, int len) Writes len bytes from the specified byte array starting at offset off to this output stream. param b The byte array from which the data will be written. param off The start offset in the byte array. param len The number of bytes to write. exception IOException if an error occurs. checkThreshold(len); getStream().write(b, off, len); written += len;