Class MultipartRequestParameter
java.lang.Object
org.apache.sling.engine.impl.parameters.MultipartRequestParameter
- All Implemented Interfaces:
RequestParameter
The
MultipartRequestParameter
represents a request parameter
from a multipart/form-data POST request.
To not add a dependency to Servlet API 3 this class does not implement the
Servlet API 3 Part
interface. To support Servlet API 3 Part
s
the SlingPart
class wraps instances of this class.
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionbyte[]
get()
Returns the contents of the parameter as an array of bytes.Returns the content type passed by the browser ornull
if not defined.Returns the original filename in the client's filesystem, as provided by the browser (or other client software).Returns an InputStream that can be used to retrieve the contents of the file.getName()
long
getSize()
Returns the size in bytes of the parameter.Returns the contents of the parameter as a String, using the default character encoding.Returns the contents of the parameter as a String, using the specified encoding.boolean
Determines whether or not this instance represents a simple form field or an uploaded file.toString()
-
Constructor Details
-
MultipartRequestParameter
public MultipartRequestParameter(org.apache.commons.fileupload.FileItem delegatee)
-
-
Method Details
-
get
public byte[] get()Description copied from interface:RequestParameter
Returns the contents of the parameter as an array of bytes.- Returns:
- The contents of the parameter as an array of bytes.
-
getContentType
Description copied from interface:RequestParameter
Returns the content type passed by the browser ornull
if not defined.- Returns:
- The content type passed by the browser or
null
if not defined.
-
getInputStream
Description copied from interface:RequestParameter
Returns an InputStream that can be used to retrieve the contents of the file.Each call to this method returns a new
InputStream
to the request parameter data. Make sure to close the stream to prevent leaking resources.- Returns:
- An InputStream that can be used to retrieve the contents of the file.
- Throws:
IOException
- if an error occurs.
-
getFileName
Description copied from interface:RequestParameter
Returns the original filename in the client's filesystem, as provided by the browser (or other client software). In most cases, this will be the base file name, without path information. However, some clients, such as the Opera browser, do include path information.- Returns:
- The original filename in the client's filesystem.
-
getSize
public long getSize()Description copied from interface:RequestParameter
Returns the size in bytes of the parameter.- Returns:
- The size in bytes of the parameter.
-
getString
Description copied from interface:RequestParameter
Returns the contents of the parameter as a String, using the default character encoding. This method usesRequestParameter.get()
to retrieve the contents of the item.- Returns:
- The contents of the parameter, as a string.
-
getString
Description copied from interface:RequestParameter
Returns the contents of the parameter as a String, using the specified encoding. This method uses linkRequestParameter.get()
to retrieve the contents of the item.- Parameters:
enc
- The character encoding to use.- Returns:
- The contents of the parameter, as a string.
- Throws:
UnsupportedEncodingException
- if the requested character encoding is not available.
-
isFormField
public boolean isFormField()Description copied from interface:RequestParameter
Determines whether or not this instance represents a simple form field or an uploaded file.- Returns:
true
if the instance represents a simple form field;false
if it represents an uploaded file.
-
toString
-
getName
- Specified by:
getName
in interfaceRequestParameter
- Returns:
- the name of this
RequestParameter
-
getEncoding
-