GuardedOutputStream

com.bric.io

Class GuardedOutputStream

java.lang.Object
- java.io.OutputStream
- - com.bric.io.MeasuredOutputStream
  - - com.bric.io.GuardedOutputStream

All Implemented Interfaces:

Closeable, Flushable, AutoCloseable
```
public class GuardedOutputStream
extends MeasuredOutputStream
```
This restricts the amount of data that can be written to an underlying OutputStream.
This is especially useful in unit testing to ensure that certain blocks of data do not exceed their allotted size.

An IOException is thrown if you attempt to write more data than this stream was told to allow.

Field Summary
- Fields inherited from class com.bric.io.MeasuredOutputStream
  written

Constructor Summary

Constructors

Constructor and Description
`GuardedOutputStream(OutputStream out, long limit)` Constructs a new `GuardedOutputStream`.

Method Summary

All Methods

Instance Methods

Concrete Methods
Modifier and Type	Method and Description
`long`	`getLimit()` The number of bytes that can still be written to this stream.
`void`	`write(byte[] b)`
`void`	`write(byte[] b, int off, int len)`
`void`	`write(int b)`

Methods inherited from class com.bric.io.MeasuredOutputStream
addChangeListener, close, fireListeners, flush, getBytesWritten, isClosed, removeChangeListener

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - GuardedOutputStream
```
public GuardedOutputStream(OutputStream out,
                           long limit)
```
    Constructs a new GuardedOutputStream.
    
    Parameters:
    
    out - the underlying OutputStream to send data to.
    
    limit - the number of bytes that can be written
- Method Detail
  - getLimit
```
public long getLimit()
```
    The number of bytes that can still be written to this stream.
    (This value changes every time write() is called.)
    
    Returns:
    
    the number of bytes that can still be written to this stream.
  - write
```
public void write(byte[] b,
                  int off,
                  int len)
           throws IOException
```
    Overrides:
    
    write in class MeasuredOutputStream
    
    Throws:
    
    IOException
  - write
```
public void write(byte[] b)
           throws IOException
```
    Overrides:
    
    write in class MeasuredOutputStream
    
    Throws:
    
    IOException
  - write
```
public void write(int b)
           throws IOException
```
    Overrides:
    
    write in class MeasuredOutputStream
    
    Throws:
    
    IOException