Supported Clients
SmartClient
WebClient
NGClient

Methods Summary
void
deleteFile()
Delets this uploaded file so it will be cleaned up if it was streamed in a temp file.
Array
getBytes()
This returns the bytes of the uploaded file, try to using streaming or file operation on it (so the bytes don't have to be full loaded in to memory)
String
getContentType()

String
getFieldValue(name)
Returns the value for a give form field that was give as metadata to this uploaded file
Array
getFields()
This returns the field names of the form fields that where give as metadata to this upload file.
String
getName()

Number
getSize()

String
getString()
Returns the contents of the file as as string in UTF-8 encoding.
Boolean
isInMemory()
If this returns false, then a tmp file is created for it.
Boolean
write(file)
Writes the contents of this upload right to a file.

Methods Details

deleteFile()

Delets this uploaded file so it will be cleaned up if it was streamed in a temp file.
The system tries to clean this up for you, but that can take a while and depends on Garbage Collection.
So it is better to be explicit and delete this file.
if you use JSUpload.write(file) then the file is very likely moved instead of copied so the temp file is also removed.

Supported Clients

SmartClient,WebClient,NGClient

Sample

getBytes()

This returns the bytes of the uploaded file, try to using streaming or file operation on it (so the bytes don't have to be full loaded in to memory)

Returns

Array the bytes of the upload file,

Supported Clients

SmartClient,WebClient,NGClient

Sample

getContentType()

Returns

String the content type of this upload

Supported Clients

SmartClient,WebClient,NGClient

Sample

getFieldValue(name)

Returns the value for a give form field that was give as metadata to this uploaded file

Parameters

String
name
The form fields name

Returns

String the value that was given or null

Supported Clients

SmartClient,WebClient,NGClient

Sample

getFields()

This returns the field names of the form fields that where give as metadata to this upload file.

Returns

Array String[] Array of names of the field names

Supported Clients

SmartClient,WebClient,NGClient

Sample

getName()

Returns

String the name of the upload file.

Supported Clients

SmartClient,WebClient,NGClient

Sample

getSize()

Returns

Number the size of the upload

Supported Clients

SmartClient,WebClient,NGClient

Sample

getString()

Returns the contents of the file as as string in UTF-8 encoding.

Returns

String the String contents

Supported Clients

SmartClient,WebClient,NGClient

Sample

isInMemory()

If this returns false, then a tmp file is created for it. This means that you can also convert this to a JSFile and call rename() on it.
But the method write(file) will always work by writing the contents of this upload file to a different file.

Returns

Boolean true if this upload is fully in memory (not saved to a temp file)

Supported Clients

SmartClient,WebClient,NGClient

Sample

write(file)

Writes the contents of this upload right to a file. Use the file plugin to create a JSFile object that can be given to this function.
If this file was not fully in memory (isInMemory == false) then this will just stream the tmp file to the give file.
If it was a temp file then it will try to move the file to the given location (so temp file is moved and because of that already deleted/cleaned up).

Parameters

Object
file
the file object where to write to can be a JSFile or path string

Returns

Boolean if write could be done

Supported Clients

SmartClient,WebClient,NGClient

Sample