bradleyross.j2ee.servlets

Class UploadServlet.Contents

java.lang.Object

bradleyross.j2ee.servlets.UploadServlet.Contents

Enclosing class:

UploadServlet

public class UploadServlet.Contents
extends Object

Contains information on the contents of a single part of a multipart form.

See http://www.w3.org/TR/html401/interact/forms.html#h-17.13.42 for a discussion of multipart/form-data.

All lines must end with \r\n. However, binary data may have \r\n in the middle of the material.

Author:

Bradley Ross

Field Summary

Fields

Modifier and Type	Field and Description
protected String	filename Filename associated with the part.
protected String	mime MIME code for the data in the part.
protected String	name Name of the part.
protected String	transferEncoding Content transfer encoding method for the element of the transaction.
protected byte[]	value The byte array containing the data for this part.

Constructor Summary

Constructors

Constructor and Description
UploadServlet.Contents()

Method Summary

Methods

Modifier and Type	Method and Description
byte[]	getContents() Obtains the byte array that was associated with this part of the form.
int	getContentsSize() Obtains the size of the byte array that was associated with this part of the form.
String	getFilename() Obtain the filename associated with the part.
String	getMime() Obtain mime type for part.
String	getName() Obtain the name of the part.
String	getTransferEncoding() Obtain the value for content-transfer-encoding.
void	parseLine(String lineValue) Parses header lines in an individual part of a multipart form.
void	setContents(byte[] input) Connect the byte array to the object.
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

name

protected String name

Name of the part.

filename

protected String filename

Filename associated with the part.

mime

protected String mime

MIME code for the data in the part.

transferEncoding

protected String transferEncoding

Content transfer encoding method for the element of the transaction.

According to the documentation, there are various encoding methods that can be used such as base64 and quoted-printable. These have not been seen in the browsers I have used, but I may have to allow for these encoding methods.

value

protected byte[] value

The byte array containing the data for this part.

Constructor Detail

UploadServlet.Contents

public UploadServlet.Contents()

Method Detail

getName

public String getName()

Obtain the name of the part.

Returns:

Name of part

getFilename

public String getFilename()

Obtain the filename associated with the part.

If the data was not taken from a file, a null value is returned.

Returns:

Filename associated with part

getMime

public String getMime()

Obtain mime type for part.

MIME types would only be associated with data taken from files.

Returns:

MIME code

getTransferEncoding

public String getTransferEncoding()

Obtain the value for content-transfer-encoding.

Returns:

Type of encoding

getContents

public byte[] getContents()

Obtains the byte array that was associated with this part of the form.

Returns:

byte array

getContentsSize

public int getContentsSize()

Obtains the size of the byte array that was associated with this part of the form.

Returns:

Size of byte array

parseLine

public void parseLine(String lineValue)

Parses header lines in an individual part of a multipart form.

This algorithm works if the values for the name and filename are surrounded by double quotes, there are no escaped characters with the values, and there are no spaces between the start of the word name or filename and the corresponding closing quote. It also assumes that the name parameter comes before the filename parameter. I'm not sure if these assumptions are valid.

Parameters:

lineValue - Line to be parsed

setContents

public void setContents(byte[] input)

Connect the byte array to the object.

Parameters:

input - Byte array to be attached to object

toString

public String toString()

Overrides:

toString in class Object