UrlEncodedDataGetter.java

package com.renomad.minum.web;

import java.io.ByteArrayOutputStream;

import java.io.IOException;

import java.io.InputStream;

/**

 * This class enables pulling key-value pairs one at a time

 * from the Request body. This enables the developer to pull data

 * incrementally, rather than reading it all into memory at once.

 */

public final class UrlEncodedDataGetter extends InputStream {

    private final InputStream inputStream;

    private final CountBytesRead countBytesRead;

    private final long contentLength;

    /**

     * After we hit the boundary, we will set this flag to true, and all

     * subsequent reads will return -1.

     */

    /**

     * Mostly similar behavior to {@link InputStream#read()}

     */

    @Override

    public int read() {

        }

        }

        try {

            // I know this is surprising, however: Because we always have the content length while reading the body,

            // we know exactly when we expect to read the last byte.  If we read and get a -1, it means

            // the stream is closed - but that should not have happened, because we should have stopped reading when

            // we hit the limit of bytes to read.  But in the real world, it will happen:  You can observe it by uploading a large

            // file and using the browser's "stop" button during the upload.

        }

        }

    }

    @Override

    public byte[] readAllBytes() {

        while (true) {

                // if our read function determines we are at the end of the value,

                // because we encountered an ampersand, it will return a -1 value,

                // and we return our value - but more keys and values expected.

            }

    }

    /**

     * By "close", we will read from the {@link InputStream} until we have finished the body,

     * so that our InputStream has been read until the start of the next partition.

     */

    @Override

    public void close() {

        while (true) {

            }

    }

}

Mutations