org.apache.tomcat.util.http.fileupload.impl

Class FileItemStreamImpl

java.lang.Object

org.apache.tomcat.util.http.fileupload.impl.FileItemStreamImpl

All Implemented Interfaces:

FileItemHeadersSupport, FileItemStream

public class FileItemStreamImpl
extends java.lang.Object
implements FileItemStream

Default implementation of FileItemStream.

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.tomcat.util.http.fileupload.FileItemStream

FileItemStream.ItemSkippedException

Constructor Summary

Constructors

Constructor and Description
FileItemStreamImpl(FileItemIteratorImpl pFileItemIterator, java.lang.String pName, java.lang.String pFieldName, java.lang.String pContentType, boolean pFormField, long pContentLength) Creates a new instance.

Method Summary

Modifier and Type	Method and Description
void	close() Closes the file item.
java.lang.String	getContentType() Returns the items content type, or null.
java.lang.String	getFieldName() Returns the items field name.
FileItemHeaders	getHeaders() Returns the file item headers.
java.lang.String	getName() Returns the items file name.
boolean	isFormField() Returns, whether this is a form field.
java.io.InputStream	openStream() Returns an input stream, which may be used to read the items contents.
void	setHeaders(FileItemHeaders pHeaders) Sets the file item headers.

Methods inherited from class java.lang.Object

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

Constructor Detail

FileItemStreamImpl

public FileItemStreamImpl(FileItemIteratorImpl pFileItemIterator,
                          java.lang.String pName,
                          java.lang.String pFieldName,
                          java.lang.String pContentType,
                          boolean pFormField,
                          long pContentLength)
                   throws FileUploadException,
                          java.io.IOException

Creates a new instance.

Parameters:

pFileItemIterator - Iterator for all files in this upload

pName - The items file name, or null.

pFieldName - The items field name.

pContentType - The items content type, or null.

pFormField - Whether the item is a form field.

pContentLength - The items content length, if known, or -1

Throws:

FileUploadException - If an error is encountered processing the request

java.io.IOException - Creating the file item failed.

Method Detail

getContentType

public java.lang.String getContentType()

Returns the items content type, or null.

Specified by:

getContentType in interface FileItemStream

Returns:

Content type, if known, or null.

getFieldName

public java.lang.String getFieldName()

Returns the items field name.

Specified by:

getFieldName in interface FileItemStream

Returns:

Field name.

getName

public java.lang.String getName()

Returns the items file name.

Specified by:

getName in interface FileItemStream

Returns:

File name, if known, or null.

Throws:

InvalidFileNameException - The file name contains a NUL character, which might be an indicator of a security attack. If you intend to use the file name anyways, catch the exception and use InvalidFileNameException#getName().

isFormField

public boolean isFormField()

Returns, whether this is a form field.

Specified by:

isFormField in interface FileItemStream

Returns:

True, if the item is a form field, otherwise false.

openStream

public java.io.InputStream openStream()
                               throws java.io.IOException

Returns an input stream, which may be used to read the items contents.

Specified by:

openStream in interface FileItemStream

Returns:

Opened input stream.

Throws:

java.io.IOException - An I/O error occurred.

See Also:

FileItemStream.ItemSkippedException

close

public void close()
           throws java.io.IOException

Closes the file item.

Throws:

java.io.IOException - An I/O error occurred.

getHeaders

public FileItemHeaders getHeaders()

Returns the file item headers.

Specified by:

getHeaders in interface FileItemHeadersSupport

Returns:

The items header object

setHeaders

public void setHeaders(FileItemHeaders pHeaders)

Sets the file item headers.

Specified by:

setHeaders in interface FileItemHeadersSupport

Parameters:

pHeaders - The items header object