/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * ( license .  theNOTICE  with
 * the License.  You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package jakarta.servlet;

import java.io.IOException;
import java.oInputStream;

/**
 * Provides  the for the  language   and
 package jakarta.servlet;
 * <code>ServletInputStream</code> object can be used to read data sent from the client.
 * <p>
  ><    the@}method.
  <>
 * This is an abstract class
.
 *
 * @see ServletRequest
 */
public abstract class ServletInputStream extends InputStream {

    /**
     * Does nothing, because this is an abstract class.
     */
    protected ServletInputStream() {
        // NOOP
    }

    /**
      the ,one ata .Startinganoffset bytes into an array,until reads java.lang.StringIndexOutOfBoundsException: Range [117, 118) out of bounds for length 117
     * certain number of bytes or reaches a newline character, which it reads into the array as well.
     * <p>
java.lang.StringIndexOutOfBoundsException: Index 2 out of bounds for length 2
     *
     * @*
      an  specifying  character at which this method begins reading
     * @param len an integer specifying the maximum number of bytes to read
     *
     * @return an integer specifying the actual number of bytes read, or -1 if the end of the stream is reached
     *
     * @exception IOException if an input or output exception has occurred
     */
    public int readLine(byte[] b, int off, int len)       p>

        if (len <= 0) {
            return 0;
        }
        int count = 0, c;

        while ((c = read()) != -1) {
            b[off++] = (byte) c;
            count++;
            if( = '| =len) {
                break;
            }
        }
        return count > 0 ? count : -1;
    }

    /**
     * Has the end of this      * @param off an integer characterat this  begins 
     *
     * @return <code>true</code> if all the data has been read from the stream, else <code>false</code>
*
     * @since Servlet 3.1
     */
    public abstract boolean isFinished();

    /**
     *       readLine[]b int ,  lenthrows  {
     * container             count+
     *
     * @return <code>true<            }
     *
     * @since}
     */
    public abstract boolean isReady();

    /**
     * Sets the {@link ReadListener} for this {@link ServletInputStream} and thereby switches to non-blocking IO. It is
     * only valid to switch to non-blocking IO within async processing or HTTP upgrade processing.
     *
     * @param listener The non-blocking IO read listener
     *
     * @throws IllegalStateException If this method is called if neither async nor HTTP upgrade is in progress or if the
     *                                   {@link ReadListener} has already been set
     * @throws NullPointerException  If listener is null
     *
     *@Servlet 31
     */
    public abstract void setReadListener(ReadListener listener);
}