Package org.eclipse.jetty.http

Class MultiPartFormInputStream

java.lang.Object

org.eclipse.jetty.http.MultiPartFormInputStream

public class MultiPartFormInputStream
extends java.lang.Object

MultiPartInputStream

Handle a MultiPart Mime input stream, breaking it up on the boundary into files and strings.

See Also:

https://tools.ietf.org/html/rfc7578

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
class	MultiPartFormInputStream.MultiPart
static class	MultiPartFormInputStream.NonCompliance

Constructor Summary

Constructors

Constructor	Description
MultiPartFormInputStream(java.io.InputStream in, java.lang.String contentType, javax.servlet.MultipartConfigElement config, java.io.File contextTmpDir)
MultiPartFormInputStream(java.io.InputStream in, java.lang.String contentType, javax.servlet.MultipartConfigElement config, java.io.File contextTmpDir, int maxParts)

Method Summary

Modifier and Type	Method	Description
void	deleteParts()	Delete any tmp storage for parts, and clear out the parts list.
int	getBufferSize()
java.util.EnumSet<MultiPartFormInputStream.NonCompliance>	getNonComplianceWarnings()
java.util.Collection<javax.servlet.http.Part>	getParsedParts()	Deprecated.
javax.servlet.http.Part	getPart(java.lang.String name)	Get the named Part.
java.util.Collection<javax.servlet.http.Part>	getParts()	Parse, if necessary, the multipart data and return the list of Parts.
boolean	isDeleteOnExit()	Deprecated. no replacement provided
boolean	isEmpty()
boolean	isWriteFilesWithFilenames()
protected void	parse()	Parse, if necessary, the multipart stream.
void	setBufferSize(int bufferSize)
void	setDeleteOnExit(boolean deleteOnExit)	Deprecated. no replacement provided.
void	setWriteFilesWithFilenames(boolean writeFilesWithFilenames)
protected void	throwIfError()	Throws an exception if one has been latched.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MultiPartFormInputStream

public MultiPartFormInputStream(java.io.InputStream in,
                                java.lang.String contentType,
                                javax.servlet.MultipartConfigElement config,
                                java.io.File contextTmpDir)

Parameters:

in - Request input stream

contentType - Content-Type header

config - MultipartConfigElement

contextTmpDir - javax.servlet.context.tempdir

MultiPartFormInputStream

public MultiPartFormInputStream(java.io.InputStream in,
                                java.lang.String contentType,
                                javax.servlet.MultipartConfigElement config,
                                java.io.File contextTmpDir,
                                int maxParts)

Parameters:

in - Request input stream

contentType - Content-Type header

config - MultipartConfigElement

contextTmpDir - javax.servlet.context.tempdir

maxParts - the maximum number of parts that can be parsed from the multipart content (0 for no parts allowed, -1 for unlimited parts).

Method Detail

getNonComplianceWarnings

public java.util.EnumSet<MultiPartFormInputStream.NonCompliance> getNonComplianceWarnings()

Returns:

an EnumSet of non compliances with the RFC that were accepted by this parser

isEmpty

public boolean isEmpty()

Returns:

whether the list of parsed parts is empty

getParsedParts

@Deprecated
public java.util.Collection<javax.servlet.http.Part> getParsedParts()

Deprecated.

Get the already parsed parts.

Returns:

the parts that were parsed

deleteParts

public void deleteParts()

Delete any tmp storage for parts, and clear out the parts list.

getParts

public java.util.Collection<javax.servlet.http.Part> getParts()
                                                       throws java.io.IOException

Parse, if necessary, the multipart data and return the list of Parts.

Returns:

the parts

Throws:

java.io.IOException - if unable to get the parts

getPart

public javax.servlet.http.Part getPart(java.lang.String name)
                                throws java.io.IOException

Get the named Part.

Parameters:

name - the part name

Returns:

the parts

Throws:

java.io.IOException - if unable to get the part

throwIfError

protected void throwIfError()
                     throws java.io.IOException

Throws an exception if one has been latched.

Throws:

java.io.IOException - the exception (if present)

parse

protected void parse()

Parse, if necessary, the multipart stream.

setDeleteOnExit

@Deprecated
public void setDeleteOnExit(boolean deleteOnExit)

Deprecated.

no replacement provided.

setWriteFilesWithFilenames

public void setWriteFilesWithFilenames(boolean writeFilesWithFilenames)

isWriteFilesWithFilenames

public boolean isWriteFilesWithFilenames()

isDeleteOnExit

@Deprecated
public boolean isDeleteOnExit()

Deprecated.

no replacement provided

getBufferSize

public int getBufferSize()

Returns:

the size of buffer used to read data from the input stream

setBufferSize

public void setBufferSize(int bufferSize)

Parameters:

bufferSize - the size of buffer used to read data from the input stream