2
* $HeadURL: https://svn.apache.org/repos/asf/httpcomponents/httpcore/tags/4.0.1/httpcore-nio/src/main/java/org/apache/http/nio/util/ContentInputBuffer.java $
4
* $Date: 2009-02-14 18:34:58 +0100 (Sat, 14 Feb 2009) $
6
* ====================================================================
7
* Licensed to the Apache Software Foundation (ASF) under one
8
* or more contributor license agreements. See the NOTICE file
9
* distributed with this work for additional information
10
* regarding copyright ownership. The ASF licenses this file
11
* to you under the Apache License, Version 2.0 (the
12
* "License"); you may not use this file except in compliance
13
* with the License. You may obtain a copy of the License at
15
* http://www.apache.org/licenses/LICENSE-2.0
17
* Unless required by applicable law or agreed to in writing,
18
* software distributed under the License is distributed on an
19
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
20
* KIND, either express or implied. See the License for the
21
* specific language governing permissions and limitations
23
* ====================================================================
25
* This software consists of voluntary contributions made by many
26
* individuals on behalf of the Apache Software Foundation. For more
27
* information on the Apache Software Foundation, please see
28
* <http://www.apache.org/>.
32
package org.apache.http.nio.util;
34
import java.io.IOException;
36
import org.apache.http.nio.ContentDecoder;
39
* Buffer for storing content streamed out from a {@link ContentDecoder}.
42
* @version $Revision: 744545 $
46
public interface ContentInputBuffer {
49
* Reads content from the given {@link ContentDecoder} and stores it in
52
* @param decoder the content decoder.
53
* @return number of bytes read.
54
* @throws IOException in case of an I/O error.
56
int consumeContent(ContentDecoder decoder) throws IOException;
59
* Resets the buffer by clearing its state and stored content.
64
* Reads up to <code>len</code> bytes of data from this buffer into
65
* an array of bytes. The exact number of bytes read depends how many bytes
66
* are stored in the buffer.
68
* <p> If <code>off</code> is negative, or <code>len</code> is negative, or
69
* <code>off+len</code> is greater than the length of the array
70
* <code>b</code>, this method can throw a runtime exception. The exact type
71
* of runtime exception thrown by this method depends on implementation.
72
* This method returns <code>-1</code> if the end of content stream has been
75
* @param b the buffer into which the data is read.
76
* @param off the start offset in array <code>b</code>
77
* at which the data is written.
78
* @param len the maximum number of bytes to read.
79
* @return the total number of bytes read into the buffer, or
80
* <code>-1</code> if there is no more data because the end of
81
* the stream has been reached.
82
* @exception IOException if an I/O error occurs.
84
int read(byte[] b, int off, int len) throws IOException;
87
* Reads one byte from this buffer. If the buffer is empty this method can
88
* throw a runtime exception. The exact type of runtime exception thrown
89
* by this method depends on implementation. This method returns
90
* <code>-1</code> if the end of content stream has been reached.
94
int read() throws IOException;