DRAFT

javax.servlet.http
Interface Part


public interface Part

This class represents a part or form item that was received within a multipart/form-data POST request.

Since:
Servlet 3.0

Method Summary
 void delete()
          Deletes the underlying storage for a file item, including deleting any associated temporary disk file.
 java.lang.String getContentType()
          Gets the content type of this part.
 java.lang.String getHeader(java.lang.String name)
          Returns the value of the specified mime header as a String.
 java.lang.Iterable<java.lang.String> getHeaderNames()
          Returns an Iterable of all the header names this part contains.
 java.lang.Iterable<java.lang.String> getHeaders(java.lang.String name)
          Returns all the values of the specified Part header as an Iterable of String objects.
 java.io.InputStream getInputStream()
          Gets the content of this part as an InputStream
 java.lang.String getName()
          Gets the name of this part
 long getSize()
          Returns the size of this fille.
 void write(java.lang.String fileName)
          A convenience method to write this uploaded item to disk.
 

Method Detail

getInputStream

java.io.InputStream getInputStream()
                                   throws java.io.IOException
Gets the content of this part as an InputStream

Returns:
The content of this part as an InputStream
Throws:
java.io.IOException - If an error occurs in retrieving the contet as an InputStream

getContentType

java.lang.String getContentType()
Gets the content type of this part.

Returns:
The content type of this part.

getName

java.lang.String getName()
Gets the name of this part

Returns:
The name of this part as a String

getSize

long getSize()
Returns the size of this fille.

Returns:
a long specifying the size of this part, in bytes.

write

void write(java.lang.String fileName)
           throws java.io.IOException
A convenience method to write this uploaded item to disk.

This method is not guaranteed to succeed if called more than once for the same part. This allows a particular implementation to use, for example, file renaming, where possible, rather than copying all of the underlying data, thus gaining a significant performance benefit.

Parameters:
fileName - aString specifying the file name which the stream is written out to. The file is created relative to the location as specified in the MultipartConfig
Throws:
java.io.IOException - if an error occurs.

delete

void delete()
            throws java.io.IOException
Deletes the underlying storage for a file item, including deleting any associated temporary disk file.

Throws:
java.io.IOException - if an error occurs.

getHeader

java.lang.String getHeader(java.lang.String name)
Returns the value of the specified mime header as a String. If the Part did not include a header of the specified name, this method returns null. If there are multiple headers with the same name, this method returns the first header in the part. The header name is case insensitive. You can use this method with any request header.

Parameters:
name - a String specifying the header name
Returns:
a String containing the value of the requested header, or null if the part does not have a header of that name

getHeaders

java.lang.Iterable<java.lang.String> getHeaders(java.lang.String name)
Returns all the values of the specified Part header as an Iterable of String objects.

If the Part did not include any headers of the specified name, this method returns an empty Iterable. The header name is case insensitive. You can use this method with any Part header.

Parameters:
name - a String specifying the header name
Returns:
an Iterable containing the values of the requested header. If the Part does not have any headers of that name return an empty Iterable. If the container does not allow access to header information, return null

getHeaderNames

java.lang.Iterable<java.lang.String> getHeaderNames()
Returns an Iterable of all the header names this part contains. If the part has no headers, this method returns an empty Iterable.

Some servlet containers do not allow servlets to access headers using this method, in which case this method returns null

Returns:
an Iterable of all the header names sent with this part; if the part has no headers, an empty Iterable; if the servlet container does not allow servlets to use this method, null

DRAFT

Submit a bug or feature

Copyright © 2009 Sun Microsystems, Inc. All Rights Reserved. Use is subject to license terms.