Add RecordingInputStream.asOutputStream()

[ato]

Using RecordingInputStream requires an awkward workaround when the API being recorded is not in the form of an InputStream, for example, if it's asynchronous. This adds a method to access the underlying RecordingOutputStream so you can write to it directly when that would be easier.

Before:

byte[] inputBuffer;
InputStream ris = recorder.inputWrap(new InputStream() {
    public int read(byte[] buffer, int off, int len) {
        System.arraycopy(inputBuffer, 0, buffer, off, len);
        return len;
    }

    public int read() { throw new AssertionError(); }
});

void onDataReceived(byte[] chunk) throws IOException {
    byte[] discardBuffer = new byte[chunk.length]
    inputBuffer = chunk;
    ris.read(discardBuffer, 0, chunk.length);
}

After:

InputStream ris = recorder.inputWrap(null);

void onDataReceived(byte[] chunk) throws IOException {
     ris.asOutputStream().write(chunk);
}

[ato]

Thinking about it again I realised you can simplify the workaround by passing the data to read() and then have the wrapped InputStream do nothing and just pretend to have written to the buffer. Although I think asOutputStream() is still worth having, because this code is rather deceptive and unexpected. It's also convenient to be able to pass the OutputStream to other the APIs that expect one.

InputStream ris = recorder.inputWrap(new InputStream() {
    public int read(byte[] buffer, int off, int len) {
        return len; // do nothing, buffer already has the expected data
    }

    public int read() { throw new AssertionError(); }
});

void onDataReceived(byte[] chunk) throws IOException {
    ris.read(chunk, 0, chunk.length);
}