- Properties and Parameters -

JFileDownload supports most JFileUpload parameters. They can be setup in applet such as <PARAM NAME="" VALUE="">. The list below describe parameters you should need to control download behavior.

JFileDownload parameters
Parameters Description and sample
url Server URL that will process the download. For instance:
For FTP: ftp://yourserver.com
For HTTP: http://yourserver.com/something/process.php
itemX

itemX (with X starting to 1) allows to setup filenames or foldernames to download from the FTP or HTTP server. For instance, if you want to download file1.zip, file2.pdf and fullfolder2 then you have to setup:
<PARAM NAME="item1" VALUE="file1.zip">
<PARAM NAME="item2" VALUE="file2.pdf ">
<PARAM NAME="item3" VALUE="fullfolder2">
Values are relative to url parameter. If you have:
<PARAM NAME="url" VALUE="ftp://yourserver.com">
then file1.zip (i.e. item1) will be download from:
ftp://yourserver.com/file1.zip

mode This parameter allows selecting either FTP or HTTP download.
For FTP it must be: jfileupload.download.ftp.FTPDownloadTransfer
For HTTP it must be: jfileupload.download.http.HTTPDownloadTransfer
resume This parameter enables resume support for broken transfer.
<PARAM NAME="resume" VALUE="true">
overwrite This parameter makes the applet overwrite or rename duplicated files to download. To display an error for duplicated file:
<PARAM NAME="overwrite" VALUE="false">
To rename file by appending an incremental number:
<PARAM NAME="overwrite" VALUE="indexrename">
Setup this parameter to "false" to enable resume/overwrite/skip pop-up. Pop-up usage also requires resume enabled:
<PARAM NAME="overwrite" VALUE="false">
<PARAM NAME="resume" VALUE="true">
authentication Setup this parameter to "auto" to enable either FTP or HTTP authentication pop-up when required.
<PARAM NAME="authentication" VALUE="auto">
folderdepth Setup this parameter to "-1" to enable recursive folders download.
<PARAM NAME="folderdepth" VALUE="-1">
To enable folders/subfolders structure recomposition while dowloading, add "relativefilename" extra parameter:
<PARAM NAME="param2" VALUE="relativefilename">
<PARAM NAME="value2" VALUE="true">
account Setup this extra parameter to define an initial folder for files and folders to download. For instance, if file1.zip and file2.zip to download are available into ftp://yourserver.com/user1/ then use:
<PARAM NAME="url" VALUE="ftp://yourserver.com">
<PARAM NAME="param3" VALUE="account">
<PARAM NAME="value3" VALUE="user1">
<PARAM NAME="item1" VALUE="file1.zip">
<PARAM NAME="item2" VALUE="file2.zip">
resources This parameter allows to setup your own JFileDownload progress bar front-end properties: <PARAM NAME=iresources" VALUE="i18n_bar">
transferui This parameter must be jfileupload.download.ui.DownloadTransferUI to enable download front-end.
transferuiresources This parameter allows to setup your own JFileDownload front-end properties (except progress bar):
<PARAM NAME="transferuiresources" VALUE="i18n_pane">
transferuiparamX and transferuivalueX pair Up to 8 parameters could be passed to JFileDownload through transferuiparamX and transferuivalueX (with X in [1,8]). These parameters are reserved for a future usage.

Here is the list and the meaning of a JFileDownload front-end properties. They can be setup in i18n_pane.properties text file.

JFileDownload properties
Properties Description and sample
savefilepanel.empty This property allows updating "No file to download" label.
savefilepanel.title This property allows updating "Please select target directory for download" label.
savefilepanel.save.button This property allows updating "Select location" button.
savefilepanel.buttons.align This property allows defining alignment of cancel button.
savefilepanel.invalid.folder This property allows updating "Cannot save into this folder, select another one." label.
duplicatepanel.title This property allows updating "Duplicate file" label.
duplicatepanel.file This property allows updating "already exists. Please choose an action below:" label.
duplicatepanel.confirm.yes
duplicatepanel.confirm.no		 This property allows updating "ok/cancel" buttons in duplicate panel pop-up.
duplicatepanel.overwrite This property allows updating "Overwrite" label in duplicate panel pop-up.
duplicatepanel.resume This property allows updating "Resume" label in duplicate panel pop-up.
duplicatepanel.skip This property allows updating "Skip" label in duplicate panel pop-up.
progresspanel.download.label This property allows updating "Downloading:" label.
pprogresspanel.download.label.* These properties allows updating download label color, font style and size.
progresspanel.download.file.label This property allows updating file info label.
progresspanel.download.file.label.* These properties allows updating file info label color, font style and size.
progresspanel.download.init.label This property allows updating "Initializing download ..." label.


Java and all Java-based marks are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries.
All other company and/or product names are the property of their respective owners.