java servletinputstream_javax.servlet.ServletInputStream翻译 | 学步园

javax.servlet

Class ServletInputStream

public abstract class ServletInputStream

Provides an input stream for reading binary data from a client request, including an efficient readLine method for reading data one line at a time. With some protocols, such as HTTP POST and PUT, a ServletInputStream object can be used to read data sent from the client. 提供了一种输入流用于从客户端请求中读取二进制数据，包括一次读取一行数据的高效方法readLine。使用了某些协议，比如HTTP POST和PUT，ServletInputStream对象可能用来读取客户端发送的数据。

A ServletInputStream object is normally retrieved via theServletRequest.getInputStream()method. ServletInputStream对象通常通过ServletRequest.getInputStream()方法获取。

This is an abstract class that a servlet container implements. Subclasses of this class must implement the java.io.InputStream.read() method. 这是一个抽象类，由servlet容器实现。该类的子类必须实现java.io.InputStream.read()方法。

Version:

$Version$

Author:

Various

See Also:

Constructor Summary

protected

Does nothing, because this is an abstract class. 不做任何事，因为这是一个抽象类。

Method Summary

int

(byte[] b, int off, int len)Reads the input stream, one line at a time. 读取输入流，一次一行。

Constructor Detail

ServletInputStream

protected ServletInputStream()

Does nothing, because this is an abstract class. 不做任何事，因为这是一个抽象类。

Method Detail

readLine

public int readLine(byte[] b,

int off,

int len)

throwsIOException

Reads the input stream, one line at a time. Starting at an offset, reads bytes into an array, until it reads a certain number of bytes or reaches a newline character, which it reads into the array as well. 读取输入流，一次一行。从偏移开始将字节读入数组，直到读入某数量的字节或者抵达一新行符，它也被读入数组。

This method returns -1 if it reaches the end of the input stream before reading the maximum number of bytes. 如果在读入最大数量的字节前，抵达输入流结尾，方法返回-1。

Parameters:

b - an array of bytes into which data is read 读入数据的字节数组

off - an integer specifying the character at which this method begins reading 一个整数，标明方法开始读取的字符位置

len - an integer specifying the maximum number of bytes to read 一个整数，标明读取的字节最大数

Returns:

an integer specifying the actual number of bytes read, or -1 if the end of the stream is reached 一个整数，标明读取的实际字节数，如果流抵达末尾，返回-1

Throws:

- if an input or output exception has occurred 如果发生输入输出异常时抛出

Copyright 2003 Sun Microsystems, Inc. All rights reserved.