MultipartParser (Cos 2017.5 API)

java.lang.Object
- com.oreilly.servlet.multipart.MultipartParser

```
public class MultipartParser
extends java.lang.Object
```
A utility class to handle multipart/form-data requests, the kind of requests that support file uploads. This class uses a "pull" model where the reading of incoming files and parameters is controlled by the client code, which allows incoming files to be stored into any OutputStream. If you wish to use an API which resembles HttpServletRequest, use the "push" model MultipartRequest instead. It's an easy-to-use wrapper around this class.
This class can receive arbitrarily large files (up to an artificial limit you can set), and fairly efficiently too. It cannot handle nested data (multipart content within multipart content). It can now with the latest release handle internationalized content (such as non Latin-1 filenames).
It also optionally includes enhanced buffering and Content-Length limitation. Buffering is only required if your servlet container is poorly implemented (many are, including Tomcat 3.2), but it is generally recommended because it will make a slow servlet container a lot faster, and will only make a fast servlet container a little slower. Content-Length limiting is usually only required if you find that your servlet is hanging trying to read the input stram from the POST, and it is similarly recommended because it only has a minimal impact on performance.
See the included upload.war for an example of how to use this class.
The full file upload specification is contained in experimental RFC 1867, available at http://www.ietf.org/rfc/rfc1867.txt.

版本:

1.13, 2004/09/01, added workaround if content-length is -1, 1.12, 2004/05/17, added trim on disposition, 1.11, 2002/11/01, added constructor that takes an encoding, to make sure chars are always read correctly, 1.10, 2002/11/01, added support for a preamble before the first boundary marker, 1.9, 2002/11/01, added support to parse odd Opera Content-Type, 1.8, 2002/11/01, added support for lynx with unquoted param vals, 1.7, 2002/04/30, fixed bug if a line was '\n' alone, 1.6, 2002/04/30, added better internationalization support, thanks to Changshin Lee, 1.5, 2002/04/30, added Opera header fix, thanks to Nic Ferrier, 1.4, 2001/03/23, added IE5 bug workaround supporting \n as line ending, thanks to Michael Alyn Miller, 1.3, 2001/01/22, added support for boundaries surrounded by quotes and content-disposition after content-type, thanks to Scott Stark, 1.2, 2001/01/22, getFilePath() support thanks to Stefan Eissing, 1.1, 2000/10/29, integrating old WebSphere fix, 1.0, 2000/10/27, initial revision

作者:

Jason Hunter, Geoff Soutter

另请参阅:
MultipartRequest

构造器概要

构造器
构造器和说明
`MultipartParser(javax.servlet.http.HttpServletRequest req, int maxSize)` Creates a `MultipartParser` from the specified request, which limits the upload size to the specified length, buffers for performance and prevent attempts to read past the amount specified by the Content-Length.
`MultipartParser(javax.servlet.http.HttpServletRequest req, int maxSize, boolean buffer, boolean limitLength)` Creates a `MultipartParser` from the specified request, which limits the upload size to the specified length, and optionally buffers for performance and prevents attempts to read past the amount specified by the Content-Length.
`MultipartParser(javax.servlet.http.HttpServletRequest req, int maxSize, boolean buffer, boolean limitLength, java.lang.String encoding)` Creates a `MultipartParser` from the specified request, which limits the upload size to the specified length, and optionally buffers for performance and prevents attempts to read past the amount specified by the Content-Length, and with a specified encoding.

方法概要

方法
限定符和类型	方法和说明
`Part`	`readNextPart()` Read the next part arriving in the stream.
`void`	`setEncoding(java.lang.String encoding)` Sets the encoding used to parse from here onward.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - MultipartParser
```
public MultipartParser(javax.servlet.http.HttpServletRequest req,
               int maxSize)
                throws java.io.IOException
```
    Creates a MultipartParser from the specified request, which limits the upload size to the specified length, buffers for performance and prevent attempts to read past the amount specified by the Content-Length.
    
    参数:
    req - the servlet request.
    maxSize - the maximum size of the POST content.
    
    抛出:
    
    java.io.IOException
  - MultipartParser
```
public MultipartParser(javax.servlet.http.HttpServletRequest req,
               int maxSize,
               boolean buffer,
               boolean limitLength)
                throws java.io.IOException
```
    Creates a MultipartParser from the specified request, which limits the upload size to the specified length, and optionally buffers for performance and prevents attempts to read past the amount specified by the Content-Length.
    
    参数:
    req - the servlet request.
    maxSize - the maximum size of the POST content.
    buffer - whether to do internal buffering or let the server buffer, useful for servers that don't buffer
    limitLength - boolean flag to indicate if we need to filter the request's input stream to prevent trying to read past the end of the stream.
    
    抛出:
    
    java.io.IOException
  - MultipartParser
```
public MultipartParser(javax.servlet.http.HttpServletRequest req,
               int maxSize,
               boolean buffer,
               boolean limitLength,
               java.lang.String encoding)
                throws java.io.IOException
```
    Creates a MultipartParser from the specified request, which limits the upload size to the specified length, and optionally buffers for performance and prevents attempts to read past the amount specified by the Content-Length, and with a specified encoding.
    
    参数:
    req - the servlet request.
    maxSize - the maximum size of the POST content.
    buffer - whether to do internal buffering or let the server buffer, useful for servers that don't buffer
    limitLength - boolean flag to indicate if we need to filter the request's input stream to prevent trying to read past the end of the stream.
    encoding - the encoding to use for parsing, default is ISO-8859-1.
    
    抛出:
    
    java.io.IOException
- 方法详细资料
  - setEncoding
```
public void setEncoding(java.lang.String encoding)
```
    Sets the encoding used to parse from here onward. The default is ISO-8859-1. Encodings are actually best passed into the contructor, so even the initial line reads are correct.
    
    参数:
    encoding - The encoding to use for parsing
  - readNextPart
```
public Part readNextPart()
                  throws java.io.IOException
```
    Read the next part arriving in the stream. Will be either a FilePart or a ParamPart, or null to indicate there are no more parts to read. The order of arrival corresponds to the order of the form elements in the submitted form.
    
    返回:
    either a FilePart, a ParamPart or null if there are no more parts to read.
    
    抛出:
    
    java.io.IOException - if an input or output exception has occurred.
    另请参阅:
    FilePart, ParamPart

类 MultipartParser

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

MultipartParser

MultipartParser

MultipartParser

方法详细资料

setEncoding

readNextPart